OTMA client descriptors

Use OTMA client descriptors to provide information about a specific OTMA client to IMS™. OTMA client descriptor entries are identified in the DFSYDTx PROCLIB member by an M in column one of the descriptor entry.

The information in the OTMA client descriptor helps IMS manage messages from the OTMA client. The information included in an OTMA client descriptor can also be specified in an OTMA client-bid request or, in some cases, in a /START OTMA command. Information provided by these alternate methods might override the information provided in the OTMA client descriptor.

Using an OTMA client descriptor, you can specify to OTMA and IMS the following attributes of an OTMA client:

The name of the OTMA Destination Resolution exit routine that the OTMA client uses.
The timeout value that OTMA should use when waiting for an ACK or NAK response from the OTMA client for both commit-then-send messages and send-then-commit messages that use synclevel=confirm or synclevel=syncpt.
The maximum number of input messages from the OTMA client that can be processing in an IMS system before triggering a message flood condition.

OTMA client descriptors are optional; however, they can be particularly useful for routing output to an OTMA client before the OTMA client has actually connected to OTMA. When the OTMA client finally does connect, the specifications in the client-bid request override the specifications made in the OTMA client descriptor.

The following defaults apply if you do not specify any of the parameters of the OTMA client descriptor:

IMS uses the default OTMA Destination Resolution exit routine, DFSYDRU0, unless the client-bid request specifies a different exit routine name.
For the acknowledgment timeout value, IMS uses a default of two minutes unless a different timeout value is provided in either the client-bid request or the TIMEOUT parameter of the /START TMEMBER command.
For message flood detection, IMS uses a default threshold of 5000 messages, unless a different value is provided in either the client-bid request or the INPUT parameter of the /START TMEMBER command.

OTMA client descriptors are built during IMS initialization. The descriptors are included in DFSYDTx members of IMS.PROCLIB. The x on DFSYDTx is the IMS nucleus suffix. If you have multiple clients at the same IMS system, list each client name on a separate line. Ensure that columns 3-18 are different for each client.

You can define a maximum of 254 client descriptors. If you do not use the DFSOTMA descriptor, you can define 255 client descriptors.