1 12/01/86  create_list, cls
 2 
 3 Syntax:  cls path {-control_args}
 4 
 5 
 6 Function:  specifies that selected data is to be retrieved and written
 7 to a specified Lister file.  This file can be manipulated via Lister
 8 commands to create a formatted report.  A translated or translatable
 9 query must be available.
10 
11 
12 Arguments:
13 path
14    pathname of a Multics file into which the selected data is to be
15    written.  The data is written in a form suitable for processing by
16    Lister.  The suffix lister is appended to the pathname (if not
17    present in the invocation) and the file is created if it does not
18    exist.  If the file currently exists, it is truncated unless the
19    -extend control argument is specified.
20 
21 
22 Control arguments:
23 -extend
24    specifies that if the Lister file already exists, it is to be added
25    to rather than truncated.  The field names (either default or
26    explicitly specified) must be identical to those defined in the
27    existing file.
28 -field_names STR, -fn STR
29    explicitly specifies the field names in the Lister file being
30    created or extended.  STR is a list of field names that must
31    correspond in order and quantity to the items specified in the
32    select clause of the associated query.  This control argument must
33    be specified if the query select clause contains an expression.  If
34    not specified, the names of the selected data base columns become
35    the lister file field names.
36 
37 
38 Notes:  The values being written to the lister file have all leading
39 and trailing blanks stripped off.