HP OpenVMS Systems Documentation
OpenVMS System Management Utilities Reference Manual
SYSMAN> DEFINE/KEY/TERMINATE _Key name: KP0 _Translation: "SET ENVIRONMENT/NODE=(NODE21,NODE22,NODE23)"
Once the key is defined, you can press keypad 0, and SYSMAN executes
the SET ENVIRONMENT command. Note that key definitions are lost each
time that you exit from SYSMAN, unless you define them in the SYSMAN
initialization file. (See Section 21.1.2 for more information about
executing commands from an initialization file.)
21.1.2 Executing Commands from an Initialization File
You can create an initialization file that SYSMAN will use each time you invoke the utility. In the SYSMAN initialization file, you can perform tasks such as defining keys and setting the SYSMAN environment.
The default file specification for the SYSMAN initialization file is SYS$LOGIN:SYSMANINI.INI. If you want your SYSMAN initialization file to have a different file specification, you must define the logical name SYSMANINI to point to the location of the file.
The following example is a sample initialization file in which several keys are defined:
$ TYPE SYSMANINI.INI DEFINE/KEY/TERMINATE KP0 "SET ENVIRONMENT/CLUSTER/NODE=(NODE21,NODE22,NODE23,NODE24)" DEFINE/KEY/TERMINATE KP1 "CONFIGURATION SHOW TIME" DEFINE/KEY/TERMINATE KP2 "SHOW PROFILE" . . .
The System Management utility (SYSMAN) centralizes system management, enabling you to manage nodes or clusters from one location.
None.Usage Summary To invoke SYSMAN, enter the following command at the DCL prompt:
$ RUN SYS$SYSTEM:SYSMAN
SYSMAN displays the following prompt at which you can enter SYSMAN commands using the standard rules of DCL syntax:
As an alternative, you can enter the RSX command MCR, which expands to RUN SYS$SYSTEM:
$ MCR SYSMAN
With 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.
SYSMAN has the following restrictions:
This section describes the SYSMAN commands and demonstrates their use. Table 21-1 summarizes each command as follows.
|@ (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.|
|CLASS_SCHEDULE ADD||Creates a new scheduling class.|
|CLASS_SCHEDULE DELETE||Deletes a scheduling class.|
|CLASS_SCHEDULE MODIFY||Modifies the characteristics of a scheduling class.|
|CLASS_SCHEDULE RESUME||Resumes a scheduling class that has been suspended.|
|CLASS_SCHEDULE SHOW||Displays the characteristics of a scheduling class.|
|CLASS_SCHEDULE SUSPEND||Temporarily suspends a scheduling class.|
|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 about SYSMAN commands.|
|++ IO AUTOCONFIGURE||Automatically identifies and configures all hardware devices attached to a system.|
|++ IO CONNECT||Connects devices and loads device drivers.|
|++ IO FIND_WWID||Detects all previously undiscovered tapes and medium changers.|
|++ IO LOAD||Loads an I/O driver.|
|++ IO REBUILD||Rebuilds all device configuration tables.|
|++ IO REPLACE_WWID||Replaces one worldwide identifier (WWID) with another.|
|++ IO SCSI_PATH_VERIFY||Checks each SCSI and FC path in the system to determine whether the attached device has been changed; if it has, the SCSI or FC path in the IO database is disconnected.|
|++ 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.|
|RESERVED_MEMORY ADD||On Alpha systems, adds an entry to the Reserved Memory Registry data file.|
|RESERVED_MEMORY FREE||On running Alpha systems, frees reserved memory.|
|RESERVED_MEMORY MODIFY||On Alpha systems, allows you to modify an existing entry in the Reserved Memory Registry data file.|
|RESERVED_MEMORY REMOVE||On Alpha systems, removes a reserved memory entry from the Reserved Memory Registry data file.|
|RESERVED_MEMORY SHOW||On Alpha systems, displays the memory reservations on the running system.|
|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.
filespecSpecifies 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.
$ 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>
This example shows how to create a command procedure that sets the SYSMAN environment to the local node, and displays the current profile. These commands execute when you enter the @ENV.COM command.
$ CREATE TIME.COM SET ENVIRONMENT/CLUSTER CONFIGURATION SHOW TIME[Ctrl/Z] $ MCR SYSMAN SYSMAN> @TIME System time on node NODE23: 19-JUN-2000 13:32:19.45 System time on node NODE24: 19-JUN-2000 13:32:27.79 System time on node NODE25: 19-JUN-2000 13:32:58.66
This example shows how to create and execute a command procedure that shows the current date and time for all the nodes in the cluster.
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
deviceSpecifies 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.
userSpecifies 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.
/PORTChecks 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.
/PROXYChecks that the device name is in the NODE::USERNAME format.
/LOGDisplays 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.
SYSMAN> ALF ADD TTA3 JBERGERON SYSMAN> ALF ADD "MN34C3/LC-1-2" FMARTIN /PORT
In this example, the first command assigns terminal TTA3 to user JBERGERON. The second command assigns port MN34C3/LC-1-2 to user FMARTIN.
SYSMAN> ALF ADD VMS:.ZKO.VMSORG.SYSMAN.CLIENT1::SYSTEM FOOBAR
In this example, VMS:.ZKO.VMSORG.SYSMAN.CLIENT1::SYSTEM is the value for the device parameter, which is assigned to FOOBAR.