Previous Topic: #LOAD SyntaxNext Topic: #LOAD Status Codes


#LOAD Parameters

PGM=

Specifies the 1- to 8-character name of the module to be loaded in the program pool.

program-name-pointer

A register that points to a field that contains the program name, the symbolic name of a user-defined field that contains the program name, or the program-name literal enclosed in quotation marks.

VERSION=version-number

Specifies a version number. Version-number can be an absolute value, a halfword or fullword value, or a register.

DICTNOD=

Identifies the node that controls the dictionary in which the program resides.

nodename-pointer

A register that points to a field that contains the name of the node, the symbolic name of a user-defined field containing the name of the node, or the nodename literal enclosed in quotation marks. A blank value refers to the local node.

DICTNAM=

Identifies the default dictionary in which the named program resides.

dictionary-name-pointer

A register that points to a field containing the dictionary name, the symbolic name of a user-defined field containing the dictionary name, or the dictionary name literal enclosed in quotation marks.

Note: If the DICTNAM and/or DICTNOD is specified, the system searches only the specified dictionary for the module. A program-not-found condition is returned if the module cannot be found in the specified dictionary.

EPADDR=

Specifies where the system will return the entry-point address of the loaded program.

(0)

(Default) specifies that the system will return the entry-point address to register 0.

entry-point-address

Specifies that the system will return the entry-point address to a user-defined Entry-point-address is a register location or the symbolic name of a fullword user-defined field that contains the entry-point address.

,TYPE=

Qualifies the type of load to perform.

PROGRAM

Has been pre-defined as a program at system generation or dynamically defined as a program via DCMT VARY DYNAMIC PROGRAM command.

Note: The program must reside in a load library. No attempt will be made to load the program from a dictionary load area.

TABLE

Has been pre-defined as a table at system generation or dynamically defined using a DCMT VARY DYNAMIC PROGRAM command.

PLIST=

Specifies the location of the storage area in which the system builds the #LOAD parameter list.

SYSPLIST

Is the symbolic name of the storage area in which the system builds the #LOAD parameter list.

parameter-value-list-pointer

A register that points to the area or the symbolic name of the area.

Note: The PLIST parameter is required only if the DICNAM or DICTNOD options are specified.

COND=

Specifies whether this #LOAD is conditional and under what conditions control should be returned to the issuing program:

NO

(Default); specifies that the request is not conditional.

ALL

Specifies that the request is conditional. Control is returned if the load cannot be serviced for one or more of the reasons listed under condition.

condition

Specifies conditions under which control is returned to the program.

NOST

Available storage in the program pool is insufficient to load the requested program.

IOER

An I/O error occurs during the load.

SNGL

The requested program has been defined as nonconcurrent and is currently in use.

LDCF

The requested program is in use by another task but has been overlayed temporarily in the program pool, causing a storage location conflict.

PGNF

The requested program cannot be found in the program definition table (PDT), or is marked as out-of-service.

DEAD

The requested program cannot be loaded immediately because of a no-storage-in-program-pool condition and waiting would cause a deadlock.

NOSTXIT=insufficient-storage-label

Specifies the symbolic name of a routine to which control should be returned if the #LOAD request cannot be serviced due to insufficient storage in the program pool.

IOERXIT=i/o-error-label

Specifies the symbolic name of a routine to which control should be returned if the #LOAD request cannot be serviced due to an I/O error while processing the load.

SNGLXIT=single-thread-in-use-label

Specifies the symbolic name of a routine to which control should be returned if the #LOAD request is for a program marked nonconcurrent and the program is in use.

LDCFXIT=storage-location-conflict-label

Specifies the symbolic name of a routine to which control should be returned if the #LOAD request cannot be serviced due to a storage location conflict.

PGNFXIT=program-not-found-label

Specifies the symbolic name of a routine to which control should be returned if either the requested program cannot be found in the PDT or is out-of-service.

DEADXIT=deadlock-label

Specifies the symbolic name of a routine to which control should be returned if the requested program cannot be loaded immediately and to wait on its availability would cause a deadlock.

ERROR=error-label

Specifies the symbolic name of the routine to which control should be returned if a condition specified in the COND parameter occurs for which no other exit routine was coded.