$D LOADmod(jxxxxxxx)

Function

To display information that would be useful for diagnosing JES2 problems. Use this command to get the virtual address where a load module has been loaded in storage, exit routines included in the load module, its length, the RMODE, and the area of storage where the load module is located.

This command has parameters you can use as a filtering technique to limit the type of information to search, or the amount of information to display. See Using filtering to control and display information for additional information.

One or more parameters on this command accepts wild cards. Parameter descriptions will note that.

Syntax


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

>--+---------------------------------+-------------------------->
   '-| Selection limiting keywords |-'   

>--+-------------------------------+---------------------------><
   '-| Display limiting keywords |-'   

Display limiting keywords

|--+------------+--+------------+--+-----------+---------------->
   '-,--ADDRess-'  '-,--DYNAMIC-'  '-,--LENgth-'   

>--+-------------+--+---------+--+----------+------------------->
   '-,--LOADTIME-'  '-,--LONG-'  '-,--RMODE-'   

>--+-------------+--+------------+--+------------+-------------->
   '-,--ROUtines-'  '-,--SPLevel-'  '-,--STORage-'   

>--+-----------+------------------------------------------------|
   '-,--TABles-'   

Selection limiting keywords

|--+------------------------------------+----------------------->
   '-,--+---+--ADDRess--+-=--+--address-'   
        '-/-'           +-^=-+              
                        +->--+              
                        '-<--'              

>--+----------------------------------+------------------------->
   '-,--+---+--DYNamic----=------NO---'   
        '-/-'                             

>--+----------------------------------+------------------------->
   '-,--+---+--LENgth--+-=--+--length-'   
        '-/-'          +-^=-+             
                       +->--+             
                       '-<--'             

>--+----------------------------------+------------------------->
   '-,--+---+--RMODE--+-=--+--+-ANY-+-'   
        '-/-'         '-^=-'  '-24--'     

>--+----------------------------------------+------------------->
   '-,--+---+--SPLevel--+-=--+--+-CHECK---+-'   
        '-/-'           '-^=-'  '-NOCHECK-'     

>--+----------------------------------------+------------------->
   '-,--+---+--STORage--+-=--+--+-CSA-----+-'   
        '-/-'           '-^=-'  +-LPA-----+     
                                +-PRIVATE-+     
                                '-PVT-----'     

>--+-------------------------------+----------------------------|
   '-,--+---+--TYPE----=------OS---'   
        '-/-'

Parameters

LOADmod

Specifies the JES2 load module name for which information is to be displayed. Specify the load module name (for example, HASCLINK) to obtain specific load module information, or an asterisk ( * ) to obtain information for all load modules. You can also specify wild cards for the load module name. See Using wildcards for additional information. The following load modules cannot be displayed:

HASPFSSM
HASJES20
Load modules beginning with the characters HASM

ADDRess=address

Displays the hexadecimal address of the load module in storage.

DYNamic

DYNamic=NO indicates that this module does not support dynamic functions ($ADD LOADMOD, $DEL LOADMOD and $T LOADMOD,REFRESH). Nothing displays if the module supports dynamic functions.

LENgth=length

Displays the load module's exact hexadecimal length.

LOADTIME

Displays the time when the load module being displayed was loaded.

LONG

Specifies whether or not an abbreviated list of characteristic is provided. An abbreviated display of characteristics is provided unless LONG is requested. The abbreviated list includes only the following characteristics:

ADDRESS
LENGTH
LOADTIME
RMODE
SPLEVEL
STORAGE

RMODE[=24|ANY]

Displays the link-edit attributes of the load module. Optionally, you can specify one of the following keywords to display load modules that reside in a particular area:

Value: Meaning
24: Display only those load modules that reside below 16 megabytes of virtual storage.
ANY: Display only those load modules that reside above 16 megabytes of virtual storage.

ROUtines

Displays the routines that are defined using the $ENTRY macros in a module. These routines are available for use through the EXIT(nnn) initialization statement.

Only routine names in installation-provided modules or in IBM-provided sample exit modules will be included.

SPLevel[=CHECK|NOCHECK]

Displays the value the module assigned to the SPLEVEL= parameter on the $MODULE macro. Optionally, you can display only those modules that have assigned a specific value to the $MODULE SPLEVEL= parameter by coding one of the following keywords:

Value: Meaning
CHECK: Display only those modules that specified CHECK on the $MODULE SPLEVEL= parameter.
NOCHECK: Display only those modules that specified NOCHECK on the $MODULE SPLEVEL= parameter.

STORage[=CSA|LPA|PRIVATE|PVT]

Displays the type of storage in which the load module resides. Optionally, you can specify an area of storage.

Code one of the following keywords:

Value: Meaning
CSA: Display only those load modules that are loaded into common storage.
LPA: Display only those load modules that are loaded into link pack area storage.
PRIVATE|PVT: Display only those load modules that are loaded into the private storage of the JES2 address space.

TABles

Displays any DYNAMIC tables which are defined in this module, along with the type of table.

TYPE

TYPE=OS indicates that this module is not a JES2 module. Nothing displays if the module is a JES2 module.

Authority Required

This command requires display 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 read security access authority. For a description of assigning command input authority, see z/OS JES2 Initialization and Tuning Guide, SA32-0991.

Scope

Single member. The response to this command will be a display of information about this member only. You might want to use this command to get information about all members in the MAS. To do so, you can use the MVS ROUTE *ALL command to issue this command to all active members (if the JES2 command character is the same on all members). See z/OS MVS System Commands, SA38-0666 for more information on using the ROUTE *ALL command.

Messages

The $HASP819 message displays the current address, length, routines, RMODE, SPLEVEL and storage information for the specified load modules.

Examples

 1   $d loadmod(hastx24) 

            $HASP819 LOADMOD(HASTX24) 
  $HASP819 LOADMOD(HASTX24)   ADDRESS=0A18D000,LENGTH=000E70, 
  $HASP819                    LOADTIME=(2007.337,15:07:35), 
  $HASP819                    RMODE=ANY,SPLEVEL=CHECK,STORAGE=PV

This command displays the characteristics of HASTX24.

 2   $d loadmod(hastx24),long 

            $HASP819 LOADMOD(HASTX24) 
  $HASP819 LOADMOD(HASTX24)   ADDRESS=0A18D000,LENGTH=000E70, 
  $HASP819                    LOADTIME=(2007.337,15:07:35), 
  $HASP819                    ROUTINES=($$$$LOAD=0A18D050, 
  $HASP819                    $$$$DEL=0A18D1A0,FIXMAP=0A18D4A0, 
  $HASP819                    ISSI256=0A18D5F0),RMODE=ANY, 
  $HASP819                    SPLEVEL=CHECK,STORAGE=PVT, 
  $HASP819                    TABLES=($$LDMSGS($SCANTAB))

This command displays a complete list of the characteristics of HASTX24.

 3   $d loadmod(*),rmode,storage=pvt 

  $HASP819 LOADMOD(HASTX24)   RMODE=ANY 
  $HASP819 LOADMOD(HASTX5)    RMODE=ANY

This command displays the RMODE for all load modules in private storage.