MCR SYSMAN STARTUP — VMS 5.4-3
Additional information available:
ADDDISABLEENABLEMODIFYREMOVESETSHOW
ADD
Adds a component to the startup database.
Requires read (R) and write (W) access to the startup database.
Format
STARTUP ADD FILE filespec
Additional information available:
Parameter
FILE Directs SYSMAN to add a component to the startup database. SYSMAN modifies STARTUP$STARTUP_LAYERED by default. filespec Specifies which file to add to the startup database. Each component of the startup database must have a file type of COM or EXE and reside in SYS$STARTUP.
Qualifiers
Additional information available:
/CONFIRM/LOG/MODE/NODE/PARAMETER/PHASE
/CONFIRM
/CONFIRM
/NOCONFIRM (default)
Controls whether SYSMAN displays the file specification of each
file before adding it to the startup database and requests you to
confirm the addition. If you specify /CONFIRM, you must respond to
the prompt with
a Y (Yes) or a T (True) and press Return before the file is added.
If you enter anything else, such as N or NO, the requested file is
not added.
/LOG
/LOG
/NOLOG
Controls whether the STARTUP ADD command displays the file
specification of each file after it has been added.
/MODE
/MODE=mode
Specifies the mode of execution for the file. Valid modes include
DIRECT, SPAWN, BATCH, or ANY.
/NODE
/NODE=(node1,node2,...,nodex)
Names the nodes within the cluster that run the file during
startup. By default, a startup file executes on all nodes in the
cluster.
/PARAMETER
/PARAMETER=(P1:arg1,P2:arg2,...,P8:arg8)
Specifies the parameters that are to be passed to the file
during startup. Parameters that are omitted receive the default
parameters defined by the system parameter STARTUP_Pn.
/PHASE
/PHASE=phase-name
Indicates the phase within system startup when the file is to be
executed. Valid phases include LPBEGIN, LPMAIN, LPBETA, and END.
LPMAIN is the default.
Example
SYSMAN> STARTUP ADD FILE /MODE=DIRECT /PHASE=LPMAIN -
_SYSMAN> FOR$LPMAIN_043_STARTUP.COM
The STARTUP ADD command in this example adds a record to the
startup database that starts FORTRAN Version 4.3.
DISABLE
Prevents a file in the startup database from executing.
Requires read (R) and write (W) access to the startup database.
Format
STARTUP DISABLE FILE filespec
Additional information available:
Parameter
FILE Directs SYSMAN to disable a component of the startup database. SYSMAN modifies STARTUP$STARTUP_LAYERED by default. filespec Specifies the name of a component in the startup database. The startup file must reside in SYS$STARTUP and have a file type of COM or EXE. The wildcard characters % and * are permitted.
Qualifiers
Additional information available:
/CONFIRM
/CONFIRM
/NOCONFIRM (default)
Controls whether the STARTUP DISABLE command displays the file
specification of each file before disabling it in the startup
database and requests you to confirm that the file should be
disabled. If you specify /CONFIRM, you must respond to the prompt
with a Y (Yes) or a T (True) and press Return before the file
is disabled. If you enter anything else, such as N or NO, the
requested file is not disabled.
/LOG
/LOG
/NOLOG
Controls whether the STARTUP DISABLE command displays the file
specification of each file after it has been disabled.
/NODE
/NODE=(node1,node2,...,nodex)
Identifies nodes within the cluster that do not run the file
during startup. By default, the startup file is disabled on all
nodes in the cluster.
/PHASE
/PHASE=phase-name
Indicates the phase of system startup in which the specified file
normally executes. Valid phases include LPBEGIN, LPMAIN, LPBETA,
and END. LPMAIN is the default.
Example
SYSMAN> STARTUP DISABLE FILE /NODE=BELA FOR$LPMAIN_043_STARTUP.COM
The command in this example modifies the startup database so
that FORTRAN will not be installed on node BELA.
ENABLE
Allows a previously disabled file in the startup database to
execute during system startup.
Requires read (R) and write (W) access to the startup database.
Format
STARTUP ENABLE FILE filespec
Additional information available:
Parameter
FILE Directs SYSMAN to enable a component of the startup database. SYSMAN modifies STARTUP$STARTUP_LAYERED by default. filespec Specifies the name of the startup file that you are enabling. Wildcard characters are accepted.
Qualifiers
Additional information available:
/CONFIRM
/CONFIRM
/NOCONFIRM (default)
Controls whether the STARTUP ENABLE command displays the file
specification of each file before enabling it in the startup
database and requests you to confirm that the file should be
enabled. If you specify /CONFIRM, you must respond to the prompt
with a Y (Yes) or a T (True) and press Return before the file
is enabled. If you enter anything else, such as N or NO, the
requested file is not enabled.
/LOG
/LOG
/NOLOG
Controls whether the STARTUP ENABLE command displays the file
specification of each file after it has been enabled.
/NODE
/NODE=(node1,node2,...,nodex)
Names nodes within the cluster where the file should be enabled.
By default, the startup file is enabled on all nodes.
/PHASE
/PHASE=phase-name
Indicates the phase within system startup when the specified file
is to be enabled. Valid phases include LPBEGIN, LPMAIN, LPBETA,
and END. LPMAIN is the default.
Example
SYSMAN> STARTUP ENABLE FILE /NODE=ZURICH FOR$LPMAIN_043_STARTUP.COM
The command in this example modifies the startup database. Node
ZURICH will have FORTRAN Version 4.3 installed at startup.
MODIFY
Changes information associated with a startup file in the startup
database.
Requires read (R) and write (W) access to the startup database.
Format
STARTUP MODIFY FILE filespec
Additional information available:
Parameter
FILE Directs SYSMAN to modify a record in the startup database. SYSMAN modifies STARTUP$STARTUP_LAYERED by default. filespec Selects a startup file for modification. Wildcard characters are accepted.
Qualifiers
Additional information available:
/CONFIRM/LOG/MODE/NAME/PARAMETER/PHASE
/CONFIRM
/CONFIRM
/NOCONFIRM (default)
Controls whether the STARTUP MODIFY command displays the
file specification of each file before modifying its startup
characteristics in the startup data file and requests you to
confirm that the file characteristics should be modified. If you
specify /CONFIRM, you must respond to the prompt with a Y (Yes) or
a T (True) and press Return before the file is modified. If you
enter anything else, such as N or NO, the requested file is not
modified.
/LOG
/LOG
/NOLOG
Controls whether the STARTUP MODIFY command displays the file
specification of each file after its startup characteristics have
been modified.
/MODE
/MODE=mode
Changes the mode of execution for a startup file. Valid modes
include DIRECT, SPAWN, BATCH, or ANY.
/NAME
/NAME=filespec
Changes the name of the startup file. The file must reside in
SYS$STARTUP.
/PARAMETER
/PARAMETER=(P1:arg1,P2:arg2,...,P8:arg8)
Changes the parameters that are to be passed to the file
during startup. Parameters that are omitted receive the default
parameters defined by the system parameter STARTUP_Pn.
/PHASE
/PHASE=phase-name
Selects startup files for modification based on the phase in which
they run. Valid phases include LPBEGIN, LPMAIN, LPBETA, and END.
LPMAIN is the default.
Example
SYSMAN> STARTUP MODIFY FILE FOR$LPMAIN_043_STARTUP.COM -
_SYSMAN> /PARAM=(P3:TRUE,P4:FALSE) /CONFIRM
The command in this example changes two startup parameters for
the command procedure FOR$LPMAIN_043_STARTUP.COM.
REMOVE
Removes a record in the startup database, so the specified startup
file no longer executes during system startup.
Requires read (R) and write (W) access to the startup database.
Format
STARTUP REMOVE FILE filespec
Additional information available:
Parameter
FILE Directs SYSMAN to remove a component from the startup database. SYSMAN modifies STARTUP$STARTUP_LAYERED by default. filespec Specifies the name of the file to remove from the startup database. Wildcard characters are accepted.
Qualifiers
Additional information available:
/CONFIRM
/CONFIRM
/NOCONFIRM (default)
Controls whether the STARTUP REMOVE command displays the file
specification of each file before deleting its record in the
startup database and requests you to confirm that the file should
be deleted. If you specify /CONFIRM, you must respond to the
prompt with a Y (Yes) or a T (True) and press Return before the
file is removed. If you enter anything else, such as N or NO, the
requested file is not removed.
/LOG
/LOG
/NOLOG
Controls whether SYSMAN displays the file specification of each
file after it has been removed.
/PHASE
/PHASE=phase-name
Indicates the phase of system startup from which the file should
be removed. Valid phases include LPBEGIN, LPMAIN, LPBETA, and END.
Example
SYSMAN> STARTUP REMOVE FILE FOR$LPMAIN_043_STARTUP.COM /LOG
The command in this example takes the file FOR$LPMAIN_043_
STARTUP.COM out of the startup database.
SET
SET DATABASE
Establishes the current startup database.
Format
STARTUP SET DATABASE database
Additional information available:
Parameter
database Specifies the name of the target database, which is STARTUP$STARTUP_LAYERED by default. The second database, STARTUP$STARTUP_VMS is available for viewing; however, Digital recommends that you do not modify it.
Example
SYSMAN> STARTUP SET DATABASE STARTUP$STARTUP_LAYERED
%SYSMAN-I-NEWCOMPFIL, current component file is now STARTUP$STARTUP_LAYERED
SYSMAN> STARTUP SHOW FILE
%SYSMAN-I-COMPFIL, contents of component database on node LUCERN
Phase Mode File
----- ---- ---------------------------
LPBEGIN DIRECT VMS$LPBEGIN_050_STARTUP.COM
LPMAIN DIRECT FOR$LPMAIN_043_STARTUP.COM
The commands in this example establish the layered products
database as the default, so it can be displayed.
SHOW
Displays the name of the current startup database or its
components.
Format
STARTUP SHOW DATABASE
FILE
Additional information available:
Parameter
DATABASE Directs SYSMAN to display the name of the current startup database. There are two startup databases: STARTUP$STARTUP_LAYERED and STARTUP$STARTUP_VMS. Digital recommends that you do not modify the STARTUP$STARTUP_VMS database. FILE Displays the contents of the current startup database. The display includes the file name, phase, and mode of execution for each component in the database.
Qualifiers
Additional information available:
/FULL/NODE/OUTPUT/PARAMETERS/PHASE
/FULL
Displays full information about each component in the database. In addition to the phase, file name, and mode of execution for each startup component, SYSMAN displays the nodes on which the file executes and the parameters passed to the file. Relevant with the FILE parameter.
/NODE
Displays the nodes within the cluster on which the file executes. By default, a startup file executes on all nodes in an environment. Relevant with the FILE parameter.
/OUTPUT
/OUTPUT=filespec
Redirects command output from SYS$OUTPUT to the file named with
the qualifier. Without a filespec, SYSMAN writes the output to
SYSMAN.LIS in the current directory.
/PARAMETERS
Lists the parameters with which the startup file executes. Parameters that are not specified receive the defaults defined by the system parameter STARTUP_Pn. Relevant with the FILE parameter.
/PHASE
/PHASE=phase-name
Displays components that execute in a specific phase of system
startup. Valid phases include LPBEGIN, LPMAIN, LPBETA, and END.
LPMAIN is the default. Relevant with the FILE parameter.
Example
SYSMAN> STARTUP SET DATABASE STARTUP$STARTUP_VMS
SYSMAN> STARTUP SHOW FILE
%SYSMAN-I-COMPFIL, contents of component database on node LUCERN
Phase Mode File
----- ---- --------------------------------
BASEENVIRON DIRECT VMS$BASEENVIRON_050_LIB.COM
BASEENVIRON CALLED VMS$BASEENVIRON_050_SMISERVER.COM
BASEENVIRON DIRECT VMS$BASEENVIRON_050_VMS.COM
.
.
.
The commands in this example display the contents of the VMS
startup database.