PMDF User's Guide
OpenVMS Edition


Previous Contents Index


PRINT

Print a mail message.

Syntax

PRINT

Qualifiers Defaults
/AFTER /NOAFTER
/ALL /NOALL
/BURST /NOBURST
/CANCEL /NOCANCEL
/CONFIRM /NOCONFIRM
/COPIES=n /NOCOPIES
/DIGEST /NODIGEST
/ENTIRE /PART
/FEED /FEED
/FLAG /NOFLAG
/FORM=form-name See text
/HEADER /HEADER
/HOLD /NOHOLD
/LOG /LOG
/MARKED None
/MESSAGE /PART
/NAME=job-name None
/NOTIFY /NONOTIFY
/NOW /NONOW
/PARAMETERS=(P1[,...]) /NOPARAMETERS
/PART /PART
/PRINT /NOPRINT
/READ None
/REPLIED None
/QUEUE=queue-name See text
/SETUP /NOSETUP
/SPACE /NOSPACE
/TERMINAL None
/TRAILER /NOTRAILER
/TRIM_HEADER /NOTRIM_HEADER

Parameters

None.

Description

The PRINT command prints a copy of the message you are currently reading. Messages printed with the PRINT command do not actually begin printing until you either exit PMDF MAIL or issue the PRINT/NOW command. This allows multiple print requests to be concatenated together into one print job.

When the PRINT command is issued, the last message read is printed. If that message is a multipart message, then only the last read part of that message is actually printed. Use the /ENTIRE qualifier to print the entire message and not just a part of it.


Qualifiers

/AFTER=time

/NOAFTER (default)

Print the message after the specified time.

/ALL

/NOALL (default)

Print all currently selected messages. Messages will be printed as a message digest.

/BURST=ALL

/BURST=ONE

/NOBURST (default)

Controls whether a burst page is printed. /BURST=ALL requests that a burst page separate each print request generated by the PRINT command; /BURST=ONE requests that only one burst page be printed preceding the first message printed. By default, no burst pages are printed.

When used in conjunction with /TERMINAL, form feeds will be output after each message.

/CANCEL

/NOCANCEL (default)

/CANCEL cancels any outstanding print requests.

/CONFIRM

/NOCONFIRM (default)

When you specify /CONFIRM, you must approve the printing of each message. That is, for each message to be printed, you will be prompted. If you reply to the prompt in the affirmative, then the message will be printed; otherwise, it will be skipped.

/COPIES=n

/NOCOPIES (default)

Controls the number of copies printed. By default, only one copy is printed.

/DIGEST

/NODIGEST (default)

When /DIGEST is specified, multiple messages output to a file will be formatted as a MIME message/digest.

/ENTIRE

/MESSAGE

/PART (default)

By default, when you print a multipart or nested message, only the current part is printed. This behavior is explicitly requested with the /PART qualifier. To print the entire message, specify /ENTIRE; to only print the current part identifiable as a message, specify /MESSAGE. When printing a single-part message which is not nested, the /ENTIRE, /PART, and /MESSAGE qualifiers are identical and have no effect. /ENTIRE is assumed when /ALL is specified; /MESSAGE and /PART have no effect in that case.

/FEED (default)

/NOFEED

Controls whether the print system paginates the output by inserting a form feed at the end of each page of output.

/FLAG=ALL

/FLAG=ONE

/NOFLAG (default)

Controls whether a flag page is printed. /FLAG=ALL requests that a flag page separate each print request generated by the PRINT command; /FLAG=ONE requests that only one flag page be printed preceding the first message printed. By default, no flag pages are printed.

/FORM=form-name

/NOFORM

By default, the form specified with the SET FORM command is used as the print form. If you have never used that command or have issued the SET NOFORM command, then the default print form associated with the printer queue is used. The /FORM and /NOFORM commands override the SET FORM command. The /FORM qualifier requests a specific print form; /NOFORM requests that no print form be used.

/HEADER (default)

/NOHEADER

By default, when the message is printed its header is included. Specify /NOHEADER to omit the message header.

/HOLD

/NOHOLD (default)

Controls whether the message is available for immediate printing. When you specify /HOLD, the print job is not released for actual printing until you use the DCL command SET QUEUE/ENTRY/RELEASE to release it.

