Stopping NetSpool printer LUs

While NetSpool is running, you can use (1) Infoprint Central, (2) the LUNAME PURGE command, or (3) the VTAM® VARY INACT and LUNAME DEL commands to deactivate the VTAM session with a printer and to stop NetSpool from processing any more print requests for the printer LU.

This section describes the VTAM VARY INACT, LUNAME DEL, and LUNAME PURGE commands. The Infoprint Central action to stop a NetSpool LU is equivalent to entering the LUNAME PURGE command. For information about how to use Infoprint Central, see the Infoprint Central online help system.

Infoprint Central and the LUNAME PURGE command provide a fast way to stop a printer LU because the VTAM session ends immediately and no more data is sent to the printer LU. The printer LU finishes processing data it has already received so no data is lost. The LUNAME DEL command lets you stop a printer LU after the VTAM session has ended normally.

Limitation: You cannot use Infoprint Central to start, stop, or display the status of NetSpool LUs if you start more than one NetSpool task. However, you can use Infoprint Central to do other functions.

Tip: If you remove a printer LU name from a printer definition after NetSpool is started, NetSpool automatically stops the printer LU after the VTAM application ends the session. Therefore, you do not need to use stop the printer LU in this case.

Steps to stop an LU with the VTAM VARY and LUNAME DEL commands:

1. If the printer is started, deactivate the printer LU in VTAM, using the VTAM VARY INACT command. The type of VARY command you choose depends on how quickly you want the VTAM session to end. In either case, NetSpool creates an output data set with all data received. Therefore, no data is lost.
   • Specify the TYPE=IMMED option to end the VTAM session immediately.
   • Specify no TYPE option to wait until the VTAM application sending the data ends the session normally. A long delay might occur until the session ends.

   When you deactivate the printer LU in VTAM, the printer is placed in the WAITING state, meaning that NetSpool automatically restarts the printer LU when you reactivate the printer LU in VTAM.

   Tip:

   If a printer LU is already in the WAITING state because NetSpool could not start it, you do not need to first deactivate the printer in VTAM.

   _______________________________________________________

2. Delete the printer LU from NetSpool using the LUNAME DEL command. This command frees resources for the printer LU and prevents NetSpool from restarting it when you reactivate the printer LU using VTAM. After you enter the LUNAME DEL command, the printer LU will be in a PENDING CLOSE state until NetSpool has created an output data set with data received prior to the LUNAME DEL command.
   Tip:

   Wait for the printer to become inactive in VTAM before you enter this command.

   _______________________________________________________

The format of the LUNAME DEL command is:

F jobname[.id],LUNAME=lu-name,DEL

lu-name

Specifies the name of the printer LU. The name must match the LU name in a printer definition in the Printer Inventory.

Examples:

• In this example, printer LU LUPRT003 is deactivated in VTAM after the VTAM session for printer LU LUPRT003 ends immediately. The LUNAME DEL command, entered after the printer is inactive in VTAM, causes NetSpool to delete LUPRT003 from its list of selected printers LUs.

      VARY NET,INACT,ID=LUPRT003,TYPE=IMMED

      F jobname.id,LUNAME=LUPRT003,DEL

• In this example, NetSpool deletes printer LU LUPRT003 from its list of selected printers. Use the LUNAME DEL command without preceding it with a VARY INACT command only when the printer LU has not been successfully started. That is, the printer LU is in the WAITING state.

      F jobname.id,LUNAME=LUPRT003,DEL

Stopping an LU with the LUNAME PURGE command:

The LUNAME PURGE command deactivates the printer LU in VTAM immediately and closes the printer LU, deleting it from NetSpool’s list of selected printers. NetSpool creates an output data set with any data received from VTAM before you enter the LUNAME PURGE command. However, the VTAM session is ended as soon as the command is entered, and the printer LU does not receive any new data from VTAM.

The format of the LUNAME PURGE command is:

F jobname[.id],LUNAME=lu-name,PURGE

lu-name

Specifies the name of the printer LU. The name must match the LU name in a printer definition in the Printer Inventory.

Example: In this example, the VTAM session with printer LU LUPRT003 ends immediately. LUPRT003 is in a PENDING CLOSE state while NetSpool creates an output data set for any data it has received. NetSpool deletes LUPRT003 from its list of selected printers.

F jobname.id,LUNAME=LUPRT003,PURGE