Viewing OTMA connection information for IMS-to-IMS TCP/IP communications

You can view configuration and status information for IMS-to-IMS TCP/IP connections that are used for OTMA by issuing IMS Connect commands.

The information that you can view for an IMS-to-IMS TCP/IP connection that is used for OTMA is different depending on whether you are viewing the information on the sending side of a connection or the receiving side of a connection. For this reason, the commands you use to display the connection information are also different on the sending and receiving sides of the connection.

To display connection information on the sending side of a connection that is used for OTMA, issue any one of the following IMS Connect commands that display the RMTIMSCON connection information:
- In the IMS type-2 format, QUERY IMSCON TYPE(RMTIMSCON)
- In the WTOR format, VIEWRMT
- In the z/OS® MODIFY format, QUERY RMTIMSCON
To display connection information on the receiving side of a connection that is used for OTMA, issue any one of the following IMS Connect commands that display port information:
- In the IMS type-2 format, QUERY IMSCON TYPE(PORT)
- In the WTOR format, VIEWPORT
- In the z/OS MODIFY format, QUERY PORT

Example: IMS Connect to IMS Connect connections for OTMA

In the following example, the VIEWRMT command is issued at a sending IMS Connect instance for a RMTIMSCON connection, ICON2B.

nnVIEWRMT ICON2B

The example output shows that there is one active send client socket connection, OTM924FA, on the RMTIMSCON connection ICON2B. The SENDCLNT ID is auto-generated by the sending IMS Connect instance when establishing the connection with the receiving IMS Connect instance. In the example, PORT=5555 shows that the sending IMS Connect expects the receiving IMS Connect to be listening on port 5555.

HWSC0001I    RMTIMSCON=ICON2B    STATUS=ACTIVE                        
HWSC0001I      IP-ADDRESS=009.030.221.055  PORT=5555                  
HWSC0001I      HOSTNAME=ECSER14.VMEC.SVL.IBM.COM                      
HWSC0001I      AUTOCONN=N  PERSISTENT=Y                               
HWSC0001I      IDLETO=3000                                            
HWSC0001I      RESVSOC=4   NUMSOC=1                                   
HWSC0001I      SENDCLNT USERID   STATUS       SECOND SENDPORT         
HWSC0001I      OTM924FA APOL1    CONN           5941 1026             
HWSC0001I      TOTAL SENDCLNTS=1 RECV=0 CONN=1 XMIT=0 OTHER=0

In the following example, which corresponds to the preceding example, the VIEWPORT command is issued at a receiving IMS Connect instance for port 5555.

nnVIEWPORT 5555

The example output shows that there is one receive socket connection, OTM924FA, in RECV state on port 5555. The CLIENTID OTM924FA of the socket connection matches the SENDCLNT ID shown in the example command output for the sending IMS Connect instance.

HWSC0001I    PORT=5555     STATUS=ACTIVE     KEEPAV=0 NUMSOC=2       EDIT=        TIMEOUT=0
HWSC0001I      CLIENTID USERID TRANCODE DATASTORE STATUS  SECOND CLNTPORT IP-ADDRESS               APSB-TOKEN
HWSC0001I      OTM924FA APOL1  APOL11   IMS2      RECV        11 1026     0:0:0:0:0:FFFF:91E:7326
HWSC0001I      TOTAL CLIENTS=1  RECV=1 READ=0 CONN=0 XMIT=0 OTHER=0