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 on these authorities, see the iSeries 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	Type	Field
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

Top | UNIX-Type APIs | APIs by category