Delete Interprocess Communication Objects (QP0ZDIPC) API
Required Parameter Group:
| 1 | Delete control | Input | Char(*) |
| 2 | Error code | I/O | Char(*) |
Default Public Authority: *USE
Threadsafe: No
The Delete Interprocess Communication Objects (QP0ZDIPC) API deletes one or more interprocess communication (IPC) objects as specified by the delete control parameter.
Authorities and Locks
- Job Authority
- The calling thread must be the owner, must be the creator, or must have
*ALLOBJ special authority.
For additional information about these authorities, see the Security reference topic collection.
Required Parameter Group
- Delete control
- INPUT; CHAR(*)
Information about which IPC objects to delete. For the layout of this structure, see Delete Control Format.
- Error code
- I/O; CHAR(*)
The structure in which to return error information. For the format of the structure, see Error code parameter.
Delete Control Format
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 | ||
Field Descriptions
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.
Error Messages
| 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. |
API introduced: V4R2