Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

ALF

CONFIGURATION

DISKQUOTA

DO

EXIT

LICENSE

PARAMETERS

STARTUP

Restrictions

SET parameter

SHOW parameter

ENVIRONMENT

PROFILE

TIMEOUT

Examples

Restrictions

qualifiers

/CLUSTER

/NODE

/USERNAME

qualifiers

/DEFAULT

/PRIVILEGES

ENVIRONMENT

PROFILE

TIMEOUT

Examples

MCR SYSMAN — VMS 5.2

Additional information available:

ALFCONFIGURATIONDISKQUOTADOEXIT
LICENSEPARAMETERSSTARTUP

RestrictionsSET parameterSHOW parameter

Restrictions

  1. SYSMAN will not read its input from an indirect command file
     (i.e. you cannot respond @filename to the SYSMAN> prompt).

  2. You may run SYSMAN in a batch job or a command procedure, but it
     will not read remote passwords if SYS$COMMAND is not a terminal,
     hence environments outside the current security perimeter cannot
     be processed in this way.

  3. SYSMAN does not support keypad commands or initialization files.

  4. The user's LOGIN.COM is NOT executed on non-local systems.

SET parameter

 The SET command allows the user to select the target nodes, the USERNAME,
 the default directories, the process privileges, and command timeout
 period for use in executing subsequent commands on local and remote systems.

Additional information available:

ENVIRONMENTPROFILETIMEOUT

ExamplesRestrictions

ENVIRONMENT

 Use of this parameter and its qualifiers establishes a context for
 subsequent commands.

 format:

    SET ENVIRONMENT[/qualifiers=[value]]

Additional information available:

qualifiers

qualifiers

Additional information available:

/CLUSTER/NODE/USERNAME

/CLUSTER

 /CLUSTER

 This qualifier specifies that all subsequent commands affect all
 cluster members.  In the absence of other qualifiers, the local
 cluster is the cluster affected.

 If used in conjunctions with the NODE qualifier, the environment
 defined is clusterwide on the cluster of which the specified remote
 nodename is a member, or for which the remote nodename is the cluster
 alias. However, CLUSTER cannot be used in conjunction with a list of
 nodes specified with the NODE qualifier.

/NODE

 /NODE=(node, node,...)

 This qualifier specifies that all subsequent commands affect the
 listed node(s).  The node may be a specific system name or a cluster
 alias.  If a list of nodes is provided, then the commands affect all
 the nodes in the list.  The nodes need not be members of the same
 cluster, and the list must be enclosed in parentheses and separated
 by commas.  If a list is provided, it may not be used in conjunction
 with the CLUSTER qualifier.

/USERNAME

 /USERNAME=username

 This specifies that the given username is to be used for access
 control purposes on the nonlocal systems.  If USERNAME is given, a
 password will be prompted for using a noecho read.  The current
 username is used if USERNAME is not specified.  The password will be
 prompted for in any case if the environment is outside the local
 cluster (i.e., a NODE qualifier was given).  SYSMAN recognizes the
 case where NODE specifies either the local node or a member of the
 local cluster and uses local cluster access control in these cases.

PROFILE

 The SET PROFILE command allows the device/directory and the current
 privileges to be changed.

 Format:

   SET PROFILE[/DEFAULT=device:<directory>][/PRIVILEGES=(priv1[,priv2...])]

 The profile is reset to UAF defaults when a new SET ENVIRONMENT
 command is issued.  The privileges, default device/directory,
 identifiers held, UIC, account name, and UAF flags as specified in
 the user's remote system UAF record are normally established for all
 remote systems included in the environment. Privileges can be set or
 cleared.  In order to set privileges the USERNAME must be authorized
 for those privileges on the selected nodes.

Additional information available:

qualifiers

qualifiers

Additional information available:

/DEFAULT/PRIVILEGES

/DEFAULT

 /DEFAULT=device:<directory>

 This qualifiers allows the user to specify the default
 device/directory to be used on all local and remote systems.

/PRIVILEGES

 /PRIVILEGES=(priv1,priv2,...)

 This qualifier allows the user to set or clear privileges on all
 local and remote systems specified in the SET ENVIRONMENT command.
 Default privileges are those specified in the user's UAF record on
 the relevant node.  If a list of privileges is specified, it must
 be comma separated and enclosed in parentheses.  A user must be
 authorized for a privilege on the relevant nodes in order to set a
 privilege.

TIMEOUT

 The SET TIMEOUT command establishes the amount of time SYSMAN waits
 for a node to respond.

 Format:

   SET TIMEOUT time

 Specify a delta time value to determine how long SYSMAN waits for a
 node to respond to a command issued from the current process.  Once
 the time period expires, SYSMAN proceeds to execute the command on
 the next node in the environment or returns if no more nodes remain
 for the command to be processed on.  By default there is no timeout
 period and SYSMAN waits indefinitely.

