The following example shows how to requeue an SMTP mail message that is currently holding, using the TCPIP SEND MAIL command (similar to the DCL ENTRY/RELEASE command). You are prompted to confirm you want the mail message requeued.

$ TCPIP SEND MAIL /ENTRY=828 _PLUTO$DKD0:[MARLOW]970207015114580_MARLOW.TCPIP_PLUTO;1? y

5.10 Using Mail from Your PC

With SMTP and the Post Office Protocol (POP) functionality, you can receive and send OpenVMS mail from your PC.

POP is a mail repository that accepts and stores your mail even when the PC is turned off. At your request, the POP server reads mail from your OpenVMS NEWMAIL folder, then moves the mail to your MAIL folder.

To send and receive mail on your PC, make sure the system manager has configured the POP server for use on your PC (the POP client system).

To set up your POP client account, use one of the following methods:

• On networks where maximum security is not required, enter your PC mail application and configure a user name and password in to the system.
  The user name and password pair becomes authorization information for the TCP/IP system, not your POP client system. Your PC client sends the password to the POP server unencrypted.
  As an added security measure, POP permits only two user name and password authorization attempts per TCP connection.
• On networks where maximum security is required, enter your PC mail account and configure a user name and shared-secret password in to the system.
  This method is called the APOP authorization method where you store a shared-secret password in a one-line file named POP_SECRET.DAT in your default OpenVMS mail directory.
  You can use the DCL command CREATE or your text editor to create the file and specify a password string, then set the file protection to prevent other users from accessing it. For example:

  $ SET DEFAULT USER$DISK:[JONES.MAIL] $ CREATE POP_SECRET.DAT xyztancreff [Ctrl/Z] $ SET FILE/PROT=(s,w,g,o:rwed) POP_SECRET.DAT

  
  The shared-secret password cannot exceed 500 characters.
  Each time you enter your PC mail application, the shared-secret string is sent from the PC client to the POP server using an encryption process.

For more information about the POP process, including information about how POP builds SMTP-compliant mail headers, see the DIGITAL TCP/IP Services for OpenVMS Management guide.

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.

What You Can Do

The following table lists network printing services you can perform and the sections that explain how to use them.

Capability	Section
Send print jobs to a printer connected to a remote internet host	6.1
Display print queue status	6.2
Cancel print jobs	6.3
Receive on local (OpenVMS system) print queues print jobs initiated from a user on a UNIX system	6.4
Get a "finished" notification through SMTP mail	6.1.2.2

What You Need

To use the DIGITAL TCP/IP Services for OpenVMS network printer services, you need the following:

• The name of the remote print queue
• DEC Remote Print Server LPD protocol extensions software to enter PRINT /PARAMETERS=options=value
• TCP/IP Services for OpenVMS must be installed and LPR/LPD enabled on your OpenVMS system.

Command Summary

To use the remote printing features, enter the commands summarized in Table 6-1 (for complete command descriptions, see Section 6.6).

Table 6-1 Network Printing Commands: Summary

DCL Command	UNIX Command	Description
PRINT (See the OpenVMS documentation.)	lpr (See the UNIX documentation.)	Prints files
LPQ	lpq	Displays the status of a remote print queue
LPRM	lprm	Removes jobs from a remote print queue

6.1 Printing at 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:

• /FORM
• /PARAMETERS

The following sections discuss the unique features of these two qualifiers when used for remote printing.

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.

6.1.2 PRINT Command: /PARAMETERS Qualifier

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:

• Blanks
• 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

The following /PARAMETERS options are supported only for use with remote printing.

HOST	MAIL
NOFLAG	PRINTER

The options are described in more detail in the following sections.

6.1.2.1 /PARAMETERS Qualifier: Host and Printer Options

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 (see Section 1.4).

6.1.2.2 /PARAMETERS Qualifier: MAIL Option

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

6.1.2.3 /PARAMETERS Qualifier: NOFLAG Option

The NOFLAG option suppresses printing of a banner (flag) page at an LPD queue. For information about LPD queues, see the DIGITAL TCP/IP Services for OpenVMS Management manual.)

