$D MODule(jxxxxxxx)

Function

To display information about JES2 assembly modules within JES2 load modules, in the JES2 address space or in common storage. These modules can be from IBM® or installation-defined.

The information displayed for each module includes the module name and any of the following information:

The storage address where the module is loaded and the module length.
The date and time the module was assembled.
The assembly environment of the module.
Any exit points defined within the module.
Whether the module is a base module, a sample exit routine, or not part of the JES2 product.
The number of the last APAR applied to the module.
The hexadecimal length of the module.
The name of the load module that contains the assembly module.
The value that the module assigned to the SPLEVEL SET= parameter.
The names of any exit routines that are included in the module.
The SPLEVEL of the MVS™ macros used in the assembly of this module.

This information would be useful for diagnosing JES2 problems.

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--MODule--+----------------------------+------------------->
               +-'--module--'---------------+   
               |    .-,----------------.    |   
               |    V                  |    |   
               '-(----+-module-------+-+--)-'   
                      '-'--module--'-'          

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

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

Display limiting keywords

|--+------------+--+-------------+--+------------+-------------->
   '-,--ADDRess-'  '-,--ASSEMBLY-'  '-,--ENViron-'   

>--+------------+--+---------+--+------------+------------------>
   '-,--EXITPTS-'  '-,--FMID-'  '-,--IBMJES2-'   

>--+-------------+--+------------+--+-----------+--------------->
   '-,--LASTapar-'  '-,--LASTPTF-'  '-,--LENgth-'   

>--+------------+--+---------+--+-------------+----------------->
   '-,--LOADmod-'  '-,--LONG-'  '-,--MACLevel-'   

>--+-------------+--+------------+--+-----------+--------------->
   '-,--ROUtines-'  '-,--SPLevel-'  '-,--TABles-'   

>--+-------------+--+------------+------------------------------|
   '-,--UVERSION-'  '-,--VERSION-'   

Selection limiting keywords

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

>--+----------------------------------------+------------------->
   '-,--+---+--ENViron--+-=--+--+-FSS-----+-'   
        '-/-'           '-¬=-'  +-JES2----+     
                                +-MIXED---+     
                                +-SUBTASK-+     
                                '-USER----'     

>--+---------------------------------------+-------------------->
   '-,--+---+--IBMJES2--+-=--+--+-BASE---+-'   
        '-/-'           '-¬=-'  +-No-----+     
                                '-SAMPLE-'     

>--+--------------------------------------+--------------------->
   '-,--+---+--LASTapar--+-=--+--lastapar-'   
        '-/-'            +-¬=-+               
                         +->--+               
                         '-<--'               

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

>--+------------------------------------+----------------------->
   '-,--+---+--LOADmod--+-=--+--loadmod-'   
        '-/-'           +-¬=-+              
                        +->--+              
                        '-<--'              

>--+--------------------------------------+--------------------->
   '-,--+---+--MACLevel--+-=--+--maclevel-'   
        '-/-'            +-¬=-+               
                         +->--+               
                         '-<--'               

>--+----------------------------------------+------------------->
   '-,--+---+--ROUtines----=------routine---'   
        '-/-'                                   

>--+----------------------------------------+-------------------|
   '-,--+---+--SPLevel--+-=--+--+-CHECK---+-'   
        '-/-'           '-¬=-'  '-NOCHECK-'

Parameters

module

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

ADDRess=address

The hexadecimal address where the module has been loaded into storage. If a module has not been loaded into storage, an address of 00000000 is displayed.

You can specify wild cards on this parameter. See Using wildcards for additional information.

ASSEMBLY

Displays the date and time the module was assembled.

ENViron[=FSS|JES2|MIXED| SUBTASK|USER]

Displays the value of the ENVIRON= parameter, which was set in the $MODULE macro, of the module. You can specify the ENVIRON parameter without an environment keyword, or specify an environment if you are requesting information about all modules in that environment only (for example, ENV=USER).

Valid keyword values for the ENV= parameter are:

