1 01/24/83  get_system_aim_attributes_
 2 
 3 
 4 Entry points in get_system_aim_attributes_:
 5    (List is generated by the help command)
 6 
 7 
 8 :Entry: get_system_aim_attributes_: 01/19/83  get_system_aim_attributes_
 9 
10 
11 Function: returns a structure describing the AIM attributes
12 defined on this system.
13 
14 
15 Syntax:
16 declare get_system_aim_attributes_ entry (ptr, char(*), ptr,
17      fixed bin(35));
18 call get_system_aim_attributes_ (area_ptr, version_wanted,
19      aim_attributes_ptr, code);
20 
21 
22 Arguments:
23 area_ptr
24    is a pointer to an area in which the aim_attributes structure is
25    allocated.  (Input)
26 version_wanted
27    is the version of the structure that the caller expects
28    get_system_aim_attributes_ to return.  The only supported version at
29    present is given by the value of the named constant
30    AIM_ATTRIBUTES_VERSION_1 defined in the system include file
31    aim_attributes.incl.pl1.  (Input)
32 aim_attributes_ptr
33    is set to locate the aim_attributes structure allocated by this
34    program.  (Output)
35 
36 
37 code
38    is a standard system status code.  (Output) It can be one of the
39    following:
40    0
41       the aim_attributes structure was successfully allocated.
42    error_table_$unimplemented_version
43       the version of the structure requested by the caller is not
44       implemented by get_system_aim_attributes_.
45    error_table_$noalloc
46       there was not sufficient room in the caller's area to allocate
47       the aim_attributes structure.
48 
49 
50 Notes: The aim_attributes structure is defined in the system include file
51 aim_attributes.incl.pl1 and has the following format:
52 
53    dcl 1 aim_attributes           aligned based,
54          2 version                char(8) unaligned,
55          2 access_class_ceiling   bit(72),
56          2 levels (0 : 7),
57            3 long_name            char(32) unaligned,
58            3 short_name           char(8) unaligned,
59          2 categories (18),
60            3 long_name            char(32) unaligned,
61            3 short_name           char(8) unaligned,
62 
63 
64 Structure elements:
65    version
66       is the version of this structure (currently
67       AIM_ATTRIBUTES_VERSION_1).
68    access_class_ceiling
69       is the maximum authorization or access class in terms of the AIM
70       attributes.
71    levels
72       are the sensitivity levels defined on this system.  Only the
73       entries from levels(0) through levels(highest_level) contain
74       definitions.  The remaining entries are all blank.
75       long_name
76          is the long name of this sensitivity level.
77       short_name
78          is the short name of this sensitivity level.
79 
80 
81    categories
82       are the access categories defined on this system.  Only the first
83       n_categories entries of this substructure contain definitions.
84       The remaining entries are all blank.
85       long_name
86          is the long name of this sensitivity level.
87       short_name
88          is the short name of this sensitivity level.