 |
» |
|
|
|
The SPOOLF command enables you to alter, print, or delete
spool files. Syntax | |
Alter option:
SPOOLF [IDNAME=]{spoolid
(spoolid[,spoolid]...)}
{;ALTER}[;DEV={ldev
devclass
devname}][;PRI=outpri][;COPIES=numcopies]
[;SPSAVE][;DEFER
;UNDEFER][;SHOW]
|
Print option:
SPOOLF [IDNAME=]{fileset
(fileset[,fileset]...)}
{;PRINT}[;DEV={ldev
devclass
devname}][;PRI=outpri][;COPIES=numcopies]
[;SPSAVE][;DEFER
;UNDEFER][;SHOW]
|
Delete option:
SPOOLF [IDNAME=]{spoolid
(spoolid[,spoolid]...)}
{;DELETE}[;SHOW]
|
Parameters | |
Alter Option: - IDNAME
Specifies one or more spool file IDs, spoolid,
in the form of #Onnn. The spooling subsystem assigns the IDs when the
spool files are created. The # and the O are optional and are assumed if you do
not supply them.
As a shortcut, you can use O@ to specify all output spool files. If you have system manager (SM) or system supervisor (OP)
capability, O@ affects all output spool files on the
system. If you have account manager (AM)
capability, O@ affects all output spool files created
by users in the same account. If you do not have any of these capabilities,
you are limited to alter only files that you have created.
- ALTER
Alters the characteristics of specified spool files. The
DEFER, DEV, and SPSAVE parameters affect the ALTER option
as follows: If you use DEFER or DEV for a spool file currently printing,
the spooler process interrupts the printing. The spooler process saves the
page number of the last complete page that was printed.
The next time any spooler selects
the file for printing, output resumes at the saved page number.
Because large amounts of data are buffered in the file system and the
device, an output device may continue to print, appearing as though
DEFER and DEV have not affected printing. This is because the spooler
stops sending data to the device when the command is received, but must
wait until all buffered data has been printed before releasing the spool file.
Depending on both the content of the data and the amount of buffering,
this may require a significant part of a page or even several pages.
You cannot alter the attributes of spool files in the SPSAVE state.
- DEV
Specifies the device, which may have one of the following values: - ldev
Specifies the logical device number of the spool file's new
destination device.
If the spool file is in the print state, it returns
to the ready state. It can immediately enter the print state on
ldev if it meets all requirements. The system interrupts spool file printing only if the newly specified target
ldev differs from the previous target ldev.
- devclass
Specifies the new destination device class name for
the spool file. If the spool file is in the print state, it returns
to the ready state. It can immediately enter the print state on
a device in devclass if it meets all requirements. The devclass parameter must begin with a letter and consist of eight
or fewer alphanumeric characters. The system does not allow the same name
to be configured as a device class name and a device name. The system interrupts spool file printing only if the newly specified target
devclass differs from the previous target devclass.
- devname
Specifies the device name of the spool file's new destination
device. If the spool file is in the print state, it returns
to the ready state. It can immediately enter the print state on
devname if it meets all requirements. This occurs even if devname
is the same as the device currently printing the file. The devclass parameter must begin with a letter and consist of eight
or fewer alphanumeric characters. The system does not allow the same name
to be configured as a device class name and a device name. The system interrupts spool file printing only if the newly specified target
devname differs from the previous target devname.
- PRI
Specifies the output priority of the designated spool files,
where 0 is the lowest priority and 14 is the highest priority. You can
specify an outpri of 14 only from the console or if you have system
supervisor (OP) capability; otherwise, the highest priority is 13.
- COPIES
Specifies the number of copies, numcopies, of the
designated spool files to be printed. The allowable range is from 1 through
65535.
- SPSAVE
Specifies that the selected spool files are not to be deleted
after the last copies have printed. Instead, the spool files are retained
in the HPSPOOL account in the SPSAVE state until you manually
delete them. You cannot, however, save private spool files. When a file enters the SPSAVE state, the system sets the priority to 8
and the number of copies to 1.
- DEFER
Changes the spool file's state to DEFER. If the spool file
is currently in the print state, its spooler is notified and
printing stops. The spool file's priority remains unchanged.
If you use this parameter with the PRINT option, the system copies
the spool file to OUT.HPSPOOL and links it to the spooling system, but the
state of the spool file is DEFER. The spool file does not print until
you enter a subsequent SPOOLF...;UNDEFER. If you use the DEFER parameter for any file in the CREATE state
(open for original creation), the spool file only enters the DEFER state
after it is completed (closed for the last time).
- UNDEFER
Changes a spool file's state from DEFER to READY
and causes a spooler to start printing the spool file if the spool file
is qualified to be printed by an idle printer. The spool file's priority
remains unchanged.
- SHOW
Displays the results of the SPOOLF command. When you
enter a SPOOLF command string, all parameters process before the
SHOW parameter.
Print Option: - IDNAME
Specifies the set of files, fileset, to be printed. This parameter has the following form: filename[/lockword[.groupname[.accountname]]] If the file name or set is not fully qualified, the default is the user's
current logon group and account. In batch mode, if any file in the set
has a lockword, you must supply it with the command; therefore, the file
cannot be part of a set that contains wildcards. This restriction does not
apply in interactive mode, because the system prompts you for each required
lockword. If you do not provide the correct lockword for either mode, the
print option fails for the file and the command continues to process the
remaining files.
- PRINT
Copies the specified file sets to the HPSPOOL account
and links the new output spool files into the spool queues for printing.
This parameter is especially useful for generating additional copies of
a spool file in the SPSAVE state. You must have nonshareable device
(ND) capability to use the PRINT option. You cannot
print private files using this option.
- DEV
For information about this parameter, refer to DEV for
the ALTER option.
- PRI
For information about this parameter, refer to PRI for
the ALTER option.
- COPIES
For information about this parameter, refer to COPIES for
the ALTER option.
- SPSAVE
For information about this parameter, refer to SPSAVE for
the ALTER option.
- DEFER
For information about this parameter, refer to DEFER for
the ALTER option.
- UNDEFER
For information about this parameter, refer to UNDEFER for
the ALTER option.
- SHOW
For information about this parameter, refer to SHOW for
the ALTER option.
Delete Option: - IDNAME
For information about this parameter,
refer to IDNAME for the Alter option.
- DELETE
Purges all specified private or nonprivate spool files that you can access from the system. If a spool file is not in use (opened by a user, or being printed or stored),
it is purged immediately. If it is in use, the system places it in the
DELPND state. The printer spooler process is notified, and printing
stops at that point. Because large amounts of data are buffered in the file system and the
device, an output device may continue to print, appearing as though
the DELETE option has not affected printing. This is because the spooler
stops sending data to the device when the command is received, but must
wait until all buffered data has been printed before stopping.
Depending on both the content of the data and the amount of buffering,
this may require a significant part of a page or even several pages. The DELETE option can delete all output spool files in the READY,
PRINT, DEFER, SPSAVE, or PROBLM states. The DELETE option cannot
delete $STDIN files. Use the ABORTJOB command for these files.
- SHOW
Refer to SHOW for the Alter option for information about
this parameter.
Operation Notes | |
Usage You can enter this command from a session, a job, a program, or in
break mode. Any user can enter this command; however the user's
capabilities determine which files the user can alter, print, or delete.
Altering private spool files
With certain limitations, you can alter private spool files. You can only
use the PRI, DEFER, UNDEFER, and DELETE parameters. If you have
system manager (SM) capability, you can also use the DEV parameter.
Problem state spool files
You can use the ALTER option on problem state spool files to alter the
device attribute so that the spool file becomes ready again. Generally,
the spool file is in the problem state because the target device of the
spool file is invalid.
Example | |
To change the priority of all output spool files to 8 and show the results,
enter:
:SPOOLF O@;ALTER;PRI=8;SHOW
SPOOLID JOBNUM FILEDES PRI COPIES DEV STATE RSPFN OWNER
#414 J5 $STDLIST 8 1 16 READY ALIX.MKT
#416 J7 HOTSTUFF 8 2 16 READY JACK.SALES
|
Related Commands | |
ABORTJOB
ALTSPOOLFILE
DELETESPOOLFILE
LISTFILE
LISTSPF
PRINT
PURGE
SPOOLER
|
|
