Display assignment of operator roles to user IDs
Component: | SRPMNUC |
Functional area: | Operator function control |
Domain: | CONSOLE-MANAGEMENT |
Privileges: | STD-PROCESSING |
Routing code: | @ |
Function
The SHOW-OPERATOR-ATTRIBUTES command allows the user to obtain information about which operator roles are assigned to his user ID.
SECURITY-ADMINISTRATOR can assign one or more operator roles to a user ID. Through the assignment of an operator role, an operator terminal (console) or a user task with OPERATING privilege which uses this user ID can take on the assigned role with the REQUEST-OPERATOR-ROLE command and perform the operator functions associated with the role. The scope of permitted functions, i.e. the sphere of operating responsibility granted, is defined by SECURITY-ADMINISTRATOR through the allocation of routing codes.
The granting and assumption of operator roles is described in the “Introduction to System Administration” [14].
The command supports structured output in S variables (see "Output in S variables").
Privileged functions
A Privileg SECURITY-ADMINISTRATIOR is given information about all the user IDs on all the pubsets, but other callers can only obtain information about the assignment of operator roles to their own user IDs.
Format
SHOW-OPERATOR-ATTRIBUTES |
USER-IDENTIFICATION = *OWN / ALL / list-poss(20): *OWN / <name 1..8> ,PUBSET = *HOME / *ALL / list-poss(20): *HOME / <cat-id 1..4> ,OUTPUT = *SYSOUT / list-poss(2): *SYSOUT / *SYSLST |
Operands
USER-IDENTIFICATION = *OWN / *ALL / list-poss(20): *OWN / <name 1..8>
Selects the user IDs whose assignment to operator roles is to be displayed. Up to 20 user IDs (including *OWN) can be specified in a list. The nonprivileged user only receives information about his own user ID, however.
USER-IDENTIFICATION = *OWN
Default value: Information about the user’s own user IDs is to be output.
USER-IDENTIFICATION = *ALL
Information about all user IDs is to be output. The nonprivileged user only receives information about his own user ID (*ALL then has the effect of *OWN).
PUBSET = *HOME / *ALL / list-poss(20): *HOME / <cat-id 1..4>
Specifies the pubset to which the operator roles and the user IDs belong. Up to 20 catalog IDs (including *HOME) can be specified in a list.
PUBSET = *HOME
Default value: Information about the assignments for the home pubset are to be output.
PUBSET = *ALL
Information about the assignments for all the connected pubsets is to be output.
OUTPUT = *SYSOUT / list-poss(2): *SYSOUT / *SYSLST
Specifies where the information is to be output to. The information can be output to SYSOUT (default), to SYSLST or to SYSOUT and SYSLST.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | No error | |
2 | 0 | SRM6001 | Command executed with warning |
32 | SRM6020 | System error during command processing | |
64 | SRM6040 | Semantic error | |
130 | SRM6030 | Command temporarily cannot be executed |
Output in S variables
Output information | Name of the S variable | T | Contents | Condition |
|---|---|---|---|---|
Operator role associated with the user ID | var(*LIST).OPER-ROLE(*LIST) | S | <name 1..8> | |
Pubset catalog ID | var(*LIST).PUBSET | S | <cat-id 1..4> | |
User ID | var(*LIST).USER-ID | S | <name 1..8> |