Altering, Printing and Deleting Spoolfiles--The SPOOLF Command [ Introduction to MPE XL for MPE V System Administrators ] MPE/iX 5.0 Documentation
Introduction to MPE XL for MPE V System Administrators
Altering, Printing and Deleting Spoolfiles--The SPOOLF Command
The SPOOLF command enables you to alter characteristics of spoolfiles
such as the device, the output priority, the number of copies to print
and whether or not the spoolfile should be saved or deferred. You may
also use it to print or delete spoolfiles.
Altering Spoolfiles
You may use the ;ALTER parameter of the SPOOLF command to alter the
characteristics of spoolfiles.
To alter the print device (to device class LP2) for three spoolfiles
enter:
SPOOLF (357,375,458);ALTER;DEV=LP2
You may specify a device class, as in the example, or you may specify a
logical device number or device name.
To alter the output priority of all output spoolfiles of which you are
the owner (or, if you are logged onto the console, or have OP or SM
capability, all output spoolfiles on the system) enter:
SPOOLF O@;ALTER;PRI=12
To alter the number of copies for one or more output spoolfiles enter:
SPOOLF (357,375,458);ALTER;COPIES=3
To defer one or more spoolfiles enter:
SPOOLF (357,375,458);ALTER;DEFER
A deferred spoolfile will not print.
NOTE When a spoolfile is deferred in this way, its priority is not
changed. Instead, it is simply marked as deferred.
To undefer one or more spoolfiles enter:
SPOOLF (357,375,458);ALTER;UNDEFER
An undeferred output spoolfile will print if its output priority exceeds
the outfence of the printer to which it has been sent.
The ;ALTER parameter of the SPOOLF command has a selection equation
option that enables you to specify a group or subset of spoolfiles on
which to perform the alterations.
For example:
SPOOLF O@;ALTER;SELEQ=[OWNER=@.MFG];PRI=12
[REV END][REV BEG]
The DELPND State and ;ALTER - Additional Considerations
A spoolfile is put into the DELPND (delete pending) state by issuing the
PURGE command, the DELETESPOOLFILE command, or the SPOOLF nnn;DELETE
command on the spoolfile. The STORE subsystem with the PURGE option also
puts a file into the DELPND state. SPOOLF nnn;ALTER changes the
spoolfile state from DELPND to its previous state.
Altering an Actively Printing File.
If a spooler is printing the spoolfile and has not yet closed the file,
entering the command SPOOLF nnn;ALTER returns the file to the PRINT
state. But first the spooler prints all data currently in the buffer and
closes the file.
Because the spooler has been interrupted while printing a spoolfile, it
marks the spoolfile as incompletely printed when it closes it. The
spoolfile is put into the READY state, where it can be selected for
printing once again.
A Spoolfile Opened by a User Process.
A user process that has opened a spoolfile is not interrupted by the
SPOOLF nnn;DELETE command nor by the a SPOOLF nnn;ALTER command. When
the user process eventually closes the spoolfile, the file disposition
used during the close determines the fate of the spoolfile. The
spoolfile returns to the state it was in before the user opened it, if it
continues to exist.
Printing Spoolfiles
You may use the ;PRINT option of the SPOOLF command to print spoolfiles.
For more information on printing spoolfiles refer to the PRINTSPF utility
described later in this chapter.
Suppose you have copied a spoolfile from the OUT group of the HPSPOOL
account into the PUB group of the MFGRPTS account and named it MFGDATA.
To print this spoolfile, while you were logged onto that group and
account, you would enter:
SPOOLF MFGDATA;PRINT;DEV=LP
To print MFGDATA from a different logon group and account you would add
the spoolfile's group and account name as follows:
SPOOLF MFGDATA.PUB.MFGRPTS;PRINT;DEV=LP
SPOOLF @.PUB.MFG;PRINT;DEV=6
Deleting Spoolfiles with the SPOOLF Command
The ;DELETE option of the SPOOLF command allows you to delete spoolfiles.
To delete one or more spoolfiles enter:
SPOOLF (357,375,458);DELETE;SHOW
[REV END]
[REV
BEG]
MPE/iX 5.0 Documentation