The CONFIGURATION command is used to inspect and modify various
 parameters controlling the software configuration and execution of
 the running system or cluster.

 Format:

 CONFIGURATION [subcommand] [parameter] [value or qualifier]

Additional information available:

SETSHOW

 The CONFIGURATION subcommand SET modifies the value of a parameter.
 Its function is dependent on the particular parameter.

Additional information available:

CLUSTER_AUTHORIZATIONTIME

 The CLUSTER_AUTHORIZATION parameter updates records in SYS$SYSTEM:
 CLUSTER_AUTHORIZE.DAT. The file is created if it does not exist.

 Format: CONFIGURATION SET CLUSTER_AUTHORIZATION

Additional information available:

Parameter qualifiers

Additional information available:

/GROUP_NUMBER/PASSWORD

 /GROUP_NUMBER=n

 This specifies the Cluster group number. It must be in the range of
 1-4095 and 61440-65535. If omitted, the group number is not changed.
 If SYS$SYSTEM:CLUSTER_AUTHORIZE.DAT does not exist, the group number
 must be specified.  SYSPRV and OPER privileges are required on each
 of the selected nodes.  Use the SET PROFILE/PRIV=(SYSPRV,OPER)
 command to set these privileges. Requires appropriate file access
 privilege to SYS$SYSTEM:CLUSTER_AUTHORIZE.DAT.

 /PASSWORD=password

 This specifies the password for cluster access. It must be from
 1 to 31 characters in length, and must be composed of
 alphanumeric characters, dollar signs, and underscores. If the
 password value is omitted, the password is not changed. If
 SYS$SYSTEM:CLUSTER_AUTHORIZE.DAT does not exist, a password must
 be supplied.  SYSPRV and OPER privileges are required on each of
 the selected nodes.  To set these privileges use the command
 SET PROFILE/PRIV=(SYSPRV,OPER).

 4 Examples

 1.  SYSMAN> CONFIGURE SET CLUSTER_AUTHORIZATION/PASSWORD=trigger -
     _SYSMAN> /GROUP_NUMBER=64464

     This command will set the cluster password for the currently
     selected cluster to "TRIGGER" and modify the GROUP NUMBER of
     the currently selected cluster to the value 64464.

 The TIME parameter is used to update the system time.

 Format:
   CONFIGURATION TIME [time]

 If "time" is not specified, the interval system clock is
 automatically reset according to the time-of-year clock. LOG_IO,
 SYSLCK, and OPER privileges are required for this command.  Use
 the SET PROFILE/PRIV=(LOG_IO,SYSLCK,OPER) command to set these
 privileges.

Additional information available:

timeRestrictionsCluster-wide timeExamples

 A date-time value in the format:   [dd-mmm-yyyy[:]] [hh:mm:ss.cc]

 The hyphens, colons, and period are required delimiters. Delimit
 the date and time, when both are specified, with a colon.

Additional information available:

time-date format information

 A date in the format: DAY-MONTH-YEAR, or
 a time in the format: HOUR:MINUTE:SECOND.HUNDREDTH, or both.
 DAY       an integer in the range 1 through 31.
 MONTH     JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC.
 YEAR      an integer in the range 1858 through 9999.
 HOUR      an integer in the range 0 through 23.
 MINUTE    an integer in the range 0 through 59.
 SECOND    an integer in the range 0 through 59.
 HUNDREDTH an integer in the range 0 through 99.

 Note that the time-of-year clock is optional for some
 processors. For further information about the time-of-year
 clock, see the VAX Hardware handbook.

 If the SYSMAN environment is /CLUSTER, then special processing
 is employed to insure that all processors in the cluster are set
 to the same time: Due to communications and processing delays,
 the command cannot synchronize clocks exactly; the variation is
 typically less than a few hundredths of a second. If the command
 cannot verify that the time was set to within one half second of
 the specified time, you receive a warning message that names the
 node which failed to respond quickly enough.



 As a result of slight inaccuracies in each interval clock, times
 on various members of a VAXcluster tend to drift apart.  See the
 examples section for a command procedure that can automatically
 synchronize system times in a VAXcluster.

 1.   $ SYNCH_CLOCKS:
      $    RUN SYS$SYSTEM:SYSMAN
             set environment/cluster
             configuration set time
           exit
      $    WAIT 6:00:00
      $    GOTO SYNCH_CLOCKS

 This procedure sets the time on all VAXcluster nodes to
 the value obtained from the local time-of-year clock,
 waits 6 hours, then resets the time for the cluster again.


 2. SYSMAN> CONFIGURATION SET TIME 08:00:00.00

 This command will set the time on the selected nodes to
 8:00AM.

 The CONFIGURATION SHOW subcommand displays the value of a
 parameter.  Its function is dependent on the parameter.

 format:
   CONFIGURATION SHOW parameter

Additional information available:

CLUSTER_AUTHORIZATIONTIME

Command qualifiersExamples

Additional information available:

/OUTPUT

 /OUTPUT[=file-spec]

 Specifies that the output from the execution of this command is to
 written to the file specified, or to "[default_directory]SYSMAN.LIS"
 if no filespec is given.

 Displays the group number of the cluster authorization file for all
 systems in the environment.  If the environment is CLUSTER, then only
 the first node's group is displayed, and warning messages are given
 for nodes in the cluster whose group numbers and/or passwords are
 different.

 Displays the current system time.

 1. SYSMAN> CONFIGURATION SHOW TIME
    System time on node LONDON: 11-OCT-1987 20:01:32.22
    System time on node ROME: 11-OCT-1987 20:01:31.42
    System time on node PARIS: 11-OCT-1987 20:01:31.33
    SYSMAN>

    This command displays the time on each of the selected nodes.






 2. SYSMAN> CONFIGURATION SHOW CLUSTER_AUTHORIZATION
    Node LONDON:   Cluster group number 64664
    SYSMAN>

    This command lists the cluster group number of the first node
    to respond.  If any of the other nodes has a different Cluster
    group number, a warning message is displayed.