Trailing-Edge
-
PDP-10 Archives
-
BB-JR93N-BB_1990
-
10,7/system/print.hlp
There are 3 other files named print.hlp in the archive. Click here to see a list.
PRINT Command
Function
The PRINT command queues files to be printed on the line printer.
For more information and examples, see the QUEUE help file.
Format
PRINT dev:jobname=file-spec
Where: dev: is the device name of the specific line printer
on which your files are to be printed. (For example,
LPT2: is line printer number 2.) You can specify that
your files be printed on a printer on another node by
using the format LPTSxx, where xx is the node number.
(For example, LPTS31 is a printer on node 31.) The
device name is optional.
jobname is the name of the job being entered into the
queue. The job name is optional. The default is the
name of the first file in the request.
The equal sign is required if you specify the device,
job name, or both.
file-spec is a single file specification or a string of
file specifications separated by commas, for the files
being processed. A file specification is in the form
dev:file.ext[directory].
If you specify neither the job name nor the input specification,
the system prints a list of all the jobs in the lineprinter queue
on your terminal.
You can use the asterisk wildcard construction for the input
specification. Switches that aid in constructing the queue entry
can appear as part of the input specifications.
The switches to this command can be divided into two categories,
depending on whether the switch can be used only once, or can be
used more times, in a single command string. The two categories
are:
o Queue-Operation Switches
These switches can be used only once in the command string.
They affect the entire request, and you can place them
anywhere in the command string. If you have used one of
these switches in a command string, you cannot use it again
in the same string. Many switches have a /NO construction,
which has a negative effect. Be sure you do not use the /NO
construction of a switch in the same command string with the
positive construction.
o File-Control Switches
These switches can be used any number of times in the
command string. You can also use the /NO construction of a
switch in the same command string with the positive
construction. For information about switches, see the help
file SWITCH.
Switch Category Function
/ABEFORE: File Queues the file only if the access
date-time control date is before the specified date
and time.
/ACCOUNT: Queue Specifies the account to which the
"string" operation job should be charged. If the
account string contains any
nonalphanumeric characters, you
must enclose the string in
quotation marks.
/AFTER: Queue Processes the request after the
date-time operation specified date and time.
/ALLFILES: Queue Accepts a request only if all of
YES or NO operation the files in the request exist. By
default, if any of the files do not
exist, the others will be processed
appropriately. This switch
specifies that if any file does not
exist, no files should be
processed. The value of YES or NO
is optional. If you specify YES,
all of the specified files must
exist.
/ASINCE: File Queues only the files that have
date-time control been accessed since the specified
date and time.
/BEFORE: File Queues only the files with creation
date-time control dates before the specified date and
time.
/BEGIN:n File Starts the output on the specified
control page.
/CHARACTERISTIC: Queue Specifies an output characteristic.
arg operation You can find a list of the
characteristics arguments defined
for your system in the file
SYS:CHARTY.DAT.
/CHECK Queue Prints on your terminal a list of
operation the queue entries made by your job.
/COPIES:n File Repeats the output the specified
control number of times (n must be less
than 64).
/CREATE Queue Makes a new entry in the queue.
operation This is the default except when you
are listing queue entries.
/DEFERRED Queue Causes all deferred output to be
operation released to the system queues. You
must use one of the following
switches with /DEFERRED:
/CREATE completes all released
output requests.
/KILL eliminates the released
output requests.
See the SET DEFER command for more
information and examples.
/DELETE File Deletes the file after printing
control it. This is the same as
/DISPOSE:DELETE
/DESTINATION: Queue Specifies the node that will
node operation process the request. Use this
switch to specify that the files
are to be printed on a line printer
connected to the specified node.
Use the node name or node number to
specify the node.
/DISPOSE:arg File Controls the disposition of the
control file after it is queued. The
arguments to this switch are:
DELETE deletes the file from your
directory after printing it.
PRESERVE preserves the file after
printing it. This is the default
function.
RENAME renames the file into the
queuing area, deleting it from your
directory immediately.
/DISTRIBUTION: Queue Specifies text to place in the
"text" operation distribution field, on the banner
page of output listings. You can
use this field to include mailing
information, or the location where
the operator should leave the
listing. The text field may be up
to 39 alphanumeric characters,
including punctuation and spaces if
the text is placed in quotation
marks.
/ERBINARY File Prints an error message if a binary
control file is included in the queue.
This is the default function.
/ERNONE Queue Prints an error message if no files
operation match the file specification. This
is the default function.
/ERPROTECTION Queue Prints an error message if
operation processing the request would
require a violation of file
protection code. This is the
default function.
/FAST Queue Prints the entries in the queue on
operation your terminal in a fast format.
/FILE: File Specifies the way the file is to be
arg control interpreted. The following
arguments can be used with this
switch:
ASCII interprets the file as ASCII
text.
COBOL interprets the file as COBOL
SIXBIT text.
FORTRAN interprets the file as a
Fortran data file. This is the
default for files with the
extension .DAT.
/FONT: Queue Prints the file using the font
fontname operation designated in fontname. Fontnames
vary from installation to
installation. See your system
administrator for a list of valid
font names.
/FORMS:name Queue Prints the file on the named forms.
operation The argument to the switch can be
up to six alphanumeric characters.
Available forms are listed in
SYS:FORMST.DAT.
/GENERIC Queue Sends output to the next available
operation line printer. This switch is the
complement to /UNIT.
/HEADER: File Prints block headers at the
YES or NO control beginning of the file. This is the
default function.
/HELP: Queue Prints information on your terminal
arg operation about the QUEUE command. This
switch does not queue any files.
This switch can be used alone
(/HELP) or with one of the
following arguments:
TEXT prints a message with the
format and switches to the QUEUE
command. This is the same as /HELP
with no arguments.
SWITCHES prints a list of all the
switches available with the QUEUE
command.
/JOBNAME: Queue Specifies the name of the job. The
name operation job name can be up to six
alphanumeric characters.
/KILL Queue Removes the specified entry from
operation the queue. You must include the
job name, /REQUESTID, or /SEQUENCE
to the left of the equal sign in
the command line. (See the
examples.)
/LENGTH:n:m File Prints only files whose length
control is between n and m blocks.
/LIMIT:n Queue Limits the output to the specified
operation number of pages.
/LIST:arg Queue Prints information about the jobs
operation in the queue. If you use /LIST
alone, it shows the jobs in the
queue. This is equivalent to using
the PRINT command with no arguments
and no switches. /LIST and /LIST:
can be abbreviated to /L and /L:.
The switch can also take one of the
following arguments:
ALL shows all data about each queue
request.
FAST shows a fast list of the queue
requests.
JOBS shows a list of the jobs in
the queue. (This is the same as
/LIST with no arguments.)
SUMMARY shows only the summary line
of the queue display.
/LOWERCASE Queue Forces the output to be printed on
operation a line printer with lowercase
ability.
/MESSAGE:arg Queue Specifies the amount of information
operation to be printed when an error occurs
from the request. You can specify
one or more of the following
arguments:
ADDRESS prints the location in
memory where the error occurred.
CONTINUATION prints information
about the error.
FIRST prints the one-line error
message.
PREFIX prints the six-character
error prefix.
/MODIFY Queue Alters the specified parameter in
operation the specified job. This switch
requires that you have access
rights to the job. You must
include the job name, /REQUESTID,
or /SEQUENCE, to the left of the
equal sign in the command line.
(See the examples.) You can modify
a request as long as the request
has not been started.
/NEW: File Accepts the request even if the
YES or NO control file does not yet exist.
/NOHEADER Queue Suppresses the block headers at the
operation beginning of the file.
/NONEW File Does not accept file specifications
control of files that do not exist. This
is the default function.
/NONOTIFY Queue Suppresses notification when your
operation request is finished. See /NOTIFY.
/NONULL Queue Prints a fatal error message if
operation none of the specified files exist.
This is a default function.
/NOOPTION Queue Suppresses the option file
operation SWITCH.INI.
/NOPHYSICAL File Recognizes logical names for
control devices in the command string.
This is a default function.
/NOSTRS File When searching for the file on all
control structures, takes only the first
occurrence. This is the default
function.
/NOTES:"text" Queue Prints the specified text on the
operation header pages of the output. The
text can be 12 characters, and if
it contains any nonalphanumeric
characters, it must be enclosed in
quotation marks.
/NOTIFY: Queue Notifies you on your terminal when
YES or NO operation your request is completed. To be
notified, use /NOTIFY with no
argument, or with YES or 1 as an
argument. To suppress
notification, use /NOTIFY:0,
/NOTIFY:NO, or /NONOTIFY. By
default, you are not notified when
a request is finished. In special
cases, such as the printing of log
files and the output of deferred
requests, you will never be
notified.
/NULL: Queue Does not print a fatal error
YES or NO operation message if the specified files do
not exist. /NULL:NO is the same as
/NONULL.
/OKBINARY Queue Accepts files whose extensions
Operation indicate that they include binary
information. Normally files with
extensions .SAV, .SHR, .LOW, .REL,
.EXE, and .HGH will not be
accepted.
/OKNONE Queue Does not produce a warning message
operation if no files match the file
specification.
/OKPROTECTION Queue Does not produce an error message
operation if a file protection code is
violated.
/OPTION:option Queue Uses the option line QUEUE:option
operation in the SWITCH.INI file. See the
help file SWINI for more
information about SWITCH.INI.
/PHYSICAL File Does not recognize logical names
control in the command line.
/PRESERVE File Saves the file after printing
control it. This switch is the same as
DISPOSE:PRESERVE. This is the
default function.
/PRINT:arg File Prints the file with the specified
control characteristics. The default
printing mode is ASCII. The
argument can be any one of the
following:
ARROW prints the file literally,
denoting each control character by
a ^ and the character, except for
the following which are printed
literally: carriage return,
linefeed, horizontal tab, vertical
tab, and formfeed.
ASCII prints the file with no
changes.
GRAPHICS causes the LN01 laser
printer to recognize escape
sequences. These embedded
sequences allow font changes within
the file. Unless you specify this
switch, escape sequences will be
ignored and printed as part of the
file.
OCTAL prints the octal values
instead of the characters in the
file.
SUPPRESS converts all control
characters to line feeds except for
ASCII code characters CR and DC3.
/PRIORITY:n Queue Gives the specified priority number
operation (n is 1 to 63) to the request. A
larger number has greater priority.
/PROTECTION: Queue Specifies a protection code for the
nnn operation queue request. Queue requests are
protected in the same way that
files are protected. For
information about protection codes
see the help file PCODES.
/QUEUE:queue Queue Specifies the remote VAX queue to
operation receive the output from the
request.
/REMOTE Queue Prints on your terminal a list of
operation remote queues. Must be used with
/DESTINATION.
/REPORT:code File Processes COBOL report files by
control printing every line in the file
that begins with the specified
code.
/REQUESTID:n Queue Specifies the request
operation identification number of the job
you wish to modify or terminate
(/KILL). The request
identification number is assigned
by the system when the request is
made. Place this switch to the
left of the equal sign in the
command line. (See the examples.)
/RUN:file Queue Executes the specified file after
operation the request is accepted.
/RUNCORE:n Queue Executes the file specified in /RUN
operation in nK of core after the request is
accepted.
/RUNOFFSET:n Queue Executes the file specified in /RUN
operation with offset n after the request is
accepted.
/SEQUENCE:n Queue Specifies a sequence number to aid
operation in identifying a request to be
modified or deleted. This switch
must be used to the left of the
equal sign in the command line.
(See the examples.)
/SINCE: File Queues only the files with creation
date-time control dates after the specified date and
time.
/SPACING: File Prints the files with the specified
arg control spacing parameters. The default
function is to make no spacing
changes to the file, which is the
same as /SPACING:SINGLE. You can
use the following arguments with
this switch:
SINGLE prints the file with no
spacing changes.
DOUBLE prints a blank line between
every line of the file.
TRIPLE prints two blank lines
between every line of the file.
/STRS: File Searches for the file on all
YES or NO control structures in the search list and
takes every occurrence. The
default is to take just the first
occurrence of the file.
/TMPFIL: Queue Creates a temporary file TMP:file
file:text operation and enters the text into the file.
/UNIT:n Queue Specifies a decimal unit number
operation or SIXBIT name of the device you
want the output sent to.
/UPPERCASE Queue Forces the output to be printed on
operation an uppercase-only line printer.
This switch is the complement to
/LOWERCASE.
/USERNAME: Queue Specifies the user name for the
"name" operation banner page of output listings.
This field can contain up to 39
alphanumeric characters, and may
include punctuation and spaces if
the name is placed in quotation
marks.
Associated Messages
When a new entry is made in a system queue, the system prints a
message on the user's terminal. The message is in the form:
[PRINTER JOB name QUEUED, REQUEST #nnn, LIMIT xxx]
Where: name is the name of the job in the queue. This can be
specified by the user. Otherwise, it defaults to the
name of the first file in the request.
nnn is the number that represents the request
identification of the job in the queue.
xxx is the maximum number of pages that the job will
use.
Characteristics
Leaves your terminal in monitor mode.
Destroys your core image.
Does not require LOGIN if you want only a list of jobs in the
queue to be printed on your terminal.
Examples
1. Print the file SYS:NOTICE.TXT.
.PRINT SYS:NOTICE.TXT<RET>
[PRINTER JOB NOTICE QUEUED, REQUEST #109, LIMIT 50]
.
2. Print the file SYS:NOTICE.TXT after 5:00 P.M.
.PRINT SYS:NOTICE.TXT /AFTER:17:00<RET>
[PRINTER JOB NOTICE QUEUED, REQUEST #109, LIMIT 50]
.
3. Change the job with request identifcation number 109 to print
after 4:30 P.M.
.PRINT /REQUESTID:109= /MODIFY /AFTER:16:30<RET>
4. Cancel the job with sequence number 22.
.PRINT /SEQUENCE:22= /KILL<RET>