WRKPRTSTS (Work with Printing Status)

WRKPRTSTS Command syntax diagram

 

Purpose

The Work with Printing Status (WRKPRTSTS) command allows you to list the status of printing jobs for a specified spooled file.

 

Required Parameters

FILE

Specifies the name of a file created by a user program and the name of the device file used to create the file.

 

Optional Parameters

JOB

Specifies the name of the job that created the spooled file. This parameter is valid only if a spooled file name is specified in the FILE parameter. If no job qualifier is given, all of the jobs currently in the system are searched for the simple job name.

A job identifier is a special value or a qualified name with up to three elements. For example:

*
job-name
user-name/job-name
job-number/user-name/job-name

More information on this parameter is in commonly used parameters.

*: The job from which this WRKPRTSTS command was entered 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 spooled file being processed. This parameter is valid only if a spooled file name is specified in the FILE parameter. 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 job's spooled file that is on the specified output queue and that is being processed first.

JOBSYSNAME

Specifies the name of the system where the job that created the spooled file being processed (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. This parameter is valid only if a spooled file name is specified in the FILE parameter.

*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 being processed 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. This parameter is valid only if a spooled file name is specified in the FILE parameter.

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

Example for WRKPRTSTS

WRKPRTSTS  FILE(MYFILE)

This command assumes that the user has a spooled file on an output queue that does not have a printer attached to it. When the user specifies this command, the Work with Printing Status display will be shown. One status message that would apply to the file named MYFILE would be, "This file is not associated with a started printer." Depending on the status of MYFILE, other status types could be shown.

Error messages for WRKPRTSTS

*ESCAPE Messages

CPF3303

File &1 not found in job &5/&4/&3.

CPF3309

No files named &1 are active.

CPF3330

Necessary resource not available.

CPF3342

Job &5/&4/&3 not found.

CPF3344

File &1 number &2 no longer in the system.

CPF34B4

WRKPRTSTS command not valid for diskette files.

CPF34B5

Printer &1 is not found.

CPF34B6

More than one printer was selected

CPF34B7

Printer must be selected from list of printers.

CPF9871

Error occurred while processing.