Display Data Area (DSPDTAARA)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Display Data Area (DSPDTAARA) command shows 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. Restrictions:
- To use this command, the user must have use (*USE) authority for the data area and execute (*EXECUTE) authority for the library. No specific authority is required for the local data area, group data area, or program initialization parameter data area.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| DTAARA | Data area | Single values: *LDA, *GDA, *PDA Other values: Qualified object name |
Required, Positional 1 |
| Qualifier 1: Data area | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| OUTPUT | Output | Optional, Positional 2 | |
| OUTFMT | Output format | *CHAR, *HEX | Optional |
| SYSTEM | System | *LCL, *RMT | Optional |
| Top |
Data area (DTAARA)
Specifies the name and library of the data area whose attributes and values are to be displayed.
This is a required parameter.
Single values
- *LDA
- The local data area is displayed. The local data area (*LDA) is a character data area 1024 bytes in length. It is automatically associated with your job and cannot be accessed from another job.
- *GDA
- The group data area is displayed, if this job is a group job. This data area is automatically associated with the group and can not be accessed from jobs outside the group. The length of this character data area is 512 bytes.
- *PDA
- The program initialization parameter data area is shown. This value is valid only if this is a prestart job. The length of this data area is 2000 bytes.
Qualifier 1: Data area
- name
- Specify the name of the data area.
Qualifier 2: Library
- *LIBL
- All libraries in the thread's library list are searched until a match is found.
- *CURLIB
- The current library for the thread is used to locate the object. If no library is specified as the current library for the thread, the QGPL library is used.
- name
- Specify the library where the data area is located.
| Top |
Output (OUTPUT)
Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.
- *
- The output is displayed for interactive jobs or printed with the job's spooled output for non-interactive jobs.
- The output is printed with the job's spooled output.
| Top |
Output format (OUTFMT)
Specifies the format in which the value of the data area is shown. In order to show the hexadecimal value of characters that cannot be shown, both character and hexadecimal representations of a character data area can be shown.
- *CHAR
- The output is shown in character format.
- *HEX
- The output is shown in both hexadecimal format and character format. This value is valid only for character data areas.
| Top |
System (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 data area on the local system.
- *RMT
- The data displayed is from the remote data area named on the RMTDTAARA parameter of a successfully issued Create Data Area (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.
| Top |
Examples
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.
| Top |
Error messages
*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.
- CPF9899
- Error occurred during processing of command.
| Top |