Example
This example shows how to enable the SAPI interface and how to define the SAPI parameters to send data to a remote system as a file.
To enable the SAPI interface, you must specify the following GLOBAL parameter:
SAPI_INTERFACE=YES.
The following example is a sample NODE definition:
** SAPI Selection Criteria * SAPI_CLASS=A SAPI_WRITER=ACCTDATA * ** SAPI Default parameters * SAPI_REMOTE_FILE=d:\printer\test.%JOBN..%JOBID..D%JDATE..T%TIME SAPI_TRY=5 DEFAULT_COMPRESS=NO CHECKPOINT=NO SAPI_DISP=(DELETE,KEEP,HOLD) * ** SAPI Security Definitions * DEFAULT_USERID=ntuser DEFAULT_PASSWORD=ntpass DEFAULT_LOGON_DOMAIN=ACCTDOMAIN * ** TCP Connection Parameters * APPLICATION=FUSION IPPORT=46464 IPADDR=192.168.0.100 PARALLEL=YES WINNERS=5
In this example, the NODE definition uses SYSOUT class and writer as a filter. This node will only select output written to SYSOUT class A and SYSOUT writer ACCTDATA.
Any file transfers initiated as a result of data selected from the queue will be sent to the remote system as a file. The file name will be created based on the SAPI_REMOTE_FILE parameter, and substitutable parameters will be inserted into the file name to make it unique. The platform server will try the request for 5 times before the transfer fails with a permanent network error. If a network error occurs, the system will not compress the data, and requests will start from the beginning. When a request is completed successfully, the SYSOUT file will be deleted. When the request is completed with a permanent network error, the data will be kept so that the platform server can process it at a later time. When the request is completed with an error other than a network error, the data will be held.
When the data is sent to the remote system, the user ID will be ntuser and the password is ntpass. ACCTDOMAIN will be passed as the logon domain.
The TCP connection parameters define the IP address and IP port used for communicating with the remote node. The Fusion protocol will be used to communicate with this node, and a maximum of 5 concurrent initiator transfers are supported.