The Command Line Interface › Transferring Files › Options

Options

The following list explains the options available for xcom62 and xcomtcp:

Note: When the shell encounters an option that performs an action and exits xcom62 or xcomtcp, it will perform the command and exit xcom62 or xcomtcp without reading the rest of the command line.

-cnumber

The type of transfer to be attempted. Valid values for number are:

1—Send file to remote system (default).

2—Send report to be printed on remote system.

3—Send job to be executed on remote system.

4—Receive file from remote system.

5—Metatransfer to a remote system.

6—Metatransfer to inquire on the status of metatransfers.

7—Metatransfer to retrieve history records.

-ping

CA XCOM Data Transport tests reachability of the remote CA XCOM Data Transport Server and displays information about CA XCOM Data Transport Server.

Note: All other options are ignored.

-h

CA XCOM Data Transport displays help. The usage message is displayed and exits xcom62 or xcomtcp.

Note: All other options are ignored.

-r

CA XCOM Data Transport displays the release level. The release level of the software is displayed and exits xcom62 or xcomtcp.

-q

CA XCOM Data Transport queues the transfer. This option works like the QUEUE=YES parameter in xcom.cnf.

-s

CA XCOM Data Transport sets silent mode, which turns off all output to stderr.

-t

CA XCOM Data Transport sends trace output to stderr.

-i

CA XCOM Data Transport ignores configuration errors.

-f configfilename

CA XCOM Data Transport reads configfilename to set the parameters necessary for the transfer. The syntax for setting parameters within the configuration file is as follows:

PARAMETER1=value
PARAMETER2=value

Note: Though you can have CA XCOM Data Transport read parameters from a file as well as from the command line, the parameters on the command line take precedence and must come after the file name.

If you specify -f, you must specify configfilename or PARAMETERNAME=value, or you can specify both.

PARAMETERNAME=value...

Instead of setting parameters in a file, you can set them on the command line. The syntax is as follows:

PARAMETER1=value PARAMETER2=value

The value of the parameters must be in uppercase where appropriate, but the parameter names themselves, with an underscore character where indicated, are not required to be in uppercase.

Note: Parameters entered on the command line take precedence over those in the parameter file.

no options

If you invoke CA XCOM Data Transport without options, the defaults that are in xcom.cnf are used for the transfer.

-v

Sets the transfer version type. Valid values are 1 or 2.

-x

Sets the trace level. Valid values are 0 to 10.