# Conversion Rules Panel

You can create or modify a conversion rule in the Conversion Rules panel.

## Panel Layout

    SXTP03 ----------------------- Conversion Rules -------------- Row 1 to 6 of 6
    Command ===>                                                   Scroll ==> CSR
     (ADD=Create new Conversion Rule, CAN=Cancel updates, F=Find)
     (Use line cmd 'M' to relate Message fields to conversion rules)
              Max    EMS  S
    Sel Flds Bufsz   Type Z  Conversion Id    Message Id      Buffer Id
    -   ---- ------- ---- -  ---------------- --------------- ---------------
           1 0         M  B  CVR-I-ADMIN      MSG-IN-ADMIN    BUF-IO-ADMIN
           9 0         M  B  CVR-I-IMSCVS-01  MSG-IN-IMSCVS   BUF-I-IMSCVS-01
          13 0         M  B  CVR-I-TSRR-01    MSG-IO-RR-01    BUF-IO-BF01
          12 0         M  B  CVR-I-01         MSG-IN-01       BUF-IO-BF01
          20 0         M  B  CVR-I-02         MSG-IN-02       BUF-IO-BF02
           1 0         B  M  CVR-IO-BYTES     MSG-JMS-BYTES   BUF-BYTES

## Field Description

The following table list the fields in the Conversion Rules panel:

Field | Description
--- | ---
Command | You can enter `ADD` to create a new conversion rule, and enter `CAN` to cancel all modifications just done to the existing conversion rule. Enter F xyz to bring the xyz conversion rule to the top of the list. Valid commands: ADD, CAN and F.
Sel | You can select an existing conversion rule to modify. Valid selections: S(elect), M(essages), D(elete), R(epro), and U(sedon). If you select M, you can access the panel described in Define Message Fields to Conversion Rule Panel. If you select U, you can access the panel described in Recipes & Triggers using a Conversion Rule Panel
Flds | The number of fields that have been mapped between messages and buffers.
Max Bufsz | Optional. The maximum size of the buffer (data area) that is used for communication. Numeric only. Default value: 0.
EMS Type | The message type of a nested message. Valid selections: M(ap), S(tream), T(ext), and B(ytes). Default selection: M.
SZ | This field is used only with TIBCO Enterprise Message Service messages and if the message type is either BYTES or TEXT. Valid selections: M(ap) and B(ytes). Default selection: B. You can determine how Substation ES calculates the size for data communication with the BES application (CICS or IMS): If you select M, the payload (TIBCO Enterprise Message Service message) size determines the data communication area size. Both the input and output data communication sizes are set by the size of the input message. The output message data size can only be equal to or less than the input message size. If you select B, the data communication size is determined by the area, fields, or both in the conversion rules buffer definition. This is the existing method for Substation ES versions earlier than 2.5.
Conversion Id | Required. The user defined name of the conversion. Default value: New_Rule1.
Message Id | The name of the message definition used in the conversion rule.
Buffer Id | The name of the buffer definition used in the conversion rule.

Copyright © TIBCO Software Inc. All rights reserved.