HP 3000 Manuals HP 3000 Manuals
HPACDPUT
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 .
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 .
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 .
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 .
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)