RLSSPLF (Release Spooled File)

RLSSPLF Command syntax diagram

 

Purpose

The Release Spooled File (RLSSPLF) command releases a specified spooled file formerly held on an output queue for processing by a spooling writer. The RLSSPLF command can release a spooled file that was held by:

• A HLDSPLF command
• HOLD(*YES) being specified in the device file or on an override command
• SAVE(*YES) being specified in the device file, on an override command, or in the CHGSPLFA command
• A HLDWTR command and a RLSWTR command with OPTION(*BYPASS) specified
• The operator canceling a system request to put forms on the printer
• HLDJOB SPLF(*YES) if the job is later ended while the job is held and the spooled file action (SPLFACN) job attribute is *DETACH.>

 

Required Parameters

FILE

Specifies the name of the spooled file that is being released to be written to an output device.

*SELECT: All spooled files that meet the selection requirements specified in the SELECT keyword are released. This value is mutually exclusive with the JOB, SPLNBR, JOBSYSNAME, and CRTDATE parameters. Specifying *SELECT causes the JOB, SPLNBR, JOBSYSNAME, and CRTDATE parameters to be ignored.

spooled-file-name: Specify the name of the spooled file being released.

 

Optional Parameters

JOB

Specifies the name of the job that created the file being released for additional processing.

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 that issued this RLSSPLF command is the job that produced the spooled file being released. If no job qualifier is given, all of the jobs currently in the system are searched for the simple job name.

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 file being released.

job-number: Specify the number of the job that created the file being released.

SPLNBR

Specifies the number of the spooled file being released. 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 to release that has the specified file 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 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, and spooled file number 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.

SELECT

Specifies which group of files is selected for being released. Files can be selected based on user, device, form type, or user data. Only files that meet each of the requirements are selected.

Element 1: User Values

*CURRENT: Only files created by the user running this command are released.

*ALL: Files created by all users are released.

user-name: Specify the user name of the files being released.

Element 2: Device Values

*ALL: Files queued for any device or on any object queue are released.

*OUTQ: All files that are not queued for a device are released. These files are on output queues that are not associated with printers.

device-name: Specify the name of the device whose queued files are released.

Element 3: Form Type Values

*ALL: Files for all form types are released.

*STD: Only files that specify the standard form type are selected.

form-type: Only files with the specified form type are released.

Element 4: User Data Values

*ALL: Files with any user data tag specified are released.

user-data: Only files with the specified user data tag are released.

Example for RLSSPLF

RLSSPLF  FILE(STOCK14)  JOB(000047/SMITH/MASTER)

This command releases the spooled file named STOCK14 created in the job named MASTER. The file can now be selected for processing by the spooling writer. The job was run under the user profile named SMITH and was assigned the job number 000047 by the system.

Error messages for RLSSPLF

*ESCAPE Messages

CPF33D0

Printer &1 does not exist.

CPF33D1

User &1 does not exist.

CPF3303

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

CPF3304

File &1 number &2 cannot be released.

CPF3309

No files named &1 are active.

CPF3322

File &1 number &2 not released.

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.

CPF3357

Output queue &1 in library &2 not found.

CPF3362

Objects in QTEMP not valid for parameter values.

CPF3492

Not authorized to spooled file.