 |
» |
|
|
|
Manipulates security information in the access control definition (ACD) of a specified
file or device. Syntax | |
I32 IV * IV *
HPACDPUT(status,itemnum1,item1,itemnum2,item2);
|
Parameters | |
- status
32-bit signed integer by reference (required) Returns the status of the HPACDPUT 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 (32650-90066, 32650-90152, and 32650-90368) 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 HPACDPUT is 246.
- itemnum1
integer by value (required) Passes an identifier code defining the accompanying paired input (item1).
The values for itemnum1 are described in
the item1 parameter description. Refer to Table 4-13 “HPACDPUT Itemnum1/Item1 Values”.
- item1
Type varies by reference (required) Passes the file or device identification information. The file
or device identifier must be specified using one of the
following predefined itemnum1/item1 pairs. Refer to Table 4-13 “HPACDPUT Itemnum1/Item1 Values”.
- itemnum2
Integer by value (required) Passes the function code defining the accompanying paired input (item2). The
values for itemnum2 are described in the item2 parameter description.
Refer to Table 4-14 “HPACDPUT Itemnum2/Item2 Values”. - item2
Type varies by reference (required) Passes the information to be used to manipulate the ACD of the specified file or device. Functionality requests can be made using one of the predefined
itemnum2/item2 pairs. Refer to Table 4-14 “HPACDPUT Itemnum2/Item2 Values”.
Table 4-13 HPACDPUT Itemnum1/Item1 Values | Itemnum | Mnemonic | Item Description
|
|---|
| 1 | BA | Specifies the target file name. The item1 value specified must be
a byte
array of 1 to 35 characters, word aligned. No wildcard characters are allowed, a lockword can be included, the file name specified
does not need to be fully qualified
and can be specified using an MPE or HFS name syntax. HFS pathnames must begin with a dot (.) or slash (/) character and cannot exceed 1024 characters including the dot or slash. MPE filenames < 35 characters must be terminated with a null character or a carriage return. | | 2 | BA | Specifies the target file name. The item1 value specified must be
a byte
array of 1 to 35 characters, word aligned. Wildcard characters are allowed, a lockword can be included, the file name specified
does not need to be fully qualified, and a file name < 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 number of a previously opened file. The item1 value
specified must be a 16-bit integer value.
| | 5 | N/A | Specifies all devices configured on the system. An item1 value is
not
required with the option.
| | 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.
| | 8 | BA | Specifies the name of a specific device class. 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, including the terminating carriage return, blank, or null character.
|
Table 4-14 HPACDPUT Itemnum2/Item2 Values | Itemnum | Mnemonic | Item Description
|
|---|
| 20 | BA | Create a new ACD. The item2 value specified must be a 1 to 279 character
byte array.
| | 21 | BA | Add ACD pairs. The item2 value specified must be a 1 to 279 character
byte array.
| | 22 | BA | Replace ACD pairs. The item2 value specified must be a 1 to 279 character
byte array.
| | 23 | BA | Delete ACD pairs. The item2 value specified must be a 1 to 279 character
byte array.
| | 24 | N/A | Delete an ACD. An item2 value is not required with this option.
| | 25 | BA | Create a new ACD. The item2 value specified must be
specified using an MPE or HFS name syntax. HFS pathnames must begin with a dot (.) or slash (/) character and cannot exceed 1024 characters, including the dot or slash. MPE filenames < 35 characters must be terminated with a null character or a carriage return.
| | 26 | BA | Copy an ACD from a specified file. The item2 value specified must
be specified using an MPE or HFS name syntax. HFS pathnames must begin with a dot (.) or slash (/) character and cannot exceed 1024 characters, including the dot or slash. MPE filenames < 35 characters must be terminated with a null character or a carriage return.
| | 27 | UDS | Copy an ACD from the specified unique file identifier (UFID). The item2
value specified must be a 20-byte structure containing the UFID obtained from
the file system through the FLABELINFO and FFILEINFO intrinsics.
| | 28 | I | Copy an ACD from a previously opened file number. The item2 value
specified
must be a 16-bit integer containing the filenum of the file containing the ACD
to be copied.
| | 29 | I | Copy an ACD from the specified logical device number (ldev). The item2
value specified must be a 16-bit integer value.
| | 30 | BA | Copy an ACD from the specified device name. The item2 value specified
must be a 1 to 8 character byte array.
| | 31 | BA | Add ACD pairs. The item2 value specified must be
specified using an MPE or HFS name syntax. HFS pathnames must begin with a dot (.) or slash (/) character and cannot exceed 1024 characters, including the dot or slash. MPE filenames < 35 characters must be terminated with a null character or a carriage return.
| | 32 | BA | Replace ACD pairs. The item2 value specified must be
specified using an MPE or HFS name syntax. HFS pathnames must begin with a dot (.) or slash (/) character and cannot exceed 1024 characters, including the dot or slash. MPE filenames < 35 characters must be terminated with a null character or a carriage return.
| | 33 | BA | Delete ACD pairs.The item2 value specified must be
specified using an MPE or HFS name syntax. HFS pathnames must begin with a dot (.) or slash (/) character and cannot exceed 1024 characters, including the dot or slash. MPE filenames < 35 characters must be terminated with a null character or a carriage return.
| | 50 | I | File class indicating the maximum access to be calculated and assigned in the class mask. The item2 value specified must be a a 32-bit interger.
|
Operation Notes | |
The HPACDPUT intrinsic allows programmatic adjustment, creation, and deletion
of ACDs and their security provisions. The intrinsic is used to create, copy, and
delete an ACD and to add, replace, modify, and delete pairs within an ACD. Related Information | |
- Intrinsics
HPACDINFO, HPFOPEN - Commands
ALTSEC, COPY, PASSWORD, RELEASE, SECURE, STORE,
RESTORE - Manuals
MPE/iX Commands Reference Manual Volumes 1 and 2 (32650-90003 and 32650-90364), System Startup, Configuration, and Shutdown Reference Manual (32650-90042), MPE/iX Utilities Manual (32650-90081), and Controlling System Activity (32650-90155)
|
