DSPDTAARA (Display Data Area) Command Description

DSPDTAARA Command syntax diagram

Purpose

The Display Data Area (DSPDTAARA) command displays the attributes and value of the specified data area. The following attributes are displayed: the type and length of the data area, the library where the data area is located (there is no library associated with a local data area, the group data area, or the program initialization parameter data area), and the text describing the data area.

If the job is a group job, the data area specified may be the group data area (*GDA). This data area is automatically associated with the group and it cannot be read from jobs outside the group. The length of this character data area is 512 bytes. More information about group jobs is in the Work Management book.

The local data area (*LDA) is a character data area 1024 bytes long. It is automatically associated with the job and cannot be accessed from another job.

If the job is a prestart job, the data area specified may contain program initialization parameter data (*PDA). This data area is automatically associated with the prestart job and is inaccessible from other jobs. The length of this character data area is 2000 bytes. More information about prestart jobs is in the Work Management book.

Restriction: To use this command, the user must have *USE authority for the data area and *EXECUTE authority for the library. No specific authority is required for the local data area or the group data area.

Required Parameter

DTAARA
Specifies the name and library of the data area whose attributes and value are to be displayed.

The name of the data area can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list 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.

library-name: Specify the name of the library to be searched.

data-area-name: Specify the name of the data area to be displayed.

*GDA: The group data area is displayed if this is a group job.

*LDA: The local data area is displayed.

*PDA: The program initialization parameter data area is displayed if this is a prestart job.

Optional Parameters

OUTPUT
Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output. More information on this parameter is in commonly used parameters.

*: 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.

OUTFMT
Specifies the format in which the objects are shown.

*CHAR: The output is displayed in character format.

*HEX: The output is displayed in both hexadecimal format and character format. This value is valid only for character data areas.

SYSTEM
Specifies whether the information provided is the data area on the local system (*LCL) or on the remote system (*RMT).

*LCL: The data displayed is for the local data area.

*RMT: The data displayed is from the remote data area named on the RMTDTAARA paramter of a successfully issued CRTDTAARA command. To view this data, specify the name of the data area created on the CRTDTAARA command, not the name of the remote data area.

Examples for DSPDTAARA

Example 1: Displaying Output in Hexadecimal and Character Format 

DSPDTAARA  DTAARA(HEXDATA)  OUTPUT(*)  OUTFMT(*HEX)

The value and attributes of data area HEXDATA are displayed if the user has proper authority. Both character and hexadecimal representations are shown.

Example 2: Displaying Output in Character Format 

DSPDTAARA  DTAARA(TIME)  OUTPUT(*)

The value and attributes of the data area TIME are displayed if the user has the proper authority. The library list is used to find the data area.

Error messages for DSPDTAARA

*ESCAPE Messages

CPF1015
Data area &1 in &2 not found.
CPF1016
No authority to data area &1 in &2.
CPF1021
Library &1 not found for data area &2.
CPF1022
No authority to library &1 data area &2.
CPF104A
SYSTEM(*RMT) not allowed for data area &1 in library &2.
CPF1046
DTAARA(*GDA) not valid because job not group job.
CPF1048
OUTFMT(*HEX) not valid for data area &1 in library &2.
CPF1063
Cannot allocate data area &1 in library &2.
CPF1067
Cannot allocate library &1.
CPF1072
DTAARA(*PDA) not valid because job not prestart job.
CPF9845
Error occurred while opening file &1.
CPF9846
Error while processing file &1 in library &2.
CPF9847
Error occurred while closing file &1 in library &2.
CPF9850
Override of printer file &1 not allowed.
CPF9851
Overflow value for file &1 in &2 too small.
CPF9871
Error occurred while processing.