cwbDQ_Delete

Purpose

Remove all data from an iSeries™ data queue and delete the data queue object.

Syntax

 
unsigned int CWB_ENTRY cwbDQ_Delete(
                             char               *queue,
                             char               *library,
                             char               *systemName,
                             cwbSV_ErrHandle     errorHandle);

Parameters

char * queue - input

Pointer to the data queue name contained in an ASCIIZ string.

char * library - input

Pointer to the library name contained in an ASCIIZ string. If this pointer is NULL then the current library will be used (set library to "*CURLIB").

char * systemName - input

Pointer to the system name contained in an ASCIIZ string.

cwbSV_ErrHandle errorHandle - output

Any returned messages will be written to this object. It is created with the cwbSV_CreateErrHandle API. The messages may be retrieved through the cwbSV_GetErrText API. If the parameter is set to zero, no messages will be retrieved.

Return Codes

The following list shows common return values.

CWB_OK

Successful completion.

CWB_COMMUNICATIONS_ERROR

A communications error occurred.

CWB_SERVER_PROGRAM_NOT_FOUND

iSeries application not found.

CWB_HOST_NOT_FOUND

iSeries system inactive or does not exist.

CWB_INVALID_POINTER

Bad or null pointer.

CWB_SECURITY_ERROR

A security error has occurred.

CWB_LICENSE_ERROR

A license error has occurred.

CWB_CONFIG_ERROR

A configuration error has occurred.

CWBDQ_QUEUE_NAME

Queue name is too long.

CWBDQ_LIBRARY_NAME

Library name is too long.

CWBDQ_SYSTEM_NAME

System name is too long.

CWBDQ_REJECTED_USER_EXIT

Command rejected by user exit program.

CWBDQ_USER_EXIT_ERROR

Error in user exit program.

CWBDQ_LIBRARY_NOT_FOUND

Library not found on system.

CWBDQ_QUEUE_NOT_FOUND

Queue not found on system.

CWBDQ_NO_AUTHORITY

No authority to queue.

CWBDQ_QUEUE_SYNTAX

Queue syntax is incorrect.

CWBDQ_LIBRARY_SYNTAX

Library syntax is incorrect.

Usage

None