![[Digital logo]](../../IMAGES/DIGITAL-LOGO.GIF){kind=logo}
![[HR]](../../IMAGES/REDBAR.GIF)
The System Management utility (SYSMAN) centralizes system management, enabling you to manage nodes or clusters from one location.
RUN SYS$SYSTEM:SYSMAN
None.
To invoke SYSMAN, enter the following command at the DCL prompt:$ RUN SYS$SYSTEM:SYSMANSYSMAN displays the following prompt at which you can enter SYSMAN commands using the standard rules of DCL syntax:
SYSMAN>As an alternative, you can enter the RSX command MCR, which expands to RUN SYS$SYSTEM:
$ MCR SYSMANWith the MCR command, you can invoke SYSMAN and supply a command in one command string. With any SYSMAN command invoked in this way (except SET ENVIRONMENT), SYSMAN executes the command string and exits. After executing a SET ENVIRONMENT command, the utility returns the SYSMAN> prompt.
To exit from SYSMAN and return to the DCL command level, enter the EXIT command at the SYSMAN> prompt or press Ctrl/Z.
Note
SYSMAN has the following restrictions:
- You must have the OPER privilege on the local node and authorization for the OPER or SETPRV privilege on any remote nodes in the management environment.
You must also have the privileges required by individual commands, as each command in this chapter describes. To determine which privileges are required for DCL commands or for system management utilities, refer to the OpenVMS DCL Dictionary or the appropriate utility reference part of this manual.
- You cannot run SYSMAN from a batch job in any environment that requires a password.
- Some DCL commands, such as SHOW SYSTEM/CLUSTER, SET CLUSTER/QUORUM, MOUNT/CLUSTER, and some forms of the REPLY command, operate clusterwide by design. These commands should not be run using SYSMAN, unless the environment has been set to a single node.
- If a SYSMAN user running with more than 125 total rights attempts to issue a SYSMAN command to a remote node within a cluster, the following error message is displayed:
SMI-E-RIGHTSLIM, Rights limit exceeded.
Note that this rights limitation includes a minimum of three identifiers that are granted during login when the process rights list is created:
- A UIC identifier
- A system identifier
- Depending upon the environment in which the process is operating, at least one environmental identifier
Users who want to run SYSMAN must have either one of the following:
- A separate account with no more than 125 rights
- Enough identifiers removed from their current account so that the total number of rights falls within the appropriate range
| Command | Function |
|---|---|
| @ (Execute Procedure) | Requests that SYSMAN read subsequent command input from the specified file or device. |
| ALF ADD | Adds a record to the automatic login facility (ALF) database. |
| ALF REMOVE | Deletes one or more records from the automatic login facility (ALF) database. |
| ALF SHOW | Displays one or more records from the automatic login facility (ALF) database. |
| ATTACH | Transfers control from your current process to the specified process in your job. |
|
CONFIGURATION SET
CLUSTER_AUTHORIZATION |
Updates security data in a local area cluster. |
| CONFIGURATION SET TIME | Updates system time. |
| CONFIGURATION SHOW CLUSTER_AUTHORIZATION | Displays cluster security data. |
| CONFIGURATION SHOW TIME | Displays current system time. |
| DEFINE/KEY | Defines a key to execute a SYSMAN command |
| DISKQUOTA ADD | Adds an entry to a disk quota file. |
| DISKQUOTA CREATE | Creates and enables a disk quota file for a volume that does not contain one. |
| DISKQUOTA DELETE | Removes an entry from a quota file. |
| DISKQUOTA DISABLE | Suspends disk quota operations on a volume. |
| DISKQUOTA ENABLE | Resumes disk quota operations on a volume. |
| DISKQUOTA MODIFY | Changes an entry in the quota file or adjusts the default quota and overdraft values. |
| DISKQUOTA REBUILD | Reconstructs the disk usage counts for all entries. |
| DISKQUOTA REMOVE | Removes an entry from a disk quota file. |
| DISKQUOTA SHOW | Displays disk quotas and usage counts. |
| DO | Executes a DCL command or DCL command procedure. |
| EXIT | Terminates the SYSMAN session and returns control to the DCL command level. |
| HELP | Provides information on SYSMAN commands. |
| ++ IO AUTOCONFIGURE | Automatically identifies and configures all hardware devices attached to a system. |
| ++ IO CONNECT | Connects devices and loads device drivers. |
| ++ IO LOAD | Loads an I/O driver. |
| ++ IO REBUILD | Rebuilds all device configuration tables. |
| ++ IO SET EXCLUDE | Sets the permanent exclusion list to be used when configuring devices automatically. |
| ++ IO SET PREFIX | Sets the prefix used to build the IOGEN Configuration Building Module (ICBM) names. |
| ++ IO SHOW BUS | Lists the system's buses, node numbers, bus names, TR numbers, and base CSR addresses on the system. |
| ++ IO SHOW DEVICE | Displays information about devices, their drivers, and their I/O databases. |
| ++ IO SHOW EXCLUDE | Displays the permanent exclusion list used in the autoconfiguration of devices. |
| ++ IO SHOW PREFIX | Displays the current prefix list used to produce the IOGEN Configuration Building Module (ICBM) names. |
| LICENSE LOAD | Activates a license that is registered in the LICENSE database. |
| LICENSE UNLOAD | Deactivates a license that is registered in the LICENSE database. |
| PARAMETERS DISABLE CHECKS | Inhibits range checks on system parameter values specified in subsequent PARAMETERS SET commands. |
| PARAMETERS ENABLE CHECKS | Ensures that range checks are in effect. Enables range checks after a PARAMETERS DISABLE CHECKS command. |
| PARAMETERS SET | Modifies the value of a system parameter in the work area. |
| PARAMETERS SHOW | Displays the values of system parameters in the work area, plus the default, minimum, and maximum values of the parameters and their units of measure. |
| PARAMETERS USE | Initializes the current work area with system parameter values and the name of the site-independent command procedure. |
| PARAMETERS WRITE | Writes the system parameter values and the name of the site-independent command procedure from the work area to a parameter file, the current system parameter file, or the active system in memory. |
| SET ENVIRONMENT | Establishes a management context for subsequent SYSMAN commands. |
| SET PROFILE | Modifies the default device and directory and the current privileges for the current management environment, and allows you to set DCL verification for future DO commands. |
| SET TIMEOUT | Establishes the amount of time that SYSMAN waits for a node to respond. |
| SHOW ENVIRONMENT | Displays the current command context. |
| SHOW KEY | Displays key definitions. |
| SHOW PROFILE | Displays the default device and directory and the current privileges. |
| SHOW TIMEOUT | Displays the current timeout period. |
| SHUTDOWN NODE | Shuts down one or more nodes simultaneously with a single command line. |
| SPAWN | Creates a subprocess of the current process, where the context of the subprocess is copied from the current process. |
| STARTUP ADD | Adds an executable file or command procedure to the startup database. |
| STARTUP DISABLE | Prevents a component of the startup database from executing on one or more nodes in the environment. |
| STARTUP ENABLE | Allows a component of the startup database to execute. |
| STARTUP MODIFY | Edits a record in the startup database describing how a startup component executes. |
| STARTUP REMOVE | Removes one or more components from the startup database. |
| STARTUP SET DATABASE | Determines the default database. |
| STARTUP SET OPTIONS | Displays startup status. |
| STARTUP SHOW | Displays the name of the current startup database or its contents. |
| SYS_LOADABLE ADD | Adds an executive loaded image to the set of images loaded at boot time. |
| SYS_LOADABLE REMOVE | Removes an executive loaded image from the set of images loaded at boot time. |
Requests that SYSMAN read subsequent command input from the specific file or device.
@ filespec
filespec
Specifies either the input device or the command procedure you want to execute. The default file type is .COM. You cannot use wildcard characters in the file specification.
Use the execute procedure command to execute a command procedure containing SYSMAN commands. To execute the command procedure, invoke SYSMAN, place the at sign (@) command at the beginning of a command line, then specify the file name of the command procedure.The command procedure can contain any valid SYSMAN command.
Examples
$ CREATE ENV.COM
SET ENVIRONMENT
SHOW PROFILE [Ctrl/Z]
$ MCR SYSMAN
SYSMAN> @ENV.COM
%SYSMAN-I-DEFDIR, default directory on node -- SYS$SYSROOT:[SYSMGR]
%SYSMAN-I-DEFPRIV, default process privileges on node --
CMKRNL
CMEXEC
SYSNAM
.
.
.
GRPPRV
READALL
SECURITY
SYSMAN>
$ CREATE TIME.COM SET ENVIRONMENT/CLUSTER CONFIGURATION SHOW TIME [Ctrl/Z] $ MCR SYSMAN SYSMAN> @TIME System time on node NODE23: 19-JUN-1996 13:32:19.45 System time on node NODE24: 19-JUN-1996 13:32:27.79 System time on node NODE25: 19-JUN-1996 13:32:58.66
Adds a new record to the automatic login facility (ALF) database. You can also create records for proxy accounts.Requires read (R) and write (W) access to the SYSALF database (SYS$SYSTEM:SYSALF.DAT by default).
ALF ADD device user
device
Specifies the terminal name or port name that you want to assign to a user name. The parameter device must be a terminal name if you do not specify qualifiers on the command line, and can be either a logical name or an abbreviated device name. This parameter accepts a maximum of 63 characters, including devices for proxy accounts.user
Specifies the user name of the account that you want to assign to a particular terminal or port.
/TERMINAL (default)
Checks whether the device name you specified is a terminal on the target system. The parameter device can be a logical name or an abbreviated device name, which SYSMAN translates to a full device name./PORT
Checks whether the device name you specified is a valid port. If the port name contains special characters, such as a slash (/), or if it contains lowercase letters that you want to preserve, you must enclose the port name within quotation marks (" ").Be aware that anything within quotation marks is written literally to the ALF database file. For example, if the actual port name contains uppercase letters as well as special characters, be sure to specify uppercase letters within the quotation marks. Otherwise, a mismatch will occur between the actual port name and what is specified in the SYSALF.DAT file.
/PROXY
Checks that the device name is in the NODE::USERNAME format./LOG
Displays the device names and user names as they are added to the ALF database.
You can use the ALF ADD command to associate a terminal or port with a particular user name. This will enable certain users to log in to certain terminals or ports without specifying a user name.The ALF ADD command adds a new record to the ALF database.
Examples
SYSMAN> ALF ADD TTA3 JBERGERON SYSMAN> ALF ADD "MN34C3/LC-1-2" FMARTIN /PORT
SYSMAN> ALF ADD VMS:.ZKO.VMSORG.SYSMAN.CLIENT1::SYSTEM FOOBAR
Removes one or more records from the ALF database.Requires read (R) and write (W) access to the SYSALF database (SYS$SYSTEM:SYSALF.DAT).
ALF REMOVE device
device
Specifies the terminal name or port name whose record you want to remove from ALF. You can use wildcard characters in the terminal name or port name. For example, if you specify the device TTA*, the system removes all records that start with the string TTA. The system does not, however remove any records that start with the string <nodename>$TTA, where <nodename> is the system's SCSNODE name.If you omit either of the wildcard characters and enter a REMOVE command, SYSMAN attempts to match the device name exactly. If more than one record matches the criteria, SYSMAN returns an error message.
/USERNAME=user
Enables you to remove a record in ALF by specifying a user name rather than a terminal name or port name. You can use wildcard characters with the /USERNAME qualifier./CONFIRM
Displays a message asking you to verify that you want to remove the record./LOG
Displays each device name and user name after it has been removed from the ALF database.
The ALF REMOVE command removes one or more records from the ALF database.
Examples
SYSMAN> ALF REMOVE _TTA3: SYSMAN> ALF REMOVE /USERNAME=SMITHSON
SYSMAN> ALF REMOVE <nodename>$TTA* SYSMAN> ALF REMOVE *TTA*
SYSMAN> REMOVE TTA
%SYSMAN-E-ALFWILCRDREQ, more than one record might match - Wildcard or unit number of device required.
Note
Digital recommends that you use caution when issuing REMOVE commands from Version 6.1 or lower SYSMAN clients to Version 6.2 or higher systems.
SYSMAN> SET ENVIRONMENT/NODE=FOOBAR ! FOOBAR runs OpenVMS Version 6.2
%SYSMAN-I-ENV, current command environment:
Individual nodes: FOOBAR
Username SYSTEM will be used on nonlocal nodes
SYSMAN> ALF REMOVE TTA ! Does not produce an error message
SYSMAN>
%SYSMAN-I-NODERR, error returned from node FOO -SMI-E-ALFNOMATCH, no records matched search criteriaThis is due to incorrect processing of wildcards prior to OpenVMS Version 6.2.
Displays one or more records from the ALF database.Requires read (R) and write (W) access to the SYSALF database (SYS$SYSTEM:SYSALF.DAT).
ALF SHOW [device]
[device]
Specifies the terminal name or port name whose record you want to display. You can use wildcard characters in the terminal name or port name. Certain restrictions in wildcard matching of ALF records exist, as shown in the examples section.
/USERNAME=user
Displays the records held by the specified user. You can use wildcard characters with this qualifier./OUTPUT[=filespec]
Directs the output of the command to a file. If you do not include a file specification with this qualifier, SYSMAN writes the output to the file SYSMAN.LIS in your default directory.
The ALF SHOW command displays one or more records in the ALF database.
Examples
SYSMAN> ALF SHOW TTA* /USERNAME=MANESS /OUTPUT=ALF.TXT
SYSMAN> ALF SHOW TTA*
SYSMAN> ALF SHOW TTA
SYSMAN> ALF SHOW *TTA
SYSMAN> ALF SHOW *TTA*
Transfers control from your current process (which then hibernates) to the specified process in your job.The ATTACH and SPAWN commands cannot be used if your terminal has an associated mailbox.
ATTACH [process-name]
process-name
Specifies the name of a parent process or a spawned subprocess to which control passes. The process must already exist, be part of your current job tree, and share the same input stream as your current process. However, the process cannot be your current process or a subprocess created with the /NOWAIT qualifier.Process names can contain from 1 to 15 alphanumeric characters. If a connection to the specified process cannot be made, an error message is displayed.
/PARENT
Enables you to attach to the parent process. If no parent process exists, you receive an error message.
The ATTACH command connects your input stream to another process. You can use the ATTACH command to change control from one subprocess to another subprocess or to the parent process.When you enter the ATTACH command, the parent process goes into hibernation and your input stream connects to the specified destination process. You can use the ATTACH command to connect to a subprocess that is part of a current job (left hibernating as a result of the SPAWN/WAIT command or another ATTACH command) as long as the connection is valid. No connection can be made to the current process, to a process that is not part of the current job, or to a process that does not exist. If you attempt any of these connections, you receive an error message.
You can also use the ATTACH command in conjunction with the SPAWN/WAIT command to return to a parent process without terminating the created subprocess. See the description of the SPAWN command for more details.
$ SPAWN %DCL-S-SPAWNED, process SYSTEM_1 spawned %DCL-S-ATTACHED, terminal now attached to process SYSTEM_1 $ RUN SYS$SYSTEM:SYSMAN SYSMAN> ATTACH SYSTEM %DCL-S-RETURNED, control returned to process SYSTEM $
In this example, the SPAWN command creates a subprocess (SYSTEM_1). After you invoke SYSMAN and enter the ATTACH command, you transfer the terminal's control back to the parent process (SYSTEM).
6048P052.HTM OSSG Documentation 26-NOV-1996 12:43:38.52
Copyright © Digital Equipment Corporation 1996. All Rights Reserved.