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:

• You must have use (*USE) authority to the module being displayed and execute (*EXECUTE) authority to the library in which the module is stored.

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

Top

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.