LPRSET command—Set the default printer and host name

Purpose

Use the LPRSET command to set the default printer and host name. The printer and host name can also be included in the line printer commands (LPR, LPQ, and LPRM).

Notes:

Do not use the forward slash character (/) in any parameter value for this command.
The TSO LPRSET 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


>>-LPRSET--printer@host--+--------------------------+----------><
                         '-| Optional Parameters: |-'   

Optional Parameters:

|--(--+-------+--+-------+--+---------+-------------------------|
      '-Query-'  +-TRace-+  '-Version-'   
                 '-TYpe--'

Parameters

printer@host: Specifies the name of the printer and host to be used. If host is a name, it must resolve to an IPv4 address.
Query: Displays the current settings for the default printer and host.
TRace: Turns on the trace details for the recording of the printer and remote host name. 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

Set the default printer and host as the printer lp0 on the local system mvs1:
```
LPRSET lp0@mvs1
```
Display the current version of LPRSET:
```
LPRSET (VERSION
```
Display the current settings:
```
LPRSET (QUERY
```

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 TR instead of the fullword Trace as a parameter.
When you use LPRSET to set the printer and host, a data set by the name userid.LASTING.GLOBALV (where userid is the TSO user ID) is created or updated. If this data set does not exist, you must be able to create this data set. userid.LASTING.GLOBALV is the name required by LPRSET.
Printer names can be case sensitive. The printer name must be spelled the way the host uses it. For example, on UNIX systems, lp0 and LP0 can refer to different printers.
Also be aware that ISPF panels default to uppercase unless otherwise specified.
When you query the current settings on the same command that you set the default printer and host, the query of the current settings is done before the specified default printer and host are set. For example, if the printer was set to PRINT1@RALVM13, and you perform the query, LPRSET PRINT2@RALVM13(Q, the message returned says, PRINTER is PRINT1@RALVM13. However, it also changes the default printer to PRINT2. So if you query again, it would respond, PRINTER is PRINT2@RALVM13.
If you want to set the default printer and host and see that the defaults were set in the same LPRSET command, use the TYPE parameter. For example, if you want to set the default printer and host to PRINT2 on RALVM13 and then see the results afterward, you would enter the following command.
```
LPRSET PRINT2@RALVM13 (TYPE
```