1 02/06/84  convert_aim_attributes_
 2 
 3 
 4 Entry points in convert_aim_attributes_:
 5    (List is generated by the help command)
 6 
 7 
 8 :Entry: convert_aim_attributes_: 02/06/84  convert_aim_attributes_
 9 
10 
11 Function: converts a bit(72) aligned representation of an access
12 authorization or access class into a character string of the form:
13         LL...L:CC...C
14 where LL...L is an octal sensitivity level number, and CC...C is an
15 octal string representing the access category set.
16 
17 
18 Syntax:
19 declare convert_aim_attributes_ entry (bit(72) aligned, char(32)
20      aligned);
21 call convert_aim_attributes_ (aim_bits, aim_chars);
22 
23 
24 Arguments:
25 aim_bits
26    is the binary representation to be converted.  (Input)
27 aim_chars
28    is the character string representation.  (Output)
29 
30 
31 Notes:  Only significant digits of the level number (usually a single
32 digit from 0 to 7) are printed.
33 
34 Currently, only 18 access category bits are used, so that only six
35 octal digits are required to represent access categories.  Therefore,
36 aim_chars is padded on the right with blanks, which may be used at a
37 later time for additional access information.  Trailing zeros are NOT
38 stripped.
39 
40 If either the level or category field of aim_bits is invalid, the
41 erroneous field is returned as full octal (6 digits for level, 12
42 digits for category), followed by the string "(undefined)".