$ADD LOADmod(name)

Function

To load a new installation load module into storage. Load modules can be placed in JES2 private, common storage, or obtained from LPA. See z/OS JES2 Initialization and Tuning Guide, SA32-0991 for the search order used during loading modules.

As part of loading the new module, JES2 processes any dynamic tables in the load module. However, adding a new module does not affect any routine specification on an EXIT(nnn) statement. If the new load module contains exit routines, an appropriate $T EXIT(nnn) command is needed to enable those exit routines.

Note: This function alters the current execution environment by adding new routines and tables that can get control. It is primarily intended for a test environment. In a production environment, this function should be limited to one of the following situations:

The situation that could prevent an IPL.
The situation that loads service modules provided by IBM® or other vendors.

Before using this command, ensure that the module to load supports dynamic loads. See z/OS JES2 Installation Exits, SA32-0995 for more information about considerations for dynamic load modules.

Syntax


>>-$ADD LOADmod--+-'--jxxxxxxx--'---------------+--------------->
                 |    .-,------------------.    |   
                 |    V                    |    |   
                 '-(----+-jxxxxxxx-------+-+--)-'   
                        '-'--jxxxxxxx--'-'          

>--+-----------------------+-----------------------------------><
   |           .-PVT-----. |   
   '-STORage=--+-CSA-----+-'   
               +-LPA-----+     
               '-PRIVATE-'

Parameters

jxxxxxxx: Specifies the name of the module to load. If there is an existing load module with this name, the $ADD LOADMOD will fail.
STORage=PVT|CSA|LPA|PRIVATE: Specifies whether this load module is loaded into the JES2 private area (PVT), common storage (CSA), or if the module will be found in the link pack area (LPA). See z/OS JES2 Initialization and Tuning Guide, SA32-0991 for more detailed information. See z/OS JES2 Installation Exits, SA32-0995 for detailed information about how JES2 uses this statement to determine which load module to use if there are multiple load modules with the same name.

Authority Required

This command requires system authority. The description of the $T RDRnn command explains how to ensure that the authority of the appropriate MVS™ system command group is assigned.

This command requires control security access authority. See z/OS JES2 Initialization and Tuning Guide, SA32-0991 for a description of assigning command input authority.

Scope

Single member. The values supplied for this command will be in effect for this member only.

Depending on the setup of installation, you might want this command to be applied to all members of the MAS to ensure a consistent environment. If the JES2 command character is the same on all members, you can use the MVS ROUTE *ALL command to issue this command to all active members. See z/OS MVS System Commands, SA38-0666 for more information on how to use the ROUTE *ALL command.

Messages

The $HASP819 message displays the current values of all the parameters for the load module.

Example

 1   $add loadmod(hasx05a) 

          $HASP819 LOADMOD(HASX05A)                             
$HASP819 LOADMOD(HASX05A)   ADDRESS=09C73000,LENGTH=000800,     
$HASP819                    LOADTIME=(2007.337,15:12:36),
$HASP819                    RMODE=ANY,SPLEVEL=CHECK,STORAGE=PVT