Katalogisierte z/OS-JCL-Prozeduren
Der Server mit WebSphere Application Server for z/OS verwendet die katalogisierten JCL-Prozeduren für eigenständige Anwendungsserver und Network-Deployment-Zellen. In diesem Artikel werden die empfohlenen Namenskonventionen und das Zuordnen von Benutzer-IDs zu Addressräumen von WebSphere Application Server for z/OS beschrieben.
Jeder Server mit WebSphere Application Server for z/OS verwendet eine katalogisierte JCL-Prozedur. Diese Prozeduren sind ziemlich ähnlich und bestehen aus einer katalogisierten Hauptprozedur und einem INCLUDE-Member, das DD-Anweisungen enthält. Nachfolgend sind Beispiele für katalogisierte Prozedurenbibliothekmember für einen Controller aufgeführt, wie sie vom Profile Management Tool oder vom Befehl zpmt generiert werden:
//BBO8ACR PROC ENV=,PARMS=' ',REC=N,AMODE=00
// SET ROOT='/wasv9config/bbobase/bbonode'
// SET FOUT='properties/service/logs/applyPTF.out'
// SET WSDIR='AppServer'
//*************************************************************
//* Test that OMVS can successfully launch a shell and return *
//*************************************************************
//TOMVS EXEC PGM=BPXBATCH,REGION=0M,
// PARM='SH exit 13'
//SYSOUT DD PATH='&ROOT./&ENV..HOME/&FOUT.',
// PATHOPTS=(OWRONLY,OCREAT,OAPPEND),PATHMODE=(SIRWXU,SIRWXG)
//SYSPRINT DD PATH='&ROOT./&ENV..HOME/&FOUT.',
// PATHOPTS=(OWRONLY,OCREAT,OAPPEND),PATHMODE=(SIRWXU,SIRWXG)
//*********************************************************
//* If the shell RC code is as expected (13) - proceed *
//*********************************************************
//IFTST IF (RC = 13) THEN
//*********************************************************
//* Start the Multi-Product PTF Post-Installer *
//*********************************************************
//APPLY EXEC PGM=BPXBATCH,REGION=0M,
// PARM='SH &ROOT./&ENV..HOME/bin/applyPTF.sh inline'
//SYSOUT DD PATH='&ROOT./&ENV..HOME/&FOUT.',
// PATHOPTS=(OWRONLY,OCREAT,OAPPEND),PATHMODE=(SIRWXU,SIRWXG)
//SYSPRINT DD PATH='&ROOT./&ENV..HOME/&FOUT.',
// PATHOPTS=(OWRONLY,OCREAT,OAPPEND),PATHMODE=(SIRWXU,SIRWXG)
// IF (APPLY.RC <= 4) THEN
//*********************************************************
//* If the RC from the Post-Installer is LE 4 then start *
//* the WebSphere Application Server *
//*********************************************************
//STEP1 EXEC PGM=BPXBATA2,REGION=0M,TIME=MAXIMUM,MEMLIMIT=NOLIMIT,
// PARM='PGM &ROOT./&WSDIR./lib/s390-common/bbooctlm &AMODE. &PARMS. //REC=&REC' STDENV DD PATH='&ROOT/&ENV/was.env'
//*
//* Output DDs
//*
//CEEDUMP DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE
//SYSOUT DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE
//SYSPRINT DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE
//DEFALTDD DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE
//HRDCPYDD DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE
// ENDIF //IFTSTEND ENDIF
Prozedurenbibliothekmember
BBO8ASR://BBO8ASR PROC ENV=,AMODE=00
// SET ROOT='/wasv9config/bbobase/bbonode'
// SET WSDIR='AppServer'
//STEP1 EXEC PGM=BPXBATSL,REGION=0M,TIME=NOLIMIT,MEMLIMIT=NOLIMIT,
// PARM='PGM &ROOT./&WSDIR./lib/s390-common/bboosrmr &AMODE.' //STDENV DD PATH='&ROOT/&ENV/was.env'
//*
//* Output DDs
//*
//CEEDUMP DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE
//SYSOUT DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE
//SYSPRINT DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE
//DEFALTDD DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE
//HRDCPYDD DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE
Die Anweisung STDENV DD verweist auf die Datei was.env (Startparameter) für den Server. Der Pfad zu dieser Datei besteht aus dem Verzeichnisnamen des Konfigurations-HFS (fest codiert mit der ROOT-JCL-Variablen) und der symbolischen Verbindung für diesen speziellen Server, die beim Start mit dem Parameter ENV= angegeben wird.
Die katalogisierte Controller-Prozedur umfasst einige zusätzliche Anweisungen vor der Anweisung EXEC, mit der BPXBATA2 aufgerufen wird. Mit diesen Anweisungen wird der Post-Installer (Programm, das nach Installationsabschluss ausgeführt wird,) aufgerufen, das den erforderlichen Wartungsstand für das Konfigurations-HFS und seine Ausgangsverzeichnisse anwendet, wenn das Produkt-HFS und die Lademodule gewartet werden.
In den folgenden Abschnitten werden die katalogisierten Prozeduren, die für jede Konfiguration erforderlich sind, beschrieben, eine empfohlene Namenskonvention wird gegeben und es wird erläutert, wie die SAF-Benutzer-ID für jeden Server bestimmt wird.
Katalogisierte Prozeduren für eigenständige Anwendungsserver
Sie können dieselben katalogisierten Prozeduren für unterschiedliche eigenständige Server verwenden, WENN Konfigurations-HFS und Produktcodestufe (einschließlich STEPLIB) bei beiden Servern übereinstimmen.
Katalogisierte Prozeduren für Network-Deployment-Zellen
Eine Network-Deployment-Zelle verwendet die folgenden katalogisierten Prozeduren:
Die katalogisierte Prozedur für Servants des Anwendungsservers ist die einzige Prozedur, die wahrscheinlich geändert werden muss, um Bibliotheken (CICS, DB2, usw.) in die STEPLIB-Verkettung aufzunehmen.
Sie können dieselben katalogisierten Prozeduren für mehrere Knoten in einer Network-Deployment-Zelle verwenden, wenn das Konfigurations-HFS bei allen Servern identisch ist.
Empfohlene Namenskonvention für katalogisierte Prozeduren
Verwenden Sie für die katalogisierten Prozeduren in WebSphere Application Server for z/OS eine einheitliche Namenskonvention. Der Prozedurname sollte die Version von WebSphere Application Server for z/OS und das Konfigurations-HFS anzeigen.
Prozedur | Empfohlener Name |
---|---|
Deployment-Manager-Controller | cc8DCR |
Deployment-Manager-Servant | cc8DSR |
Location-Service-Daemon-Controller | cc8DMN |
Anwendungsserver-Controller | cc8ACR |
Anwendungsserver-Servant | cc8ASR |
Zusatzregion | cc8AAR |
Benutzer-IDs den Adressräumen in WebSphere Application Server for z/OS zuordnen
Falls Sie z/OS Security Server (RACF) als SAF-kompatibles Sicherheitssystem in z/OS verwenden, werden STARTED-Klassenprofile verwendet, um die Benutzer-IDs der gestarteten Task den einzelnen Servern mit WebSphere Application Server for z/OS zuzuordnen. Diese STARTED-Profile werden von den Stapeljobs konfiguriert, die vom Profile Management Tool oder vom Befehl zpmt erstellt werden. Aktualisieren Sie diese STARTED-Profile gegebenenfalls, damit die von Ihnen erstellten Server den geeigneten Benutzer-IDs zugeordnet werden.
Controller (Deployment Manager, Location Service Daemon, Node Agent oder Anwendungsserver-Controller) werden mit dem Konsolbefehl START gestartet, den Sie entweder über MVS-Konsole oder intern ausführen. Für diese Server hat der geprüfte STARTED-Profilname das Format Prozedurname.Jobname.
Servant-Bereiche (Anwendungsserver-Servants und Adjunct-Prozesse) werden mithilfe von Workload Manager (WLM) gestartet. Für diese Server hat der geprüfte STARTED-Profilname das Format Jobname.Jobname.
Falls Sie ein anderes mit SAF kompatibles Sicherheitssystem verwenden, wenden Sie sich an den Hersteller des Sicherheitsservers, um Informationen zur Konfiguration von WebSphere Application Server for z/OS zu erhalten.