$T LOADmod - Refresh a load module from storage
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.
- 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.
Before using this command, ensure that the module to refresh supports dynamic functions. See z/OS JES2 Installation Exits for more information about considerations for dynamic load modules.
Syntax
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 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 for more information about using the ROUTE *ALL command.
Messages
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