Display Module (DSPMOD)

The Display Module (DSPMOD) command displays information about a module. The display includes information about the compiler, the source from which the module was created, the processing attributes of the module, and the size of the module.

Restrictions:

Parameters

Keyword Description Choices Notes
MODULE Module Qualified object name Required, Positional 1
Qualifier 1: Module Name
Qualifier 2: Library Name, *LIBL, *CURLIB
DETAIL Detail Single values: *ALL
Other values (up to 7 repetitions): *BASIC, *SIZE, *EXPORT, *IMPORT, *PROCLIST, *REFSYSOBJ, *COPYRIGHT		 Optional, Positional 2
OUTPUT Output *, *PRINT, *OUTFILE Optional, Positional 3
OUTFILE File to receive output Qualified object name Optional
Qualifier 1: File to receive output Name
Qualifier 2: Library Name, *LIBL, *CURLIB
OUTMBR Output member options Element list Optional
Element 1: Member to receive output Name, *FIRST
Element 2: Replace or add records *REPLACE, *ADD

Module (MODULE)

Specifies the module for which information is to be displayed.

This is a required parameter.

Qualifier 1: Module

name
Specify the name of the module for which information is displayed.

Qualifier 2: Library

*LIBL
All libraries in the library list for the current thread are searched until the first match is found.
*CURLIB
The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
name
Specify the name of the library to be searched.

Detail (DETAIL)

Specifies which set of information is displayed for the module.

Single values

*ALL
All the information applicable to the specified module is displayed or printed.

Note: DETAIL(*ALL) is valid only when information is displayed or printed. It is not valid if *OUTFILE is specified for the Output (OUTPUT) parameter.

Other values (up to 7 repetitions)

*BASIC
The basic module information, module compatibility section, and SQL information is shown.
*SIZE
The size and size limits for this module are shown.
*EXPORT
The symbols defined in this module that are exported to other modules are shown.
*IMPORT
The symbols defined externally to this module are shown.
*PROCLIST
A list of the procedure names with their type and priority is shown.
*REFSYSOBJ
A list of the system objects referred to by this module when the module is bound into a bound program or service program is shown.
*COPYRIGHT
Copyright information for this module is shown.

Output (OUTPUT)

Specifies whether the output from this command is displayed, printed, or directed to a database file.

*
Output requested by an interactive job is shown on the display. Output requested by a batch job is printed with the job's spooled output.
*PRINT
The output is printed with the job's spooled output.
*OUTFILE
The output is directed to the database file specified for the File to receive output (OUTFILE) parameter.

Note: When a procedure name longer than 256 characters is encountered and the value *OUTFILE is specified, the last 253 characters of the procedure name are placed in the output file and are preceded by three less than (<<<) characters. The less than (<<<) characters indicate that this is only a partial name. The diagnostic message CPD5D12, which indicates that not all available information is returned, is sent to the job log. The same message is sent as a status message to the calling program of the command processing program (CPP) that can be monitored. You can use the Retrieve Module Information (QBNRMODI) or the List Module Information (QBNLMODI) APIs to find the complete name of the procedure.

Note: DETAIL(*ALL) is not valid when OUTPUT(*OUTFILE) is specified.

File to receive output (OUTFILE)

Specifies the database file to which the output of this command is directed. If the output file does not exist, this command creates a database file in the specified library. If the file is created, the text is "Output file for DSPMOD", The public authority of the file is the same as the create authority specified for the library in which the file is created. The record format of the output file will be the same as that used in the IBM-supplied database file.

Note: When a procedure name longer than 256 characters is encountered and the value *OUTFILE is specified, the last 253 characters of the procedure name are placed in the output file and are preceded by three less than (<<<) characters. The less than (<<<) characters indicate that this is only a partial name. The diagnostic message CPD5D12, which indicates that not all available information is returned, is sent to the job log. The same message is sent as a status message to the calling program of the command processing program (CPP) that can be monitored. You can use the Retrieve Module Information (QBNRMODI) or the List Module Information (QBNLMODI) APIs to find the complete name of the procedure.

The IBM-supplied database files and their record formats are as follows: 

Detail:    File:      Record Format:
*BASIC     QABNDMBA   QBNDMBAS
*SIZE      QABNDMSI   QBNDMSIZ
*EXPORT    QABNDMEX   QBNDMEXP
*IMPORT    QABNDMIM   QBNDMIMP
*PROCLIST  QABNDMPR   QBNDMPRO
*REFSYSOBJ QABNDMRE   QBNDMREF
*COPYRIGHT QABNDMCO   QBNDMCOP

Qualifier 1: File to receive output

name
Specify the name of the database file that receives the output of this command.

Qualifier 2: Library

*LIBL
All libraries in the library list for the current thread are searched until the first match is found.
*CURLIB
The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
name
Specify the name of the library to be searched.

Output member options (OUTMBR)

Specifies the name of the database file member to which the output is directed. If a member already exists, the system uses the second element of this parameter to determine whether the member is cleared before the new records are added. If the member does not exist and a member name is not specified, the system creates a member with the name of the output file specified for the File to receive output (OUTFILE) parameter If an output file member name is specified, but the member does not exist, the system creates it.

Element 1: Member to receive output

*FIRST
The first member in the file receives the output. If OUTMBR(*FIRST) is specified and a file member does not exist, the system creates a member with the name of the file specified on the OUTFILE parameter.
name
Specify the name of the file member that receives the output. If the member does not exist, the system creates it.

Element 2: Replace or add records

*REPLACE
The system clears the existing member and adds the new records.
*ADD
The system adds the new records to the end of the existing records.

Examples 

DSPMOD   MODULE(MYMOD)

This command displays module object MYMOD from the library list.

Error messages

*ESCAPE Messages

CPF5CE7
Error occurred while retrieving *MODULE data
CPF9801
Object &2 in library &3 not found.
CPF9802
Not authorized to object &2 in &3.
CPF9803
Cannot allocate object &2 in library &3.
CPF9807
One or more libraries in library list deleted.
CPF9808
Cannot allocate one or more libraries on library list.
CPF9810
Library &1 not found.
CPF9820
Not authorized to use library &1.
CPF9830
Cannot assign library &1.
CPF9871
Error occurred while processing.

*STATUS Messages

CPD5D12
One or more records have incomplete values.