User manual

VSMP Reference

VSMP LOAD

VSMP LOAD loads VSMP kernel-resident module into OpenVMS kernel and sets up the system ready for

multiprocessing. In particular it creates descriptors for additional virtual processors in the OpenVMS

system and exposes VAX MP multiprocessing capability to OpenVMS. Once VSMP LOAD is executed,

created virtual processors are ready to be started with OpenVMS DCL command START /CPU.

System administator normally does not invoke VSMP LOAD command directly, rather this command is

invoked by executing command file VSMP$LOAD.COM

$ @SYS$SYSROOT:[VSMP]VSMP$LOAD [optional parameters for VSMP LOAD command]

VSMP$LOAD.COM performs three actions:

• It checks whether it is being executed on VAX MP rather than system that does not provide

VAX MP API, such as hardware VAX or regular SIMH VAX simulator or other VAX simulator. If

VAX MP API is not available, VSMP$LOAD will display a message and exit gracefully with exit

status “success” and thus not aborting the calling command file such as

SYSTARTUP_VMS.COM

• VSMP$LOAD then sets up appropriate affnity for IO devices on the system by calling file

DEVICES.COM that executes VSMP SET AFFINITY commands for various devices on the

system. DEVICES.COM is derived from knowledge about particular OpenVMS device drivers

and should not be modified except by VAX MP developers.

• VSMP$LOAD then issues VSMP LOAD command, passing it any (optional) arguments that

were specified on VSMP$LOAD command line. If VSMP LOAD fails, VSMP$LOAD will display

a message and exit gracefully with exit status “success” and thus not aborting the calling

command file such as SYSTARTUP_VMS.COM.

If arguments to be passed to VSMP LOAD via VSMP$LOAD command line are too long or exceed 8

arguments, additional arguments can also be passed via DCL symbol VSMP$LOAD_OPTIONS.

Synopsis of VSMP LOAD command is:

VSMP LOAD [IDLE=ON|OFF|NEVER]

[TIMESYNC=ON|OFF]

[NOPATCH=(list)]

[XQTIMEOUT=<nsec>]

[INTERLOCK=PORTABLE|NATIVE]

[SYNCW=(SYS|ILK|SYS,ILK|ALL|NONE)]

[SYNCW_SYS=pct]

[SYNCW_ILK=pct]

All arguments are optional.

As described in section “Device timeouts” in “VAX MP Technical Overview”.