MPE/iX Intrinsics Reference Manual (32650-90905)

Chapter 7 313
Command Definitions (HP32208-HPLOACNMPROC)
HPACDINFO
HPACDINFO
Lists security information from the access control definition (ACD) of a specified file or
device.
Syntax
I32 IV *
HPACDINFO(
status
,
itemnum1
,
item1
IV *
[,
itemnum2,item2
][,...]);
NOTE A maximum of four
itemnum2/item2
pairs can be specified. The last specified
itemnum2/item2
pair takes precedence over all identical
itemnum2/item2
pairs specified. Any conflict produces a warning message.
Parameters
status
32-bit signed integer by reference (required)
Returns the status of the HPACDINFO call. If no errors or warnings are
encountered,
status
returns 32-bits of zero. If errors or warnings are
encountered,
status
is interpreted as two 16-bit fields:
Bits (0:16) comprise
status.info
. A negative value indicates an error
condition, and a positive value indicates a warning condition. Refer to the
MPE/iX Error Message Manual Volumes 1, 2 and 3 for a description of its
value.
Bits (16:16) comprise
status.subsys
. The value represents the subsystem
that sets the status information. The subsystem identifier for HPACDINFO
is 246.
itemnum1
integer by value (required)
Passes the number indicating the
item
. Refer to Table 7-1., “HPACDINFO
Itemnum1/Item1 Values,” on page 314.
item1
Type varies (required)
Passes the file or device identification information as specified in
itemnum
.
Refer to Table 7-1., “HPACDINFO Itemnum1/Item1 Values,” on page 314.
itemnum2
integer by value (optional)
Passes the number indicating the
item2
. Refer to Table 7-2.,
“HPACDINFO Itemnum2/Item2 Values,” on page 314.
item2
Type varies (optional)
Returns the variable information as specified in
itemnum2
. Refer to
Table 7-2., “HPACDINFO Itemnum2/Item2 Values,” on page 314.