cwbDQ_Create

Purpose

Create an iSeries™ data queue object. After the object is created it can be opened using the cwbDQ_Open API. It will have the attributes that you specify in the attributes handle.

Syntax

 
unsigned int CWB_ENTRY cwbDQ_Create(
                             char               *queue,
                             char               *library,
                             char               *systemName,
                             cwbDQ_Attr          queueAttributes,
                             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.

cwbDQ_Attr queueAttributes - input

Handle to the attributes for the data queue.

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 are 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_INVALID_ATTRIBUTE_HANDLE

Invalid attributes handle.

CWBDQ_BAD_QUEUE_NAME

Queue name is incorrect.

CWBDQ_BAD_LIBRARY_NAME

Library name is incorrect.

CWBDQ_BAD_SYSTEM_NAME

System name is incorrect.

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_NO_AUTHORITY

No authority to library.

CWBDQ_QUEUE_EXISTS

Queue already exists.

CWBDQ_QUEUE_SYNTAX

Queue syntax is incorrect.

CWBDQ_LIBRARY_SYNTAX

Library syntax is incorrect.

Usage

This function requires that you have previously issued the following APIs:

• cwbDQ_CreateAttr
• cwbDQ_SetMaxRecLen