Adds an entry in the system images file SYS$UPDATE:VMS$SYSTEM_
IMAGES.IDX.
CAUTION
The SYS_LOADABLE ADD command is not intended for general
use. Only advanced system programmers should use this
command.
Format
SYS_LOADABLE ADD product image
1 – Parameters
product
A 1- to 8-character product mnemonic that uniquely identifies a
loadable image. For user-written images, this should typically
contain the string _LOCAL_.
image
The file name of the system loadable image you want to add. A
file name is the only value you can specify for this parameter.
Do not specify a device, directory, file type, or wildcard
characters.
2 – Qualifiers
2.1 /LOAD_STEP
Indicates the step of the booting process at which you want the
image loaded. Valid load steps are INIT (which causes the system
initialization code to load the image), and SYSINIT (which causes
the SYSINIT process to load the image).
If you do not specify a value for the /LOAD_STEP qualifier, it
defaults to SYSINIT.
2.2 /LOG
/LOG
/NOLOG (default)
Controls whether the SYS_LOADABLE ADD command displays a
notification after the entry has been added.
2.3 /MESSAGE
Enables you to specify the text of a message that is displayed
when the appropriate condition is met (see the /SEVERITY
qualifier). The default message is "system image load failed".
2.4 /SEVERITY
Determines how the image load status will affect console output
and booting progress. You can specify the following values for
this qualifier:
Value Description
FATAL If an error occurs loading the image, display the
error message and BUGCHECK information.
INFORMATION Display the message and continue processing.
SUCCESS Continue even if loading the image produces an error.
Does not display the message.
WARNING If an error occurs loading the image, display the
error message and continue processing.
If you do not specify a value for the /SEVERITY qualifier, it
defaults to WARNING.
3 – Description
The SYS_LOADABLE ADD command adds an entry to the system images
file SYS$UPDATE:VMS$SYSTEM_IMAGES.IDX. You can then process
this file using the command procedure SYS$UPDATE:VMS$SYSTEM_
IMAGES.COM. Processing the file with VMS$SYSTEM_IMAGES.COM
generates a new system images data file that the system uses
when it boots.
If the file SYS$UPDATE:VMS$SYSTEM_IMAGES.IDX does not exist, the
SYS_LOADABLE ADD command creates a new one.