1 08/01/84  gcos, gc
  2 
  3 Syntax as a command:  gcos job_deck_path {-control_args}
  4 
  5 
  6 Function:  The gcos command invokes the GCOS batch environment
  7 simulator to run a single GCOS job in the user's process.
  8 
  9 Related facilities include the GCOS daemon, which provides batch
 10 processing for GCOS jobs under Multics, and the gcos_sysprint,
 11 gcos_syspunch, and gcos_card_utility commands, which may be used to
 12 manipulate GCOS format files that reside in the Multics storage system.
 13 
 14 
 15 Arguments:
 16 job_deck_path
 17    is the pathname of a file (segment or multisegment file) containing
 18    a GCOS job deck.  The file may contain ASCII lines (as produced by
 19    one of the Multics editors) representing card images; or it may be a
 20    GCOS standard system format file, containing BCD and binary card
 21    images.  It is assumed to contain ASCII lines unless the GCOS format
 22    is specified.  One way of specifying GCOS format is to have the name
 23    of the file end with the gcos suffix.  The other way is the -gcos
 24    control argument, described below.
 25 
 26 
 27 Control arguments:  specifying the input supplied to the simulator are:
 28 -ascii, -aci
 29    the input file contains ASCII lines, as produced by one of the
 30    Multics editors.  This is the default, but this argument may be used
 31    if the name of an ASCII file ends with the suffix gcos (to avoid the
 32    necessity of renaming the file).
 33 -gcos, -gc
 34    the input file is in GCOS standard system format, containing BCD and
 35    binary card images.  Such a file could have been produced as output
 36    of a previous GCOS job, or by the gcos_card_utility command.
 37 
 38 
 39 -no_canonicalize, -nocan
 40    may be used to save processing time when an ASCII input file
 41    contains no tab characters, and the fields on all the card images
 42    are aligned in the columns required by GCOS.  Normally, an ASCII
 43    input file may contain tabs separating the fields on each line.  The
 44    process of replacing these tabs by the appropriate number of blanks
 45    to align the fields in the columns required by GCOS is known as
 46    canonicalization.  Logical tab stops are known for GCOS $ control
 47    cards and for all the languages supported by the simulator.
 48 -truncate, -tc
 49    if any ASCII input file (the job deck file, or any $ SELECTed file)
 50    contains lines longer than 80 characters (after canonicalization),
 51    the extra characters are assumed to be part of comments, and are
 52    discarded without warning.  If this argument is not given, the first
 53    line longer than 80 characters causes the job to be rejected.
 54 
 55 
 56 Control arguments:  specifying the disposition of output from the
 57    simulator are:
 58 -dprint, -dp
 59    queue the converted print files for printing by the Multics I/O
 60    daemon, followed by deletion.  (The -list argument is implied and
 61    need not be given.)
 62 -dprint_options "options", -dpo "options"
 63    queue the converted print files for printing by the I/O daemon, but
 64    use the dprint control arguments supplied in the options string
 65    instead of the default of -delete.  The options must be enclosed in
 66    quotation marks if they contain blanks or other delimiter characters
 67    recognized by the command processor.  The dprint command is called
 68    via cu_$cp so that a user-defined abbreviation for dprint (that
 69    supplies default heading and destination arguments, for example)
 70 
 71 
 72    would be used in this call.  (The -list and -dprint arguments are
 73    implied and need not be given.)
 74 -dpunch, -dpn
 75    queue the converted punch files for punching by the I/O daemon in
 76    raw mode, followed by deletion.  (The -raw argument is implied and
 77    need not be given.)
 78 -dpunch_options "options", -dpno "options"
 79    queue the converted punch files for punching by the I/O daemon, but
 80    use the dpunch control arguments supplied in the options string.
 81    The -raw argument is always used for dpunch, since the converted
 82    punch files are not suitable for punching in any other mode.  The
 83    explanations under -dprint_options above, regarding quotation marks
 84    and abbreviations, apply to this argument as well.  (The -raw and
 85    -dpunch arguments are implied and need not be given.)
 86 
 87 
 88 -hold, -hd
 89    do not perform the default conversion and daemon output of print and
 90    punch files.  The default is:
 91         -dpo -dl -dpno "-dl -raw"
 92    Since the default for each file type (print or punch) is overridden
 93    when any of the above arguments is specified for the given file
 94    type, the -hold argument is only required when one of the file types
 95    is to be left in GCOS standard system format, with no conversion or
 96    daemon output being performed.
 97 -list, -ls
 98    convert print files (both SYSOUT and simulated printer) from BCD to
 99    ASCII and delete the BCD copy.  (This conversion is performed by a
100    call to the gcos_sysprint command for each file.)
101 
102 
103 -lower_case, -lc
104    translate alphabetic BCD characters in print files to lowercase
105    ASCII.  (Default is uppercase)
106 -raw
107    convert punch files (both SYSOUT and simulated card punch) from BCD
108    (or binary) to an internal format suitable for punching by the
109    Multics I/O daemon in raw mode (960 bits per card image) and delete
110    the BCD copy.  (This conversion is performed by a call to the
111    gcos_syspunch command for each file.)
112 
113 
114 Control arguments:  governing the creation and use of files by the
115    simulator are:
116 -job_id id, -id id
117    use the job identification specified by id in the names of files
118    created by the simulator for this job.  See Section 2 of this manual
119    for more information on the naming of files.  The id may be any
120    character string up to 18 characters to be used in file names, or it
121    may be one of the following control arguments:
122    -unique
123       -unique use a Multics unique name as the job id.  (A unique name
124       is a 15-character string, generated by the unique_chars_
125       subroutine, beginning with an exclamation point and guaranteed to
126       be unique within the system.)
127 
128 
129    -jd_seg, -jd
130       use the entryname of the job deck segment as the job id.  If the
131       entryname ends with gcos, that suffix is removed from the id.
132       (Default)
133 -syot_dir path, -sd path
134    use the pathname of a directory specified by path for the GCOS
135    format copies of print, punch, and sysout files.  By default, the
136    working directory is used.  (The converted copies of these files are
137    always placed in the working directory.)
138 -temp_dir path, -td path
139    use the pathname of a directory specified by path for temporary GCOS
140    files.  (Default is the process directory)
141 
142 
143 Control arguments:  Other control arguments are:
144 -parameter STRs, -pm STRs
145    where STR strings override GCOS JCL parameter values specified on
146    the $ PARAM card (i.e., specify the #n values in the JCL input).
147 -brief, -bf
148    suppresses the printing of all terminal output produced by the
149    simulator except for fatal error messages.  Output from the slave
150    program is not suppressed.
151 -continue, -ctu
152    continues processing of the job when a nonfatal error occurs.
153    Unless the -brief control argument is given, a warning message is
154    printed on the user's terminal.  If this argument is not given, the
155    first nonfatal error causes the job to be rejected.  Nonfatal errors
156    occur mainly in control card processing.
157 
158 
159 -debug, -db
160    invokes interactive debugging aid to be used in the Multics
161    environment (refer to the debug command).
162    Normally, unrecoverable errors cause an immediate abort of the
163    current function and a reset to command level.  Use of this control
164    argument causes batch to call the debugging tool for further
165    analysis of the problem and possible correction.
166 -long, -lg
167    requests certain lines from the execution report, including the
168    begin and end activity lines (containing program switch word, etc.)
169    to be printed in addition to the normal terminal output.
170 -userlib
171    enables the use of GCOS slave software libraries supplied by the
172    user, instead of, or in addition to, the copies of the libraries
173    installed in the system.
174 
175 
176 Notes:  If no control arguments are given, the defaults are such that
177 the command:
178      gcos path
179 is equivalent to the command:
180      gcos path -aci -dpo -dl -dpno "-dl -raw" -id -jd
181 Any $TAPE control card in the job deck issues a mount message (to the
182 operator) for the designated tape.  The mount message requests
183 insertion of a write ring in the tape reel unless the -noring or -nr
184 control is included as a comment on the $TAPE card (see the job deck
185 example included in the -parameter control argument above).
186 
187 For tape processing, the simulator assigns drive numbers according to
188 the order in which tape devices are requested.  These numbers are used
189 in reporting information to the caller and have no correspondence to
190 the tape unit identifiers used by Multics.
191 
192 
193 When tape density of 1600 or less is specified, and a tape drive
194 capable of both 1600 and 6250 bpi is used, difficulties with tape
195 processing may occur.  The problem can be circumvented by using the
196 Multics assign_resource command to request a tape drive (i.e., one that
197 does not support both 1600 and 6250 bpi).