Berechtigung ADA, DA, Administrator ohne Domänen
Diese Anweisung gibt einen Überblick über den aktuellen Status von MAREN. Ausgegeben werden Informationen über das MAREN-Subsystem, die Steuertask MARENCP und die automatische Freibandzuweisung MARENUCP. Diese Informationen können auch von allen verbundenen Systemen des MAREN-Verbunds abgerufen werden.
Der DA kann die Anweisung nur in der eigenen Domäne ausführen. Die Angabe *ALL-FROM-DOMAIN ist daher für ihn ohne Bedeutung.
Format
| SHOW-MAREN-STATUS | Kurzname: SHMS | ||||||||||||||||
| |||||||||||||||||
Operandenbeschreibung
HOST-NAME =
Gibt an, von welchem System der MAREN-Status angezeigt werden soll.
HOST-NAME = *OWN
Informationen werden nur vom eigenen System ausgegeben.
Wenn der ADA sich mit der Anweisung MODIFY-ADMINISTRATION-SCOPE DOMAIN=. . . zum DA einer Domäne gemacht hat, wird mit HOST=*OWN das System angesprochen, das bei MODIFY-ADMINISTRATION-SCOPE durch den Operanden HOST bestimmt wurde.
HOST-NAME = *ALL
Beim Einsatz von Domänen werden für den DA die Informationen zu allen Systemen der eigenen Domäne ausgegeben, für den ADA die Informationen zu allen Systemen.
HOST-NAME = <alphanum-name 1..8>
Name eines Systems.
Wenn der DA beim Einsatz von Domänen den Namen eines Systems eingibt, muss dieses der eigenen Domäne angehören.
HOST-NAME = *ALL-FROM-DOMAIN (...)
Informationen werden für die Systeme bestimmter Domänen ausgegeben. Dieser Operand darf nur vom ADA benutzt werden.
DOMAIN =
Domänenauswahl.
DOMAIN = *STD-DOMAIN
Die Informationen über die Systeme der Standard-Domäne werden ausgegeben.
DOMAIN = *OWN
Die Informationen über die Systeme der eigenen Domäne werden ausgegeben.
Die eigene Domäne ist die Domäne des Systems, an dem der ADA aktuell arbeitet.
DOMAIN = <alphanum-name 1..8>
Die Informationen über die Systeme der angegebenen Domäne werden ausgegeben.
OVERFLOW-CONTROL =
Art der Steuerung bei Bildschirmüberlauf im Dialog.
OVERFLOW-CONTROL = *BY-PROGRAM
Steuerung durch das Programm: Nach der Ausgabe eines Informationsblocks erfolgt eine Abfrage, ob die laufende Aktion fortgesetzt oder abgebrochen werden soll.
OVERFLOW-CONTROL = *BY-SYSTEM
Steuerung durch BS2000: Die Art der Steuerung bei Bildschirmüberlauf richtet sich nur nach dem Systemparameter TCHOFLO bzw. nach dem mit dem Kommando MODIFY-TERMINAL-OPTIONS eingestellten Wert.
Hinweise
Die Ausgabe enthält für jedes System folgende Informationen:
Name des Systems
TSN der Steuertask MARENCP
TSN der automatischen Freibandzuweisung MARENUCP
Status des MAREN-Katalogs (FREE/LOCKED/UNLOCKED)
Transaktionsstatus des Subsystems (INACTIVE/ANNOUNCE/ACTIVE/FETCH)
TSN und Archivnummer der letzten Transaktion
Name der Logging-Datei
Location Manager File (Name der Reservierungsdatei) für MARENCP und MARENUCP
Name der Exit-Modulbibliothek für MARENCP und MARENUCP
Für die Informationsübergabe im Netzwerk müssen zwischen dem System mit dem MAREN-Katalog und den übrigen Systemen des MAREN-Verbunds aktive Verbindungen bestehen. Dazu muss das Subsystem HILPEX MSCF geladen sein. Die Anweisung mit dem Operand HOST-NAME=*OWN funktioniert auch ohne diese Voraussetzungen.
Beispiele
Beispiel 1: Status-Abfrage vom eigenen System
HOST-NAME ============================================================================= LEIBNIZ4 MARENLOG :BUR7:$SYSMAREN.MAREN.LOGGING MARENLMF/UCP :FSAU:$SYSMAREN.MARENLMF MARENLIB/UCP(1,6) :BUR7:$SYSMAREN.MARENLIB |
Nach Ausgabe eines Informationsblocks wird mit der Meldung MARM103 abgefragt, ob die Aktion fortgesetzt werden soll.
Beispiel 2: Status-Abfrage von allen Systemen im MAREN-Verbund
//show-maren-status host=*all
============================================================================= HOSTNAME MARENCP MARENUCP CATALOG === TRANSACTION === DOMAIN SUB-SYS TSN TSN STATUS STATUS LA-TSN LA-VSN VERSION ============================================================================= LEIBNIZ4 5TAM 5TAX UNLOCKED INACTIVE 5TDQ HSMSTES<version> D017ZE15 400J 400K UNLOCKED INACTIVE 41HT QE3009 HSMSTES<version> % MARM197 ACCESS TO HOST 'D017ZE19' NOT POSSIBLE D017ZE39 2B9I 2B91 UNLOCKED INACTIVE 2RDX QE0574 HSMSTES<version> ----------------------------------------------------------------------------- MAREN-CATALOG : :FSAU:$SYSMAREN.MARENCAT.OS ============================================================================= HOST-NAME ============================================================================= LEIBNIZ4 MARENLMF/CP :FSAU:$SYSMAREN.MARENLMF.OS MARENLIB/CP (1,3,5) :BUR7:$SYSMAREN.MARENLIB D017ZE15 MARENLMF/CP :FSAU:$SYSMAREN.MARENLMF.OS MARENLIB/CP (1,3,5) :SBZ7:$SYSMAREN.MARENLIB D017ZE39 MARENLMF/CP :FSAU:$SYSMAREN.MARENLMF.OS MARENLMF/UCP :FSAU:$SYSMAREN.MARENLMF.OS MARENLIB/CP (1,3,5) :BU7B:$SYSMAREN.MARENLIB MARENLIB/UCP (1,6) :BU7B:$SYSMAREN.MARENLIB % MARM170 STATEMENT '//SHOW-MAREN-STATUS' PROCESSED |
Wird für ein System die Meldung MARM197 ausgegeben, werden für das betreffende System keine weiteren Informationen ausgegeben. Stehen bei MARENCP-TSN bzw. MARENUCP-TSN Leerzeichen, so ist das Programm am jeweiligen System nicht geladen.
Hinter dem Dateinamen des MAREN-Katalogs wird „CLOSED“ ausgegeben, wenn dieser (mindestens) auf dem ersten System in der Liste mit der Anweisung CLOSE-MAREN-FILES geschlossen wurde.
Wenn MARENCP entladen wurde, wird der Dateiname des MAREN-Katalogs weiterhin ausgegeben. Möglicherweise wird von anderen MAREN-Instanzen oder anderen Systemen darauf zugegriffen.