cwbDQ_GetSysName

Purpose

Retrieve the system name that is used with the cwbDQ_Open API.

Syntax

 
unsigned int CWB_ENTRY cwbDQ_GetSysName(
                             cwbDQ_QueueHandle   queueHandle,
                             char               *systemName);

Parameters

cwbDQ_QueueHandle queueHandle - input

Handle that was returned by a previous call to the cwbDQ_Open function. This identifies the iSeries™ data queue object.

char *systemName - output

Pointer to a buffer where the system name will be written.

Return Codes

The following list shows common return values.

CWB_OK

Successful completion.

CWB_INVALID_POINTER

Bad or null pointer.

CWBDQ_INVALID_QUEUE_HANDLE

Invalid queue handle.

Usage

This function requires that you previously have issued cwbDQ_Open or cwbDQ_OpenEx.