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-OPERATOR-ROLE

&pagelevel(3)&pagelevel

Informationen über Operator-Rollen ausgeben

Komponente:

SRPMNUC

Funktionsbereich:

Operator-Funktionen steuern

Anwendungsbereich:

CONSOLE-MANAGEMENT
SECURITY-ADMINISTRATION

Privilegierung:

STD-PROCESSING
OPERATING
SECURITY-ADMINISTRATION

Berechtigungsschlüssel:

@                                                                                                         

Funktionsbeschreibung

Mit dem Kommando SHOW-OPERATOR-ROLE kann sich ein Benutzer bereits darüber informieren, welche Operator-Rollen definiert sind und welche Einzelberechtigungen (Routing-Codes) mit der Übernahme dieser Operator-Rollen verbunden sind. Der nichtprivilegierte Benutzer erhält nur Informationen über Operator-Rollen, die seiner Benutzerkennung zugewiesen sind.

Die Ausgabe kann nach SYSOUT (Voreinstellung) oder SYSLST erfolgen. Benutzertasks erhalten die Informationen als formatierte Ausgabe, Konsole und $CONSOLE-Anwendungen über Meldungen (SRM3522, SRM3523, u.a.).

Im kompatiblen Modus (NBCONOPI=N) wird die Eingabe des Kommandos an Konsolen bzw. $CONSOLE-Anwendungen mit generiertem Berechtigungsnamen abgewiesen. Von $CONSOLE-Anwendungen mit dynamischem Berechtigungsnamen wird das Kommando nur mit INFORMATION=*STD bzw. *ASSIGNMENT akzeptiert.

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

Privilegierte Funktionen

Ein Aufrufer mit dem Privileg SECURITY-ADMINISTRATION erhält als Verwalter der Operator-Rollen Informationen über:

  • alle Operator-Rollen des angegebenen Pubsets

  • die den Operator-Rollen zugeordneten Routing-Codes

  • die Benutzerkennungen, die die Operator-Rollen einnehmen dürfen

Ein Aufrufer mit dem Privileg OPERATING erhält Informationen über:

  • die Routing-Codes, die einer Operator-Rolle zugewiesen sind

  • die Routing-Codes, die seiner Task durch die Übernahme von Operator-Rollen aktuell zugewiesen sind 

Format

SHOW-OPERATOR-ROLE                                                                                                                           

 OPERATOR-ROLE = *STD / *OWN / *ALL / list-poss(20): <name 1..8>

,PUBSET = *HOME / *ALL / list-poss(20): *HOME / <cat-id 1..4>

,INFORMATION = *STD / list-poss(2): *ROUTING-CODES / *USER-LIST / *ASSIGNMENT

,OUTPUT = *SYSOUT / list-poss(2): *SYSOUT / *SYSLST

Operandenbeschreibung

OPERATOR-ROLE =
Bestimmt die Menge der anzuzeigenden Operator-Rollen.

OPERATOR-ROLE = *STD
Die Menge der anzuzeigenden Operator-Rollen ist abhängig von der Privilegierung des Aufrufers:

  • Benutzer mit dem Privileg STD-PROCESSING erhalten Informationen über alle Operator-Rollen, die für die eigene Benutzerkennung im Benutzerkatalog des angegebenen Pubsets zugelassen sind.

  • Benutzer mit dem Privileg OPERATING erhalten Informationen über die der Task aktuell zugewiesenen Operator-Rollen (INFORMATION=*ASSIGNMENT) bzw. über alle Operator-Rollen, die für die eigene Benutzerkennung im Benutzerkatalog des angegebenen Pubsets zugelassen sind (INFORMATION=*ROUTING-CODES).

  • Benutzer mit dem Privileg SECURITY-ADMINISTRATION erhalten Informationen über alle Operator-Rollen aus dem Benutzerkatalog des angegebenen Pubsets (entspricht *ALL).

OPERATOR-ROLE = *OWN
Die Angabe ist nur mit Privileg SECURITY-ADMINISTRATION erlaubt.
Informiert über alle Operator-Rollen, die für die eigene Benutzerkennung im Benutzerkatalog des angegebenen Pubsets zugelassen sind.

OPERATOR-ROLE = *ALL
Abhängig von der Privilegierung des Aufrufers wird die maximal mögliche Informationsmenge ausgegeben:

  • Benutzer mit dem Privileg STD-PROCESSING bzw. OPERATING erhalten Informationen über alle Operator-Rollen, die für die eigene Benutzerkennung im Benutzerkatalog des angegebenen Pubsets zugelassen sind.

  • Benutzer mit dem Privileg SECURITY-ADMINISTRATION erhalten Informationen über alle Operator-Rollen aus dem Benutzerkatalog des angegebenen Pubsets.

OPERATOR-ROLE = list-poss(20): <name 1..8>
Liste von bis zu 20 Operator-Rollen, über die Informationen geliefert werden sollen.

PUBSET =
Vereinbart den Pubset, über dessen Operator-Rollen Informationen ausgegeben werden sollen.

PUBSET = *HOME
Default-Wert: Es sollen Informationen über die Operator-Rollen des Home-Pubsets ausgegeben werden.

PUBSET = *ALL
Es sollen Informationen über die Operator-Rollen aller angeschlossenen Pubsets ausgegeben werden.

PUBSET = list-poss(20): *HOME / <cat-id 1..4>
Vereinbart in Listenform die Pubsets, über deren Operator-Rollen Informationen angefordert werden. *HOME bezeichnet dabei den Home-Pubset des aktuellen Systemlaufs.

INFORMATION =
Legt Art und Umfang der auszugebenden Informationen fest.