Value: Meaning
FSS: Display only those modules that are assembled for the FSS address space environment.
JES2: Display only those modules that are assembled for the JES2 address space main task environment.
MIXED: Display only those modules that contain routines ($ENTRY macros) that are not all defined for the same environment. Having a module with routines defined for different environments is rare in IBM modules, and is not recommended in installation-defined modules.
SUBTASK: Display only those modules that are assembled for the JES2 address space subtask environment.
USER: Display only those modules that are assembled for the multi-address-space user environment.

EXITPTS

Displays the exit points defined in the module. If the module being displayed issued the $EXIT macro, the display includes the exit points defined by that macro. An exit point is a number from 0 through 255. For example, if the module defined exit point 31, the display shows EXITPTS=(31).

If the module did not issue the $EXIT macro, the display shows EXITPTS=( ).

FMID

Displays the FMID of the release of JES2.

IBMJES2[=BASE|No|SAMPLE]

Displays the category of the module. The categories are: a base module in the JES2 product, a JES2-provided sample exit routine, or any other JES2 module that's not provided as part of the JES2 product.

You can specify this parameter without any keywords or you can specify a keyword to display only those modules that fall into one of the three module categories just mentioned.

The keyword values and their meanings are:

Value: Meaning
BASE: Limit the display to only base modules in the JES2 product.
No: Limit the display to JES2 modules that are not base modules or JES2-provided sample exit routines.
SAMPLE: Limit the display to JES2-provided sample exit routines.

LASTapar[=lastapar]

Displays the last service that has been applied to a module. You can specify wild cards on this parameter. See Using wildcards for additional information.

If no service has been applied to a module, a value of NONE is displayed.

Optionally, you can specify a service number if you are requesting information about all modules last affected by that service. You can specify NONE to display information about all modules that have not been affected by service. The keyword values and their meanings are:

Value: Meaning
aannnnn: Limit the display to only those modules that have APAR lastapar applied as their last APAR.

For non-IBM modules that contain a character constant with the label APARNUM, the display includes the value of the character constant. For non-IBM modules that do not contain this constant, the display includes the value of the &UVERS global variable defined in the $HASPGBL macro.

LASTPTF

Displays the latest PTF maintenance applied to this module.

LENgth=length

Displays the module hexadecimal length. The length that is displayed is the module's approximate length and is generally within 8 bytes of the actual module length.

LOADmod[=loadmod]

Displays the name of the load module that contains the module. You can specify a load module name if you are requesting information about all modules contained within that specific load module.

You can specify wild cards on this parameter. See Using wildcards for additional information.

LONG

Displays additional information.

Note: Because LONG automatically triggers a "long" display, you cannot add additional display-limiting parameters on this command; however, you can add selection-limiting parameters.

MACLevel[=maclevel]

Displays the value the module assigned to the SET= parameter on the SPLEVEL macro. You can specify a numeric value to display only those modules that have assigned a specific value to the SPLEVEL SET= parameter.

The numerical values and their meanings are:

Value: Meaning
1: Display only those modules that specified 1 on the SET= parameter of the SPLEVEL macro.
2: Display only those modules that specified 2 on the SET= parameter of the SPLEVEL macro.
3: Display only those modules that specified 3 on the SET= parameter of the SPLEVEL macro.
4: Display only those modules that specified 4 on the SET= parameter of the SPLEVEL macro.
5: Display only those modules that specified 5 on the SET= parameter of the SPLEVEL macro.
6: Display only those modules that specified 6 on the SET= parameter of the SPLEVEL macro.

ROUtines[=routine]

Displays routines and their addresses within the module. Only routines defined by $ENTRY are displayed. When used as a filter, only the module containing the routine and the specified routine address (unless LONG is also specified) are displayed.

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.

TABles

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

UVERSION

Displays the user version of JES2 (LONG only).

VERSION

Displays the version of JES2 (LONG only).

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 $HASP468 message displays the current address and assembly information for the desired modules, and if applicable, the latest service.

Examples

 1 
 $dmodule(haspnuc)

 $HASP468 MODULE(HASPNUC) 
 $HASP468 MODULE(HASPNUC) ADDRESS=00006000,ASSEMBLY=(11/17/99,

 $HASP468 18.07),ENVIRON=MIXED,EXITPTS=(7,21), 
 $HASP468 FMID=HJE6607,IBMJES2=BASE, 
 $HASP468 LASTAPAR=OW40627,LASTPTF=UW63110, 
 $HASP468 LENGTH=00A530,LOADMOD=HASJES20, 
 $HASP468 MACLEVEL=6,SPLEVEL=CHECK

