1 10/20/86 display_list, dils
 2 
 3 Syntax as a command:  dils path {-control_args}
 4 
 5 
 6 Syntax as an active function:  [dils path {-control_args}]
 7 
 8 
 9 Function:  displays selected portions of selected lister records.  As
10 an active function, returns selected portions of selected lister
11 records.
12 
13 
14 Arguments:
15 path
16    is the pathname of the lister file.  The suffix lister must be the
17    last component of the lister segment name; however, if path does not
18    have a suffix of lister, one is assumed.
19 
20 
21 Control arguments:
22 -brief_errors, -bfe
23    suppresses the warning when no records match the selection
24    expression.
25 -field_name field_names, -fn field_names
26    causes the specified field to be displayed or returned, in the order
27    indicated.  This control argument must be given.
28 -select STR, -sel STR
29    specifies those records whose fields are to be displayed.  If this
30    control argument is not specified, then all records are used.
31 
32 
33 -sort STR, -st STR
34    sorts the records processed according to string, which is a string
35    enclosed in quotes.  The new ordering of the list is in effect only
36    for the duration of the command.  The lister file is not modified.
37    If this control argument is not specified, then records are
38    processed in the order in which they currently appear in the lister
39    file.
40 
41 
42 Notes:  The display_list command sets the "lister" severity indicator.
43 A severity of 2 is set when the display is not performed for some
44 reason other than no records matching the selection expression, or the
45 invocation of display_list terminates abnormally.  A severity of 1 is
46 set when the selection expression finds no match.  A severity of 0 is
47 set when the display is successfully completed and the command
48 terminates normally.
49 
50 
51