Bedienerbefehle
Dieser Anhang enthält eine Zusammenfassung der Informationen zu Bedienerbefehlen (oder Konsolbefehlen) in Rational Developer for System z Hostkonfiguration (IBM Form SC12-4062). Weitere Einzelheiten entnehmen Sie dieser Veröffentlichung.
Modify (F)
Mithilfe des Befehls MODIFY können Sie die Merkmale einer aktiven Task dynamisch abfragen und ändern. Die abgekürzte Version des Befehls ist der Buchstabe F.
JES Job Monitor
Abbildung 8. Bedienerbefehl 'MODIFY JMON'
- Prozedurname
- Der Name des Members in einer Prozedurenbibliothek, mit dem der Server gestartet wird. Der während der Hostkonfiguration verwendete Standardname ist JMON.
- -TV
- Aktivieren des ausführlichen Modus (Trace-Modus). Der Trace bringt Leistungseinbußen mit sich und sollte nur auf Anweisung des IBM Support Center durchgeführt werden. Die Nachricht "Job Monitor TRACE_LEVEL_VERBOSE" wird an die DD "SYSOUT" und mit der Nachrichten-ID BPXM023I an die Konsole geschrieben.
- -TN
- Inaktivieren des ausführlichen Modus (Trace-Modus). Die Nachricht "Job Monitor TRACE_LEVEL_NONE" wird an die DD "SYSOUT" und mit der Nachrichten-ID BPXM023I an die Konsole geschrieben.
- STORAGE
- Schreiben eines Speicherbelegungsberichts an die DD "SYSOUT". Die Nachricht "Job Monitor storage information written to SYSOUT" wird mit der Nachrichten-ID BPXM023I an die Konsole geschrieben. Der Speicherbelegungsbericht zeigt verschiedene speicherbezogene Felder mit Größenangaben in Byte, Kilobyte und Megabyte an.
>>>STORAGE TRACE (console request)<<< LDAREGRQ 00000000000 00000000K 00000M requested region size below 16M line LDASIZA 00006266880 00006120K 00005M maximum region size LDALIMIT 00006266880 00006120K 00005M limit LDAVVRG 00006266880 00006120K 00005M getmain limit LDALOAL 00000061440 00000060K 00000M in use LDAHIAL 00000266240 00000260K 00000M LSQA/SWA/private subpools _GAP 00000000000 00000000K 00000M gaps in allocation _AVAIL 00005939200 00005800K 00005M available (including gaps) _MAX 00006000640 00005860K 00005M current limit above 16M line LDAESIZA 01905262592 01860608K 01817M maximum region size LDAELIM 01905262592 01860608K 01817M limit LDAEVVRG 01905262592 01860608K 01817M getmain limit LDAELOAL 00000937984 00000916K 00000M in use LDAEHIAL 00012754944 00012456K 00012M ELSQA/ESWA/private subpools _EGAP 00000000000 00000000K 00000M gaps in allocation _EAVAIL 01891569664 01847236K 01803M available (including gaps) _EMAX 01892507648 01848152K 01804M current limit
RSE-Dämon
Abbildung 9. Bedienerbefehl 'MODIFY RSED'
- Prozedurname
- Der Name des Members in einer Prozedurenbibliothek, mit dem der Server gestartet wird. Der während der Hostkonfiguration verwendete Standardname ist RSED.
- DISPLAY CLIENT [{,LOGON | ,ID | ,USER}]
- Anzeigen der aktiven Clients in einer einzelnen BPXM023I-Nachricht. Das Ergebnislayout hängt von der verwendeten Befehlsoption ab. Sie können die Sortierreihenfolge mit den optionalen Befehlsargumenten ändern.
- Keine Befehlsoption: Clients werden vom Thread-Pool-Prozess gruppiert, der diese bereitstellt.
ProcessId(<Prozess-ID>) ASId(<AS-ID>) JobName(<Jobname>) Clients(<lokal>/<Gesamt>) Order(<Startreihenfolge>)k <Client-ID><Benutzer-ID><verbunden seit> - LOGON-Befehlsoption: Clients werden nach dem Anmeldezeitpunkt sortiert.
LOGON TIME------------------ ID----- USERID-- <verbunden seit> <Client-ID> <Benutzer-ID> - ID-Befehlsoption: Clients werden nach der Client-ID sortiert.
ID----- USERID-- LOGON TIME------------------ <Client-ID> <Benutzer-ID> <verbunden seit> - USER-Befehlsoption: Clients werden nach der Benutzer-ID sortiert.
USERID-- ID----- LOGON TIME------------------ <Benutzer-ID> <Client-ID> <verbunden seit>
- Keine Befehlsoption: Clients werden vom Thread-Pool-Prozess gruppiert, der diese bereitstellt.
- DISPLAY PROCESS[{,CLEANUP | ,CPU [,PID=pid] | ,DETAIL}]
- Zeigt die RSE-Thread-Pool-Prozesse in einer oder mehreren BPXM023I-Nachrichten an. Für den Lastausgleich der verbundenen Benutzer kann es mehrere aktive Prozesse geben.
ProcessId(<Prozess-ID>) Memory Usage(<Belegung des Java-Heapspeichers>%) Clients(<Anzahl der Clients>) Order(<Startreihenfolge>) <Fehlerstatus>Anmerkung:- <Prozess-ID> kann in prozessspezifischen z/OS UNIX-Bedienerbefehlen verwendet werden.
- Jeder Prozess hat seinen eigenen Java-Heap-Speicher, dessen Größe in rsed.envvars festgelegt werden kann. Beachten Sie, dass die berichtete Java-Heapspeicherbelegung die von Developer for System z freigegebene, jedoch noch nicht durch den Garbage-Collection-Prozess von Java freigegebene Belegung einschließt.
- <Startreihenfolge> ist eine fortlaufende Zahl, die die Reihenfolge angibt, in der die Thread-Pools gestartet wurden. Die Zahl entspricht der Zahl im Dateinamen der Dateien stderr.*.log und stdout.*.log.
In normalen Situationen ist <Fehlerstatus> leer. In Tabelle 6 sind die möglichen, nicht leeren Werte für <Fehlerstatus> dokumentiert.Tabelle 6. Fehlerstatus des Thread-Pools Status Beschreibung *severe error* Der Thread-Pool-Prozess hat einen nicht behebbaren Fehler festgestellt und die Operationen angehalten. In den anderen Statusfeldern werden die letzten bekannten Werte angezeigt. Verwenden Sie die Option CLEANUP des Änderungsbefehls DISPLAY PROCESS, um diesen Eintrag aus der Tabelle zu entfernen. *killed process* Der Thread-Pool-Prozess wurde durch Java, z/OS UNIX oder einen Bedienerbefehl abgebrochen. In den anderen Statusfeldern werden die letzten bekannten Werte angezeigt. Verwenden Sie die Option CLEANUP des Änderungsbefehls DISPLAY PROCESS, um diesen Eintrag aus der Tabelle zu entfernen. *timeout* Der Thread-Pool-Prozess hat dem RSE-Dämon während einer Clientverbindungsanforderung nicht zeitnah geantwortet. In den anderen Statusfeldern werden die aktuellen Werte angezeigt. Der Thread-Pool wird in zukünftigen Clientverbindungsanforderungen ausgeschlossen. Der Status *timeout* wird zurückgesetzt, wenn sich ein Client abmeldet, der von diesem Thread-Pool bereitgestellt wurde. Es werden weitere Informationen bereitgestellt, wenn die Option "DETAIL" des Änderungsbefehls DISPLAY PROCESS verwendet wird:
ProcessId(33555087) ASId(002E) JobName(RSED8) Order(1) PROCESS LIMITS: CURRENT HIGHWATER LIMIT JAVA HEAP USAGE(%) 10 56 100 CLIENTS 0 25 60 MAXFILEPROC 83 103 64000 MAXPROCUSER 97 99 200 MAXTHREADS 9 14 1500 MAXTHREADTASKS 9 14 1500Das Feld 'ASId' ist die Adressraum-ID in Hexadezimalschreibweise. Die Tabelle zum Verarbeitungslimit zeigt die aktuelle Ressourcennutzung, die obere Grenze für die Ressourcennutzung und die Ressourcengrenze an. Beachten Sie, dass die definierte Grenze aufgrund von anderen Begrenzungsfaktoren möglicherweise nie erreicht wird.
Die CPU-Option des Änderungsbefehls DISPLAY PROCESS zeigt die kumulierte CPU-Auslastung (in Millisekunden) der einzelnen Threads in einem Thread-Pool an. Für jeden Thread-Pool gibt es eine BPXM023I-Nachricht. Standardmäßig geben alle Thread-Pools die CPU-Belegung an; Sie können den Bereich jedoch auf einen einzelnen Thread-Pools beschränken, indem Sie im Bedienerbefehl PID=pid angeben, wobei pid die Prozess-ID des Ziel-Thread-Pools ist.ProcessId(421 ) ASId(007D) JobName(RSED8) Order(1) USERID THREAD-ID TCB@ ACC_TIME TAG STCRSE 0EDE540000000000 005E6B60 822 1/ThreadPoolProcess STCRSE 0EDE870000000001 005E69C8 001 STCRSE 0EDE980000000002 005E6518 1814 STCRSE 0EDEBA0000000003 005E66B0 2305 STCRSE 0EDECB0000000004 005E62F8 001 STCRSE 0EDEDC0000000005 005E60D8 001 STCRSE 0EDF860000000006 005C2BF8 628 6/ThreadPoolMonitor$Memory UsageMonitor STCRSE 0EDF970000000007 005C2D90 003 7/ThreadPoolMonitor STCRSE 0EDFDB0000000008 005C29D8 001 STCRSE 0EE22E000000000E 005C1BE0 070 IBMUSER 0EE0EB0000000011 005C22B8 276 20/ServerReceiver IBMUSER 0EE2500000000012 005C19C0 137 16/ServerUpdateHandler IBMUSER 0EE2610000000013 005C17A0 509 15/ServerCommandHandler IBMUSER 0EE1840000000014 005C1E00 065 21/ZosSystemMiner STCRSE 0EE1510000000016 005C2098 078 STCRSE 0EE1950000000017 005C1580 001 IBMUSER 0EE23F0000000018 005C1360 021 26/UniversalFileSystemMine r IBMUSER 0EE2A5000000001C 005C0CF0 003 27/EnvironmentMiner IBMUSER 0EE283000000001D 005C1140 002 31/CommandMiner IBMUSER 0EE272000000001E 005C0E88 081 32/MVSFileSystemMiner IBMUSER 0EE294000000001F 005C0AD0 002 33/MVSByteStreamHandler$Op enCloseThread STCRSE 0EE2E90000000023 005C0470 001 IBMUSER 0EE2C70000000024 005C08B0 050 38/JESMiner IBMUSER 0EE2B60000000026 005C0690 004 40/FAMiner IBMUSER 0EE30B0000000027 005C0250 002 41/LuceneMiner IBMUSER 0EE31C0000000028 005C0030 002 42/CDTParserMiner IBMUSER 0EE32D0000000029 005BDE00 002 43/MVSLuceneMiner IBMUSER 0EE33E000000002A 005BDBE0 002 44/CDTMVSParserMinerWenn die Ausgabegröße die maximale Anzahl der Zeilen für eine Konsolennachricht überschreitet, wird die Ausgabe in mehrere BPXM023I-Nachrichten aufgeteilt. Diese zusätzlichen Nachrichten haben denselben Header wie die erste Nachricht, jedoch ist der ersten Zeile das Schlüsselwort CONTINUATION hinzugefügt.ProcessId(421 ) ASId(007D) JobName(RSED8) Order(1) CONTINUATION USERID THREAD-ID TCB@ ACC_TIME TAG - CANCEL ID=Client-ID
- Abbrechen der Clientverbindung auf der Basis der Client-ID, die im Modifizierungsbefehl DISPLAY CLIENT angegeben ist
- CANCEL USER=Benutzer-ID
- Abbrechen der Clientverbindung auf der Basis der Benutzer-ID des Clients, die im Modifizierungsbefehl DISPLAY CLIENT angegeben ist
- RSECOMMLOG {ON | OFF | I | W | E | 2 | 1 | 0}
- Steuert die Tracedetailstufe für den RSE-Server (rsecomm.log) und die MVS-Dateiservices (lock.log und ffs*.log). Die Standardeinstellung wird beim Start in rsecomm.properties definiert. Drei Detaillierungsgrade sind verfügbar:
E oder 0 oder OFF Nur Fehlernachrichten W oder 1 Fehlernachrichten und Warnungen. Dies ist die Standardeinstellung in rsecomm.properties. I oder 2 oder ON Fehlernachrichten, Warnungen und Informationsnachrichten Ein detaillierter Trace bringt Leistungseinbußen mit sich und sollte nur auf Anweisung des IBM Support Center durchgeführt werden.
- RSEDAEMONLOG {ON | OFF | I | E | 2 | 0}
- Steuert die Tracedetailstufe für den RSE-Dämon (rsedaemon.log).
Die Standardeinstellung wird beim Start in rsecomm.properties definiert.
Zwei Detaillierungsgrade sind verfügbar:
E oder 0 oder OFF Nur Fehlernachrichten I oder 2 oder ON Fehlernachrichten, Warnungen und Informationsnachrichten Ein detaillierter Trace bringt Leistungseinbußen mit sich und sollte nur auf Anweisung des IBM Support Center durchgeführt werden.
- RSESERVERLOG {ON | OFF | I | E | 2 | 0}
- Steuert die Tracedetailstufe für die RSE-Thread-Pools (rseserver.log).
Die Standardeinstellung wird beim Start in rsecomm.properties definiert.
Zwei Detaillierungsgrade sind verfügbar:
E oder 0 oder OFF Nur Fehlernachrichten I oder 2 oder ON Fehlernachrichten, Warnungen und Informationsnachrichten Ein detaillierter Trace bringt Leistungseinbußen mit sich und sollte nur auf Anweisung des IBM Support Center durchgeführt werden.
- RSESTANDARDLOG {ON |, OFF}
- Inaktiviert (OFF) oder aktiviert (ON) die Aktualisierung der Protokolldateien mit den Datenströmen 'stdout' und 'stderr' der Thread-Pools (stdout.*.log und stderr.*.log).
Die Standardeinstellung wird beim Start durch die Anweisung enable.standard.log in rsed.envvars definiert.
Ein detaillierter Trace bringt Leistungseinbußen mit sich und sollte nur auf Anweisung des IBM Support Center durchgeführt werden.
- IVP DAEMON,userid
- Meldet die Benutzer-ID userid beim RSE-Dämon an, um einen Verbindungstest durchzuführen. Die Ergebnisse werden mit mindestens einer FEK900I-Konsolennachricht angezeigt.
Der Rückkehrcode wird mit Konsolennachricht FEK901I angezeigt.
+FEK900I DAEMON IVP: SSL is disabled +FEK900I DAEMON IVP: connected +FEK900I DAEMON IVP: 1977 +FEK900I DAEMON IVP: 6902918 +FEK900I DAEMON IVP: Success +FEK901I DAEMON IVP Exit code = 0Anmerkung:- Diese Funktion mit dem Installationsprüfprogramm (Installation Verification Program, IVP) fekfivpd vergleichbar.
- Der RSE-Dämon generiert ein PassTicket, das als Kennwort für IVP verwendet wird, deshalb fordert WTOR (Write To Operator with Reply) kein Kennwort an.
- IVP ISPF,userid
- Rufen Sie den Client-Gateway der Interactive System Productivity Facility (ISPF) mit der Benutzer-ID userid auf.
Die Ergebnisse werden mit mindestens einer FEK900I-Konsolennachricht angezeigt. Der Rückkehrcode wird mit Konsolennachricht FEK901I angezeigt.
+FEK900I ISPF IVP: executed on CDFMVS08 -- Tue Sep 13 22:29:28 EDT 2011 +FEK900I ISPF IVP: executed by uid=1(IBMUSER) gid=0(SYS1) +FEK900I ISPF IVP: using /etc/rdz/rsed.envvars +FEK900I ISPF IVP: current address space size limit is 2147483647 (2048.0 MB) +FEK900I ISPF IVP: maximum address space size limit is 2147483647 (2048.0 MB) +FEK900I ISPF IVP: ----------------------------------------------------- -------- +FEK900I ISPF IVP: /etc/rdz/ISPF.conf content: +FEK900I ISPF IVP: ----------------------------------------------------- -------- +FEK900I ISPF IVP: ispllib=ISP.SISPLOAD +FEK900I ISPF IVP: ispmlib=ISP.SISPMENU +FEK900I ISPF IVP: isptlib=ISP.SISPTENU +FEK900I ISPF IVP: ispplib=ISP.SISPPENU +FEK900I ISPF IVP: ispslib=ISP.SISPSLIB +FEK900I ISPF IVP: sysproc=ISP.SISPCLIB,FEK.SFEKPROC +FEK900I ISPF IVP: ----------------------------------------------------- -------- +FEK900I ISPF IVP: Host install verification for RSE +FEK900I ISPF IVP: Review IVP log messages from HOST below : +FEK900I ISPF IVP: ----------------------------------------------------- -------- +FEK900I ISPF IVP: Service level 22Feb2011 +FEK900I ISPF IVP: RSE connection and base TSO/ISPF session initializati on check only +FEK900I ISPF IVP: *** CHECK : ENVIRONMENT VARIABLES - key variables displayed below : +FEK900I ISPF IVP: Server PATH = .:/usr/lpp/java/J5.0/bin:/usr/l pp/rdz/bin:/usr/lpp/ispf/bin:/bin:/usr/sbin +FEK900I ISPF IVP: STEPLIB = NONE +FEK900I ISPF IVP: Temporary directory = /tmp +FEK900I ISPF IVP: _CMDSERV_BASE_HOME = /usr/lpp/ispf +FEK900I ISPF IVP: _CMDSERV_CONF_HOME = /etc/rdz +FEK900I ISPF IVP: _CMDSERV_WORK_HOME = /var/rdz +FEK900I ISPF IVP: ----------------------------------------------------- -------- +FEK900I ISPF IVP: *** CHECK : USS MODULES +FEK900I ISPF IVP: Checking ISPF Directory : /usr/lpp/ispf +FEK900I ISPF IVP: Checking modules in /usr/lpp/ispf/bin directory +FEK900I ISPF IVP: Checking for ISPF configuration file ISPF.conf +FEK900I ISPF IVP: RC=0 +FEK900I ISPF IVP: MSG: SUCCESSFUL +FEK900I ISPF IVP: ----------------------------------------------------- -------- +FEK900I ISPF IVP: *** CHECK : TSO/ISPF INITIALIZATION +FEK900I ISPF IVP: ( TSO/ISPF session will be initialized ) +FEK900I ISPF IVP: RC=0 +FEK900I ISPF IVP: MSG: SUCCESSFUL +FEK900I ISPF IVP: ----------------------------------------------------- -------- +FEK900I ISPF IVP: *** CHECK: Shutting down TSO/ISPF IVP session +FEK900I ISPF IVP: RC=0 +FEK900I ISPF IVP: MSG: SUCCESSFUL +FEK900I ISPF IVP: ----------------------------------------------------- -------- +FEK900I ISPF IVP: Host installation verification completed successfully +FEK900I ISPF IVP: ----------------------------------------------------- -------- +FEK901I ISPF IVP Exit code = 0Anmerkung:- Diese Funktion mit dem Installationsprüfprogramm (Installation Verification Program, IVP) fekfivpi vergleichbar.
- Der RSE-Dämon generiert ein PassTicket, das als Kennwort für IVP verwendet wird, deshalb fordert WTOR (Write To Operator with Reply) kein Kennwort an.
- IVP PASSTICKET,userid
- Testet die Wiederverwendbarkeit eines PassTickets, das für die Benutzer-ID Benutzer-ID erstellt wurde.
Die Ergebnisse werden mit mindestens einer FEK900I-Konsolennachricht angezeigt. Der Rückkehrcode wird mit Konsolennachricht FEK901I angezeigt.
+FEK900I PASSTICKET IVP: the default applid=FEKAPPL +FEK900I PASSTICKET IVP: Success, PassTicket IVP finished normally +FEK901I PASSTICKET IVP Exit code = 0Anmerkung:- Bei der Verwendung von RACF als Sicherheitsprodukt muss sich für wiederverwendbare PassTickets das Schlüsselwort “NO REPLAY PROTECTION” in den Sicherheitsdefinitionen befinden.
- Für diesen Test gibt es kein funktional entsprechendes IVP (Installation Verification Program, Installationsprüfprogramm). Durch den Start des RSE-Dämons mit dem Argument IVP=IVP wird ein PassTicket-IVP aufgerufen, der die PassTicket-Generation, jedoch nicht die PassTicket-Wiederverwendbarkeit prüft.
- Der RSE-Dämon generiert ein PassTicket, das als Kennwort für IVP verwendet wird, deshalb fordert WTOR (Write To Operator with Reply) kein Kennwort an.
- SWITCH
- Wechsel zu einer neuen Prüfprotokolldatei
Sperrdämonprozess
Abbildung 10. Bedienerbefehl "MODIFY LOCKD"
- Prozedurname
- Der Name des Members in einer Prozedurenbibliothek, das für den Start des Servers verwendet wurde. Der während der Hostkonfiguration verwendete Standardname lautet LOCKD.
- QUERY dataset[(Member)]
- Fragt den Sperrstatus der aufgelisteten Datei oder des aufgelisteten Members ab. Der Server antwortet mit einer der folgenden Nachrichten:
BPXM023I (stclock) Datei[(Member)] NOT LOCKED BPXM023I (stclock) Datei[(Member)] LOCKED BY Benutzer-IDAnmerkung:- Der Server berichtet auch Sperren von anderen Produkten, wie ISPF.
- Für Sperren durch Clients von Developer for System z, die keine Registrierung mit dem Sperrdämonprozess durchführen konnten, wird der Adressraum des Thread-Pool-Servers (RSEDx) als Sperreneigentümer angegeben.
Wenn es dem RSE-Server nicht möglich ist, den Client mit dem Sperrdämonprozess zu registrieren, wird die Konsolnachricht FEK513W generiert. Die in dieser Nachricht aufgeführten ASID- und TCB-Werte können mit der Ausgabe des Bedienerbefehls D GRS,RES=(*,Datei[(Member)]) verglichen werden, um zu ermitteln, welcher derzeitige Benutzer die Sperre hält.
- DISPLAY TABLE
- Zeigt die Zuordnungstabelle für den Sperrdämonprozess in einer einzelnen BPXM023I-Nachricht an.
Der Sperrdämonprozess verwendet diese Zuordnungstabelle, um zu ermitteln, welcher Benutzer von Developer for System z eine bestimmte Dateisperre blockiert (GRS dokumentiert nur das ASID/TCB-Paar).
PID------- ASID TCB----- USERID-- 350 001A 00123ABC IBMUSER