There are several STARTUP subcommands. Select the one you want
from the choices below.
1 – ADD
Adds a component to the startup database.
Requires read (R) and write (W) access to the startup database.
Format
STARTUP ADD FILE filespec
1.1 – Parameters
FILE
Adds 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.
1.2 – Qualifiers
1.2.1 /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.
1.2.2 /LOG
/LOG
/NOLOG (default)
Controls whether the STARTUP ADD command displays the file
specification of each file after it has been added.
1.2.3 /MODE
/MODE=mode
Specifies the mode of execution for the file. Valid modes include
DIRECT, SPAWN, BATCH, or ANY.
1.2.4 /NODE
/NODE=(node1,node2,...,noden)
Names the nodes within the cluster that run the file during
startup. By default, a startup file executes on all nodes in
the cluster.
1.2.5 /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. If
STARTUP_Pn is blank, "FULL" is used as parameter 1 (P1) and is
passed by STARTUP.COM to each startup component file. If you want
a blank P1 parameter given to a specific component file, use the
command:
SYSMAN> STARTUP MODIFY FILE component.com/PARAM=P1:""
1.2.6 /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.
1.3 – Description
The STARTUP ADD command adds a component to the startup database.
Startup components are the command procedures or executable files
that perform actual startup work. Files from the startup database
are used to start the operating system, site-specific programs,
and layered products. STARTUP$STARTUP_VMS and STARTUP$STARTUP_
LAYERED list the components of the startup database.
Because an OpenVMS Cluster typically shares one copy of the
startup database, the SYSMAN environment can be defined as
clustered or as a single node within the cluster.
1.4 – Example
SYSMAN> STARTUP ADD FILE /MODE=DIRECT /PHASE=LPMAIN -
_SYSMAN> DECSET$ENVMGR_STARTUP.COM
This command adds a record to the startup database that starts
the DECSET environment manager software.
2 – 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
2.1 – Parameters
FILE
Disables 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 asterisk (*) and percent (%) wildcard
characters are permitted.
2.2 – Qualifiers
2.2.1 /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 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.
2.2.2 /LOG
/LOG
/NOLOG (default)
Controls whether the STARTUP DISABLE command displays the file
specification of each file after it has been disabled.
2.2.3 /NODE
/NODE=(node1,node2,...,noden)
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.
2.2.4 /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.
2.3 – Description
The STARTUP DISABLE command prevents a file in the startup
database from executing. The command edits a record in the
startup database, temporarily disabling the file.
2.4 – Example
SYSMAN> STARTUP DISABLE FILE /NODE=NODE21 DECSET$ENVMGR_STARTUP.COM
This command modifies the startup database so that the DECset
environment manager will not be installed on NODE21.
3 – ENABLE
Enables 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
3.1 – Parameters
FILE
Enables 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.
3.2 – Qualifiers
3.2.1 /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 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.
3.2.2 /LOG
/LOG
/NOLOG (default)
Controls whether the STARTUP ENABLE command displays the file
specification of each file after it has been enabled.
3.2.3 /NODE
/NODE=(node1,node2,...,noden)
Names nodes within the cluster where the file will be enabled. By
default, the startup file is enabled on all nodes.
3.2.4 /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.
3.3 – Description
The STARTUP ENABLE command permits a file that was previously
disabled to execute during system startup.
3.4 – Example
SYSMAN> STARTUP ENABLE FILE /NODE=NODE22 DECSET$ENVMGR_STARTUP.COM
This command modifies the startup database. NODE22 will have
the DECSET environment manager installed at startup.
4 – 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
4.1 – Parameters
FILE
Modifies a record in the startup database. SYSMAN modifies
STARTUP$STARTUP_LAYERED by default.
filespec
Selects a startup file for modification. Wildcard characters are
accepted.
4.2 – Qualifiers
4.2.1 /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 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.
4.2.2 /LOG
/LOG
NOLOG (default)
Controls whether the STARTUP MODIFY command displays the file
specification of each file after its startup characteristics have
been modified.
4.2.3 /MODE
/MODE=mode
Changes the mode of execution for a startup file. Valid modes
include DIRECT, SPAWN, BATCH, or ANY.
4.2.4 /NAME
/NAME=filespec
Changes the name of the startup file. The file must reside in
SYS$STARTUP.
4.2.5 /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. If
STARTUP_Pn is blank, "FULL" is used as parameter 1 (P1) and is
passed by STARTUP.COM to each startup component file. If you want
a blank P1 parameter given to a specific component file, use the
command:
SYSMAN> STARTUP MODIFY FILE component.com/PARAM=P1:""
4.2.6 /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.
4.3 – Description
The STARTUP MODIFY command edits startup information associated
with components in the startup database. For example, the command
can rename a file or change the parameters that are passed
to a file during startup. You can select a group of files for
modification based on the phase in which they run.
4.4 – Example
SYSMAN> STARTUP MODIFY FILE DECSET$ENVMGR_STARTUP.COM -
_SYSMAN> /PARAM=(P3:TRUE,P4:FALSE) /CONFIRM
This command changes two startup parameters for the command
procedure DECSET$ENVMGR_STARTUP.COM.
5 – 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
5.1 – Parameters
FILE
Removes 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.
5.2 – Qualifiers
5.2.1 /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 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.
5.2.2 /LOG
/LOG
/NOLOG (default)
Controls whether SYSMAN displays the file specification of each
file after it has been removed.
5.2.3 /PHASE
/PHASE=phase-name
Indicates the phase of system startup from which the file will be
removed. Valid phases include LPBEGIN, LPMAIN, LPBETA, and END.
5.3 – Example
SYSMAN> STARTUP REMOVE FILE DECSET$ENVMGR_STARTUP.COM /LOG
This command takes the file DECSET$ENVMGR_STARTUP.COM out of
the startup database.
6 – SET
6.1 – DATABASE
Establishes the current startup database.
Format
STARTUP SET DATABASE database
6.1.1 – 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, VSI
recommends that you do not modify it.
6.1.2 – Qualifiers
None.
6.1.3 – 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_070_STARTUP.COM
LPMAIN DIRECT FOR$LPMAIN_070_STARTUP.COM
The commands in this example establish the layered products
database as the default, so it can be displayed.
6.2 – OPTIONS
Controls logging and display of information for one or more nodes
in a cluster during startup.
Requires READ (R) and WRITE (W) access to the current system
parameter file on disk: SYS$SYSTEM:ALPHAVMSSYS.PAR (for Alpha),
and SYS$SYSTEM:IA64VMSSYS.PAR (for Integrity servers).
Format
STARTUP SET OPTIONS
6.2.1 – Qualifiers
6.2.1.1 /CHECKPOINTING
/CHECKPOINTING
/NOCHECKPOINTING
Displays informational messages describing the time and status of
each startup phase and component procedure.
The value of the system parameter STARTUP_P2 that corresponds to
/OUTPUT=CHECKPOINTING is "C".
6.2.1.2 /OUTPUT
/OUTPUT=FILE,CONSOLE
Sends output generated by using the /VERIFY qualifier to a file
or to the system console. If you choose the FILE option, it
creates SYS$SPECIFIC:[SYSEXE]STARTUP.LOG.
The value of the system parameter STARTUP_P2 that corresponds to
/OUTPUT=FILE is "D".
6.2.1.3 /VERIFY
/VERIFY=FULL,PARTIAL
/NOVERIFY
Displays startup procedures as they execute. This qualifier
defines the system parameter STARTUP_P2 to have the appropriate
value based on the options you choose. (/VERIFY with no value
following it is the equivalent of /VERIFY=full.)
/VERIFY options are in the following table:
Value Description
FULL Displays every line of DCL executed by startup component
procedures and by STARTUP.COM.
The value of the system parameter STARTUP_P2 that
corresponds to this option is "V".
PARTIAL Displays every line of DCL executed by startup component
procedures, but does not display DCL executed by
STARTUP.COM.
The value of the system parameter STARTUP_P2 that
corresponds to this option is "P".
CAUTION
All STARTUP_P2 parameter values modified by the SYSMAN
STARTUP OPTIONS will be overridden by the AUTOGEN command
procedure. To preserve any parameter modifications made with
SYSMAN, edit the SYS$SYSTEM:MODPARAMS.DAT file, as explained
in the VSI OpenVMS System Manager's Manual.
6.2.2 – Description
The STARTUP SET OPTIONS command enables you to control logging
and checkpointing during startup. You can control the amount of
information logged (full or partial) and where it is displayed
(file or console). You can also choose checkpointing, which
displays informational messages about the time and status of
each phase during startup.
The default options are /NOCHECKPOINTING, /OUTPUT=CONSOLE, and
/NOVERIFY.
Because SYSMAN enables you to define the target environment, you
can perform startup logging on your local node, your own cluster,
and a subset of nodes on your cluster. See the SET ENVIRONMENT
command for more information.
6.2.3 – Example
SYSMAN> STARTUP SET OPTIONS/VERIFY=FULL/OUTPUT=FILE/CHECKPOINTING
This example requests startup logging with full verification,
output to SYS$SPECIFIC:[SYSEXE]STARTUP.LOG, and checkpointing.
The corresponding value for system parameter STARTUP_P2 is
"VDC".
7 – SHOW
Displays the name of the current startup database or its
components as well as the startup logging options selected with
the STARTUP SET OPTIONS command.
Format
STARTUP SHOW DATABASE
FILE
OPTIONS
7.1 – Parameters
DATABASE
Displays the name of the current startup database. The
two startup databases are STARTUP$STARTUP_LAYERED and
STARTUP$STARTUP_VMS. VSI 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.
OPTIONS
Displays the options selected when using the STARTUP SET OPTIONS
command.
7.2 – Qualifiers
7.2.1 /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. This
qualifier is relevant with the FILE parameter.
7.2.2 /NODE
Displays the nodes within the cluster on which the file
executes. By default, a startup file executes on all nodes in an
environment. This qualifier is relevant with the FILE parameter.
7.2.3 /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.
7.2.4 /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. If STARTUP_Pn is blank, "FULL"
is used as parameter 1 (P1) and is passed by STARTUP.COM to each
startup component file. If you want a blank P1 parameter given
to a specific component file, see the /PARAMETER qualifier under
STARTUP MODIFY command for instructions.
7.2.5 /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. This qualifier is relevant with the FILE
parameter.
7.3 – 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
startup database.