z/OS USS–UNIX System Services Printing Commands › Lp—Print a file › Options

Options

-c

Makes a copy of the file and prints that copy. Copying files lets you change the original files after submitting the lp command. The printed file does not contain the changes. -c is the default and cannot be overwritten.

-d destination

Selects the printer destination. For destination, specify the name of a printer defined to CA LPD or CA Spool. Contact your administrator for the names of printer definitions or use the lpstat command to list the CA Spool printers you have access to.

You can omit this option if there is a default printer. You can define a default printer by setting the LPDEST or PRINTER environment variable. If you do not specify a printer and there is no default, the lp command displays an error message.

-m

Notifies you by electronic mail when the file is removed from the system spool for any reason. Currently not supported.

-n copies

Prints the specified number of copies of each file. You can specify a value from 1 to 255. This option overrides the copies job attribute. The default value is one copy.

-o option

Specifies an option, that is, one or more attribute value assignments in the format attribute=value, separated by spaces.

• If a value contains spaces, enclose the value in single or double quotation marks:

  attribute='value with spaces'
  attribute="value with spaces"
  

• If an option contains spaces or characters that can be interpreted by the shell (such as $ & ( ) > < | ' " #), enclose the option in single or double quotation marks:

  -o 'attribute1=value1 attribute2=value2'
  -o "attribute='value with spaces'"
  -o "attribute=value(1)"
  

Note: For more information about how the shell interprets special characters, see z/OS UNIX System Services User's Guide.

For a list of the attributes you can specify to describe the job and all the files in it, see print attribute table on page 2-7 in the "z/OS Printer Port Monitor for Windows" section.

Instead of entering a string of attributes on the command line, you can store attributes and values in a file. You use a special attribute called attributes to specify the file. For examples, see the "Specify the attributes files" example below.

You can also set the AOPOPTIONS environment variable to a string of attributes and values. The lp command treats these attributes as if you had specified them before any other values of the -o option on the command line. For an example of using the AOPOPTIONS environment variable, see the "Specify the AOPOPTIONS environment variable" example below.

If you specify an attribute more than once, the lp command uses the last value.

-s

Suppresses the message that the lp command returns when CA LPD or CA Spool has accepted the request. This message contains the resulting CA LPD job id or CA Spool file number.

-t "description of file"

Describes the file, which can be printed as the title on a separator page, a page that might be printed before or after the file. If the file is sent to an e-mail destination, this description is the subject of the e-mail. You can specify up to 60 characters. If the text contains spaces or characters that the shell might interpret, enclose the text in single or double quotation marks. This option overrides the title-text job attribute.

-w

Writes a message to the terminal when the file is removed from the system spool for any reason. Currently not supported.

-h hostname

Specifies the TCP/IP host name of the system where CA LPD or CA Spool is running.

Defaults to host name obtained from the LPDHOST environment variable if defined, else defaults to local host.

-r port

Specifies the TCP/IP port number on which CA LPD or CA Spool is listing.

Defaults to port number obtained from the LPDPORT environment variable if defined, else defaults to port number 515.