$D MODule(jxxxxxxx) - Display assembled module information
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 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
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.
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 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.