Befehl /STOP REGION

Mit dem Befehl /STOP REGION können Sie IMS -Regionen und/oder Anwendungsprogramme stoppen. /STOP REGION wird auf dem alternativen XRF-System nicht gespiegelt. Sie müssen diesen Befehl auf dem alternativen System eingeben, wenn er das alternative System betreffen soll.

Unterabschnitte:

Umgebung

In der folgenden Tabelle werden die Umgebungen (DB/DC, DBCTL und DCCTL) aufgelistet, in denen Sie die Befehle und Schlüsselwörter verwenden können.

Tabelle 1. Gültige Umgebungen für den Befehl /STOP REGION und Schlüsselwörter
Befehl/Schlüsselwörter DB/DC DBCTL DCCTL
/STOP X X X
ABDUMP X X X
ABBRECHEN X X X
JOBNAME X X X
REGION X X X
TRANSACTION X   X

Syntax

Syntaxdiagramm lesenVisuelles Syntaxdiagramm überspringen/STOP/STOREGION Reg#reg#-reg#Reg#ABDUMPABDUMPTranNameABDUMPFORCETRANSACTIONTranNameCANCELJOBNAMEEin Jobname.JOBNAMEEin Jobname.ABDUMPTranNameTRANSACTIONTranNameCANCEL

Schlüsselwörter

Die folgenden Schlüsselwörter sind für den Befehl /STOP REGION gültig:

REGION Reg.-Nr.
Wird verwendet, um eine oder mehrere Nachrichtenverarbeitungsregionen nach Abschluss der Verarbeitung der aktuellen Transaktion zu beenden. Die Regions-ID ist reg#.

/STOP REGION reg# kann auch zum Beenden von Fast Path-Regionen verwendet werden. /STOP REGION reg# kann nicht zum Beenden von Stapelregionen verwendet werden.

Eine Fast Path-Dienstprogrammregion wird beim nächsten Systemprüfpunkt des Dienstprogramms beendet.

REGION reg#-reg#
Wird verwendet, um einen Bereich von Nachrichtenverarbeitungsregionen nach Abschluss der Verarbeitung der aktuellen Transaktion zu beenden.

REGION Reg.-Nr. ABDUMP Tranname
Verursacht eine abnormale Beendigung eines Anwendungsprogramms.

Die Regions-ID ist reg# und der Transaktionscode ist tranname.

Wenn die durch tranname angegebene Transaktion derzeit in REGION reg#ausgeführt wird, wird am Hauptterminal eine Fehlernachricht empfangen, die auf einen Abbruch des Anwendungsprogramms hinweist. Die Region bleibt aktiv, aber die Transaktion wird gestoppt. Der Befehl wird ignoriert, wenn die Transaktion derzeit nicht in der Region reg#geplant ist.

/STOP REGION reg# ABSpeicherauszugsnummer sollte nur für eine Region verwendet werden, die sich scheinbar in einer Schleife oder in einem Wartestatus befindet. Wenn dieser Befehl die in einer Region ausgeführte Anwendung nicht abnormal beendet, kann der Befehl /STOP REGION reg# CANCEL verwendet werden. Dies kann dazu führen, dass die Steuerregion mit der abnormalen Beendigung 113 beendet wird, wenn ein paralleles DL/I verwendet wird. Weitere Warnungen finden Sie unter /STOP REGION reg# CANCEL .

Wenn der Befehl /CHECKPOINT IMS nicht beendet werden kann, weil eine Nachrichtenverarbeitungsregion aktiv zu sein scheint, die Region jedoch nicht mehr im System aktiv ist (eine Bedingung, die allgemein als Phantomregion bezeichnet wird), kann die Situation mit dem Befehl /STOP REGION reg# ABDUMP korrigiert werden. In diesem Fall erkennt der Befehl /STOP REGION reg# ABDUMP , dass die Region nicht mehr aktiv ist, und bereinigt die internen IMS -Einträge für die nicht vorhandene Region, wodurch der Systemabschlusses normal fortgesetzt werden kann.

