Checking XCF data store connection status for IMS TM clients

You can issue variations of the IMS and IMS Connect commands to determine the status of XCF data store connections for IMS TM clients.

In the following examples, the XCF connection between IMS Connect and OTMA is defined by the following DATASTORE configuration statement:

DATASTORE=(ID=DSNAME,MEMBER=ICONNAME,TMEMBER=IMSNAME,GROUP=GRPNAME...)

From IMS, use the following commands to check the status of IMS Connect:

/DIS OTMA

When IMS Connect is ready for use, the output of the /DIS OTMA command appears as shown in the following example:

GROUP/MEMBER  XCF-STATUS  USER-STATUS    SECURITY TIB   INPT SMEM  DRUEXIT  T/O  ACEEAGE
GRPNAME
-IMSNAME      ACTIVE      SERVER         FULL*
-ICONNAME     ACTIVE      ACCEPT TRAFFIC  
 
* CHECK, FULL, NONE or PROFILE depending on the OTMA Security 
  setting (for example, enter /SEC OTMA NONE on the MVS system 
  console to turn off RACF security for IMS OTMA clients). FULL
  is the default setting for OTMA security at IMS startup.

/DISPLAY TMEMBER tmembername TPIPE

For example, the command input /DISPLAY TMEMBER CLIENT1 TPIPE ALL might produce the following output:

MEMBER/TPIPE          ENQCT      DEQCT        QCT STATUS
CLIENT1                                           TRA
-TPIPE1                   0          0          0 TRA,STO
-TPIPE2                   2          2          0 TRA,STO
-TPIPE3                   1          0          1 TRA,STO
*94165/170756*

From IMS Connect, you can use the following WTOR-format commands to display status:

VIEWHWS

Displays information about data stores, ports, and IMSplex.
Tip: If you use the SUMMARY option for the VIEWHWS command, you can display IMS Connect information without the detailed output for each socket.

VIEWDS

Displays information about data stores.

Alternatively, you can issue the following IMS type-2-format commands through the OM API to display the status:

QUERY IMSCON TYPE(CONFIG)

Displays the status and activities of IMS Connect. Unlike the VIEWHWS command, individual resources such as port and data store are not displayed.

QUERY IMSCON TYPE(PORT)

Displays the status and activities of one or more ports defined to IMS Connect.
If you specify the SHOW(CLIENT) keyword, an additional line is displayed for each client associated with the specified port.

QUERY IMSCON TYPE(DATASTORE)

Displays the status and activities of one or more data stores defined to IMS Connect.
Enter the following IMS commands if you fail to receive a response to a request message sent from an IMS TM client (or to check the readiness of the host data store):
/DIS A REG
You can use this command to verify that the dependent region where your host application runs is properly configured and ready to accept messages:
```
REGID JOBNAME   TYPE  TRAN/STEP PROGRAM  STATUS   CLASS                         
    1    Job1   TP                       WAITING  1,  2,  3,  4 
```
/DIS TRAN TranName
You can use this command to verify the class and status of a transaction and whether or not a transaction is currently queued for processing:
```
TRAN     CLS ENQCT   QCT   LCT  PLCT CP NP LP SEGSZ SEGNO PARLM    RC           
TRANNAME   2     1     1 65535 65535  8  8  8     0     0  NONE     0
```
QCT is the number of transactions that are currently queued. ENQCT includes transactions that have been dequeued (processed), as well as those that are currently on the queue.
If you receive an IMS Connect error message on either the z/OS® system console or in the response message at the client when you issue IMS or IMS Connect commands, the format of IMS Connect message numbers is HWSxnnnn, where the x represents an alphabetic character and nnnn represents a 4-digit number.
IMS Connect requires that all active clients have unique client names. IMS TM Resource Adapter creates a unique CLIENTID, which identifies each request that an application makes to execute an IMS transaction. If you are using TCP/IP clients that access IMS TM other than IMS TM Resource Adapter, you must ensure that those clients each use a unique client name. This client name value is displayed for a client in the CLIENT= or ORIGIN= fields.
When IMS Connect receives an initial request from IMS TM Resource Adapter with a blank Client ID, IMS Connect generates a unique Client ID to be used for that TCP/IP persistent socket. IMS Connect returns this Client ID to IMS TM Resource Adapter on any reply message.

Important: There are OTMA restrictions on IMS commands.