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.