1 07/25/84  gcos_sysprint, gsp
 2 
 3 Syntax as a command:  gsp input_path {output_path} {-control_arg}
 4 
 5 
 6 Function:  The gcos_sysprint command converts a print file (either
 7 SYSOUT or simulated printer) produced by the GCOS environment simulator
 8 from GCOS ASCII or BCD to Multics ASCII for printing or viewing on a
 9 terminal.  This command is called automatically by the simulator to
10 convert any print files produced by the job, unless the -hold option is
11 given on the gcos command line.  It can also be called by the user to
12 convert a file that was not converted automatically.
13 
14 
15 Arguments:
16 input_path
17    is the pathname of a print file produced by the simulator.
18 output_path
19    is the pathname of a file into which the ASCII output lines are to
20    be written.  If the file already exists, it is overwritten with no
21    warning.  If output_path is omitted, the lines are displayed on the
22    user's terminal as they are converted.
23 
24 
25 Control arguments:
26 -lower_case, -lc
27    translates alphabetic characters to lowercase ASCII.  (Default is
28    uppercase)
29 
30 
31 Notes:  The star and equal conventions are not implemented in this
32 command.
33 
34 If the first record in the file is the SYSOUT header record written by
35 the simulator, then the records are ordered by report code (within each
36 activity) before being printed, and all records from the execution
37 report are printed first.  Otherwise the records are printed in the
38 order in which they appear in the input file, with no sorting or
39 reordering of any kind.
40 
41 The records are assumed to be GCOS print line images, ending with GCOS
42 printer control characters.  These latter are converted to ASCII
43 newline and newpage characters.  To convert a BCD card image file to
44 ASCII, with newline characters being added to the end of each line, use
45 the gcos_card_utility command.