$T LOADmod

Function

To replace the old copy of an installation load module with a newly loaded one. If the old copy of the module is no longer in use, the storage associated with the module is freed.

The new copy of the module is loaded with the storage attribute of the current module. If the current module was originally located in LPA (even though STORAGE= PVT or CSA was specified) and the new copy was placed the link list or the STEPLIB concatenation, you might want a different storage attribute. If a different storage attribute is needed, delete the current module ($DEL LOADMOD) and load a new copy in the desired location ($ADD LOADMOD).

If the current module is located in LPA, you must place a new copy in LPA using the MVS™ dynamic LPA services before issuing the JES2 $T LOADMOD,REFRESH command. The same module will be found in LPA if you fail to place a new module in LPA.

As part of refreshing the load module, JES2 replaces any dynamic tables and routines on EXIT(nnn) statements in the old module with corresponding tables and routines in the new modules:

Any dynamic tables in the old module that do not have corresponding tables in the new module are disconnected.
Any new dynamic tables in the new module are connected.
Any routines on a EXIT(nnn) statement in the old module that do not have corresponding routines in the new module are nullified.
New routines in the new module are not processed by this command. A separate $T EXIT(nnn) command is needed to associate those routines with an exit.

Note: This function alters the current execution environment by replacing routines and tables that might be currently in use. It is primarily intended for a test environment. Use in a production environment should be limited to situations that could prevent an IPL or to refresh service modules provided by IBM® or other vendors.

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

Syntax


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

>--+------------+----------------------------------------------><
   '-,--REFRESH-'

Parameters

jxxxxxxx: Specifies the name of an existing load module to refresh.
REFRESH: Indicates that the specified load routine must be refreshed. If this keyword is not specified, the command does nothing.

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 about using the ROUTE *ALL command.

Messages

The $HASP819 message indicates that the specified load module been refreshed.

Note: The loadtime prior to the refresh is different from the loadtime after the refresh.

Example

 1   $t loadmod(hasx05a),refresh 

            $HASP819 LOADMOD(HASX05A) 
  $HASP819 LOADMOD(HASX05A)  ADDRESS=09C75000,LENGTH=000800, 
  $HASP819                   LOADTIME=(2007.337,16:11:39), 
  $HASP819                   RMODE=ANY,SPLEVEL=CHECK,STORAGE=PVT