Delete Interprocess Communication Objects (QP0ZDIPC) API

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 on these authorities, see the Security - Reference book.

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

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.