1 05/01/84  dprint, dp
  2 
  3 Syntax:  dp {-control_args} {paths}
  4 
  5 
  6 Function:  queues specified segments and/or multisegment files for
  7 printing on one of the Multics line printers.  The output is by default
  8 identified by your Person_id.  This command does not accept standard
  9 object segments.
 10 
 11 Use enter_output_request; it has functionally replaced dprint.
 12 
 13 
 14 Arguments:
 15 paths
 16    are pathnames of segments and/or multisegment files.  The star
 17    convention is not allowed.
 18 
 19 
 20 Control arguments:
 21 -access_label, -albl
 22    uses the access class of each pathi specified as a label at the top
 23    and bottom of every page (see "Notes" below).
 24 -brief, -bf
 25    suppresses the message "j requests signalled, k already queued.
 26    (request_type queue)."  This control argument cannot be overruled
 27    later in the command line.  (See -request_type and -queue below.)
 28 -bottom_label STR, -blbl STR
 29    uses the specified string as a label at the bottom of every page
 30    (see "Notes" below).
 31 
 32 
 33 -copy N, -cp N
 34    prints N copies (N <= 4) of specified paths.  It can be overruled by
 35    a subsequent -copy.  If pathi is to be deleted after printing, all N
 36    copies are printed first.  If this control argument is not
 37    specified, one copy is made.
 38 -defer_until_process_termination, -dupt
 39    does not process the request until the requesting process
 40    terminates.  Process termination is caused by the logout command,
 41    new_proc, or a fatal process error.
 42 -delete, -dl
 43    deletes (after printing) specified paths.
 44 
 45 
 46 -destination STR, -ds STR
 47    labels subsequent output with the string STR, which is used to
 48    determine where to deliver the output.  STR is limited to 24
 49    characters and must be quoted if it contains spaces.  If
 50    -destination is not specified, the default is your Project_id.  This
 51    control argument can be overruled by a subsequent -destination.
 52 -forms STR
 53    indicates the type of forms to be used when processing the print
 54    file.  Standard I/O daemon drivers ignore the forms specification
 55    when processing print requests.
 56 -header STR, -he STR
 57    identifies subsequent output by the string STR.  STR is limited to
 58    64 characters and must be quoted if it contains spaces.  If -header
 59    is not selected, the default is your Person_id.  This control
 60    argument can be overruled by a subsequent -header.
 61 
 62 
 63 -indent N, -in N
 64    prints specified paths so that the left margin is indented N
 65    columns.  If not given, no indentation occurs.
 66 -label STR, -lbl STR
 67    uses the supplied string as a label at the top and bottom of every
 68    page (see "Notes" below).
 69 -line_length N, -ll N
 70    prints specified paths so that lines longer than N characters are
 71    continued on the following line; i.e., no line of output extends
 72    past column N.  If not chosen, a line length of 136 characters is
 73    used.
 74 -no_endpage, -nep
 75    prints indicated paths so that the printer skips to the top of a
 76    page only when a form-feed character is encountered in the input
 77    path.  This control argument ignores -page_length (if present).
 78 
 79 
 80 -no_label, -nlbl
 81    does not place any labels on the printed output.
 82 -non_edited, -ned
 83    prints nonprintable control characters as octal escapes rather than
 84    suppressing their printing.
 85 -notify, -nt
 86    sends a confirming message when the requested output is done,
 87    showing the pathname and charge.
 88 -page_length N, -pl N
 89    prints no more than N lines per page, where N is the logical page
 90    length (i.e., the number of lines of user data to appear).  The
 91    default page length varies depending upon the request type.
 92 
 93 
 94 -queue N, -q N
 95    prints supplied paths in priority queue N.  This control argument
 96    can be overruled by a subsequent -queue; if not specified, the
 97    default queue for the request type is assumed.  (See "Notes" below.)
 98 -request_type STR, -rqt STR
 99    places specified paths in the queue for requests of the type
100    identified by STR (see "Notes" below).  If not specified, the
101    default request type is "printer."
102 -single, -sg
103    prints specified paths so that any formfeed or vertical-tab
104    character in any of the paths is printed as a single newline
105    character.
106 
107 
108 -top_label STR, -tlbl STR
109    uses the specified string as a label at the top of every page (see
110    "Notes" below).
111 -truncate, -tc
112    prints specified paths so that any line exceeding the line length is
113    truncated rather than "folded" onto subsequent lines.
114 
115 
116 Access required:  You require r access to the segment or multisegment
117 file.
118 
119 The process that performs the printing (as obtained by
120 print_request_types) must have at least r access to the file and at
121 least s access to the containing directory to verify that you also have
122 at least r access to the file.
123 
124 If -delete is specified, the I/O coordinator (normally IO.SysDaemon.z)
125 must have at least m access to the containing directory and at least s
126 access to the parent directory of the containing directory to verify
127 that you also have at least m access to the containing directory.
128 
129 
130 Notes:  If you invoke dprint without any arguments, the system prints a
131 message giving the status of the default printer queue.
132 
133 If control arguments are present, they affect only paths specified
134 after their appearance in the command line.  If control arguments are
135 specified without a following pathi argument, they are ignored for this
136 invocation of the command and a warning message is printed.