Work with Spooled File Attr (WRKSPLFA)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Work With Spooled File Attributes (WRKSPLFA) command shows the current attributes of the specified spooled file. The attributes can be displayed after the file is opened and while its file entry is still on the output queue.

Top

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
OUTPUT Output *, *PRINT Optional
Top

Spooled file (FILE)

Specifies the spooled file for which you wish to display the attributes.

This is a required parameter.

name
Specify the file name of the spooled file to have its attributes displayed.
Top

Job name (JOB)

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

Single values

*
The job that entered 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. If no other job qualifiers are given, all jobs currently in the system are searched for the simple name of the job.

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.
Top

Spooled file number (SPLNBR)

Specifies the unique number of the spooled file in the job whose attributes are 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 with the specified file name whose attributes are displayed.
Top

Job system name (JOBSYSNAME)

Specifies the name of 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.
Top

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.
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 if requested by an interactive job or printed if requested by a batch job.
*PRINT
The output is printed with the job's spooled output.
Top

Examples

WRKSPLFA   FILE(QPRINT)  OUTPUT(*PRINT)

This command prints a file containing the current attributes of the spooled file QPRINT and sends it to the job's output queue to be printed. The job that entered this command must have produced only one output file named QPRINT.

Top

Error messages

*ESCAPE Messages

CPF3302
Override of print file &1 to file &2 not valid.
CPF3303
File &1 not found in job &5/&4/&3.
CPF3309
No files named &1 are active.
CPF3330
Necessary resource not available.
CPF3336
Job &5/&4/&3 no longer in the system.
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.
CPF7D41
Error occurred while logging order assistance request.
CPF7D42
Error occurred while performing database operation.
CPF9845
Error occurred while opening file &1.
CPF9846
Error while processing file &1 in library &2.
CPF9871
Error occurred while processing.
Top