/LOG (default)

/NOLOG

For each message file created for printing purposes, output to the terminal a status message. To suppress this information, use the /NOLOG qualifier.

/MARKED

/NOMARKED

Print only messages that have been marked, /MARKED, or are not marked, /NOMARKED.

/NAME=job-name

Specify a job name to associate with the print job.

/NOTIFY

/NONOTIFY (default)

When you specify /NOTIFY, you will be notified by a broadcast message when your messages have finished printing.

/NOW

/NONOW (default)

/PRINT

/NOPRINT

Close the currently open print job so that the queued messages will begin printing. That is, release all messages previously queued with the PRINT command so that they will begin printing immediately. If you do not specify /NOW or /PRINT, then your messages will not begin printing until after you exit PMDF MAIL. The only other qualifier which you can use with /NOW or /PRINT is /NOTIFY. /PRINT and /NOW are synonymous.

/PARAMETERS=(P1[,...])

Specify up to eight parameters to be associated with the print job.

/QUEUE=queue-name

/NOQUEUE

By default, the print jobs are queued to the queue specified with the SET QUEUE command. If you have never used that command or have issued the SET NOQUEUE command, then SYS$PRINT will be used. The /QUEUE and /NOQUEUE commands override the SET QUEUE command. The /QUEUE qualifier requests a specific print queue; /NOQUEUE requests that the default queue, SYS$PRINT be used.

/READ

/NOREAD

Print all currently selected messages which have been previously read, /READ, or are unread, /NOREAD.

/REPLIED

/NOREPLIED

Print all currently selected messages which have been replied to, /REPLIED, or have not been replied to, /NOREPLIED.

/SETUP=(module[,...])

/NOSETUP (default)

Specify one or more text modules to extract from the device control library and down load to the printer prior to printing the message.

/SPACE

/NOSPACE (default)

When /SPACE is specified the printed output will be double spaced. By default, /NOSPACE, the output is printed single spaced.

/TERMINAL[=PRINTER_PORT]

Print the selected messages to the terminal. Cannot be used in conjunction with any of the print queue related qualifiers (e.g., /AFTER, /PARAMETER, /NOTIFY, /TRAILER, etc.). When the optional PRINTER_PORT value is specified, the printer port will be activated prior to printing and deactivated upon completion of printing. This feature will only work with terminals supported by the SMG$ run time library. When used in conjunction with a DECterm window, the output will be handled in accord with the selected printing options for that DECterm window.

/TRAILER=ALL

/TRAILER=ONE

/NOTRAILER (default)

Controls whether a trailer page is printed. /TRAILER=ALL requests that a trailer page separate each print request generated by the PRINT command; /TRAILER=ONE requests that only one trailer page be printed after the final message printed. By default, no trailer pages are printed.

/TRIM_HEADER

/NOTRIM_HEADER (default)

By default, the full message header appears in each printed message. Use the /TRIM_HEADER qualifier to apply header trimming to each message prior to printing it.

Examples

#1

EMAIL> READ
 
Message MAIL 1                                      2-FEB-2012 12:13:18.01
 
Date: Tue, 2 Feb 2012 12:13:18 PDT
From: bob@example.com
To: staff@example.com
Subject: Vacation schedule
   .
   .
   .
EMAIL> PRINT
EMAIL> EXIT
Job MAIL_01GV5A_PRINT (queue SYS$PRINT, entry 612) started on SYS$PRINT
$
      

In this example a message is printed to the default print queue, SYS$PRINT. The message begins printing when PMDF MAIL is exited.

#2

EMAIL> READ
 
Message MAIL 1                                      2-FEB-2012 12:13:18.01
 
Date: Tue, 2 Feb 2012 12:13:18 PDT
From: bob@example.com
To: staff@example.com
Subject: Vacation schedule
   .
   .
   .
EMAIL> PRINT/QUEUE=PS_PRT
EMAIL> PRINT/NOW
Job MAIL_01GZ7C_PRINT (queue PS_PRT, entry 613) started on PS_PRT
$
      

Here, the /QUEUE qualifier is used to specify a print queue other than the default print queue. In the second PRINT command, the /NOW causes the messages to begin printing.


Previous Next Contents Index