HPlogo Commands Reference HP 3000 Series 9X8LX Computer Systems > Chapter 2 MPE/iX Commands

SPOOLER
» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

spacerspacerspacer
spacer
spacer
  		 
 

The SPOOLER command enables you to do the following:

  • Show the status of the spooling process

  • Enable or disable spooling for a specified logical device, device name, or all devices of a device class

  • Start, stop, suspend, and resume spooler printing processes

  • Release files from the spooler process

Syntax



   SPOOLER [DEV=]{ldev

                  devclass

                  devname}

Plus one of the following options:

Status option:



   {;SHOW}

Enable/Disable option:



   {;OPENQ

    ;SHUTQ}[;SHOW]

Start option:



   {;START}[;OPENQ

            ;SHUTQ][;SHOW]

Stop option:



   {;STOP}[;FINISH

           ;NOW   ][;OPENQ

                    ;SHUTQ][;SHOW]

Suspend option:



   {;SUSPEND}[;KEEP

              ;NOKEEP][;FINISH

                       ;NOW   ][;OPENQ

                                ;SHUTQ][;SHOW]

Resume option:



   {;RESUME}[;OPENQ

             ;SHUTQ][;SHOW]

Release option:



   {;RELEASE}[;OPENQ

              ;SHUTQ][;SHOW]

Parameters

DEV

Specifies the spooler device in one of the following forms:

ldev

Specifies the logical device number of the spooled device.

devclass

Specifies the device class name of the spooled devices. The devclass must begin with a letter and consist of eight or fewer alphanumeric characters.

devname

Specifies the device name of the spooled device. The devname must begin with a letter and consist of eight or fewer alphanumeric characters. A device class name and a device name cannot be the same. If you enter an alphanumeric character string, the command searches the device class list first, then the device name list.

Status option:

SHOW

Displays the status of the spooling process(es) associated with the specified device(s). This parameter reflects the updated state of the process(es) when the command finishes executing.

Enable/Disable option:

OPENQ

Enables spooling for ldev, devclass, or devname. This enables users to generate spool files on the device(s). This parameter is the default for the START option.

SHUTQ

Disables spooling for ldev, devclass, or devname. This prevents users from generating spool files on the device(s). This parameter is the default for the STOP option.

SHOW

For information about this parameter, refer to SHOW for the STATUS option.

Start option:

START

Creates and activates a new spooler process to own and manage the device and print spool files destined for the device. If a class is specified, a spooling process is created and activated for each device in the class. If you do not specify either the OPENQ or SHUTQ option, OPENQ is the default.

OPENQ

For information about this parameter, refer to OPENQ for the Enable/Disable option.

SHUTQ

For information about this parameter, refer to SHUTQ for the Enable/Disable option.

SHOW

For information about this parameter, refer to SHOW for the Status option.

Stop option:

STOP

Terminates the spooling process associated with the specified device. If you specify a class, spooling processes terminate for all devices in the specified class. When you specify this parameter, the following message appears:



   Output spooler, LDEV #ldev: Stopped.

If you do not specify either the FINISH or NOW parameters, NOW is the default. If you do not specify either the OPENQ or SHUTQ parameter, SHUTQ is the default.

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 STOP parameter has not affected printing. This happens 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.

If you stop the spooler while it is printing a file, the spooler saves the page number of the last complete page that was printed. Whenever any spooler subsequently selects the file for printing, output resumes at the page number following the saved page number.

FINISH

Directs the spooler to finish printing the currently active spool file and then stop.

NOW

Directs the spooler to immediately stop printing the currently active spool file. This is the default for the STOP option.

OPENQ

For information about this parameter, refer to OPENQ for the Enable/Disable option.

SHUTQ

For information about this parameter, refer to SHUTQ for the Enable/Disable option.

SHOW

For information about this parameter, refer to SHOW for the Status option.

Suspend option:

SUSPEND

Suspends output to one or more spooled devices so that the spooler devices become inactive. When you specify this parameter, the following message appears:



   Output spooler, LDEV #ldev: Suspended.

