cwbOBJ_SendNetSplF

Purpose

Sends a spooled file to another user on the same system or to a remote system on the network.

Syntax

 
unsigned int CWB_ENTRY  cwbOBJ_SendNetSplF(
                               cwbOBJ_ObjHandle   splFHandle,
                               cwbOBJ_ParmHandle  parmListHandle,
                               cwbSV_ErrHandle    errorHandle);

Parameters

cwbOBJ_ObjHandle splFHandle - input

Handle of the spooled file to be sent.

cwbOBJ_ParmHandle parmListHandle - input

Required. A handle of a parameter list object that contains the parameters for sending the spooled file.

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.

CWB_INVALID_PARAMETER

invalid parameter specified.

CWBOBJ_RC_HOST_ERROR

Host error occurred. Text may be in errorHandle.

CWBOBJ_RC_INVALID_TYPE

Handle is not a spooled file handle.

Usage

The equivalent of a send net spooled file (SNDNETSPLF) command will be issued against the spooled file. The following parameter key's MUST be set in the parmListHandl object:

• CWBOBJ_KEY_TOUSERID

  Specifies user ID to send the spooled file to.

• CWBOBJ_KEY_TOADDRESS

  Specifies the remote system to send the spooled file to. "*NORMAL" is the default.

The following parameter key's may be set in the parmListHandle object:

• CWBOBJ_KEY_DATAFORMAT

  Specifies the data format in which to transmit the spooled file. May be "*RCDDATA" or "*ALLDATA". "*RCDDATA" is the default.

• CWBOBJ_KEY_VMMVSCLASS

  Specifies the VM/MVS SYSOUT class for distributions sent to a VM host system or to an MVS™ host system. May be "A" to "Z" or "0" to "9". "A" is the default.

• CWBOBJ_KEY_SENDPTY

  Specifies the queueing priority used for this spooled file when it is being routed through a snad network. May be "*NORMAL" or "*HIGH". "*NORMAL" is the default.