/STOP REGION command

Use the /STOP REGION command to stop IMS regions, application programs, or both. /STOP REGION is not mirrored on the XRF alternate system. You must enter this command on the alternate system if you want it to affect the alternate system.

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 REGION command and keywords
Command / Keywords DB/DC DBCTL DCCTL
/STOP X X X
ABDUMP X X X
CANCEL X X X
JOBNAME X X X
REGION X X X
TRANSACTION X   X

Syntax

Read syntax diagramSkip visual syntax diagram/STOP/STOREGION reg#reg#–reg#reg#ABDUMPABDUMPtrannameABDUMPFORCETRANSACTIONtrannameCANCELJOBNAMEjobnameJOBNAMEjobnameABDUMPtrannameTRANSACTIONtrannameCANCEL

Keywords

The following keywords are valid for the /STOP REGION command:

REGION reg#
Is used to terminate one or more message processing regions at the conclusion of processing the current transaction. The region identifier is reg#.

/STOP REGION reg# can also be used to terminate Fast Path regions. /STOP REGION reg# cannot be used to terminate batch regions.

A Fast Path utility region is terminated at the next system checkpoint of the utility.

REGION reg#–reg#
Is used to terminate a range of message processing regions at the conclusion of processing the current transaction.

REGION reg# ABDUMP tranname
Causes abnormal termination of an application program.

The region identifier is reg# and the transaction code is tranname.

If the transaction indicated by tranname is currently running in REGION reg#, an error message is received at the master terminal, indicating an application program abend. The region will remain active, but the transaction will be stopped. The command is ignored if the transaction is not currently scheduled in region reg#.

/STOP REGION reg# ABDUMP should be used only for a region that appears to be looping or in a wait state. If this command does not abnormally terminate the application running in a region, the /STOP REGION reg# CANCEL command can be used. This might cause the control region to terminate with abend 113 if parallel DL/I is being used. See /STOP REGION reg# CANCEL for further warnings.

If the /CHECKPOINT command cannot shut down IMS because a message processing region appears to be active, but the region is no longer active in the system (a condition commonly referred to as a phantom region), the /STOP REGION reg# ABDUMP command can be used to correct the situation. In this case, the /STOP REGION reg# ABDUMP command detects that the region is no longer active and cleans the internal IMS entries for the nonexistent region, which allows the shut down process to proceed normally.

If a message processing region experiences a catastrophic failure and abnormally terminates and a /DISPLAY ACTIVE REGION shows the region is still defined to IMS, the /STOP REGION reg# ABDUMP command can be used to correct the situation. In this case, the /STOP REGION reg# ABDUMP command detects the region is no longer active and cleans the internal IMS entries for the nonexistent region.

The tranname variable is not valid for batch, IFP, or Fast Path utility regions.

REGION reg# ABDUMP FORCE
Stops a range of message processing regions whose status is either WAIT-INIT-INPROG or TERM PENDING.

The region identifier is reg#. This keyword is applicable only to MPP and JMP regions.

REGION reg# TRANSACTION tranname
Stops a message processing program in wait-for-input (WFI) mode from processing within the specified region.

The region identifier is reg# and the transaction code is tranname.

If the transaction indicated by tranname is currently running in region reg#, the IMS message DFS0569I is received at the master terminal, indicating that a QC status code (no more messages) was returned to the application program (MPPs). The region that contained the application is still active and the transaction is not stopped. A batch message processing program in WFI mode must be stopped using the /PSTOP command.

A batch message processing region (BMP) scheduled against wait-for-input (WFI) transactions returns a QC status code (no more messages) for, /PSTOP REGION, /DBD, /DBR, or /STA commands only.

REGION reg# CANCEL
Is used if the region cannot be stopped with a /STOP REGION ABDUMP command and must be preceded by a /STOP REGION ABDUMP command.

The region identifier is reg#.

Using the /STOP REGION CANCEL command can cause the IMS control region to terminate with user abend 113 if parallel DL/I is being used. A z/OS® CANCEL command will be rejected.

