| 1 | Delete control | Input | Char(*) |
| 2 | Error code | I/O | Char(*) |
The Delete Interprocess Communication Objects (QP0ZDIPC) API deletes one or more interprocess communication (IPC) objects as specified by the delete control parameter.
For additional information about these authorities, see the Security reference topic collection.
Information about which IPC objects to delete. For the layout of this structure, see Delete Control Format.
The structure in which to return error information. For the format of the structure, see Error code parameter.
The following shows the format of the delete control parameter. For detailed
descriptions of the fields in the table, see Field
Descriptions.
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | BINARY(4) | Number of objects to delete. |
| These fields repeat for each object to delete. | CHAR(1) | IPC type | |
| CHAR(3) | Reserved | ||
| BINARY(4) | Identifier | ||
Identifier. A unique IPC identifier that is used to specify which IPC object is to be deleted. The identifier is obtained from calling the APIs semget(), shmget(), msgget(), or QP0ZOLIP.
IPC type. This value describes the type of IPC object to delete. Possible values follow:
| 1 | Delete a semaphore set object. |
| 2 | Delete a shared memory object. |
| 3 | Delete a message queue object. |
Number of objects to delete. The number of IPC objects in the delete control parameter.
Reserved. A reserved field. These characters must be set to '00'x.
| Message ID | Error Message Text |
|---|---|
| CPF24B4 E | Severe error while addressing parameter list. |
| CPF3C90 E | Literal value cannot be changed. |
| CPF3CF1 E | Error code parameter not valid. |
| CPFA986 E | &1 IPC objects deleted; &2 IPC object not deleted |
| CPDA981 D | Not authorized to delete IPC object &1. |
| CPDA982 D | IPC object &1 does not exist. |
| CPDA983 D | IPC object &1 is marked as damaged. |
| CPFA987 E | Delete control not valid. |