INFORMATION = *STD
Die auszugebenden Informationen sind abhängig von der Privilegierung des Aufrufers:

  • Benutzer mit dem Privileg STD-PROCESSING erhalten die Liste der Routing-Codes, die der angegebenen Operator-Rolle zugeordnet sind (entspricht der Angabe INFORMATION=*ROUTING-CODES).

  • Benutzer mit dem Privileg OPERATING erhalten Informationen über die der Task aktuell zugewiesenen Operator-Rollen (entspricht der Angabe INFORMATION=*ASSIGNMENT).

  • Benutzer mit dem Privileg SECURITY-ADMINISTRATION erhalten die Liste der Routing-Codes, die der angegebenen Operator-Rolle zugeordnet sind, und die Liste der Benutzerkennungen, denen diese Operator-Rolle zugeordnet ist (entspricht der Angabe INFORMATION=(*ROUTING-CODES,*USER-LIST)).

INFORMATION = *ROUTING-CODES
Gibt die Liste der Routing-Codes aus, die der angegebenen Operator-Rolle zugeordnet sind.

INFORMATION = *USER-LIST
Die Angabe ist nur mit Privileg SECURITY-ADMINISTRATION erlaubt.
Gibt die Liste der Benutzerkennungen aus, denen die angegebene Operator-Rolle zugewiesen ist.

INFORMATION = *ASSIGNMENT
Die Angabe ist nur mit Privileg OPERATING erlaubt.
Gibt die Liste der Operator-Rollen aus, die der aufrufenden Task aktuell zugewiesen sind.

OUTPUT = *SYSOUT / list-poss(2): *SYSOUT / *SYSLST
Legt fest, wohin die Information auszugeben ist. Die Ausgabe erfolgt wahlweise in die Systemdatei SYSOUT (Voreinstellung) oder in die Systemdatei SYSLST. Die Ausgabe kann auch in beide Systemdateien erfolgen.
Bei der Eingabe an logischen oder physikalischen Konsolen wird die Angabe *SYSLST ignoriert und die Ausgabe erfolgt nach SYSOUT. 

Kommando-Returncode

(SC2)

SC1

Maincode

Bedeutung


0

CMD0001

Ohne Fehler

1

0

NBR0986

Operator-Rolle nicht zugewiesen

1

0

NBR0987

Keine Operator-Rolle zugewiesen

2

0

NBR0990

Nicht alle angegebenen Operator-Rollen gefunden

2

0

SRM6001

Kommando mit Warnung ausgeführt


32

NBR0983

Interner Fehler im Kommando-Server


32

SRM6020

Systemfehler bei der Kommandobearbeitung


64

NBR0979

Kommandofunktionalität in Benutzertask nicht unterstützt


64

NBR0981

Kommando von Konsole unzulässig


64

NBR0982

Kommandoaufrufer hat keine Operator-Kennung


64

SRM6040

Semantischer Fehler


130

SRM6030

Kommando kann im Moment nicht ausgeführt werden

Ausgabe in S-Variable

Der Umfang der Ausgabe hängt vom Wert des Operanden INFORMATION ab und bei INF=*ALL auch davon, ob das Privileg SECURITY-ADMINISTRATION der Benutzerkennung zugeordnet ist. Folgende Kombinationen sind von Bedeutung:

Schreibweise im Kommando

gekürzte Schreibweise in Tabelle

INFORMATION = *ALL, SECURITY-ADMINISTRATION nicht zugeordnet

1

INFORMATION = *ALL, SECURITY-ADMINISTRATION zugeordnet

2

INFORMATION = *PAR(RCODE-LIST=*YES)

3

INFORMATION = *PAR(USER-LIST=*YES) - kann nur bei zugeordnetem Privileg SECURITY-ADMINISTRATION angegeben werden

4

Ausgabe-Information

Name der S-Variablen

T

Inhalt

Bedingung

Operatorrolle der Benutzerkennung

var(*LIST).OPER-ROLE

S

<name 1..8>

1, 2, 3, 4

Katalogkennung des Pubsets

var(*LIST).PUBSET

S

<cat-id 1..4>

1, 2, 3, 4

zugewiesene Routing-Codes

var(*LIST).ROUT-ASS(*LIST)

S

<routing-code>

1, 2, 3

nicht zugewiesene Routing-Codes

var(*LIST).ROUT-NOT-ASS(*LIST)

S

<routing-code>

1, 2, 3

Benutzerkennung

var(*LIST).USER-ID(*LIST)

S

<name 1..8>

2, 4

Beispiel

Für die im Pubset T051 definierten Operator-Rollen sollen die Routing-Codes und die der Task (hier Benutzerkennung TSOS) aktuell zugewiesenen Operator-Rollen ausgegeben werden:

/show-oper-role pubset=t051

SHOW-OPERATOR-ROLE   INFORMATION = RCODE-LIST              2014-03-14 12:25:34
------------------------------------------------------------------------------
OPERATOR-ROLE    SYSADM                  PUBSET    T051
ROUTING-CODES
  ASSIGNED:      *ALL
------------------------------------------------------------------------------
OPERATOR-ROLE    XAFOPR                  PUBSET    T051
ROUTING-CODES
  ASSIGNED:      *ALL
------------------------------------------------------------------------------
SHOW-OPERATOR-ROLE   INFORMATION = RCODE-LIST                   END OF DISPLAY

/show-oper-role oper=*all,pubset=t051,inf=*assignment

%  NBR0986 OPERATOR ROLE 'SYSADM' NOT ASSIGNED TO OPERATOR ID 'TSOS'
%  NBR0986 OPERATOR ROLE 'XAFOPR' NOT ASSIGNED TO OPERATOR ID 'TSOS'
Powered by Atlassian Confluence and Scroll Viewport.