Wenn eine Nachrichtenverarbeitungsregion einen katastrophalen Fehler feststellt und abnormal beendet wird und ein /DISPLAY ACTIVE REGION anzeigt, dass die Region noch für IMSdefiniert ist, kann die Situation mit dem Befehl /STOP REGION reg# ABDUMP korrigiert werden. In diesem Fall stellt der Befehl /STOP REGION reg# ABDUMP fest, dass die Region nicht mehr aktiv ist, und bereinigt die internen IMS -Einträge für die nicht vorhandene Region.

Die Variable tranname ist für Batch-, IFP-oder Fast Path-Dienstprogrammregionen nicht gültig.

REGION Reg.-Nr. ABDUMP FORCE
Stoppt einen Bereich von Nachrichtenverarbeitungsregionen mit dem Status WAIT-INIT-INPROG oder TERM PENDING.

Die Regions-ID ist reg#. Dieses Schlüsselwort gilt nur für MPP-und JMP-Regionen.

REGION Reg.-Nr. TRANSAKTION Transaktionsname
Stoppt die Verarbeitung eines Nachrichtenverarbeitungsprogramms im WFI-Modus (WFI-Wait for Input) innerhalb der angegebenen Region.

Die Regions-ID ist reg# und der Transaktionscode ist tranname.

Wenn die mit tranname angegebene Transaktion in der Region reg#ausgeführt wird, wird die IMS -Nachricht DFS0569I am Hauptterminal empfangen, um anzuzeigen, dass ein QC-Statuscode (keine weiteren Nachrichten) an das Anwendungsprogramm (MPPs) zurückgegeben wurde. Die Region, die die Anwendung enthielt, ist noch aktiv und die Transaktion wird nicht gestoppt. Ein Stapelnachrichtenverarbeitungsprogramm im WFI-Modus muss mit dem Befehl /PSTOP gestoppt werden.

Ein BMP (Batch Message Processing Region), der für WFI-Transaktionen (WFI-Wait-for-Input) terminiert ist, gibt nur für, /PSTOP REGION-, /DBD-, /DBR-oder /STA -Befehle einen QC-Statuscode (keine weiteren Nachrichten) zurück.

REGION Reg.-Nr. STORNIEREN
wird verwendet, wenn die Region nicht mit einem /STOP REGION ABDUMP -Befehl gestoppt werden kann und ein /STOP REGION ABDUMP -Befehl vorangestellt werden muss.

Die Regions-ID ist reg#.

Die Verwendung des Befehls /STOP REGION CANCEL kann dazu führen, dass die IMS -Steuerregion mit dem Benutzerabbruch 113 beendet wird, wenn das parallele DL/I verwendet wird. Ein z/OS® -Befehl CANCEL wird zurückgewiesen.

