OTMA architected transaction attributes

When you issue an IMS /DISPLAY TRANSACTION command from OTMA, the output is in the form of an OTMA message, returned to the client in the application-data section of the message prefix.

The following table shows the Attributes Segment for a given transaction and describes the syntax of architected command output. The description includes byte, length, content, hexadecimal value, the meaning, and includes usage comments where appropriate.

Table 1. Transaction attributes segment
Byte Length Content Value Meaning Comments
0 2 Length   Length of the Transaction Attributes Segment (LL). This length includes the length field itself.
2 2 ZZ      
4 8 Transaction code   The 8-byte IMS transaction code.  
12 1 Transaction type flag 1     The flag 1 values are mutually exclusive.
    Valid X'00' A valid OTMA transaction.  
    CPIC X'04' A CPI-C (APPC) transaction.  
    FPX X'08' A Fast Path-exclusive transaction.  
    FPP X'0C' A Fast Path-potential transaction.  
    MSC X'10' An MSC remote transaction.  
    Invalid Syntax X'FE' Syntax error. The data area contains the text of the error.
    Invalid X'FF' Transaction not found, or invalid.  
13 1 Transaction type flag 2     The flag 2 values are not mutually exclusive.
    Response X'80' An IMS response mode transaction.  
    Conversation X'40' An IMS conversational transaction.  
    Update X'20' The transaction has update capability.  
    Irrecoverable X'10' The transaction is defined as irrecoverable.  
    Multi-Segment X'08' The transaction has multiple segments.  
    Uppercase X'04' Uppercase translation requested.  
14 1 Transaction status     The indicated values are not mutually exclusive.
    STOP X'80' The transaction input queuing is stopped. One of the following IMS commands was issued for the transaction:
  • /STOP
  • /PURGE
    OLC X'40' The transaction input queuing is stopped. One of the following IMS commands was issued for the transaction:
  • /MOD PREPARE
  • /MOD COMMIT
    NOSCH X'20' IMS scheduling is stopped. One of the following IMS commands was issued for the transaction:
  • /PSTOP
  • /LOCK
15 1 Reserved      
16 2 Length   Length (LL) of error text, if any. If there is error text, it replaces all subsequent sections of the message.
18 * Error text   Text of the error message. Variable length. The error test section is applicable only if transaction type flag 1 is set to Invalid Syntax (X'FE')
16 8 PSB name   IMS PSB name. Only present if there is no error text.
24 1 Class   SMB message class for IMS scheduling.  
25 1 Current priority   Current SMB priority.  
26 1 Normal priority   Normal SMB priority.  
27 1 Limit priority   SMB limit priority.  
28 2 Enqueue count   Number of messages enqueued.  
30 2 Dequeue count   Number of messages dequeued.  
32 2 Enqueue limit   Enqueue limit count.  
34 2 Processing limit count   Processing limit count.  
36 2 Output max segment length   The maximum output segment length.  
38 2 Output limit of message segments   The output limit of message segments.  
40 2 Parallel limit   The PARLIM value from TRANSACTION statement.  
42 1 Region count   The number of regions in which the transaction is currently scheduled.