JES2 displays the characteristics of HASPNUC in load module HASJES20.

 2 
  $d module(haspira)

  $HASP468      MODULE(HASPIRA) ADDR=00000000

JES2 displays the characteristics of HASPIRA in load module HASPINIT. However, if load module HASPINIT was not linked with load module HASJES20, the load module is no longer present. Therefore, the $HASP468 message cannot provide an address.

 3 
  $dmodule,routines=$post

  $HASP468 MODULE(HASPNUC)
  $HASP468 MODULE(HASPNUC)   ADDRESS=00006000,ASSEMBLY=(11/17/99,
  $HASP468                   18.07),ENVIRON=MIXED,EXITPTS=(7,21),
  $HASP468                   FMID=HJE6607,IBMJES2=BASE,
  $HASP468                   LASTAPAR=OW40627,LASTPTF=UW63110,
  $HASP468                   LENGTH=00A530,LOADMOD=HASJES20,
  $HASP468                   MACLEVEL=6,ROUTINES=($POST=00007EA8),
  $HASP468                   SPLEVEL=CHECK

JES2 displays the module containing the routine $POST and includes the address of the $POST routine itself.

 4 
  $dmodule(*),lastapar=none

  $HASP468 MODULE(HASCDAU)   ADDRESS=03004BB8,ASSEMBLY=(08/19/92,
  $HASP468                   15.55),ENVIRON=USER,EXITPTS=(),
  $HASP468                   IBMJES2=BASE,LASTAPAR=NONE,
  $HASP468                   LENGTH=0002C0,LOADMOD=HASCDAU,
  $HASP468                   MACLEVEL=4,SPLEVEL=CHECK

  $HASP468 MODULE(HASCDSAL)  ADDRESS=02FF2478,ASSEMBLY=(08/19/92,
  $HASP468                   15.56),ENVIRON=USER,
  $HASP468                   EXITPTS=(31,34,48),IBMJES2=BASE,
  $HASP468                   LASTAPAR=NONE,LENGTH=004B80,
  $HASP468                   LOADMOD=HASCDSAL,MACLEVEL=4,
  $HASP468                   SPLEVEL=CHECK

JES2 displays information about the modules that have not been affected by service.

  $dmodule,(hascsisc),long

  $HASP468 MODULE(HASCSISC)
  $HASP468 MODULE(HASCSISC)  ADDRESS=05DAC000,ASSEMBLY=(11/17/99,
  $HASP468                   16.04),ENVIRON=USER,EXITPTS=(),
  $HASP468                   FMID=HJE6607,IBMJES2=BASE,
  $HASP468                   LASTAPAR=OW35104,LASTPTF=UW63920,
  $HASP468                   LENGTH=004130,LOADMOD=HASCSISC,
  $HASP468                   MACLEVEL=6,
  $HASP468                   ROUTINES=(SSICSCAN=05DAC050,
  $HASP468                   SSICSTAT=05DAC2E0,SSISTAT=05DAC760,
  $HASP468                   CNVDEVID=05DAF1C8,PRJBCLD=05DAF4C8),
  $HASP468                   SPLEVEL=CHECK,TABLES=(),
  $HASP468                   VERSION=OS 2.7.0,UVERSION=

JES2 displays characteristics of module HASCSISC, including extended attributes such as the list of routine names.

 5 
  $dmodule(haspnuc),addr,assembly,env,exitpts

  $HASP468 MODULE(HASPNUC)   ADDRESS=00006000,ASSEMBLY=(08/19/92,
  $HASP468                   16.37),ENVIRON=JES2,EXITPTS=(7,14,21)

JES2 displays the address, assembly date, environment, and exit points for module HASPNUC.

 6 
  $dmod(haspnuc),load,macl,spl

  $HASP468 MODULE(HASPNUC)   LOADMOD=HASJES20,MACLEVEL=4,
  $HASP468                   SPLEVEL=CHECK

This command displays the name of the load module in which this module is linked, the value assigned to the SET= parameter on the SPLEVEL macro, and the SPLEVEL= assigned.