DLTSPLF (Delete Spooled File)

DLTSPLF Command syntax diagram

 

Purpose

The Delete Spooled File (DLTSPLF) command is used to delete the specified spooled file from the output queue. If the spooled file is currently being produced on a device, it is immediately stopped and deleted. Output that has not been written is lost.

For information on deleting multiple spooled files of a job, see the "Additional Considerations" section of the Work with Job (WRKJOB) command description. For information on deleting all spooled files of a job, see the ENDJOB (End Job) command description.

 

Required Parameters

FILE
Specifies the name of the spooled file being deleted from the output queue.

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

spooled-file-name: Specify the name of the spooled file being deleted from the system.

 

Optional Parameters

JOB
Specifies the name of the job that produced (or is producing) the spooled file being deleted from the output queue.

A job identifier is the 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 command is the job that produced the file being deleted.

job-name: Specify the name of the job that produced the file being deleted. If no job qualifier is given, all of the jobs currently in the system are searched for the simple job name.

user-name: Specify the name of the user of the job that produced the file being deleted.

job-number: Specify the number of the job that produced the file being deleted.

SPLNBR
Specifies the number of the job's spooled file being deleted from the output queue. 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 that is being deleted.

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.End of change

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

Element 1: User Names

*CURRENT: Only files created by the user running this command are selected for deletion.

*ALL: Files created by all users are selected for deletion.

user-name: Only files created by the specified user name are selected for deletion.

Element 2: Device Names

*ALL: Files queued for any device are selected for deletion.

*OUTQ: All files that are not queued for a device are selected for deletion. These files are on the output queue that are associated with printers.

device-name: Only files queued for the specified device name are selected for deletion.

Element 3: Form Types

*ALL: Files for all form types are selected for deletion.

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

form-type: Only files with the specified form type are selected for deletion.

Element 4: User Data Tags

*ALL: Files with any user data tag specified are selected for deletion.

user-data: Only files with the specified user data tag are selected for deletion.

Example for DLTSPLF 

DLTSPLF  FILE(WEEKLY)  JOB(000146/SMITH/PAYROLL5)

This command deletes the spooled file named WEEKLY (of job PAYROLL5, for user SMITH, job number 000146) from the output queue. Spooled files with different names produced by the job named PAYROLL5 are not affected by this command. If the job produced more than one file named WEEKLY, no file is deleted because SPLNBR(*ONLY) is assumed.

Error messages for DLTSPLF

*ESCAPE Messages

CPF33D0
Printer &1 does not exist.
CPF33D1
User &1 does not exist.
CPF3303
File &1 not found in job &5/&4/&3.
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.
CPF34A4
File &1 number &2 not held or deleted.
CPF3478
File &1 not found in job &5/&4/&3 on output queue &6 in library &7.
CPF3492
Not authorized to spooled file.
CPF8128
&8 damage on output queue &4 in library &9.