LPRM command—Remove a job from the printer queue on a remote host

Purpose

Use the LPRM command to remove a job from the printer queue on a remote host.

Notes:

Do not use the forward slash character (/) in any parameter value for this command.
The TSO LPRM command uses the Pascal socket API, so VMCF must be started for the command to be successful. If VMCF is not started, an ABEND0D6 can occur.

Format


>>-LPRM--+--------+--+------------------------------------+----><
         '-job_id-'  '-| Opt Parms 1: |--| Opt Parms 2: |-'   

Opt Parms 1:

|--(--+----------------+--+-------------+-----------------------|
      '-Printer --name-'  +-Host --host-+   
                          '-AT --host---'   

Opt Parms 2:

|--+-------+--+------+--+---------+-----------------------------|
   '-TRace-'  '-TYpe-'  '-Version-'

Parameters

job_id: Specifies either a user ID (this must not start with a digit), or a job number in the remote printer queue. If you do not specify job_id with the LPRM command, your currently active job is removed.
Printer name: Specifies the name of the printer associated with the job.
Host host: Specifies the name or IPv4 IP address of the printer host. If host is a name, it must resolve to an IPv4 address. AT is accepted as a synonym for HOST.
AT host: Specifies the name or IPv4 IP address of the printer host. If host is a name, it must resolve to an IPv4 address. Host is a synonym for this option.
TRace: Turns on the trace details for interaction with the remote printer. TRace always overrides TYpe because TYpe is a subset of TRace.
TYpe: Displays the progress of the command.
Version: Displays the version of the program.

Examples

Cancel job number 123 on the printer lp0 on the local system os2sys1:
```
LPRM 123 (PRINTER lp0 HOST os2sys1
LPRM 123 (PRINTER lp0 AT os2sys1
```
If the job is in the queue, it is removed. If the job is currently active, it is stopped.
If the LPRSET command was previously issued (LPRSET lp0@os2sys1), using the following LPRM command has the same effect as issuing the command in the previous example:
```
LPRM 123
```
Cancel the currently active job:
```
LPRM (PRINTER lp0 HOST os2sys1
```

Usage

The input string for parameters is limited to 255 bytes. To use the input string effectively, remove any extra embedded blanks and use shorter parameter labels. For example, use P instead of the full word Printer as a parameter.
If the printer and host name are not specified in the LPRM command, the last LASTING.GLOBALV variables for PRINTER and PRTHOST in the user_id.LASTING.GLOBALV data set are used as the defaults. You can set these variables with the LPRSET command. You can use these variables to set up a default printer, which is used if you do not specify a printer.
Removing the currently active job can depend on the number of jobs currently printing. If you have two jobs printing, and you use the LPRM command without the job_id parameter, the first job might finish, but you could inadvertently remove the second job instead.