Finding out current status of DBCTL activities

To find out the status of particular DBCTL activities, use the /DISPLAY command.

About this task

  • The /DISPLAY command with the ACTIVE keyword gives you an overview of activity in the entire DBCTL subsystem including processing for BMPs and for threads processing scheduled CICS® transactions. For each thread that is currently active (has a PSB scheduled) from a CICS transaction, there is an entry DBT in the column headed TYPE, as shown in the /DISPLAY command examples in Operations and automation in IMS product documentation . (The TYPE column shows the thread type and DBT stands for DBCTL thread.) The display may show fewer DBT threads than the number specified by MINTHRD in the DRA startup parameter table.
  • The /DISPLAY command with the CCTL keyword displays all (or specified) CICS systems currently connected to DBCTL. To specify a CICS system, add a CCTLNAME, which is the APPLID of the connected CICS system. The /DISPLAY command with the CCTL keyword also displays the following items for all or specified CICS systems:
    • All in-doubts for a given CICS or for all CICS systems (when you enter /DISPLAY CCTL INDOUBT).
    • Pseudo recovery token (only when status is INDOUBT). See Resolving indoubt CICS DBCTL units of work manually for information on using the pseudo recovery token in a /CHANGE command.
    • Recovery token.
    • Thread number (displayed as REGID) for all threads.
    • PSB name.
    • Status of thread(s).
    • All threads for a given CICS or all CICS systems.
    Note: The /DISPLAY command uses the CCTL ID (which, in the case of a CICS system, is the APPLID). However, many IMS messages use the jobname of the CICS system. Therefore, it is advisable to have a naming convention that enables operators to immediately identify a corresponding CICS APPLID and CICS JOBNAME. For example, if you use the APPLID DBDCICA, your job name could also contain the characters CICA.
  • The /DISPLAY command with the OLDS keyword displays the system logging status. You can use it to determine how many OLDS data sets are available for use or require archiving.
  • The /DISPLAY command with the POOL keyword displays main storage utilization statistics for IMS storage pools.
  • The /DISPLAY command with the AREA keyword displays the status of DEDB data sets in an area.
  • The /DISPLAY command with the DATABASE keyword displays the status (for example, NOTOPEN or STOPPED) of specified databases. If the database you specify is a DEDB, the associated DEDB areas are also displayed.
  • The /DISPLAY command with the DBD keyword displays, for databases that are being accessed, their type, the PSBs accessing them, and the type of access. (You can use the DBD keyword only if you have DEDB support installed.)
  • The /DISPLAY command with the MODIFY keyword displays the status of resources to be deleted or changed using the /MODIFY command. See Changing DBCTL resources online for information on the /MODIFY command.
  • The /DISPLAY command with the PSB keyword displays the status of PSBs, the databases being accessed, and the type of access. (You can use the PSB keyword only if you have DEDB support installed.)
  • The /DISPLAY command with the PROGRAM keyword displays the status of PSBs; for example, NOTINIT or STOPPED.
  • The /DISPLAY command with the SHUTDOWN STATUS keywords displays system activity during a shutdown type of checkpoint; for example, the number of regions still active.
  • The /DISPLAY command with the STATUS keyword displays the status of DBCTL resources, such as databases and PSBs.
  • The /DISPLAY command with the TRACE keyword displays status and options for IMS traces and the IMS monitor, and whether restart should occur without backout of BMP updates. (You can restart without using backout or recovery of databases: see the description of the COLDBASE keyword of the /ERESTART command in Emergency restart.)