HPACDINFO
MPE documents | |
 Complete PDF | |
| Table of Contents | |
| Index | |
| Edition 7 E0701 ♥ | |
| Edition 7 E0300 | |
| Edition 6 E0195 |
Syntax
I32 IV * IV *
HPACDINFO (status, itemnum1, item1 [,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".
- item1
Type varies (required)
Passes the file or device identification information as specified in itemnum. Refer to Table 7-1 "HPACDINFO Itemnum1/Item1 Values".
- itemnum2
integer by value (optional)
Passes the number indicating the item2. Refer to Table 7-2 "HPACDINFO Itemnum2/Item2 Values".
- item2
Type varies (optional)
Returns the variable information as specified in itemnum2. Refer to Table 7-2 "HPACDINFO Itemnum2/Item2 Values".
| Itemnum | Mnemonic | Item Description |
|---|---|---|
| The following constants have been defined for a file or device request: | ||
| 1 | BA | Specifies the target file name. The item1 value specified must be a byte array of 1 to 35 characters (for MPE filenames), word aligned. Note that no wildcard characters are allowed, a lockword can be included, and the file name specified does not need to be fully qualified and can be specified using either MPE or HFS name syntax file name. HFS pathnames must begin with a dot (.) or slash (/) character and cannot exceed 1024 characters, including the dot or slash and the null character terminator. MPE filenames < 35 characters must be terminated with a null character or a carriage return. |
| 3 | UDS | Specifies the unique file identifier (UFID). The item1 value specified must be a 20-byte structure, which can be obtained from the file system through the HPFOPEN, FLABELINFO, or FFILEINFO intrinsics. |
| 4 | I | Specifies the file identifier of a previously opened file or directory. The item1 value specified must be a 16-bit integer value. |
| 6 | I | Specifies the logical device number (ldev). The item1 value specified must be a 16-bit integer value. |
| 7 | BA | Specifies the name of a specific device. The item1 value specified must be a 1 to 8 character byte array. |
| 15 | BA | Specifies the target filename. The item1 value specified must be a byte array of < 1024 characters long inluding the terminating carriage return, blank, or null character. |
| Itemnum | Mnemonic | Item Description |
|---|---|---|
| Security information that is not user-dependent can be requested using the following itemnum2/item2 pairs: | ||
| 20 | A | Returns a unique identifier representing the current version of the ACD. Currently the version number is 5. The item2 value returned is a 16-bit integer. |
| 21 | I | Returns the number of ACD entries located in the target file ACD. The item2 value returned is a 16-bit integer. |
| 22 | BA | Returns a unique identifier representing the first user specified in the ACD. The item value returned is a 1 to 18 character byte array. |
| Security information that is user-dependent can be requested using the following itemnum2/item2 pairs: | ||
| 30 | BA | Specifies the user whose ACD information is to be returned. The item2 value specified must be an 18-character byte array, word aligned. If it is <18 characters, it must be terminated with a null character or a carriage return. This entry is required for subsequent user-dependent requests. |
| 31 | BA | Returns ACD modes in ASCII format. The item2 value returned is a 25-character byte array. |
| 32 | I | Returns ACD modes as a bit mask. The
item2 value returned is a 16-bit integer whose bits have
the following meaning:
r (0:1) - READ w (1:1) - WRITE x (2:1) - EXECUTE a (3:1) - APPEND l (4:1) - LOCK z (8:1) - Permission to read rd (11.1) - td (12.1) - cd (13.1) - dd (14.1) - n (15:1) - No access |
| 33 | BA | Returns ACD modes in ASCII format as access is granted the particular user. The item2 value returned is a 25-character byte array. All wildcards are matched from the user specification. The access granted the user in the selected ACD pair can be greater than the access specified in the ACD pair if the user has AM or SM capability. |
| 34 | I | Returns ACD modes as a bit mask of all accesses granted the particular user. The item2 value returned is a 16-bit integer whose bits have the following meanings: r (0:1) - READ w (1:1) - WRITE x (2:1) - EXECUTE a (3:1) - APPEND l (4:1) - LOCK z (8:1) - Permission to read rd (11.1) - td (12.1) - cd (13.1) - dd (14.1) - n (15:1) - No accessAll wildcards are matched from the user specification. The access granted the user in the selected ACD pair can be greater than the access specified in the ACD pair if the user has AM or SM capability. |
| 35 | BA | Returns the next user in the ACD. The item2 value returned is a 1 to 18 character byte array. |
Operation Notes
The HPACDINFO intrinsic lists the requested security attributes of a specified file or device. Three types of itemnum/item pair descriptors can be used to define supplied input or to specify returned ACD information. Such descriptors identify the file or device and request nonuser-dependent and user-dependent data.
Related Information
| Intrinsics | HPACDPUT, HPFOPEN |
| Commands | LISTF, LISTFILE, SHOWDEV |
| Manuals | MPE/iX Commands Reference Manual |
|
HP32208 |
HPACDPUT |