VMS Help TCPIP Services, LPR_LPD *Conan The Librarian (sorry for the slow response - running on an old VAX) |
The Line Printer/Line Printer Daemon (LPR/LPD) of the DIGITAL TCP/IP Services for OpenVMS software supports the DCL PRINT, LPQ, and LPRM commands for remote printing. The LPR/LPD service allows you access to print queues on remote hosts and allows users on remote hosts to access print queues on your system. To use the DIGITAL TCP/IP Services for OpenVMS network printer services, you need the following: o The name of the remote print queue o DEC Remote Print Server LPD protocol extensions software to enter PRINT /PARAMETERS=options=value o TCP/IP Services for OpenVMS must be installed and LPR/LPD enabled on your OpenVMS system.
1 - Command Summary |
To use the remote printing features, enter the commands summarized below. For complete command descriptions, enter HELP and the specific command at the DCL prompt. DCL UNIX Command Command Description PRINT lpr Prints files LPQ lpq Displays status of a remote print queue LPRM lprm Removes jobs from a remote print queue
2 - Remote Print Queues |
Your system manager can configure your system with LPR/LPD network services that allow you to use the DCL PRINT command to send print jobs to a print queue on a remote internet host. The remote host can be a UNIX system or another OpenVMS system running LPR/LPD. You print a local file at a printer on a remote host by specifying the remote queue name defined on your local host (see your system manager for queue names). LPD copies the file to the appropriate remote printer's spool directory. A copy of the file to be printed remains in the spooling queue until the printer is ready to print it. When you enter the DCL PRINT command to send a print job to a remote print queue, you use the /QUEUE qualifier to specify the queue name plus any of the following qualifiers: /AFTER /BACKUP /BEFORE /BY_OWNER /CONFIRM /COPIES /CREATED /DELETE /EXCLUDE /EXPIRED /FORM /HEADER /HOLD /IDENTIFY /JOB_COUNT /MODIFIED /NAME /NOTE /OPERATOR /PARAMETERS /PASSALL /PRIORITY /QUEUE /SETUP /SINCE /USER /WIDTH Two of these qualifiers work differently with DIGITAL TCP/IP Services for OpenVMS software than they do in a OpenVMS environment without TCP/IP support. These two qualifiers are: o /FORM o /PARAMETERS NOTE DIGITAL TCP/IP Services for OpenVMS software does not support layup definition files for print requests to remote print queues. A layup definition file sets up the layup features: borders, sheet margins, alternating margins, pages per sheet, first page, page order, and page grid.
2.1 - /FORM
The DCL PRINT /FORM command customizes the look of the printed page. This qualifier associates a form other than the default with the print job. To see which forms are defined for your system, enter: $ SHOW QUEUE /FORM To find out the currently mounted form or the default form, enter: $ SHOW QUEUE queue /FULL If the FORM associated with a remote LPD queue specifies a /WIDTH value that is not the standard 132, LPD sends a "W" card in the job's control file with the width specified in the form.
2.2 - /PARAMETERS
DIGITAL TCP/IP Services for OpenVMS supports numerous options for the DCL PRINT /PARAMETERS=(option=value) command. For example, it supports the PAGE_SIZE option as follows: $ PRINT/PARAMETERS=(PAGE_SIZE=size) /QUEUE=queue_name filename When you enter the PRINT /PARAMETERS=(option=value) command, enclose the following in quotation marks: o Blanks o Non-alphanumeric characters, including spaces and slashes You can use the following /PARAMETERS options for both local printing (standard DCL PRINT) and remote printing (DCL PRINT with LPR/LPD network services). DATA_TYPE NUMBER_UP PAGE_LIMIT PAGE_ORIENTATION PAGE_SIZE SHEET_COUNT SHEET_SIZE SIDES For a full description of the options supported for DCL local as well as remote printing, enter the following command. $ HELP PRINT_PARAMETER NOTE This help is available only if the DECprint Supervisor (DCPS) software is installed on your system. See your system manager for more information. The following /PARAMETERS options are supported only for use with remote printing. HOST MAIL NOFLAG PRINTER o Use the HOST and PRINTER options together to send a print job to any remote host and printer that does not have a specific print queue defined on the local system. In conjuction with the HOST and PRINTER qualifiers, you must also specify the /QUEUE qualifier. The value of the /QUEUE must be a local LPD print queue established for remote printing. This may be a generic LPD queue set up to handle all remote printing requests or a specific LPD queue for a particular remote printer. For example, the following command specifies that the file PINS.LIS be sent to printer CT_LN05R on remote host BALT using the generic remote printing queue DPR_ANSI. $ PRINT/PARAMETERS=(HOST=BALT, PRINTER=CT_LN05R) /QUEUE=DPR_ANSI PINS.LIS The HOST and PRINTER options allow you to use any available network printers, without your system manager having to set up additional LPD remote queues for each of these printers. Specify the remote host name either by the host name or by its fully qualified domain name (such as PACE.STATS.RINGS_ CORP.COM). o The MAIL option causes the remote host to notify you through SMTP mail when the print job completes. The following command example specifies the MAIL option. $ PRINT/PARAMETERS=MAIL /QUEUE=DPR_ANSI PINS.LIS o The NOFLAG option suppresses printing of a banner (flag) page at an LPD queue. The following command example specifies the NOFLAG option. $ PRINT/PARAMETERS=NOFLAG /QUEUE=DPR_ANSI PINS.LIS
2.3 - Examples
The following examples show how to use the remote queue print capabilities of DIGITAL TCP/IP Services for OpenVMS. 1. This example sends local file PINS.LIS to the remote print queue defined locally as FAC3_ANSI and requests notification through SMTP when the job completes at the remote printer. $ PRINT /PARAMETERS=MAIL /QUEUE=FAC3_ANSI PINS.LIS 2. This example shows how to send a local file to the remote print queue defined locally as OUR_PS for printing at a remote printer. The command specifies that text be printed on both sides of each sheet. The file is ROUGH.TXT. $ PRINT /QUEUE=OUR_PS /PARAMETER=(SIDES=2) ROUGH.TXT 3. This command sends a print job to the remote queue defined locally as YOUR_PS. $ PRINT /QUEUE=YOUR_PS - _$ /PARAMETERS=(DATA_TYPE=POST,PAGE_ORIENTATION=LANDSCAPE,SIDE=2) - _$ LET.LIS 4. This example sends a print job to Internet host PACE.SATRN.COM to print on printer K1_PRINTER. $ PRINT /QUEUE=LPD_OUTQ - _$ /PARAMETERS=(HOST=PACE.SATRN.COM,PRINTER=K1_PRINTER) - _$ USER$4:[GRANT.FINAN.SALES]ANNUAL.TXT
3 - Remote Queue Status |
To display the status of jobs you send to a remote printer, use the LPQ command. The following information is displayed: o Your name o Current rank of job in the queue o Names of the files in job o Job identifier o Total size of job in bytes
3.1 - Examples
The following examples show how you can use the LPQ command. 1. This example displays all entries in the LPS40_QUE queue. $ LPQ LPS40_QUE 2. This example shows information about Job 4 in the print queue named OFFICE_QUE. $ LPQ OFFICE_QUE /ENTRY=4 3. This example shows information about Jobs 1, 2, and 3 in print queue PEACE_Q. $ LPQ PEACE_Q /ENTRY=(1,2,3) 4. This example shows information about user NELSON's jobs in the print queue FRONT_Q. $ LPQ FRONT_Q /USER=NELSON
4 - Removing Print Jobs |
To remove your jobs from a remote print queue, use the LPRM command. Using the LPRM command, you can remove the following: o All of your active jobs o All jobs, if you have the required privileges o Selected jobs
4.1 - Examples
The following examples show how you can use the LPRM command. 1. This example deletes one job from print queue BASE_Q. $ LPRM BASE_Q /ENTRY=7 2. This example deletes jobs 555, 556, and 558 from queue BASE_Q. $ LPRM BASE_Q /ENTRY=(555,556,558) 3. In this example, the system manager, who has the required privileges, deletes all jobs from queue MAIN_QUE. $ LPRM /ALL MAIN_QUE
5 - Remote UNIX Files |
Your system manager can set up a local print queue to handle print jobs for files sent from a remote UNIX host. To print UNIX files on an OpenVMS printer, the UNIX user enters an lpr command. (See the appropriate UNIX documentation.) Local queues set up to receive UNIX print jobs support layup definition files. These are files supported only by DIGITAL and used to set the following layup features: borders, sheet margins, alternating sheet margins, pages per sheet, first page, page order, and page grid.
5.1 - Examples
The following example sends UNIX file /usr/stanton/recent.cnts to OpenVMS print queue REMOTE_QUEUE4 and specifies the formatting defined in the layup file called layup3. The REMOTE_QUEUE4 print queue is set up as a remote queue in the printcap file by the system manager. % lpr -Llayup3 -Premote_queue4 /usr/stanton/recent.cnts
|