Examples

 SYSMAN> SET ENVIRONMENT/CLUSTER

 %SYSMAN-I-ENV, current command environment:
         Clusterwide on local cluster
         Username RONNIE        will be used on nonlocal nodes


 This command establishes the environment for subsequent commands to
 be all nodes of the current cluster.







 SYSMAN> SET ENVIRONMENT/NODE=(london,paris,rome)/USERNAME=ronnie

 %SYSMAN-I-ENV, current command environment
       Individual nodes: LONDON,PARIS,ROME
       Username RONNIE        will be used on nonlocal nodes


 This command establishes the environment to be the nodes LONDON,
 PARIS, and ROME.  These nodes can be local or remote, and do not need
 to be members of the same VAXcluster system.  Additionally, the
 username to be used on the listed nodes for the execution of
 subsequent commands is defined to be RONNIE.







 SYSMAN> SET ENVIRONMENT/CLUSTER/NODE=paris

 %SYSMAN-I-ENV, current command environment:
      Clusterwide on remote cluster PARIS
      Username RONNIE        will be used on nonlocal nodes

 This command establishes the environment to be all nodes of the
 cluster of which PARIS is a member, or of which PARIS is the cluster
 alias.


 SYSMAN> SET PROFILE/DEFAULT=work$:[ronnie]/PRIVILEGES=(sysnam,oper)

 This command establishes a default device/directory, and sets the
 SYSNAM and OPER privileges for the user on the currently selected
 nodes.  Subsequent SET ENVIRONMENT commands that modify the selected
 nodes reset these values to the UAF defaults on those systems.




 SYSMAN> SET TIMEOUT 00:00:30.00
 %SYSMAN-I-TIMEVAL, timeout value is 00:00:30.00
 SYSMAN> SET TIMEOUT 00:00:00.00
 %SYSMAN-I-TIMEVAL, timeout value is 00:00:00.00

 The first command establishes a timeout period of 30 seconds for this
 SYSMAN session.  The second command re-establishes that there is no
 timeout period.



Restrictions

 1. CLUSTER cannot be used in conjunction with a list of nodes
    specified with the NODE qualifier.

 2. If a list of privileges is specified, it must be comma separated
    and enclosed in parentheses.  A user must be authorized for a
    privilege on the relevant nodes in order to set a privilege.

 3. The user profile is reset to UAF defaults when a new SET
    ENVIRONMENT command is issued.

SHOW parameter

 The SHOW command allows the user to display current SYSMAN information
 such as the target nodes, the USERNAME, the default directories,
 the process privileges and the command timeout value.  This
 information is defined by the default SYSMAN environment or by using
 the SYSMAN SET command.

Additional information available:

ENVIRONMENTPROFILETIMEOUT

Examples

ENVIRONMENT

 Use of this parameter will produce the display of the current
 management environment.

 format:

    SHOW ENVIRONMENT

 An informational message will be displayed with the current
 command environment.  SYSMAN indicates if the environment is
 local or remote, limited to individual nodes or clusterwide.
 It also shows the current username.  The environment exists
 until you issue another SET ENVIRONMENT command or exit from
 SYSMAN.


PROFILE

 The PROFILE parameter displays the device/directory and the
 privileges being used in the current environment.

 Format:

   SHOW PROFILE

 The values displayed remain in effect until you change environments,
 enter another SET PROFILE command or exit from SYSMAN.

TIMEOUT

 The TIMEOUT parameter displays the amount of time SYSMAN waits
 for a node to respond.

 Format:

   SHOW TIMEOUT

 The delta time displayed is the amount of time that SYSMAN waits
 for a node to execute a SYSMAN command.  If the timeout value is
 exceeded SYSMAN proceeds to execute the command on the next node
 in the environment or returns if no more nodes remain for the
 command to be processed on.  By default there is no timeout
 period.

Examples

 SYSMAN> SHOW ENVIRONMENT
  %SYSMAN-I-ENV, current command environment:
         Clusterwide on local cluster
         Username RONNIE        will be used on nonlocal nodes


 This command shows the current environment is the local cluster.
 The user name RONNIE will be used on other nodes in the cluster.






 SYSMAN> SHOW ENVIRONMENT
 %SYSMAN-I-ENV, current command environment
       Individual nodes: LONDON,ARUBA
       At least one node is not in local cluster
       Username RONNIE        will be used on nonlocal nodes


 This command shows the current command environment consists
 of two nodes, at least one of which is not part of the local
 cluster.





 SYSMAN> SHOW ENVIRONMENT
 %SYSMAN-I-ENV, current command environment:
      Clusterwide on remote cluster PARIS
      Username RONNIE        will be used on nonlocal nodes

 This command shows the current environment is a nonlocal cluster
 of which PARIS is a member, or of which PARIS is the cluster
 alias.


 SYSMAN> SHOW PROFILE
 %SYSMAN-I-DEFDIR, default directory on node PARIS -- WORK:[RONNIE]
 %SYSMAN-I-DEFPRIV, process privileges on node PARIS --
         TMPMBX
         OPER
         NETMBX

 This command shows the default device/directory as well as the
 current privileges.



 SYSMAN> SHOW TIMEOUT
 %SYSMAN-I-TIMEVAL, timeout value is 00:00:30.00

 The SHOW TIMEOUT command displays the current timeout value in
 delta format.  In this example the timeout value is 30 seconds.

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026