EMS-Specific Parameters
The following table lists the EMS-specific parameters. For details and the default settings, see the EMS administration manuals.
| Parameter | Description |
|---|---|
| EMS-SESSION = {N | Yes, No} | The EMS-SESSION parameter, which is a keyword for the EMS ESB endpoint, determines whether ESB Interface will use one EMS session for each task to produce messages. |
| EMS-USE-PROP = {N | Yes, No} | The
EMS-USE-PROP parameter, which is a keyword for the ESB endpoint, determines whether ESB Interface will use properties for its own described fields, such as the
tibss- fields.
Because properties can be passed into Substation ES with Text and Bytes messages, this parameter is useful if XML and COBOL copybook layouts are passed. The output fields, such as tibss-status and tibss-envelope, can also be used for non-EMS mapped messages for CICS Request Reply. The default value is N. |
| EMS-DMQ-NAME = {tibss.Dead.Msg.Queue} | The
EMS-DMQ-NAME parameter, which is a keyword for the EMS ESB endpoint, specifies the TIBCO EMS queue name for messages that cannot be delivered to their destination, known as EMS dead messages.
An external service, such as TIBCO BusinessWorks, can specify the reply to the destination name. However, if that session terminates and Substation ES can no longer reply to the queue, then this keyword identifies the queue to which Substation ES will write such messages. |
| ERROR-MSG-TYPE = {M | Map, Bytes, Text} (Optional) | The
EMS-DMQ-NAME value is a letter that identifies the EMS message type of the Substation ES error message to be delivered. The message type is specified for each ESB Interface and is Map, Bytes, or Text.
The valid values are M, B, and T; the default value is M. |
| UFLDS-FORMAT = {1 | number} | Optional.
The UFLDS-FORMAT value is the format in which Substation ES writes error descriptions in the Substation ES runtime error message. The format pertains only to the message descriptions. With format 3, the field names or error descriptions are fixed and in the range ERROR1 through ERROR9. TIBCO BusinessWorks and other applications that process the error message now have a fixed format schema to read the errors. The valid values are 1 and 3; the default value is 1. This parameter applies to EMS ESB Interface only. |