Previous Topic: The Programming InterfaceNext Topic: Allocating the Local Data Set and Parameter Files


The CA XCOM Data Transport Process

CA XCOM Data Transport can be directed to execute a file transfer immediately or to queue it until the necessary resources are available. These instructions, and all the transfer's processing options, are given to CA XCOM Data Transport by parameters passed through the application program. These can be one-time values for individual file transfers, or they can be installation-wide defaults implemented automatically.

The CA XCOM Data Transport routine XCOMJOB runs as a called program and is the same program used in the CA XCOM Data Transport Batch Interface (see the chapter “The Batch Interface”). The program that calls XCOMJOB must pass the equivalent of the EXEC PARM values, and must prime the local and SYSIN01 data sets. The instructions for coding the PARM values and the SYSIN01 parameters are identical to those for the CA XCOM Data Transport Batch Interface and are fully described in the chapter “The Batch Interface.”

Note: TYPE=EXECUTE and TYPE=SCHEDULE are supported with the APIs.

Important! XCOMJOB and all CA XCOM Data Transport LOAD modules are now fully reentrant. As such, XCOMJOB may be link edited into LOAD modules with the code that calls it as the API interface. It is also no longer necessary to delete and reload module XCOMJOB for each subsequent API call within the same program execution.

Programs which call the XCOMJOB API need not be APF authorized, unless specific CA XCOM Data Transport features are used which require APF authorization.