If you do not specify either the FINISH or NOW parameters, NOW is the default. If you do not specify either the KEEP or NOKEEP parameter, KEEP is the default.

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 SUSPEND parameter 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.

If you suspend the spooler while it is printing a file and the spooler does not retain the file, the spooler saves the page number of the last complete page that was printed. Whenever any spooler subsequently selects the file for printing, output resumes at the page number following the saved page number.

KEEP

Directs the device to retain ownership of the spool file that it is currently processing. This is the default. This parameter is valid only under the following conditions:

  • The spooler is actively processing a file or is suspending.

  • You do not specify the FINISH parameter.

NOKEEP

Directs the spooler to close the spool file that it is currently processing. This parameter is valid only under the following conditions:

  • The spooler is actively processing a file or is suspending.

  • You do not specify the FINISH parameter.

The spooler does the following when you include the NOKEEP parameter:

  • stops sending data after the current record

  • ejects a page

  • saves the last completely printed page

  • prints a trailer with (INCOMPLETE) on it if trailers are enabled

  • returns the file to the ready state

Whenever any spooler subsequently selects the file for printing, output resumes at the page number following the saved page number. The file's header and trailer include (RESUMED) if printing starts anywhere other than the first page.

FINISH

For information about this parameter, refer to FINISH for the STOP option.

NOW

For information about this parameter, refer to NOW for the STOP option.

OPENQ

For information about this parameter, refer to OPENQ for the Enable/Disable option.

SHUTQ

For information about this parameter, refer to SHUTQ for the Enable/Disable option.

SHOW

For information about this parameter, refer to SHOW for the Status option.

Resume option:

RESUME

Resumes a suspended spooler process. In order for this parameter to function, the spooler must be in the SUSPEND state. Output resumes where it was suspended.

OPENQ

For information about this parameter, refer to OPENQ for the Enable/Disable option.

SHUTQ

For information about this parameter, refer to SHUTQ for the Enable/Disable option.

SHOW

For information about this parameter, refer to SHOW for the Status option.

Release option:

RELEASE

Directs a suspended output spooler to close (release) a currently retained spool file. The spool file was retained because you previously specified the SUSPEND;KEEP parameters.

When the spooler releases the file, the spooler saves the page number of the last complete page that was printed. Whenever any spooler subsequently selects the file for printing, output resumes at the page number following the saved page number.

OPENQ

For information about this parameter, refer to OPENQ for the Enable/Disable option.

SHUTQ

For information about this parameter, refer to SHUTQ for the Enable/Disable option.

SHOW

For information about this parameter, refer to SHOW for the Status option.

Operation Notes

  • Usage

    You can enter this command from a session, a job, a program, or in break mode. Except for the status option, pressing Break does not affect this command.

    You can only enter this command from the console; however, you can enter this command from your terminal if your system administrator has used the ALLOW command to enable you to enter the command.

    Anyone can use the status option; however, all other options are only available to console users or allowed users.

  • Selective device errors

    This command affects more than one process if applied to all devices in a class. Consequently, errors can occur for some of the devices, but not others.

    For example, class LP consists of LDEVs 6, 11, and 19, and a spooler process already owns LDEV 11. The command SPOOLER LP;START would create and activate spooler processes for LDEVs 6 and 19, but would also generate the message DEVICE 11 IS ALREADY SPOOLED.

Example

  • To show the status of device name LP, enter:

    

   :SPOOLER LP;SHOW



   LDEV   DEV        SPSTATE    QSTATE    OWNERSHIP      SPOOLID



    6     LDEV6      IDLE       OPENED    OUT SPOOLER

   14     LDEV14    *SUSPEND    OPENED    OUT SPOOLER    #0237

   15     LDEV15     ACTIVE     OPENED    OUT SPOOLER    #O264

   19     LDEV19                OPENED    NO  SPOOLER

    The asterisk beside LDEV14 indicates that the SUSPEND state is pending.

Related Commands



   LISTSPF

   OPENQ

   SHOWDEV

   SHUTQ

   SPOOLF


SHOWTIME
  		 


SPOOLF  
Feedback to webmaster