Release operator roles
Component: | BS2000 |
Functional area: | Operator function control |
Domain: | CONSOLE-MANAGEMENT |
Privileges: | OPERATING |
Routing code: | @ |
Function
The RELEASE-OPERATOR-ROLE command allows you to relinquish operator roles previously requested with the REQUEST-OPERATOR-ROLE command. By releasing an operator role you give up the right to enter commands protected by any of the relinquished routing codes or to receive messages distributed via one of the relinquished routing codes. You retain any other roles that were previously associated with your user ID, which means that you keep the right to enter commands that have routing codes which are included both in a role that you have relinquished and in a role that you have retained.
An operator role is a functional area and consists of a set of routing codes defined by the security administrator. This set may be any combination of the 40 routing codes available.
Once the command has been executed successfully, you are shown which operator roles are still assigned to you.
To continue receiving messages that are distributed via a routing code which you have relinquished by releasing an operator role, you must first have requested this right with the MODIFY-MSG-SUBSCRIPTION command.
The command can be issued by $CONSOLE applications with dynamic authorization names and from user tasks with the OPERATING privilege.
If the “Operator LOGON” function is used (incompatible mode; system parameter NBCONOPI=Y), the command can also be issued at a physical operator terminal (console).
Format
RELEASE-OPERATOR-ROLE |
OPERATOR-ROLE = *ALL / list-poss(10): <name 1..8> |
Operands
OPERATOR-ROLE =
Specifies the operator roles to be relinquished by the operator’s own user ID.
OPERATOR-ROLE = *ALL
All operator roles that were associated with the operator’s user ID up to now are relinquished.
OPERATOR-ROLE = list-poss(10): <name 1..8>
All operator roles specified via their names (up to 10) are relinquished by the operator’s own user ID.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | No error | |
1 | 0 | NBR0986 | Execution unnecessary |
1 | 0 | NBR0987 | Operator ID currently has no role |
2 | 0 | NBR0990 | Not all specified roles found |
1 | CMD0202 | Syntax error | |
32 | NBR0983 | Internal error on command server | |
64 | CMD0216 | No authorization | |
64 | NBR0981 | Command cannot be issued from operator terminal in compatible mode (NBCONOPI=N) | |
64 | NBR0982 | Command issuer does not have an operator ID |