You can monitor the connection to Db2 from IMS by using
the /DISPLAY SUBSYS command.
About this task
In addition
to showing which program is active on each dependent region connection,
the display also shows the LTERM user name and gives the control region
connection status.
Procedure
To monitor the connection to Db2 from IMS:
Issue the /DISPLAY SUBSYS command with
the following syntax:
/DISPLAY SUBSYS subsystem-name
The
connection between IMS and Db2 is shown
as one of the following states:
CONNECTED
NOT CONNECTED
CONNECT IN PROGRESS
STOPPED
STOP IN PROGRESS
INVALID SUBSYSTEM NAME=name
SUBSYSTEM name NOT DEFINED BUT RECOVERY OUTSTANDING
The thread status from each dependent region is shown as one
of the following states:
CONN
CONN, ACTIVE (includes LTERM of user)
Example
The following four examples show the output that might
be generated when you issue the IMS/DISPLAY
SUBSYS command.
The
following figure shows the output that is returned for a DSN subsystem
that is not connected. The IMS attachment
facility issues message DSNM003I in this example. Figure 1. Example of output
from IMS /DISPLAY SUBSYS processing
0000 15.49.57 R 45,/DIS SUBSYS NEW
0000 15.49.57 IEE600I REPLY TO 45 IS;/DIS SUBSYS END
0000 15.49.57 JOB 56 DFS000I DSNM003I IMS/TM V1 SYS3 FAILED TO CONNECT TO SUBSYSTEM DSN RC=00 SYS3
0000 15.49.57 JOB 56 DFS000I SUBSYS CRC REGID PROGRAM LTERM STATUS SYS3
0000 15.49.57 JOB 56 DFS000I DSN : NON CONN SYS3
0000 15.49.57 JOB 56 DFS000I *83228/154957* SYS3
0000 15.49.57 JOB 56 *46 DFS996I *IMS READY* SYS3
The following figure shows the output that is returned
for a DSN subsystem that is connected. The IMS attachment
facility issues message DSNM001I in this example. Figure 2. Example of output
from IMS /DISPLAY SUBSYS processing
0000 15.58.59 R 46,/DIS SUBSYS ALL
0000 15.58.59 IEE600I REPLY TO 46 IS;/DIS SUBSYS ALL
0000 15.59.01 JOB 56 DFS551I MESSAGE REGION MPP1 STARTED ID=0001 TIME=1551 CLASS=001,002,003,004
0000 15.59.01 JOB 56 DFS000I DSNM001I IMS/TM=V1 SYS3 CONNECTED TO SUBSYSTEM DSN SYS3
0000 15.59.01 JOB 56 DFS000I SUBSYS CRC REGID PROGRAM LTERM STATUS SYS3
0000 15.59.01 JOB 56 DFS000I DSN : CONN SYS3
0000 15.59.01 JOB 56 DFS000I *83228/155900* SYS3
0000 15.59.01 JOB 56 *47 DFS996I *IMS READY* SYS3
The following figure shows the output that is returned
for a DSN subsystem that is in a stopped status. The IMS attachment
facility issues message DSNM002I in this example. Figure 3. Example of output
from the IMS /DISPLAY SUBSYS
command
0000 15.59.28 R 47,/STO SUBSYS ALL
0000 15.59.28 IEE600I REPLY TO 47 IS;/STO SUBSYS ALL
0000 15.59.37 JOB 56 DFS058I 15:59:37 STOP COMMAND IN PROGRESS SYS3
0000 15.59.37 JOB 56 *48 DFS996I *IMS READY* SYS3
0000 15.59.44 R 48,/DIS SUBSYS ALL
0000 15.59.44 IEE600I REPLY TO 48 IS;/DIS SUBSYS ALL
0000 15.59.45 JOB 56 DFS000I DSNM002I IMS/TM V1 SYS3 DISCONNECTED FROM SUBSYSTEM DSN RC = E. SYS3
0000 15.59.45 JOB 56 DFS000I SUBSYS CRC REGID PROGRAM LTERM STATUS SYS3
0000 15.59.45 JOB 56 DFS000I DSN : STOPPED SYS3
0000 15.59.45 JOB 56 DFS000I *83228/155945* SYS3
0000 15.59.45 JOB 56 *49 DFS996I *IMS READY* SYS3
The following figure shows the output that is returned
for a DSN subsystem that is connected and region 1. You can use the
values from the REGID and the PROGRAM fields to correlate the output
of the command to the LTERM that is involved. Figure 4. Example of output from IMS /DISPLAY SUBSYS processing for a DSN subsystem
that is connected and the region ID (1) that is included.