Request information on operator roles
Component: | SRPMNUC |
Functional area: | Operator function control |
Domain: | CONSOLE-MANAGEMENT |
Privileges: | STD-PROCESSING |
Routing code: | @ |
Function
The SHOW-OPERATOR-ROLE command enables users to find out which operator roles have been defined and which routing (authorization) codes are associated with the assumption of these roles. Nonprivileged users are only shown information about operator roles which are assigned to their own user ID.
Output can be directed to SYSOUT (default) or to SYSLST.
User tasks are sent the information as formatted output; operator terminals (consoles) and $CONSOLE applications are sent it in the form of messages (SRM3522, SRM3523, etc.).
In compatible mode (NBCONOPI=N), the command is rejected if issued at operator terminals or in $CONSOLE applications with generated authorization names. From $CONSOLE applications with dynamic authorization names the command is accepted only with INFORMATION=*STD or *ASSIGNMENT.
In user tasks the command supports structured output in S variables (see "Output in S variables").
Privileged functions
As the operator role administrator, a caller with the SECURITY-ADMINISTRATION privilege is shown information on the following subjects:
all operator roles for the specified pubsets
the routing codes assigned to the operator roles
the user IDs which can assume the operator roles
Callers with OPERATING privilege are shown information about:
the routing codes assigned to an operator role
the routing codes currently assigned to their own task as a result of assuming operator roles
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 |
Operands
OPERATOR-ROLE =
Specifies the set of operator roles that are to be shown.
OPERATOR-ROLE = *STD
The set of operator roles that will be shown depends on the caller’s privileges:
Users with STD-PROCESSING privilege are shown information about all the operator roles authorized for their own user ID in the user catalog of the specified pubset.
Users with OPERATING privilege are shown information about the operator roles currently assigned to the task (INFORMATION=*ASSIGNMENT) or about all operator roles authorized for their own user ID in the user catalog of the specified pubset (INFORMATION=*ROUTING-CODES).
Users with SECURITY-ADMINISTRATION privilege are shown information about all the operator roles from the user catalog of the specified pubset (equivalent to *ALL).
OPERATOR-ROLE = *OWN
Only users with SECURITY-ADMINISTRATION privilege are allowed to select this value. Provides information about all operator roles authorized for the user’s own ID in the user catalog of the specified pubset.
OPERATOR-ROLE = *ALL
The maximum possible amount of information is shown as appropriate to the caller’s privileges:
Users with STD-PROCESSING or OPERATING privilege are shown information about all the operator roles authorized for their own user ID in the user catalog of the specified pubset
Users with SECURITY-ADMINISTRATION privilege are shown information about all the operator roles from the user catalog of the specified pubset.
OPERATOR-ROLE = list-poss(20): <name 1..8>
A list of up to 20 operator roles, about which information is to be supplied.
PUBSET =
Specifies the pubset in respect of whose operator roles information is to be output.
PUBSET = *HOME
Default value: information is to be output about the operator roles of the home pubset.
PUBSET = *ALL
Information is to be output about the operator roles of all the connected pubsets.
PUBSET = list-poss(20): *HOME / <cat-id 1..4>
Specifies a list of pubsets in respect of whose operator roles information is being requested. *HOME identifies the home pubset for the current session.
INFORMATION =
Defines the nature and scope of the information that is to be shown.
INFORMATION = *STD
The information that will be shown depends on the caller’s privileges:
Users with STD-PROCESSING privilege are shown a list of the routing codes which are assigned to the specified operator role (equivalent to specifying INFORMATION= *ROUTING-CODES).
Users with OPERATING privilege are shown information about the operator roles currently assigned to the task (equivalent to specifying INFORMATION= *ASSIGNMENT).
Users with SECURITY-ADMINISTRATION privilege are shown a list of the routing codes which are assigned to the specified operator role and a list of the user IDs to which the specified operator role is assigned (equivalent to specifying INFORMATION= (*ROUTING-CODES,*USER-LIST)).
INFORMATION = *ROUTING-CODES
Outputs a list of the routing codes which are currently assigned to the specified operator role.
INFORMATION = *USER-LIST
Only users with SECURITY-ADMINISTRATION privilege are allowed to select this value Outputs a list of the user IDs to which the specified operator role is assigned.
INFORMATION = *ASSIGNMENT
Only users with OPERATING privilege are allowed to select this value.
Outputs a list of the operator roles which are assigned to the calling task.
OUTPUT = *SYSOUT / list-poss(2): *SYSOUT / *SYSLST
Specifies where the information is to be output. Output may be routed optionally to the system file SYSOUT (default) or to the system file SYSLST. Output can also be sent to both system files.
If *SYSLST is selected at logical or physical operator terminals, it is ignored and the output is sent to SYSOUT.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | No error | |
1 | 0 | NBR0986 | Operator role not assigned |
1 | 0 | NBR0987 | No operator role assigned |
1 | 0 | NBR0990 | Not all specified operator roles found |
2 | 0 | SRM6001 | Command executed with a warning |
32 | NBR0983 | Internal error on command server | |
32 | SRM6020 | System error during command processing | |
64 | NBR0979 | Command functionality not supported in user task | |
64 | NBR0981 | Command not allowed at console | |
64 | NBR0982 | Command caller does not have an operator ID | |
64 | SRM6040 | Semantic error | |
130 | SRM6030 | Command cannot temporarily be executed |
Output in S variables
The scope of the output depends on the value of the INFORMATION operand and, if INF=*ALL is specified, on whether the user ID has SECURITY-ADMINISTRATION privilege. The following combinations are of relevance:
Notation used in command | Abbreviated form used in table |
|---|---|
INFORMATION = *ALL, SECURITY-ADMINISTRATION not assigned | 1 |
INFORMATION = *ALL, SECURITY-ADMINISTRATION assigned | 2 |
INFORMATION = *PAR(RCODE-LIST=*YES) | 3 |
INFORMATION = *PAR(USER-LIST=*YES) - can be specified only if the SECURITY-ADMINISTRATION privilege has been assigned | 4 |
Output information | Name of the S variable | T | Contents | Condition |
|---|---|---|---|---|
Operator role associated with the user ID | var(*LIST).OPER-ROLE | S | <name 1..8> | 1, 2, 3, 4 |
Pubset catalog ID | var(*LIST).PUBSET | S | <cat-id 1..4> | 1, 2, 3, 4 |
Assigned routing codes | var(*LIST).ROUT-ASS(*LIST) | S | <routing-code> | 1, 2, 3 |
Routing codes which are not assigned | var(*LIST).ROUT-NOT-ASS(*LIST) | S | <routing-code> | 1, 2, 3 |
User ID | var(*LIST).USER-ID(*LIST) | S | <name 1..8> | 2, 4 |
Example
The routing codes and the operator roles currently assigned to the task (here the TSOS user ID) are to be output for the operator roles defined in pubset T051:
/show-oper-role pubset=t051
SHOW-OPERATOR-ROLE INFORMATION = RCODE-LIST 2012-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'