PRINT

PURPOSE:  The PRINT utility prints the contents of a System File (SF) or Data Base Library (DBL) objects on a printer (attached to the printer port of the terminal).  This is the only configuration that is allowed.

Syntax

FORM 1:  prints a System File.  See related options below.

PRINT SF file_name

FORM 2:  prints a DBL object.

PRINT {SD; CM; PM; GS; DI; CF; SI} object_name

[IN DBL dbl_name]

[FORM = form_name]

[BREAK = value]

[COPIES = value]

[[NO] EJECT]

[[NO] HEADER]

[HORIZONTAL = {10; 12; 17}]

[INDENT = value]

[LENGTH = value]

[PRINTER = printer_name]

[[NO] SEQUENCE]

[TERMINAL = terminal_name]

[VERTICAL = {6; 8} ]

[WIDTH = value]

[[NO] WRAP]

SF file_name

is a System File (SF) in the current user area.  RESTRICTION: the name of the file must not contain any special characters not allowed by ACCENT R.

object_name

is a DBL object  name.

IN DBL dbl_name

selects objects from another DBL besides the current one [which is the default].  This clause is ignored when printing SFs.

FORM = form_name

specifies a FORM that is predefined in an initialization file.

BREAK = value

is the number of blank lines to leave at the bottom of each page.  The default is 6 lines.

COPIES = value

specifies the number of copies to print.  The default is one copy.

[NO] EJECT

specifies whether or not to advance to a new page prior to printing.  NOEJECT will allow printing without advancing to the next page.  The default is EJECT.

[NO] HEADER

specifies whether or not to print a header line at the top of each page.  The header has the object name, date and time of printing and the page number.  The default is NOHEADER.

HORIZONTAL =

{10; 12; 17}

is the number of characters per inch to print on a line.  For devices that do not support multiple print densities, this clause is ignored.  The default is 10 characters per inch.

INDENT = value

is the number of spaces to add on the left margin.  The default is zero spaces.

LENGTH = value

is the physical length of a page in printable lines.  The default is 66 lines per page.

PRINTER = printer_name

declares the type of printer attached to the terminal.  Printer name must be defined in NIS:ACCPRT.DEV or an error message is given.  The default printer type is PRECORDRT.

[NO] SEQUENCE

specifies if the sequence numbers of a DBL entry object will be printed.  To print System Files without sequence numbers, remove them before using PRINT.  The default is NOSEQUENCE.

TERMINAL = terminal_name

declares the type of terminal that is being used.  Terminal name must be defined in NIS:ACCPRT.DEV or an error message is given.  The default terminal type is VT100.

VERTICAL = {6; 8}

is the number of lines per inch to print.  The default is 6 lines per inch.

WIDTH = value

is the maximum number of characters to print on a line including INDENT.  The default is 80 characters.

[NO] WRAP

specifies whether or not to print the remaining characters of a line exceeding the WIDTH on the next line.  The default is NOWRAP.

EXAMPLE

*PRINT SF WORK1<CR>
*PRINT SD BOOKS COPIES = 2<CR>

NOTES:  A set of pre-defined default report format settings are in an initialization file named ACCPRT.INI.  Within an initialization file, several logical groups of settings can be specified.  Each logical group is called a FORM.

The initialization file settings can be re-defined in either a personal initialization file or by the system manager in a system-wide initialization file.  This SF must first be copied into the user account and then edited.  The default settings are shown in the command description below.

When the PRINT command is issued, ACCENT R checks the system initialization file, and then checks the personal initialization file for the requested FORM.  The settings in the personal initialization file override settings in the system initialization file.  If no FORM is specified, the default settings are used.  Any setting specified in the PRINT command overrides the initialization file settings.

INITIALIZATION FILES

Initialization files are maintained through the ACCENT R editors or system level editors.  The initialization files are NIS:ACCPRT.INI and SYS$LOGIN:ACCPRT.INI.

Here is an example of an initialization file with three forms:  DEFAULT, MEMO and PROGRAM.

DEFAULT/PRI=PRECORDRT/TER=VT100/BRE=6/COP=1/HOR=10/IND=0/LEN=66/&
VER=6/WID=80/EJE/NOHEA/NOSEQ/NOWRAP
MEMO/HOR=12/IND=5/WID=95
PROGRAM/HOR=17/IND=5/WID=132/HEA/SEQ

RULES FOR INITIALIZATION FILES

  1. The definition of a form in an initialization file must be on one line.  For the purposes of documentation the definition of the DEFAULT form was shown on two lines, but this syntax is not supported.

  2. The first element on a line is the form name.  This is an alphanumeric character string of up to eight characters.

  3. If specifying a form on the command line, first the user initialization file, then the system initialization file is searched.  If the form is not found, an error message is given and the command aborts.

  4. Whether a form has been specified or not, the initialization files (first the user’s, then the system’s), are searched for the form DEFAULT.  However, DEFAULT settings do not override user-specified settings or FORMs.

  5. The form DEFAULT, whether its defined in the user’s initialization file or in the system’s, must contain settings for all available PRINT switches, otherwise the results are indeterminate.

  6. Any settings given on the command line override the settings given on either user-specified forms or the DEFAULT form.

Valid Devices

The Data Set (DS) NIS:ACCPRT.DEV is supplied with the PRINT utility.  This file is maintained by the system manager and contains the device dependent control sequences which allow PRINT to work with different types of terminals and printers.  Presently this device file supports:

Terminals: VT100s and compatibles

Printers:           LA50            DEC’s personal printer

            PRECORDRT            Precordriters by C’Itoh

The system manager can add additional devices without affecting the functionality of the PRINT utility.