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:
ENVIRONMENT
Use of this parameter and its qualifiers establishes a context for
subsequent commands.
format:
SET ENVIRONMENT[/qualifiers=[value]]
Additional information available:
qualifiers
Additional information available:
/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
Additional information available:
/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:
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.