Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

SHOW-PUBSET-OCCUPATION

&pagelevel(3)&pagelevel

Pubset-belegende Aufträge ausgeben

Komponente:

BS2000

Funktionsbereich:

Pubset- und MRSCAT-Verwaltung

Anwendungsbereich:

MULTI-CATALOG-AND-PUBSET-MGMT

Privilegierung:

TSOS
OPERATING
SW-MONITOR-ADMINISTRATION

Berechtigungsschlüssel:

@

Funktionsbeschreibung

Das Kommando SHOW-PUBSET-OCCUPATION informiert die Systembetreuung über die Pubset-belegenden Aufträge. Das Kommando liefert Informationen sowohl für Single-Feature-Pubsets (SF-Pubsets) als auch System-Managed-Pubsets (SM-Pubsets).

Das Kommando unterstützt die strukturierte Ausgabe in S-Variable (siehe „Ausgabe in S-Variable").

Die Informationen zur Pubset-Belegung sind auch in der Ausgabe des Kommandos SHOW-PUBSET-PARAMETERS enthalten.
Einschränkungen

Für SF-Pubsets im Shared-Pubset-Verbund sind nur die am Pubset-Master ausgegebenen Informationen gültig. Die an einem Pubset-Slave ausgegebenen Informationen werden jeweils gültig, wenn dieser zum Pubset-Master wird.

Format

SHOW-PUBSET-OCCUPATION

 PUBSET = *ALL / <cat-id 1..4>

,SELECT-PUBSET = *ALL / *EXCLUSIVE / *SHARED / *ACCESSIBLE / *LOCAL-ACCESSIBLE /

*REMOTE-ACCESSIBLE / *HSMS-SUPPORTED / *SPEEDCAT / *PAGING /

*SINGLE-FEATURE / *SYSTEM-MANAGED / *DEFINED-XCS-CONFIGURATED /

*XCS-CONFIGURATED

,HOST = *LOCAL / *ALL / <alphanum-name 1..8>

Operandenbeschreibung

PUBSET = *ALL / <cat-id 1..4>
Bestimmt, für welche Pubsets die belegenden Aufträge ausgegeben werden sollen.

PUBSET = *ALL
Es werden die belegenden Aufträge aller Pubsets ausgegeben. Über den Operanden SELECT-PUBSET kann Informationsausgabe auf Pubsets mit bestimmten Eigenschaften beschränkt werden.

PUBSET = <cat-id 1..4>
Kennung des Pubsets, dessen belegenden Aufträge ausgegeben werden sollen.

SELECT-PUBSET = *ALL / *EXCLUSIVE / *SHARED / *ACCESSIBLE / *LOCAL-ACCESSIBLE /
*REMOTE-ACCESSIBLE / *HSMS-SUPPORTED /
*SPEEDCAT / *PAGING / *SINGLE-FEATURE /
*SYSTEM-MANAGED / *DEFINED-XCS-CONFIGURATED / *XCS-CONFIGURATED

Gibt an, ob die Informationsausgabe nur für bestimmte Pubsets erfolgen soll. Eine Einschränkung auf bestimmte Pubsets ist sinnvoll, wenn im Operanden PUBSET mit *ALL alle Pubsets ausgewählt wurden.

SELECT-PUBSET = *ALL
Die belegenden Aufträge aller im Operanden PUBSET angegebenen Pubsets werden ausgegeben.

SELECT-PUBSET = *EXCLUSIVE
Die belegenden Aufträge aller exklusiv importierten Pubsets werden ausgegeben.

SELECT-PUBSET = *SHARED
Die belegenden Aufträge aller shared importierten Pubsets werden ausgegeben.

SELECT-PUBSET = *ACCESSIBLE
Die belegenden Aufträge aller Pubsets, auf die zugegriffen werden kann, werden ausgegeben.

SELECT-PUBSET = *LOCAL-ACCESSIBLE
Die belegenden Aufträge aller lokal verfügbaren, d.h. importierten Pubsets, werden ausgegeben.

SELECT-PUBSET = *REMOTE-ACCESSIBLE
Die belegenden Aufträge aller Pubsets, die nicht lokal importiert sind, auf deren Dateikatalog jedoch über eine MSCF-Verbindung zugegriffen werden kann, werden ausgegeben.

SELECT-PUBSET = *HSMS-SUPPORTED
Die belegenden Aufträge aller durch das Subsystem HSMS bedienbaren Pubsets werden ausgegeben.

SELECT-PUBSET = *SPEEDCAT
Die belegenden Aufträge aller SF-Pubsets, auf deren Dateikatalog im lokalen System über SPEEDCAT zugegriffen wird, werden ausgegeben.

SELECT-PUBSET = *PAGING
Die belegenden Aufträge aller Pubsets mit lokal genutzten Seitenwechsel-Bereichen werden ausgegeben.

SELECT-PUBSET = *SINGLE-FEATURE
Die belegenden Aufträge aller SF-Pubsets werden ausgegeben.

SELECT-PUBSET = *SYSTEM-MANAGED
Die belegenden Aufträge aller SM-Pubsets werden ausgegeben.

SELECT-PUBSET = *DEFINED-XCS-CONFIGURATED
Die belegenden Aufträge aller Pubsets, die im MRS-Katalog als XCS-Pubsets definiert sind, werden ausgegeben.

SELECT-PUBSET = *XCS-CONFIGURATED
Die belegenden Aufträge aller XCS-Pubsets werden ausgegeben.

HOST = *LOCAL / *ALL / <alphanum-name 1..8>
Bestimmt, von welchem Rechner die belegenden Aufträge ermittelt werden sollen.

HOST = *LOCAL
Es werden nur die belegenden Aufträge des lokalen Rechners angezeigt.

HOST = *ALL
Es werden die belegenden Aufträge aller Rechner des Shared-Pubset-Verbundes angezeigt, wenn der lokale Rechner der Pubset-Master ist. Andernfalls werden nur die belegenden Aufträge des lokalen Rechners angezeigt (siehe HOST = *LOCAL).

HOST = <alphanum-name 1..8>
Es werden die belegenden Aufträge des angegebenen Rechners angezeigt.
Bezeichnet der angegebene BCAM-Name nicht den lokalen Rechner, wird die Information nur ausgegeben, wenn der lokale Rechner der Pubset-Master des Shared-Pubsets ist und der angegebene BCAM-Name einen weiteren Pubset-Sharer bezeichnet.

Kommando-Returncode

(SC2)

SC1

Maincode

Bedeutung


0

CMD0001

Ohne Fehler


32

CMD0221

Interner Systemfehler


32

CMD2009

Fehler bei Ausgabe in S-Variable (z.B. Subsystem nicht verfügbar)


64

CMD0216

Privilegienfehler


64

DMS1381

Volume-Set-Konflikt


64

DMS138B

Pubset nicht vorhanden oder nicht mit angegebener Eigenschaft


64

DMS138E

Volume-Set nicht vorhanden


64

DMS1396

Rechnername ungültig


128

DMS1386

Klasse-4/5-Speichermangel

Ausgabeformat

Als Kopfzeile wird der Kommandoname ausgegeben. Die Ausgabeinformation pro Pubset lässt sich in zwei Gruppen von Ausgabeblöcken einteilen:

  1. Ausgabeblock für die pubset-globale Grundinformation

  2. Ausgabeblöcke für pubset-globale Detail-Informationen 

Pubset-globale Grundinformation

Der Ausgabeblock für die pubset-globale Grundinformation besteht aus einer Wertezeile, die gleichzeitig als Überschriftszeile die Informationsausgabe für einen Pubset einleitet. Die Grundinformation besitzt folgendes Layout:

PUBSET <catid>: <type>, CTL-SET = (<ctlid>, <type>), <status>, <hsms>

Bedeutung der Ausgabewerte

<catid>

Kennung des Pubsets

<type>

Typ des Pubsets; möglich sind: SINGLE-FEATURE bzw. SYSTEM-MANAGED

<ctlid>

Kennung des Control-Volume-Sets (bei SM-Pubset)

<type>

Gerätetyp der Systemplatte des Control-Volume-Sets (bei SM-Pubset)

<status>

Verfügbarkeit des Pubsets; möglich Werte sind:

  • ACC : Der Pubset ist lokal zugreifbar.

  • INACC: Der Pubset ist nicht lokal zugreifbar.

<hsms>

Unterstützung durch das Subsystem HSMS (bei SM-Pubset); möglich Werte sind:

  • HSMS-SUP : Der Pubset wird von HSMS bedient.

  • NO-HSMS-SUP: Der Pubset wird nicht von HSMS bedient.

Pubset-globale Detail-Informationen

Für die Pubsets werden die belegenden Aufträge ausgegeben.

Der Ausgabeblock wird mit der folgenden Überschriftszeile eingeleitet:

--- REFERENCE              ---------------------------------------

Die nachfolgende Wertezeile zeigt die Anzahl der pubset-belegenden Aufträge:

NUMBER OF OCCUPYING TASKS        | <number>

Existiert mindestens ein pubset-belegender Auftrag, dann werden anschließend detaillierte Informationen über die belegenden Aufträge ausgegeben. Die Ausgabe erfolgt pro Rechner, auf dem belegende Aufträge existieren. Die Information über die belegenden Aufträge eines Rechners wird von einer der folgenden Überschriftszeilen eingeleitet:

  • Überschriftszeile für belegende Aufträge des lokalen Rechners:

    OCCUPATIONS BY LOCAL TASKS

  • Überschriftszeile für belegende Aufträge von unbekannten Rechnern:

    OCCUPATIONS FROM HOST: (UNKNOWN)

  • Überschriftszeile für belegende Aufträge eines entfernten Rechners:

    OCCUPATIONS FROM HOST: <bcam name>

In einer bzw. mehreren Wertezeilen werden alle belegenden Aufträge des jeweiligen Rechners mit der Auftragsnummer (TSN) und Benutzerkennung (falls vorhanden) angezeigt:

<tsn> <userid>    <tsn> <userid>    <tsn> <userid>    <tsn> <userid>

Ausgabe in S-Variable

Ausgabe-Information

Name der S-Variablen

T

Inhalt

Bedingung

Gerätetyp der Systemplatte des Control-Volume-Sets;
*NO für SF-Pubsets

var(*LIST).CONTR-DEV-TYPE

S

*NO
<c-string 1..8>


Kennung des Control-Volume-Sets;
*NO für SF-Pubsets

var(*LIST).CONTR-VOLSET

S

*NO
<cat-id>


HSMS-Unterstützung des Pubsets
*NO=Pubset wird nicht unterstützt
*STD=für Single-Feature-Pubsets
*YES=Pubset wird unterstützt

var(*LIST).HSMS-SUP

S

*NO
*STD
*YES


Anzahl der Beleger

var(*LIST).OCCUP.NUM-OF-TASK

I

<integer>


Rechnername (nur bei OCCUP.NUM-OF-TASK > 0)

var(*LIST).OCCUP.HOST(*LIST).NAME

S

*LOC
*UNKNOWN
<alphan.-name 1..8>


TSN eines Belegers (nur bei OCCUP.NUM-OF-TASK > 0)

var(*LIST).OCCUP.HOST(*LIST).TASK(*LIST).TSN

S

<tsn>


Userid eines Belegers (nur bei OCCUP.NUM-OF-TASK > 0)

var(*LIST).OCCUP.HOST(*LIST).TASK(*LIST).USER-ID

S

*NONE
<user-id>


Kennung des Pubsets

var(*LIST).PUBSET-ID

S

<cat-id>


Pubset-Typ

var(*LIST).PUBSET-TYPE

S

*SINGLE-FEATURE
*SYS-MANAGE


Verfügbarkeit des Pubsets
*ACCESSIBLE=lokal zugreifbar
*INACCESSIBLE=nicht lokal zugreifbar

var(*LIST).STA

S

*ACCESSIBLE
*INACCESSIBLE


Beispiel

/show-pubset-occupation pubset=x

%---------------------------------------------------------------------------- 
%COMMAND: SHOW-PUBSET-OCCUPATION 
%- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
PUBSET X   : SINGLE-FEATURE, ACC
---- REFERENCE            -------------------------------------------------
 NUMBER OF OCCUPYING TASKS            | 1
---- DETAILS OF OCCUPATION  -------------------------------------------------
 OCCUPATIONS BY LOCAL TASKS
  RP02
-----------------------------------------------------------------------------