1 02/21/84  archive_table, act
 2 
 3 Syntax:  act archive_path {starnames} {-control_args}
 4 
 5 
 6 Syntax as active function:
 7    [act archive_path {starnames} {-control_args}]
 8 
 9 
10 Function:  returns the names of specified archive components in a
11 specified archive segment.  As a command, archive_table prints one
12 component name per line.  As an active function, it returns names
13 individually requoted and separated by single spaces.
14 
15 
16 Arguments:
17 archive_path
18    is the pathname of an archive segment, with or without the archive
19    suffix.  The star convention is not allowed.
20 starnames
21    are optional component names to be matched against names of archive
22    components.  The star convention is allowed.
23 
24 
25 Control arguments:
26 -absolute_pathname, -absp
27    causes -name to return archive pathnames, of the form
28    ARCHIVE_DIR>ARCHIVE_NAME::COMPONENT_NAME, rather than just the
29    component names.
30 -bit_count, -bc
31    returns the bit count of the selected components.
32 -component_name, -cnm
33    causes -name to return only the component name portion of the
34    selected components.  It has no effect if -no_name is selected.
35    (Default)
36 -date_time_contents_modified, -dtcm
37    returns the date-time-contents-modified of the segment when the
38    component was last updated in the archive.
39 
40 
41 -date_time_updated, -dtud
42    returns the date-time when the selected components were last updated
43    in the archive.
44 -header, -he
45    prints a header.  Not accepted by the active function.
46 -mode, -md
47    returns the access mode of the selected components.
48 -name, -nm
49    returns the name of the selected components.  (Default)
50 -no_bit_count, -nbc
51    suppresses bit count information.  (Default)
52 -no_date_time_contents_modified, -ndtcm
53    suppresses date-time-contents-modified information.  (Default)
54 -no_date_time_updated, -ndtud
55    suppresses component update time information.  (Default)
56 
57 
58 -no_header, -nhe
59    prints no header.  (Default)
60 -no_name, -nnm
61    suppresses component name information.
62 -no_requote
63    does not requote component attribute groups.
64 -requote
65    requotes the attributes of each component as a single entity.  This
66    control argument is ignored by the command.  (Default)
67 
68 
69 Notes on active function:  If -name is given, archive_table always
70 requotes the component name (-component_name selected) or archive
71 pathname (-absolute_pathname selected).
72 
73 If more than one of -bit_count, -date_time_contents_modified,
74 -date_time_updated, -mode, and -name is supplied, the selected
75 attributes are returned, separated by a space.  The order of items is
76 always:  name, date-time-contents-modified, mode, date-time-updated,
77 bit count; which is the same order found when using the archive
78 command's "tl" key.
79 
80 
81 If -no_requote is used, the selected attributes for each component are
82 returned separated by spaces.  If more than one component is specified,
83 successive component attributes are separated by a space.
84 
85 If -requote is given, the selected attributes for each component are
86 requoted separated by spaces.  If more than one component is supplied,
87 then each component's requoted attribute group is separated from the
88 others by a space.