DSPSPLF (Display Spooled File)

DSPSPLF Command syntax diagram

 

Purpose

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 for spooled files which do not contain ASCII data.The display provides various functions to show the file and to scan for a specific character string.

 

Required Parameters

FILE
Specifies the name of the spooled file whose records are to be displayed.

 

Optional Parameters

JOB
Specifies the qualified name of the job and consists of as many as three elements. For example:
job-name
user-name/job-name
job-number/user-name/job-name

*N may be used in place of the user-name element to maintain position in the sequence. More information on this parameter is in commonly used parameters.

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

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

user-name: Specify the name of the user of the job that created the spooled file.

job-number: Specify the number of the job that created the spooled file.

SPLNBR
Specifies the number of the job's spooled file that is being displayed. More information on this parameter is in commonly used parameters.

*ONLY: One spooled file from the job has the specified file name. The number of the spooled file is not necessary. If *ONLY is specified and more than one spooled file has the specified file name, a message is sent.

*LAST: The highest-numbered spooled file with the specified file name is displayed.

*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 creation date and time parameter is to take precedence over the spooled file number when selecting a spooled file.>

spooled-file-number: Specify the number of the spooled file having the specified file name whose data records are displayed.

Start of changeJOBSYSNAME
Specifies the name of the system where the job that create 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 creation 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 creation 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 creation date and time parameter is to take precedence over the job system name when selecting a spooled file.

system name: Specify the name of the system where the job that created the spooled file ran.

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.

*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 creation 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: Date spooled file was created

date: Specify the date the spooled file was created.

Element 2: Time spooled file was created

*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 creation date.

*LAST: The spooled file with the latest creation time of the specified job name, user name, job number, spooled file name, spooled file number, job system name, and spooled file creation date is used.

time: Specify the time the spooled file was created.End of change

FOLD
Specifies whether the records in the first display are folded 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 first display shows the first record folded on one or more display lines if it is longer than one line.

Example for DSPSPLF

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 for DSPSPLF

*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 &2 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 &2.
CPF3427
Job &5/&4/&3 not interactive job.
CPF3428
DSPSPLF command ended for file &1 number &2.
CPF3429
File &1 number &2 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.