1 10/20/86  append_list, als
 2 
 3 Syntax as a command:  als path {-control_args}
 4 
 5 
 6 Function:  adds a record to a lister file.
 7 
 8 
 9 Arguments:
10 path
11    is the pathname of the lister file.  The suffix lister must be the
12    last component of the lister segment name; however, if path does
13    not have a suffix of lister, one is assumed.
14 
15 
16 Control arguments:
17 -field_name field_name STR, -fn field_name STR
18    assigns the value of STR to the field indicated by field_name.  If
19    STR contains spaces, it must be enclosed in quotes.  If this
20    control argument is not given, those fields without it are
21    assigned null values.  If this control argument is not given at
22    least once, then the default of -prompt is applied.
23 -prompt, -pmt
24    prompts the user for each field in the file.  The response is
25    given, all on one line, and is terminated with a newline
26    character.  This control argument is incompatible with the use of
27    the -field_name control argument.  (Default)
28 
29 
30 -string STR, -str STR
31    uses STR as a character string with no special interpretation,
32    preventing STR from being interpreted as a control argument.  It
33    is to be used with the -field_name control argument (e.g.,
34    "-field_name rating -string -20").
35 
36 
37 Notes:  The append_list command sets the "lister" severity indicator.
38 A severity of 2 is set when the record is not appended or the
39 invocation of append_list terminates abnormally.  A severity of 0 is
40 set when the record is successfully appended and the command
41 terminates normally.