cwbOBJ_MoveSplF

Purpose

Moves an iSeries™ spooled file to another output queue or to another position on the same output queue.

Syntax

 
unsigned int CWB_ENTRY  cwbOBJ_MoveSplF(
                               cwbOBJ_ObjHandle   splFHandle,
                               cwbOBJ_ObjHandle  *targetSplFHandle,
                               cwbOBJ_ObjHandle  *outputQueueHandle,
                               cwbSV_ErrHandle    errorHandle);

Parameters

cwbOBJ_ObjHandle splFHandle - input

Handle of the spooled file to be moved.

cwbOBJ_ObjHandle *targetSplFHandle - input

Optional. The handle of another spooled file on the same system, that specifies the spooled file to move this spooled file after. If this is specified, *outputQueueHandle is not used.

cwbOBJ_ObjHandle *outputQueueHandle - input

Optional. The handle of an output queue on the same system that specifies which output queue to move the spooled file to. The spooled file will be moved to the first position on this queue. This parameter is ignored if targetSplFHandle is specified.

cwbSV_ErrHandle errorHandle - output

Optional, may be 0. 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 retrievable.

Return Codes

The following list shows common return values.

CWB_NO_ERROR

Successful completion.

CWB_NOT_ENOUGH_MEMORY

Insufficient memory.

CWB_INVALID_HANDLE

Handle is not valid.

CWBOBJ_RC_HOST_ERROR

Host error occurred. Text may be in errorHandle.

CWBOBJ_RC_INVALID_TYPE

Handle is not a spooled file handle.

Usage

If both targetSplFHandle and outputQueueHandle are NULL, the spooled file will be moved to the first position on the current output queue.