Preparing to use $VMCONS

The use of $VMCONS for VM2000 operation is optional. If the recommended administration and operating media are used (see section "VM2000 Operating strategy"), the measures described in this section do not have to be carried out.

$VMCONS connects to UCON via the system application $CONSOLE. To operate correctly, $VMCONS requires authorization to send VM2000 commands to UCON and to receive the corresponding messages from UCON. This means that it is necessary to define an operator ID and an operator role for $VMCONS using BS2000 commands in the monitor system and to link these to each other.

1. Set up an operator ID for $VMCONS used as the user ID in the user catalog of the home pubset (privilege: USER-ADMINISTRATION):

   /ADD-USER USER-IDENTIFICATION=VMADMIN/<name 1..8>,
          PROTECTION-ATTRIBUTE=*PARAMETERS(
            LOGON-PASSWORD=*NONE/<c-string 1..8>),

   The user ID must be specified as the parameter VMCONS-OPERID in the parameter file of the VM2-MON subsystem (default value: VMADMIN), see "Setting up the VM2000 monitor".
   The password for the user ID must be specified as the parameter VMCONS-OPERID-PASSWORD in the parameter file of the VM2-MON subsystem (default value: *NONE). Hexadecimal passwords are not permitted.

   If the software product SECOS is used, (see [11]) /MODIFY-LOGON-PROTECTION can be used to restrict access to VMCONS-OPERID to programs only (privilege: USER-ADMINISTRATION):
   /MODIFY-LOGON-PROTECTION USER-IDENTIFICATION=VMADMIN/<name 1..8>,
                         DIALOG-ACCESS=*NO,
                         BATCH-ACCESS=*NO,
                         OPERATOR-ACCESS-PROG=*YES

2. Set up the operator role for $VMCONS. This is a set of routing codes describing the range of tasks to be performed by $VMCONS (privilege: SECURITY-ADMINISTRATION):

   /CREATE-OPERATOR-ROLE OPERATOR-ROLE=VM2000/<name 1..8>,
                      ROUTING-CODE=9,PUBSET=*HOME

   The name of the operator role must be specified as the parameter VMCONS-OPERATOR-ROLE in the parameter file of the VM2-MON subsystem (default value: VM2000). Routing code “9” covers all VM2000 commands and messages.

   To avoid undesirable reactions, use only routing code “9”.

3. Assign the $VMCONS operator role to the $VMCONS operator ID (privilege: SECURITY-ADMINISTRATION):

   /MODIFY-OPERATOR-ATTRIBUTES USER-IDENTIFICATION=VMADMIN/<name 1..8>,
                            ADD-OPERATOR-ROLE=VM2000/<name 1..8>,
                            PUBSET=*HOME

   To avoid undesirable reactions, do not assign any further operator roles to the operator ID.