$DEL LOADmod

Function

To discontinue use of an installation load module. Once the module is no longer in use, the storage associated with the module is freed (unless the module was in LPA).

As part of deleting the load module, JES2 disconnects any dynamic tables in the load module. If any EXIT(nnn) statements specify routines that reside in the load module to be deleted, the corresponding routine addresses for those exits will be nullified.

Note: This function alters the current execution environment by removing routines and tables which may be critical to correct operations. 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 remove service modules provided by IBM® or other vendors.

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

Syntax


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

Parameters

jxxxxxxx: Specifies the name of the module to delete.

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

Messages

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

Examples

1 Exit 5 specifies that routine EXIT05, which resides in load module HASX05A, will be invoked:

  $d exit(5),routines
  $HASP823 EXIT(5) ROUTINES=(EXIT05)

Use $DEL LOADMOD to delete load module HASX05A:

  $del loadmod(hasx05a)

            $HASP819 LOADMOD(HASX05A) 
  $HASP819 LOADMOD(HASX05A) ADDRESS=09C73000, 
  $HASP819                  LOADTIME=(2007.337,15:17:59), 
  $HASP819                  STORAGE=PVT - ELEMENT DELETED

After the module has been deleted, the routine specification on the EXIT(5) statement is null:

  $d exit(5),routines
  $HASP823 EXIT(5) ROUTINES=(EXIT05(NULL))

The routine name is remembered in case a $T EXIT(5),REFRESH command is issued. However, no actual routine is called for this exit.