REGIONSJOBNAME
Gibt die zu stoppenden Regionen anhand ihrer Jobnamen an Der Jobname muss 1 bis 8 alphanumerische Zeichen oder nationale Sonderzeichen ($, #, @) enthalten. Das erste Zeichen des Jobnamens muss entweder alphabetisch oder national sein.

Beispiele

Es folgen Beispiele für den Befehl /STOP REGION :

Beispiel 1 für den Befehl /STOP REGION

Eintrag ET:
/DISPLAY A
Antwort 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*

Erläuterung: Die nachrichtengesteuerte Fast Path-Region 3 enthält momentan keine zu verarbeitenden Nachrichten.

Eintrag ET:
/STOP REG 3
Antwort ET:
DFS058I STOP COMMAND IN PROGRESS
Eintrag ET:
/DISPLAY A
Antwort 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*

Erläuterung: Fast Path-Bereich 3 wurde gestoppt. Wenn Region 3 eine Nachricht verarbeitet hätte, hätte IMS die Region nach Abschluss der Transaktion beendet.

Beispiel 2 für den Befehl /STOP REGION

Eintrag ET:
/DISPLAY A
Antwort 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*
Eintrag ET:
/STOP REG 1
Antwort ET:
DFS058I STOP COMMAND IN PROGRESS
DFS0557I STOP REGION ID NOT VALID- REGION 0001 IS BMP.

Erläuterung: /STOP REGION (ohne Schlüsselwörter) ist für Stapelregionen nicht gültig.

Beispiel 3 für den Befehl /STOP REGION

Eintrag ET:
/DISPLAY A
Antwort 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*
Eintrag ET:
/STOP REG 3
Antwort ET:
DFS058I STOP COMMAND IN PROGRESS
Eintrag ET:
/DISPLAY A
Antwort 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*

Erläuterung: Fast Path-Dienstprogrammbereich 3 wurde gestoppt. Das Fast Path-Dienstprogramm DBF#FPU0 wurde beim nächsten Systemprüfpunkt beendet.

Beispiel 4 für den Befehl /STOP REGION

Eintrag ET:
/DISPLAY A
Antwort 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*

Erläuterung: Die Transaktion TXCDRN24 in Region 2 befindet sich in einer Schleife oder in einem Wartestatus.

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

Erläuterung: Das Anwendungsprogramm wurde mit einem U0474 -ABEND beendet. Dieser Abbruch gibt die Beendigung als Antwort auf eine Benutzeranfrage (/STOP REGION ABDUMP) an.

Eintrag ET:
/DISPLAY A
Antwort 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*

Erläuterung: Die Anwendung wurde beendet, aber die Region bleibt aktiv.

Eintrag ET:
/DISPLAY PROG DDLTRN24
Antwort ET:
PROGRAM   TRAN       TYPE
DDLTRN24   TXCDRN24   TP
*90340/143749*

Erläuterung: Das Programm wurde nicht gestoppt.

Eintrag ET:
/DISPLAY TRANSACTION TXCDRN24
Antwort 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*

Erläuterung: Die Transaktion wurde gestoppt.

Beispiel 5 für den Befehl /STOP REGION

Eintrag ET:
/DISPLAY A
Antwort 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*
Eintrag ET:
/STOP REG 3 ABDUMP
Antwort ET:
DFS058I STOP COMMAND IN PROGRESS

Erläuterung: Beim Beenden eines Fast Path-Dienstprogramms mit einem /STOP REGION ABDUMP -Befehl wird kein Transaktionscode eingegeben.

Beispiel 6 für den Befehl /STOP REGION

Eintrag ET:
/DISPLAY A
Antwort 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*

Erläuterung: Das Nachrichtenverarbeitungsprogramm DDLTRN24 wartet auf eine Eingabenachricht.

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

Erläuterung: Ein QC-Statuscode wurde an das WFI-Anwendungsprogramm DDLTRN24zurückgegeben.

Eintrag ET:
/DISPLAY A
Antwort 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*

Erläuterung: Die WFI-Anwendung wurde beendet, aber die Region ist noch aktiv.

Eintrag ET:
/DISPLAY TRANSACTION TXCDRN24
Antwort 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*

Erläuterung: Die Transaktion wurde nicht gestoppt.

Beispiel 7 für den Befehl /STOP REGION

Eintrag ET:
/DISPLAY A
Antwort 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*
Eintrag ET:
/STOP REGION 2 TRANSACTION TRAN255
Antwort ET:
DFS058I STOP COMMAND IN PROGRESS
DFS0558I TRAN TRAN255 NOT SCHEDULED

Erläuterung: TRAN255 ist eine gültige Transaktion für das IMS -System, aber sie ist momentan nicht in Region 2 geplant. Wenn TRAN255 keine gültige Transaktion für das IMS -System war, wird nur eine NachrichtDFS230I (TRAN SPECIFIED WITH ABDUMP OR TRAN KEYWORD IS NOT VALID)wäre ausgegeben worden.

Beispiel 8 für den Befehl /STOP REGION

Eintrag ET:
 D A,L
Antwort 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

Erläuterung: MPP610C ist ein IMS -Nachrichtenverarbeitungsbereich.

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

SMF000I  MPP610C     MPP         DFSRRC00    0000
$HASP395 MPP610C  ENDED