REGION JOBNAME
Identifies regions to be stopped by their job names. The job name must be 1-8 alphanumeric or national ($,#,@) characters. The first character of the job name must be either alphabetic or national.

Examples

The following are examples of the /STOP REGION command:

Example 1 for /STOP REGION command

Entry ET: 
/DISPLAY A
Response ET: 
REGID JOBNAME   TYPE  TRAN/STEP PROGRAM  STATUS           CLASS
    2 MPP       TP    TXCDRN24  DDLTRN24                    1,  2
    1 BMP       BMP   BMP       BMP255
    3 IFPN      FPM   NO MSG.   DDLTJN26
      DBR1CT13  DBRC 
VTAM ACB CLOSED
LINE ACTIVE-IN -   1 ACTIV-OUT -   0
NODE ACTIVE-IN -   0 ACTIV-OUT -   0
LINK ACTIVE-IN -   0 ACTIV-OUT -   0
*89041/142004*

Explanation: Fast Path message-driven region 3 currently has no messages to process.

Entry ET: 
/STOP REG 3
Response ET: 
DFS058I STOP COMMAND IN PROGRESS
Entry ET: 
/DISPLAY A
Response ET: 
REGID JOBNAME    TYPE  TRAN/STEP PROGRAM  STATUS         CLASS
    2 MPP        TP    TXCDRN24  DDLTRN24                  1,   2
    1 BMP        BMP   BMP       BMP255
      FPRGN      FP    NONE
      DBRC1CT13  DBRC
VTAM ACB CLOSED
LINE ACTIVE-IN -    1 ACTIV-OUT -   0
NODE ACTIVE-IN -    0 ACTIV-OUT -   0
LINK ACTIVE-In -    0 ACTIV-OUT -   0
*89041/142102*

Explanation: Fast Path region 3 has been stopped. If region 3 had been processing a message, IMS would have terminated the region on completion of the transaction.

Example 2 for /STOP REGION command

Entry ET: 
/DISPLAY A
Response ET: 
REGID JOBNAME   TYPE  TRAN/STEP PROGRAM  STATUS         CLASS
    2 MPP       TP    TXCDRN24  DDLTRN24                  1,   2
    1 BMP       BMP   BMP       BMP255
      FPRGN     FP    NONE
      DBR1CT13  DBRC
VTAM ACB CLOSED
LINE ACTIVE-IN -   1 ACTIV-OUT -   0
NODE ACTIVE-IN -   0 ACTIV-OUT -   0
LINK ACTIVE-IN -   0 ACTIV-OUT -   0
*89041/142102*
Entry ET: 
/STOP REG 1
Response ET: 
DFS058I STOP COMMAND IN PROGRESS
DFS0557I STOP REGION ID NOT VALID- REGION 0001 IS BMP.

Explanation: /STOP REGION (with no keywords) is not valid for batch regions.

Example 3 for /STOP REGION command

Entry ET: 
/DISPLAY A
Response ET: 
REGID JOBNAME   TYPE  TRAN/STEP PROGRAM  STATUS           CLASS
    2 MPP       TP    TXCDRN24  DDLTRN24                    1,   2
    1 BMP       BMP   BMP       BMP255
    3 FPU       FPU   IFP       DBF#FPU0
      DBR1CT13  DBRC 
VTAM ACB CLOSED
LINE ACTIVE-IN -   1 ACTIV-OUT -   0
NODE ACTIVE-IN -   0 ACTIV-OUT -   0
LINK ACTIVE-IN -   0 ACTIV-OUT -   0
*89041/142453*
Entry ET: 
/STOP REG 3
Response ET: 
DFS058I STOP COMMAND IN PROGRESS
Entry ET: 
/DISPLAY A
Response ET: 
REGID JOBNAME   TYPE  TRAN/STEP PROGRAM  STATUS           CLASS
    2 MPP       TP    TXCDRN24  DDLTRN24                    1,   2
    1 BMP       BMP   BMP       BMP255
      FPRGN     FP    NONE
      DBR1CT13  DBRC
VTAM ACB CLOSED
LINE ACTIVE-IN -   1 ACTIV-OUT -   0
NODE ACTIVE-IN -   0 ACTIV-OUT -   0
LINK ACTIVE-In -   0 ACTIV-OUT -   0
*89041/142758*

Explanation: Fast Path utility region 3 has been stopped. The Fast Path utility DBF#FPU0 was terminated at the next system checkpoint.

Example 4 for /STOP REGION command

Entry ET: 
/DISPLAY A
Response ET: 
REGID JOBNAME   TYPE  TRAN/STEP PROGRAM  STATUS           CLASS
    2 MPP       TP    TXCDRN24  DDLTRN24                    1,   2
    1 BMP       BMP   BMP       BMP255
      FPRGN     FP    NONE   SYS3
VTAM ACB CLOSED
LINE ACTIVE-IN -   1 ACTIV-OUT -   0
NODE ACTIVE-IN -   0 ACTIV-OUT -   0
LINK ACTIVE-IN -   0 ACTIV-OUT -   0
*89041/142758*

Explanation: Transaction TXCDRN24 in region 2 is looping or in a wait state.

Entry ET: 
/STOP REG 2 ABDUMP TXCDRN24
Response ET: 
DFS058I STOP COMMAND IN PROGRESS
DFS555I TRAN TXCDRN24 ABEND S000,U0474 SYS ID 220  MSG IN PROGRESS

Explanation: The application program has been terminated with a U0474 ABEND. This abend indicates termination in response to a user request (/STOP REGION ABDUMP).

Entry ET: 
/DISPLAY A
Response ET: 
REGID JOBNAME   TYPE  TRAN/STEP PROGRAM  STATUS         CLASS
    2 MPP       TP    WAITING                             1,   2
    1 BMP       BMP   BMP       BMP255
      FPRGN     FP    NONE
      DBR1CT13  DBRC
VTAM ACB CLOSED 
LINE ACTIVE-IN -   1 ACTIV-OUT -   0
NODE ACTIVE-IN -   0 ACTIV-OUT -   0
LINK ACTIVE-IN -   0 ACTIV-OUT -   0
*89041/143420*

Explanation: The application has been terminated but the region remains active.

Entry ET: 
/DISPLAY PROG DDLTRN24
Response ET: 
PROGRAM   TRAN       TYPE
DDLTRN24   TXCDRN24   TP
*90340/143749*

Explanation: The program has not been stopped.

Entry ET: 
/DISPLAY TRANSACTION TXCDRN24
Response ET: 
  TRAN   CLS ENQCT   QCT   LCT  PLCT CP NP LP SEGSZ SEGNO PARLM RC
TXCDRN24   2     1     0 65535 65535  1  1  1     0     0     0  0
PSBNAME: DDLTRN24
STATUS: STOP
*90340/143802*

Explanation: The transaction has been stopped.

Example 5 for /STOP REGION command

Entry ET: 
/DISPLAY A
Response ET: 
REGID JOBNAME   TYPE  TRAN/STEP PROGRAM  STATUS           CLASS
    2 MPP       TP    WAITING                               1,   2
    1 BMP       BMP   BMP       BMP255
    3 FPU       FPU   IFP       DBP#FPU0
      DBR1CT13  DBRC 
VTAM ACB CLOSED
LINE ACTIVE-IN -   1 ACTIV-OUT -   0
NODE ACTIVE-IN -   0 ACTIV-OUT -   0
LINK ACTIVE-IN -   0 ACTIV-OUT -   0
*89041/144248*
Entry ET: 
/STOP REG 3 ABDUMP
Response ET: 
DFS058I STOP COMMAND IN PROGRESS

Explanation: A transaction code is not entered when terminating a Fast Path utility with a /STOP REGION ABDUMP command.

Example 6 for /STOP REGION command

Entry ET: 
/DISPLAY A
Response ET: 
REGID JOBNAME   TYPE  TRAN/STEP PROGRAM  STATUS            CLASS
    2 MPP       TP    TXCDRN24  DDLTRN24 WAIT-INPUT          1,   2
    1 BMP       BMP   BMP       BMP255
      FPRGN     FP    NONE
      DBR1CT13  DBRC
VTAM ACB CLOSED
LINE ACTIVE-IN -   1 ACTIV-OUT -   0
NODE ACTIVE-IN -   0 ACTIV-OUT -   0
LINE ACTIVE-IN -   0 ACTIV-OUT -   0
*89041/150141*

Explanation: Message processing program DDLTRN24 is waiting for an input message.

Entry ET: 
/STOP REGION 2 TRANSACTION TXCDRN24
Response ET: 
DFS058I STOP COMMAND IN PROGRESS
DFS0569I PSTOP OR STOP COMPLETE FOR REGION0002 TRAN TXCDRN24.

Explanation: A QC status code was returned to the WFI application program DDLTRN24.

Entry ET: 
/DISPLAY A
Response ET: 
REGID JOBNAME   TYPE  TRAN/STEP PROGRAM  STATUS         CLASS
    2 MPP       TP    WAITING                             1,   2
    1 BMP       BMP   BMP       BMP255
      FPRGN     FP    NONE
      DBR1CT13  DBRC
VTAM ACB CLOSED
LINE ACTIVE-IN -   1 ACTIV-OUT -   0
NODE ACTIVE-IN -   0 ACTIV-OUT -   0
LINK ACTIVE-In -   0 ACTIV-OUT -   0
*89041/150206*

Explanation: The WFI application has been terminated but the region is still active.

Entry ET: 
/DISPLAY TRANSACTION TXCDRN24
Response ET: 
  TRAN   CLS ENQCT   QCT   LCT  PLCT CP NP LP SEGSZ SEGNO PARLM RC
TXCDRN24   2     4     0 65535 65535  1  1  1     0     0     0  0
PSBNAME: DDLTRN24
*90340/150219*

Explanation: The transaction is not stopped.

Example 7 for /STOP REGION command

Entry ET: 
/DISPLAY A
Response ET: 
REGID JOBNAME   TYPE  TRAN/STEP PROGRAM  STATUS            CLASS
    2 MPP       TP    TXCDRN24  DDLTRN24 WAIT-INPUT          1,   2
    1 BMP       BMP   BMP       BMP255
      FPRGN     FP    NONE
      DBR1CT13  DBRC
VTAM ACB CLOSED
LINE ACTIVE-IN -   1 ACTIV-OUT -   0
NODE ACTIVE-IN -   0 ACTIV-OUT -   0
LINK ACTIVE-IN -   0 ACTIV-OUT -   0
*89041/150813*
Entry ET: 
/STOP REGION 2 TRANSACTION TRAN255
Response ET: 
DFS058I STOP COMMAND IN PROGRESS
DFS0558I TRAN TRAN255 NOT SCHEDULED

Explanation: TRAN255 is a valid transaction for the IMS system but it is not currently scheduled in region 2. If TRAN255 had not been a valid transaction for the IMS system, only message DFS230I (TRAN SPECIFIED WITH ABDUMP OR TRAN KEYWORD IS NOT VALID) would have been issued.

Example 8 for /STOP REGION command

Entry ET: 
 D A,L
Response ET: 
 JOBS     M/S    TS USERS    SYSAS    INITS   ACTIVE/MAX VTAM     OAS
 00001    00010    00001      00019    00020    00001/00020       00000
 LLA      LLA      LLA      NSW  S  VLF      VLF      VLF      NSW  S
 JES2     JES2     IEFPROC  NSW  S  RMF      RMF      IEFPROC  NSW  S
 IMSVTAM  IMSVTAM  IEFPROC  NSW  S  TSO      TSO      STEP1    NSW  S
 CQS      CQS      IEFPROC  NSW  S  IMSECTA9 IMSECTA9 IEFPROC  NSW  S
 DLIECTA9 DLIECTA9 DLISAS   NSW  S  DBRECTA9 DBRECTA9 DBRC     NSW  S
 MPP610C  MPP      MPP      NSW  J
 USRID01  OWT

Explanation: MPP610C is an IMS message processing region.

Entry ET: 
/STOP REGION JOBNAME MPP610C
Response ET: 
DFS058I STOP COMMAND IN PROGRESS
DFS552I MESSAGE REGION MPP610C  STOPPED ID=00001 TIME=1616  SYSX

SMF000I  MPP610C     MPP         DFSRRC00    0000
$HASP395 MPP610C  ENDED