IMS Queue Control Facility and OTMA

The IMS Queue Control Facility (QCF) supports OTMA messages. You can use QCF to switch between all supported IMS releases, or between Shared Queues and non-Shared Queues.

You can access QCF both online with an ISPF interface and with control statements in a BMP environment.

TMEMBER and TPIPE are the operands for the INCLUDE and EXCLUDE control statements.

tmember: A 1- to 16-character OTMA target member (client) name. You can generically specify groups of names that begin with the same characters by using an asterisk (*) after the characters that are the same. An asterisk as the first character will include or exclude all OTMA transactions.
tpipe: A 1- to 8-character OTMA transaction pipe name. You can generically specify groups of names that begin with the same characters by using an asterisk (*) after the characters that are the same.

To selectively recover OTMA messages, use the INCLUDE and EXCLUDE control statements. The format of the INCLUDE and EXCLUDE statements with OTMA operands is:

INCLUDE  operand(,)
 
EXCLUDE  operand(,)

operand must start in column 10 and is one of the following:

TMEMBER=tmember
TPIPE=tpipe

Example: To select all OTMA messages using transaction pipe name S4A1BV6, specify:

INCLUDE  TMEMBER=*,
         TPIPE=S4A1BV6

All messages with the same tmember are grouped together, and the count is reported by the tpipe name.

Example:

  **** MESSAGES INSERTED BY DESTINATION ****
         BY OTMA DESTINATION
         TMEMBERNAME
           TPIPE1                              count
           TPIPE2                              count

If a client-bid request changes the name of the current OTMA Destination Resolution exit routine, any transactions enqueued before IMS terminates that are then reprocessed by the Message Requeuer might not use the changed exit routine name. Inserts to alternate PCBs use the exit routine name in the client descriptor.

With QCF, you can identify a category of message as well as the message type. The following table describes category parameters, and the supported message types and keywords associated with the parameter.

Table 1. Selecting messages by category type
Category parameter	Description	Supported message types and keywords
DESTYPE	Checks the destination of a message for a selected message type	APPC, LTERM, MSC, OTMA, LTRAN, RTRAN, TRANS, VSP
SRCETYPE	Checks the source of the message for a selected message type	APPC, MSC, OTMA, VSP
MSGTYPE	Checks the source or destination of the message for the selected message type	APPC, LTERM, MSC, OTMA, VSP

Related Reading: For more information about message selection by category in QCF, refer to IMS Queue Control Facility for z/OS® User's Guide.