HPACDPUT
MPE documents | |
 Complete PDF | |
| Table of Contents | |
| Index | |
| Edition 7 E0701 ♥ | |
| Edition 7 E0300 | |
| Edition 6 E0195 |
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 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 7-3 "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 7-3 "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 7-4 "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 7-4 "HPACDPUT Itemnum2/Item2 Values".
| Itemnum | Mnemonic | Item Description |
|---|---|---|
| 1 | BA | Specifies the target file name. The item1 value specified must be a byte array, 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 either 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 and a null character terminator. 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, 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. |
| 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 an 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 slashand the null character terminator. 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 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. |
| 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 an 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. |
| 32 | BA | Replace ACD pairs. The item2 value specified must 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. |
| 33 | BA | Delete ACD pairs. The item2 value specified must be 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. 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 32-bit integer. |
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 |
|
HPACDINFO |
HPCALENDAR |