Parameters

EPLOC=

Specifies the address of the name of the module to be loaded. The name must be left-justified in an 8-byte field, padded on the right with blanks.

EP=

Specifies the 1- to 8-character name of the module to be loaded. All eight characters of the module name are used during the ALOAD macro processing; all module names (JES3 and user) must be unique.

CSECT=

Specifies whether the module is an executable module or a data module.

NO: Specifies that the module is not a data module. (The module will be considered reentrant if REUSE=NO.)
YES: Specifies that the module is a data module. (The module will never be considered reentrant.)
Note: If CSECT=YES is specified, REUSE=YES must not be specified.

REUSE=

Specifies whether the module is serially reusable or not.

NO

Specifies that the module is not serially reusable.

YES

Specifies that the module is serially reusable.

Note:

If REUSE=YES is specified, CSECT=YES must not be specified.
REUSE=YES should be used only when loading the DSP initialization and termination routines in module IATGRJR.

DCB=

Specifies the address of the opened data control block (DCB) of the load module library from which the module is to be loaded.

NORMAL=

This parameter specifies that after the macro processing routine executes, the issuing program can resume execution at an instruction other than the instruction that immediately follows the macro.

ERROR=

Specifies the address to which the macro processing routine returns if an error occurs.

If an error occurs and the ERROR parameter was not specified, the DSP is ended using the FAILDSP macro.

The three errors listed here can occur during ALOAD processing and cause DM abends. (In all three cases, register 1 contains the JES3 dump code.)

Return code 04 – The JES3 AGETMAIN for a storage buffer can fail. If an error return is specified, register 15 contains the reason code returned from the MVS™ GETMAIN macro, register 0 contains the ECF mask and the ECF address returned from a busy AGETMAIN, and register 1 contains the JES3 dump code (in hex). If an error return is not specified, register 4 contains the AGETMAIN busy return code (X'04'), and a FAILDSP will be issued with a DM083.
Return code 14 – The MVS LOAD macro may fail. If it does, message IAT6308 is issued indicating the MVS LOAD ABEND code and return code. If an error return is specified, register 1 will have the JES3 dump code (in hex) and register 15 will have the ALOAD return code for a LOAD failure (X'14'). If an error return is not specified, register 4 contains the ALOAD error return code (X'14') and a FAILDSP will be issued with a DM080.
See z/OS MVS Programming: Assembler Services Guide for more information about the ABEND and reason codes returned by the MVS LOAD macro.
Return code 18 – The MVS BLDL to find the module and obtain its size requirements can fail. If it does, message IAT6308 is issued indicating the reason code and return code from the BLDL macro. If an error return is specified, register 1 will contain the JES3 dump code (in hex) and register 15 will contain the BLDL failed return code (X'18'). If an error return is not specified, register 4 contains the BLDL error return code (X'18'), and JES3 will issue a FAILDSP with a DM081.