WRKSPLFA (Work with Spooled File Attributes)

WRKSPLFA Command syntax diagram

 

Purpose

The Work with Spooled File Attributes (WRKSPLFA) command allows you to work with the current attributes of the specified spooled file.

The attributes can be shown after the file is opened and while its file entry is still on the output queue.

 

Required Parameters

FILE

Specifies the name of the spooled file to have its attributes shown.

 

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 entered this WRKSPLFA command is the job that created the spooled file.

job-name: Specify the name of the job that created the spooled file. If no job qualifier is given, all jobs currently in the system are searched for the simple job name. More information on this parameter is in commonly used parameters.

SPLNBR

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

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

OUTPUT

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

*: The output is shown 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.

Example for WRKSPLFA

WRKSPLFA  FILE(QPRINT)  OUTPUT(*PRINT)

This command allows you to work with 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.

Error messages for WRKSPLFA

*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 &2 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.