| Name
|
Type an IMS interface name.
|
| Description
|
Type a short description for the IMS interface.
|
| Interface ID
|
Type an IMS interface identifier, which is the internal interface name for Substation ES.
|
| XCF Member Name
|
Type the XCF member name.
|
| TPIPE Name
|
Type a one-to-eight-character OTMA Named transaction pipe (Tpipe) name, which is analogous to LTERM. It is a logical structure that represents an anchor point for Substation ES transactions and output.
You must specify this value.
|
| TPIPE Prefix
|
Type a one-to-five-character OTMA Named transaction pipe (Tpipe) name, which is analogous to LTERM. It is a logical structure that represents an anchor point for Substation ES transactions and output.
You must specify this value.
|
|
Output Interface
|
Type an output interface, or click the
 icon to select one.
|
|
IMS Endpoint
|
Type an IMS endpoint, or click the
icon to select one.
|
| Active Triggers
|
Specifies whether the trigger-processing resources have been activated for the outbound messages.
By default, this check box is cleared.
|
| Sync Call-out Timeout (sec)
|
Enter the timeout value that denotes the time for which the Substation ES synchronous callout process waits before sending a clear SRB request to the OTMA interface.
Valid values for this field are in the range
1 -
120.
The default value is
10.
|
| In the
TPIPE Name for trigger services area, the following items are available:
|
| Guaranteed
|
Type a one-to-sixteen-character Substation ES IMS Interface Guaranteed trigger destination name. This value is used by IMS to reroute messages through OTMA to the Substation ES IMS Interface. When applications reroute or insert messages that are intended for Substation ES to an alternate PCB, specify this name as
LTERM. No default value is available for this field.
|
| Reliable
|
Type a one-to-sixteen-character Substation ES IMS Interface reliable trigger destination name. This value is used by IMS applications to reroute messages using OTMA to the Substation ES IMS Interface. If applications reroute or insert messages that are intended for Substation ES to an alternate PCB, specify this name as
LTERM. No default value is available for this field.
|
| Sync Call-out
|
Type a one-to-sixteen-character Substation ES IMS Interface synchronous call-out destination name. This value is used by IMS to route synchronous call-out transactions through OTMA to EMS or Rendezvous. This value must match a destination-type entry in IMS parameter member
DFSYDTx. TIBCO supplies a sample
DFSYDT10 in
USERHLQ.PROC.
|
|
IMS Commit Mode
|
Select whether the IMS transactions processed by Substation ES are coded as commit
0 or commit
1. This value is passed on in each of the transactions.
|
| Workers
|
In the
ESB Request/Reply field, enter the number of concurrent OTMA client subtasks that are started to service Substation ES IMS requests.
In the
Service: Trigger field, enter the number of concurrent OTMA trigger sessions that will be started to service Substation ES requests.
|
| In the
OTMA Settings panel, the following items are available:
|
| Wait time in seconds
|
In the
Initialization field, type a value in seconds. This value denotes the maximum time for which the Substation ES IMS Interface waits during XCF initialization and for the OTMA server to be contacted before issuing an error.
Valid values for this field are in the range
1 -
30 .
The default value is
2.
|
| In the
OTMA field, type a value in seconds. This value denotes the maximum time for which the Substation ES IMS Interface waits for a NACK response from the IMS Server on a RESUME TPIPE command issued during interface initialization.
Valid values for this field are in the range
1 -
10 .
The default value is
2.
|
| In the
Message field, type a value in seconds. This value denotes the maximum time for which the Substation ES IMS Interface waits for a response from the IMS Server for transactions or commands before issuing a timeout.
Valid values for this field are in the range
1 -
600
.
The default value is
30.
|
| In the
Transaction field, type a value in seconds. This value denotes the time for which the Substation ES waits after the message wait time has expired before flushing the transaction buffer.
Valid values for this field are in the range
1
-
30.
The default value is
3.
|
| Transaction
|
In the
Buffer Allocation Value - Transaction
field, type the number of buffers that send transaction or command information to IMS. This value must be at least equal to that of the IMS Interface WORKERS parameter.
Valid values for this field are in the range
16 -
128.
The default value is
20.
|
| In the
Buffer Size Value (bytes) - Transaction field, type the length of data buffers for gathering and receiving IMS data. The value must be equal to the largest data area being transferred to and from IMS. Normally, the value of the
Buffer Size Value (bytes) - SRB parameter must be equal to the value specified here.
Valid values for this field are in the range
4096 -
4 MB.
The default value is
4096.
|
| SRB
|
In the
Buffer Allocation Value - SRB field, type the number of buffers used by the OTMA interface service request blocks (SRBs) to communicate with IMS and the OTMA server.
This value must be about three times that of the BUFF-TRANS parameter.
Valid values for this field are in the range
32 -
1024.
The default value is
64.
|
| In the
Buffer Size Value (bytes)- SRB field, type the buffer length used in the SRB routines. The value is advised to be equal to or greater than the most frequently used IOPCB size of your IMS transactions, or the size of your data area for ICAL operations.
Valid values for this field are in the range
4096 -
4 MB.
The default value is
4096.
Note: IMS does not support segments larger than 32K. As a result, a value between 32K and 64K is not currently suggested.
|
| Group
|
In the
Buffer Allocation Value - Group field, type the number of buffers for communicating with the XCF group.
Valid values for this field are in the range
8 -
64.
The default value is
8.
|
| In the
Buffer Size Value (bytes) - Group field, type the length of buffers used in the communication with the XCF and XCF group and members. The default value must be sufficient unless the XCF group is very large.
Valid values for this field are in the range
512 -
65536
(64 KB).
The default value is
2048 (2 KB).
|
| Loopback:
|
This item is used in a QA and testing environment by TIBCO Support to determine whether the messages received by Substation ES are passed through to the CICS Region.
It can be set to
Yes or
No.
Note: Do not change this value unless requested by TIBCO Support.
|
| Trace Level: Trigger
|
Enter the trace level of the IMS interface when tracing trigger entries that pass through the interface,
where:
- Level 1 only traces an entry in the log file.
- Level 2 dumps the buffer content in the trace file into the log file.
- Level 3 includes all details from trigger processes in the trace file.
- A value of 0 disables tracing of trigger entries on the IMS Interface.
The default value is
0.
|
|
Trace Level OTMA
|
Enter the tracing level for components of the OTMA interface that are located in the IMS interface.
This value can also be dynamically changed by means of Substation ES operational commands. A value of 0 produces minimal messages, and a value of 5 includes snaps of control blocks and data. For best results, set it to
2.
|
