Display Spooled File (DSPSPLF)

The Display Spooled File (DSPSPLF) command shows the data records in the specified spooled file. The current contents of the file (data records) can be displayed any time an entry for the spooled file is on the output queue. The screen provides various functions to display various parts of the file and to scan for a specific character string.

Parameters

Keyword Description Choices Notes
FILE Spooled file Name Required, Positional 1
JOB Job name Single values: *
Other values: Qualified job name
Optional, Positional 2
Qualifier 1: Job name Name
Qualifier 2: User Name
Qualifier 3: Number 000000-999999
SPLNBR Spooled file number 1-999999, *ONLY, *LAST, *ANY Optional, Positional 3
JOBSYSNAME Job system name Name, *ONLY, *CURRENT, *ANY Optional
CRTDATE Spooled file created Single values: *ONLY, *LAST
Other values: Element list
Optional
Element 1: Creation date Date
Element 2: Creation time Time, *ONLY, *LAST
FOLD Fold records *NO, *YES Optional

Spooled file (FILE)

Specifies the spooled file which has its records displayed.

This is a required parameter.

name
Specify the file name of the spooled file to be displayed.

Job name (JOB)

Specifies the name of the job that created the spooled file whose data records are to be displayed.

Single values

*
The job that issued this command is the job that created the spooled file.

Qualifier 1: Job name

name
Specify the name of the job that created the spooled file.

Qualifier 2: User

name
Specify the user name that identifies the user profile under which the job is run.

Qualifier 3: Number

000000-999999
Specify the system-assigned job number.

Spooled file number (SPLNBR)

Specifies the number of the job's spooled file that is to be displayed.

*ONLY
Only one spooled file in the job has the specified file name; therefore, the number of the spooled file is not necessary.
*LAST
The spooled file with the highest number and the specified file name is used.
*ANY
The spooled file number is not used to determine which spooled file is used. Use this value when the job system name parameter or the spooled file create date and time parameter is to take precedence over the spooled file number when selecting a spooled file.
1-999999
Specify the number of the spooled file having the specified file name whose data records are displayed.

Job system name (JOBSYSNAME)

Specifies the system where the job that created the spooled file (JOB parameter) ran. This parameter is considered after the job name, user name, job number, spooled file name, and spooled file number parameter requirements have been met.

*ONLY
There is one spooled file with the specified job name, user name, job number, spooled file name, spooled file number, and spooled file create date and time.
*CURRENT
The spooled file created on the current system with the specified job name, user name, job number, spooled file name, spooled file number, and create date and time is used.
*ANY
The job system name is not used to determine which spooled file is used. Use this value when the spooled file create date and time parameter is to take precedence over the job system name when selecting a spooled file.
name
Specify the name of the system where the job that created the spooled file ran.

Spooled file created (CRTDATE)

Specifies the date and time the spooled file was created. This parameter is considered after the job name, user name, job number, spooled file name, spooled file number, and job system name parameter requirements have been met.

Single values

*ONLY
There is one spooled file with the specified job name, user name, job number, spooled file name, spooled file number, and job system name.
*LAST
The spooled file with the latest create date and time of the specified job name, user name, job number, spooled file name, spooled file number, and job system name is used.

Element 1: Creation date

date
Specify the date the spooled file was created.

Element 2: Creation time

*ONLY
There is one spooled file with the specified job name, user name, job number, spooled file name, spooled file number, job system name, and spooled file create date.
*LAST
The spooled file with the latest create time of the specified job name, user name, job number, spooled file name, spooled file number, job system name, and spooled file create date is used.
time
Specify the time the spooled file was created.

Fold records (FOLD)

Specifies whether the first display has the records folded (wrapped) if they are longer than the length of the display line.

*NO
The records are not folded. When the length of the record is longer than one line, the remaining positions of the record are not shown.
*YES
The initial display shows the first record folded on one or more display lines if it is longer than one line.

Examples

DSPSPLF   FILE(QPRINT)  JOB(PAYROLL01)  SPLNBR(4)  FOLD(*NO)

In this example, the spooled file QPRINT is displayed. The file is the fourth file produced by the job PAYROLL01. The record positions that are longer than the length of the display line are truncated on the first display.

Error messages

*ESCAPE Messages

CPF2207
Not authorized to use object &1 in library &3 type *&2.
CPF3303
File &1 not found in job &5/&4/&3.
CPF3308
Error occurred when trying to display data.
CPF3309
No files named &1 are active.
CPF3330
Necessary resource not available.
CPF3340
More than one file with specified name found in job &5/&4/&3.
CPF3342
Job &5/&4/&3 not found.
CPF3343
Duplicate job names found.
CPF3344
File &1 number &8 no longer in the system.
CPF3359
Not able to display data.
CPF3386
File &1 in &2 not a data base file.
CPF3387
Cannot display data in file &1 in &2.
CPF3394
Cannot convert spooled file data.
CPF33F9
Error occurred while displaying file &1 number &6.
CPF3427
Job &5/&4/&3 not interactive job.
CPF3428
DSPSPLF command ended for file &1 number &8.
CPF3429
File &1 number &7 cannot be displayed, copied, or sent.
CPF3434
Data in file &1 in &2 member &3 not in required format.
CPF3435
Requested data not found in file &1 in &2 member &3.
CPF3478
File &1 not found in job &5/&4/&3 on output queue &6 in library &7.
CPF3492
Not authorized to spooled file.
CPF7D41
Error occurred while logging order assistance request.
CPF7D42
Error occurred while performing database operation.
CPF9812
File &1 in library &2 not found.
CPF9815
Member &5 file &2 in library &3 not found.
CPF9845
Error occurred while opening file &1.
CPF9846
Error while processing file &1 in library &2.
CPF9871
Error occurred while processing.