/STOP THREAD command

Use the /STOP THREAD command to stop an inactive CCTL thread. The DEDB utility region is terminated at the next system checkpoint.

Subsections:

Environment

The following table lists the environments (DB/DC, DBCTL, and DCCTL) in which you can use the commands and keywords.

Table 1. Valid environments for the /STOP THREAD command and keywords
Command / Keywords DB/DC DBCTL DCCTL
/STOP X X X
ABDUMP X X X
CANCEL X X X
THREAD X   X
TRANSACTION X   X

Syntax

Read syntax diagramSkip visual syntax diagram/STOP/STOTHREAD reg#reg#ABDUMPABDUMPtrannameABDUMPFORCETRANSACTIONtrannameCANCEL

Keywords

For information about the keywords that are valid for the /STOP THREAD command, see the description about the same keywords under the /STOP REGION command.

Usage notes

The /STOP THREAD command is not valid for:
  • Active CCTL threads
  • BMPs

The THREAD ABDUMP command abnormally ends BMPs and DEDB utilities. If this command is used with CCTL threads, a U0474 abend results.

Examples

The following are examples of the /STOP THREAD command:

Example 1

Entry ET: 
/DISPLAY A REGION
Response ET: 
REGID JOBNAME   TYPE  TRAN/STEP PROGRAM  STATUS     CLASS
      BATCHREG  BMP   NONE
      FPRGN     FP    NONE
    2 CICS1A    DBT   IEFPROC   BMP255   ACTIVE
    3 CICS1A    DBT   IEFPROC   PLVAPZ12 ACTIVE
    1 CICS1A    DBT   IEPROC             AVAILABLE
      DBRCHTA1  DBRC
      DLICHTA1  DLS
*00082/142907*
Entry ET: 
/STOP THREAD 2
Response ET: 
DFS058I STOP COMMAND IN PROGRESS
DFS0556I COMMAND REJECTED; DBCTL THREAD IS ACTIVE

Example 2

Entry ET: 
/DISPLAY A REGION
Response ET: 
REGID JOBNAME   TYPE  TRAN/STEP PROGRAM  STATUS     CLASS
      BATCHREG  BMP   NONE
      FPRGN     FP    NONE
    2 CICS1A    DBT   IEFPROC   BMP255   ACTIVE
    3 CICS1A    DBT   IEFPROC   PLVAPZ12 ACTIVE
    1 CICS1A    DBT   IEFPROC            AVAILABLE
      DBRCHTA1  DBRC
      DLICHTA1  DLS
*00082/143027*
Entry ET: 
/STOP THREAD 1
Response ET: 
DFS058I STOP COMMAND IN PROGRESS
Entry ET: 
/DISPLAY A REGION
Response ET: 
REGID JOBNAME   TYPE  TRAN/STEP PROGRAM  STATUS     CLASS
      BATCHREG  BMP   NONE
      FPRGN     FP    NONE
    2 CICS1A    DBT   IEFPROC   BMP255   ACTIVE
    3 CICS1A    DBT   IEFPROC   PLVAPZ12 ACTIVE
      DBRCHTA1  DBRC
      DLICHTA1  DLS
*00082/143055*

Example 3

Entry ET: 
/DISPLAY A REGION
Response ET: 
REGID JOBNAME   TYPE  TRAN/STEP PROGRAM  STATUS     CLASS
      BATCHREG  BMP   NONE
      FPRGN     FP    NONE
    2 CICS1A    DBT   IEFPROC   BMP255   ACTIVE
    3 CICS1A    DBT   IEFPROC   PLVAPZ12 ACTIVE
      DBRCHTA1  DBRC
      DLICHTA1  DLS
*00082/144731*
Entry ET: 
/STOP THREAD 2 ABDUMP
Response ET: 
/DFS058I STOP COMMAND IN PROGRESS
Response ET: 
DFS554A CICS1A     00002 IEFPROC  BMP255   (3)        000,0474   20
/082 14:49:11    RTKN= CICS1   B3C81CB789F4BE83
Entry ET: 
/DISPLAY A REGION
Response ET: 
REGID JOBNAME   TYPE  TRAN/STEP PROGRAM  STATUS     CLASS
      BATCHREG  BMP   NONE
      FPRGN     FP    NONE
    3 CICS1A    DBT   IEFPROC   PLVAPZ12 ACTIVE
      DBRCHTA1  DBRC
      DLICHTA1  DLS
*00082/145038*