Functional areas in BS2000 operation
The following table provides an overview of the functional areas in BS2000 operation. The table also includes the commands (in alphabetical order) which belong to the individual functional areas. This is a standard allocation of commands, which can be changed at system initialization (separately for each command; see section "SET-CMD-CODE statement").
For some commands, the default assignment to a functional area and therefore also the assignment of an authorization code depends on the system parameter NBCONOPI. Some commands which are protected by default with the authorization code $ with NBCONOPI=N, receive a different default authorization code if the operator logon is activated (NBCONOPI=Y). These are indicated in the table.
Every functional area is provided with an authorization code (AC), also known as a routing code (RC), which must be specified in each case when the assignment is made. The meaning of this authorization code is described on "Notes on the individual functional areas".
Information and the assignment of functional areas to consoles can be found under "Assignment of functional areas to consoles".
An assignment of “operator commands to routing codes” is provided in the “Commands” manual [27].
As a rule, the following table applies only in conjunction with NBCONOPI=N. Exceptions are indicated separately.
AC/RC | Task area | Standard for command |
A | System administration | CHANGE-SERSLOG-FILE, |
C | Operation of the data communication system | All BCAM commands, e.g.: |
File Transfer operation and control | openFT commands, see manual | |
D | Operation of disks | CHANGE-DISK-MOUNT, e.g. SHOW-DRV-STATUS, SET-DISK-DEFAULTS, |
E | General tasks and responsibilities | CANCEL-RUN-PROCESS, |
With NBCONOPI=Y, some commands which otherwise have the AC $ are given the new AC E. | MODIFY-MSG-FILE-ASSIGNMENT, | |
W | Device management | ADD-IO-UNIT, |
H | Hardware maintenance | |
J | Job control | HOLD-JOB, |
With NBCONOPI=Y, some commands which otherwise have the AC $ are given the new AC J. | MODIFY-JOB, | |
K | OPR command management | CONNECT-CMD-SERVER |
N | Monitoring of remote SPOOL | REDIRECT-PRINT-JOB |
O | Operation of printers | HOLD-PRINT-JOB (alias HOLD-SPOOLOUT), |
P | Control of tasks | CANCEL-JOB, |
R | Monitoring and control of system behavior | ACTIVATE-SNAPSHOT, |
S | Control of spoolout operation | MODIFY-PRINTER-OUTPUT-STATUS, |
T | Operation of magnetic tape devices | ADD-DEVICE-DEPOT, |
U | File management | |
W,X,Y,Z | Freely selectable | |
B,F,I,L,M, | Reserved | |
9 | VM2000 administration | All VM2000 commands |
# | POSIX | |
@ | Special meaning | ADD-CONSOLE-FILTER, |
Additional with NBCONOPI=Y | EXIT-JOB, | |
* | Main console | CONSOLE |
$ | Special meaning | ADD-MASTER-CATALOG-ENTRY, |
In conjunction with NBCONOPI=Y, the AC changes from $ to E | ADD-/SET-FILE-LINK, | |
In conjunction with NBCONOPI=Y, the AC changes from $ to J | CREATE-JV, DELETE-JV, |
Table 45: authorization code (AC/RC) - functional areas - commands
Notes on the individual functional areas
A | System administration Comprises activation/deactivation of the software error logging function and changing the SERSLOG file. |
C | Operation of the data communication system Includes the following activities, for example:
Every assigned console also receives messages which indicate errors in the Data Communication System. |
D | Operation of disks Includes the mounting of volumes (disks). Every assigned console also receives messages which indicate inconsistencies in the volume serial numbers, or other errors. |
E | General tasks and responsibilitiesIncludes no precisely defined activities; the associated commands should rather be available to every console. |
W | Device management Includes the following activities, for example:
Every assigned console also receives messages which indicate inconsistencies. |
H | Hardware maintenance Every assigned console receives messages which indicate errors in the server and which are evaluated by the maintenance personnel. |
J | Job control Every assigned console receives messages which indicate the start of or any particularities or errors in the processing of jobs, so that the operator can monitor job execution. |
K | OPR command management Authorized user programs can define operator commands and delete the commands they have defined. They can also assume and relinquish responsibility for processing existing operator commands. |
N | Monitoring of remote SPOOL |
O | Operation of printers |
P | Control of tasks Includes the following activities, for example:
|
R | Monitoring and control of system behavior Includes the following activities, for example:
Every assigned console also receives messages which indicate system errors or server faults or which indicate that users have requested more space on public volumes than they are permitted. |
S | Control of spoolout operation Includes the following activities, for example: assigning output devices to spoolout jobs. Every assigned console also receives messages which indicate inconsistencies. |
T | Operation of magnetic tape devices Includes the mounting/changing of volumes. Every assigned console also receives messages which indicate errors. |
U | File management |
W,X,Y,Z | |
Freely selectable. These functional areas are freely available to the user for specific purposes (e.g. for special commands). | |
B,F,I,L,M,Q,V,1,2,3,4,5,6,7,8 | |
Reserved for future system expansion. These functional areas have not yet been defined but may be defined in future versions. | |
9 | Reserved for VM2000 management |
# | POSIX |
Authorization codes with special meanings
0 | Messages with this authorization code cannot be requested. Messages without a response are simply stored in the CONSLOG file. Messages with a response (queries) are delivered to the main console. |
* | Main console In addition, every assigned console receives messages which provide information on the status of accounting files. |
@ | Messages with this authorization code are requestable (MODIFY-MSG-SUBSCRIPTION command). Messages without a response are simply stored in the CONSLOG file. Messages with a response (queries) are delivered to the main console. Commands with this authorization code are unprotected; any operator is authorized to enter them. |
$ | No user is allowed to use a command protected by code $. Although authorization code $ may be assigned to any console or authorized user program, it does not authorize them to issue a command protected by $. Code $ has no special meaning as a message distribution code. |
Assignment of functional areas to consoles
The following methods are available for assigning functional areas to consoles:
NBCONOPI=N
At system startup
Functional areas can be assigned to physical or virtual consoles (but not to authorized user programs) via the STARTUP parameter file during system startup. This is done using the SET-CODE statement (SET-CODE CODE=rc,CONSOLE=mn; see "SET-CODE statement").
During the session
The ASR command can be used on the relevant main console to create any desired assignment for physical consoles and for virtual consoles with generated authorization names.
Depending on the system parameters ASRSW1 and ASRSW2 the ASR command can also be used from another physical console or from a virtual console with a generated authorization name (so long as the ASR command is permitted there) to set the assignment
ASR commands to change the allocation of functional areas are rejected if they are entered by authorized user programs with dynamic authorization names or in reference to these. Authorized user programs with dynamic authorization names assign themselves to their functional areas with the REQUEST-OPERATOR-ROLE command.The “Main console” function can only be switched over if the previous main console agrees.
If the current main console fails, the system automatically switches the “main console” function to another console, selecting the standby console predefined in the parameter service (see section "DEFINE-CONSOLE statement"). This selection can be influenced by the operator by means of the CONSOLE command.
NBCONOPI=Y
The routing codes assigned to the IPL console in the startup parameter file by means of the SET-CODE statement are called “implicit routing codes”. Their effect is controlled by the system parameter NBIMPRCA. When NBIMPRCA=Y is specified, they are effective throughout the whole session, but when NBIMPRCA=N is specified, they only apply until “System ready” and after system termination (successful shutdown).
Implicit routing codes basically work only like routing codes (for distributing messages) and not like authorization codes (for input of commands).
At system startup and after system termination
The main console receives all messages of the routing codes which were defined as implicit routing codes.
During the session (until shutdown)
When NBIMPRCA=Y is specified, the main console receives all messages of the implicit routing codes, provided these are not explicitly assigned to any other console.
A console can be:
operable / inoperable
active / inactive
authorized / unauthorized
A console is inoperable when it is managed system-internally as “defective”. This also applies to non-existent devices or devices in the DETACHED state. All other consoles are operable.
An operable console is activated by the SET-LOGON-PARAMETERS command and deactivated by the EXIT-JOB command.
An active console receives various authorization codes through the REQUEST-OPERATOR-ROLE command, which represent its authorization scope. Active consoles are always authorized for the input of @ commands.
Inactive consoles only have the following commands at their disposal:
SET-LOGON-PARAMETERS and SHOW-PENDING-MSG.The first console on which the SET-LOGON-PARAMETERS command was successfully entered receives the “Main console” attribute. It is now active but is only authorized for the input of @ commands.
The “Main console” function can only be switched over if the previous main console agrees.
If the current main console fails, the system automatically switches the “Main console” function over to a different console; it searches first in the set of active consoles and then in the set of operable consoles. An EXIT-JOB command from the main console also initiates this search.
With ASR authorization, the main console can create any required assignment of routing codes to user programs with generated authorization names.
Notes
Assigning a console to the functional area “@” has no real effect.
It is also possible to have a routing/authorization code (e.g. A, C, R, U) that is not assigned to a console. When routing codes are not assigned to a console, the following occurs:
Messages requiring no response are not output at any console. They are only written to the logging file (this is always the case with the @ code).
Messages requiring a response from the operator are output at the main console. Even messages routed via the @ code are output at the main console if they require an operator response.
With NBCONOPI=N, commands bearing authorization codes of this type that are not assigned to any console are accepted by the system if issued from the main console.
Exception: commands with the code @ are always accepted.