The following command example specifies the NOFLAG option.

$ PRINT/PARAMETERS=NOFLAG /QUEUE=DPR_ANSI PINS.LIS

6.1.3 Remote Queue Printing 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

To display the status of jobs you send to a remote printer, use the LPQ command. The following information is displayed:

• Your name
• Current rank of job in the queue
• Names of the files in job
• Job identifier
• Total size of job in bytes

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

To remove your jobs from a remote print queue, use the LPRM command. Using the LPRM command, you can remove the following:

• All of your active jobs
• All jobs, if you have the required privileges
• Selected jobs

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

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.

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

6.5 Obtaining Online Help

You can obtain online help for the LPR/LPD network printing services by entering the following commands:

$ HELP TCPIP_SERVICES LPR_LPD $ HELP LPQ $ HELP LPRM

6.6 Command Descriptions

This section provides complete descriptions of the commands you can use to send a print job to a remote printer, monitor remote print jobs, and remove remote print jobs.

Displays the status of your jobs in a remote print queue:

• Current rank of your job in the queue
• Names of your queued files
• Job identifier
• Size of jobs in bytes

Format

LPQ queue [ /ENTRY=n ]
[ /HOST=host ]
[ /PRINTER=remote_printer ]
[ /USER=user_name ]

Parameters

queue

Required.

Queue for which you want status.

Qualifiers

/ENTRY=n

Optional. Default: all jobs. You can specify a list of values.

Displays status for the specified jobs.

/HOST=host

Optional. Default: host defined in the printcap file.

Displays status for the jobs you sent to the specified host. This is the host you also specified in the PRINT /PARAMETERS=(HOST=host) command.

/PRINTER=remote_printer

Optional. Default: printer defined in the printcap file.

Displays status for the jobs you sent to the specified remote printer. This is the queue you also specified in the PRINT /PARAMETERS=(PRINTER=queue) command.

/USER=user

Optional. Default: all users.

Displays status for the jobs sent by the specified user. You can specify a list of values.

Examples

$ LPQ LPS40_QUE 
      

Shows all entries in the LPS40_QUE queue.

$ LPQ MAIN_QUE /ENTRY=4 
      

Shows information about Job 4 in the print queue named MAIN_QUE.

$ LPQ PEACE_8 /ENTRY=(1,2,3) 
      

Shows information about Jobs 1, 2, and 3 in print queue PEACE_8.

$ LPQ 3RD_FLOOR_Q /USER=MILLER
      

Shows information about user MILLER's jobs in the print queue called 3RD_FLOOR_Q.

Removes one or more jobs from a remote print queue.

Format

LPRM queue { /ALL
/ENTRY=n
/USER=user_name }
[ /HOST=host ]
[ /PRINTER=remote_printer ]

Parameters

queue

Required.

Print queue with waiting jobs you want to delete.

Qualifiers

/ALL

Required, unless you specify /ENTRY or /USER.

Removes all jobs for all users from the specified queue. Requires SYSPRV, OPER, or BYPASS privileges. Comparable to the UNIX command lprm -Pqueue - when performed by the root user on the UNIX system.

/ENTRY=n

Required, unless you specify /ALL or /USER.

Removes the specified job. Specify only your own jobs. You can specify a list of values.

/USER=user

Required, unless you specify /ALL or /ENTRY.

Removes jobs by user name. You can specify a list of values.

/HOST=host

Optional. Default: host defined in the printcap file.

Removes jobs by host for the host you specified in the PRINT /PARAMETERS=(HOST=host) command.

/PRINTER=remote_printer

Optional. Default: printer defined in the printcap file.

Removes jobs from the remote printer you specified in the PRINT /PARAMETERS=(PRINTER=queue) command.

Examples

$ LPRM BASE_Q /ENTRY=7 
      

Deletes your Job 7 from print queue BASE_Q.

$ LPRM FRONT_Q /ENTRY=(555,556,558) 
      

From queue FRONT_Q, deletes a list of entries: 555, 556, and 558.