![[z/OS]](../images/ngzos.gif)
WSGrid-Jobschablone
Die WSGrid-Jobschablone ist eine Eingabe für das Dienstprogramm "WSGrid". Die Schablone enthält die Eigenschaften, die das Dienstprogramm "WSGrid" verwendet, um mit einem Stapeljob zu interagieren.
WSGrid-Jobschablone
//WSGRIDT JOB (),MSGCLASS=H
//RUN EXEC PGM=WSGRID
//*********************************************************************
//*
//* WSGrid-Jobschablone
//*
//* WSGrid ist ein Java-Dienstprogramm, das unter der Steuerung von JZOS
//* ausgeführt wird, um einen Stapeljob zuzustellen. Das Dienstprogramm übergibt den
//* Stapeljob, schreibt das Stapeljobprotokoll während der Ausführung des WCG-Jobs in den STDOUT-DD
//* und wird dann mit einem Rückkehrcode beendet, der den Rückkehrcode des Stapeljobs angibt.
//*
//* Rückkehrcodes
//* --------
//*
//* 0-3040 - Benutzerbereich
//*
//* Dies ist ein benutzerdefinierter Rückkehrcode, der von einem
//* abgeschlossenen WCG-Job zurückgegeben wird.
//*
//* 3041-4096 - System ausgeführt
//*
//* Dies sind Rückkehrcodes, die vom System vor dem Abschluss eines
//* WCG-Jobs definiert sind. Die folgenden Rückkehrcodes sind definiert:
//*
//* 4084 (-12) - WCG-Job wurde mit dem Status "Erneuter Start möglich" beendet
//* 4080 (-16) - Schwerwiegender Systemfehler
//*
//*********************************************************************
//*
//* Erforderliche Einstellungen:
//*
//* 1) Das Symbol WGCNTL muss auf eine Datei mit qualifiziertem
//* Pfad gesetzt werden, die die WSGRID-Steuerungseigenschaften´
//* enthält. Weitere Informationen finden Sie im Kommentarblock
//* in der Nähe des WGCNTL-DD.
//*
//* 2) Das Symbol WGSUB muss auf eine Datei mit qualifiziertem Pfad
//* gesetzt werden, die eine WCG-xJCL-Jobdefinition enthält.
//*
//* 3) Die Umgebungsvariable WAS_HOME muss auf den Namen des
//* WAS-Ausgangsverzeichnisses gesetzt werden. Sie finden diese
//* Variable unter dem STDENV-DD.
//*
//* Optionale Einstellungen.
//*
//* 1) Das Symbol WGSUBS wird auf die Datei mit qualifiziertem Pfad gesetzt,
//* die die WCG-Jobsubstitutionseigenschaften enthält.
//*
//* 2) Das Symbol WGRSTRT wird auf die Datei mit qualifiziertem Pfad
//* gesetzt, die für die Ausgabe/Eingabe der Neustartverarbeitung
// verwendet wird. Weitere Informationen finden Sie im Kommentarblock
//* in der Nähe des WGRSTRT-DD.
//*
//*********************************************************************
// SET WGCNTL=<Dateiname mit qualifiziertem Pfad>
// SET WGJOB=<Dateiname mit qualifiziertem Pfad>
//*SET WGSUBS=<Dateiname mit qualifiziertem Pfad>
//*SET WGRSTRT=<Dateiname mit qualifiziertem Pfad>
//*********************************************************************
//*
//* WSGrid-Steuerungseigenschaften - erforderlicher DD
//*
//* queue-manager-name=<Name des MQ-Warteschlangenmanagers>
//* scheduler-input-queue=<während der Konfiguration definierte MQ-Eingabewarteschlange>
//* scheduler-output-queue=<während der Konfiguration definierte MQ-Ausgabewarteschlange>
//* timeout=<Zeit in Millisekunden, die WSGRID auf die nächste Ausgabenachricht vom Job-Scheduler wartet>
//* debug=<true|false>
//*
//*********************************************************************
//WGCNTL DD PATH='&WGCNTL.'
//*
//*********************************************************************
//*
//* WSGrid-Jobdefinition - erforderlicher DD
//*
//* Datei muss eine gültige WCG-JCL-Jobdefinition enthalten.
//*
//*********************************************************************
//WGJOB DD PATH='&WGJOB.'
//*
//*********************************************************************
//*
//* WSGrid-Jobsubstitutionen - optionaler DD
//*
//* Werte müssen im folgenden Format angegeben werden:
//*
//* substitution-prop.<Eigenschaftsname>=<Eigenschaftswert>
//*
//*********************************************************************
//*WGSUBS DD PATH='&WGSUBS.'
//*
//*********************************************************************
//*
//* WSGrid-Neustarttoken - optionaler DD
//*
//* Anmerkung: Das Neustarttoken wird nur geschrieben, wenn dieser
//* Jobabschnitt mit RC=4084 (-12) abgeschlossen wird.
//*
//* Der WGRSTRT-DD hat Vorrang vor dem WGJOB-DD. Wenn dieser Job
//* mit einer nicht leeren Neustartdatei neu gestartet wird,
//* wird der mit dem Token angegebene WCG-Job neu gestartet.
//* Es wird keine neue Jobinstanz erstellt, die auf der Jobdefinition
//* in WGJOB basiert.
//*
//* restart-job=<Job-ID des neu zu startenden Jobs. Nur für den Neustart eines Jobs angeben.>
//*********************************************************************
//*WGRSTRT DD PATH='&WGRSTRT.'
//* PATHOPTS=(ORDWR,OCREAT),
//* PATHMODE=(SIRUSR,SIWUSR)
//*
//*********************************************************************
Beispiel-JCL für Übergabe eines neuen Jobs
Verwenden Sie das folgende Beispiel, wenn Sie einen Job mit dem Dienstprogramm "WSGrid" übergeben.
//WSGRIDCI JOB 1,'HUTCH',MSGCLASS=O
//SUBMIT EXEC PGM=WSGRID,REGION=0M
//STEPLIB DD DSN=B7CELL.WSGRID.LOAD,DISP=SHR
// DD DISP=SHR,DSN=SYS1.MQM.SCSQLOAD
// DD DISP=SHR,DSN=SYS1.MQM.SCSQAUTH
//*****************************************************
//SYSPRINT DD SYSOUT=*
//*****************************************************
//WGCNTL DD *
queue-manager-name=MQW1
scheduler-input-queue=WASIQCG
scheduler-output-queue=WASOQCG
timeout=5000
submit-timeout=30000
//WGJOB DD PATH='/u/hutch/cg/jcl/SimpleCIxJCL_Ebc.xml'
//WGSUBS DD *
substitution-prop.calctime=5
//*
Beispiel-JCL für den Neustart eines Jobs
Verwenden Sie das folgende Beispiel, wenn Sie einen Job mit dem Dienstprogramm "WSGrid" neu starten möchten.
//B7WSRST4 JOB 1,'Restart IVT',MSGCLASS=O,NOTIFY=?
//SUBMIT EXEC PGM=WSGRID,REGION=0M
//STEPLIB DD DSN=B7CELL.WSGRID.LOAD,DISP=SHR
// DD DISP=SHR,DSN=SYS1.MQM.SCSQLOAD
// DD DISP=SHR,DSN=SYS1.MQM.SCSQAUTH
//SYSPRINT DD SYSOUT=*
//WGCNTL DD *
queue-manager-name=MQW1
scheduler-input-queue=WASIQ
scheduler-output-queue=WASOQ
timeout=5000
restart-job=XDCGIVTtxt-Long:00004
//WGJOB DD PATH='/u/hutch/cg/jcl/EBCxJCL-XDCGIVT-Text_Long.xml'