Previous Topic: Configuration Files

Next Topic: Symbolic Parameters in Configuration Files

The Command Line Interface › Using Configuration Files › Create Configuration Files from the Command Prompt

Create Configuration Files from the Command Prompt

To create configuration files of your own for different types of transfers

  1. From the Windows command prompt, enter the following: 
    CD c:\Program Files (x86)\CA\XCOM\config

    This brings you to the default directory where CA XCOM Data Transport configuration files are stored and makes it the current directory.

    Note: Your configuration may have these files in a different directory. If you plan to use this configuration file from the command prompt, keep it in the same directory where you have CA XCOM Data Transport. The default directory is c:\Program Files (x86)\CA\XCOM. If you put the configuration file in another directory, you must specify the full path name when referring to it. For example, C:\XCOMWIN\FILENAME.CNF.

    To specify a path name that contains a blank or special character, put double quotes (" ") around it. For example:

    Note: If you plan to use this configuration file with the GUI, it can be in any directory.

  2. Enter the following: 
    COPY XCOM.CNF FILENAME.CNF

    XCOM.CNF is copied and renamed to FILENAME.CNF.

    Note: The name FILENAME.CNF is used only as an example here.

  3. Use any text editor that generates ASCII text to open and modify the parameters in the new file to your specific needs.

    It is not necessary to list all available parameters in a configuration file, because any unspecified parameters will use the defaults that are set in XCOM.GLB or the XCOMD CA XCOM Scheduler service.

    If you specify a configuration file, then XCOM.CNF is not used. If you do not specify a configuration file, then CA XCOM Data Transport looks in XCOM.CNF for parameter values.

  4. Save the file as ASCII text and exit the editor.

Note: You may also copy and rename configuration files through the Windows Explorer or using any editor that generates ASCII text.

If you create configuration files that are not named with a .cnf or .xml extension, when you open them in the GUI you must change List Files of Type to All files (*.*) in the Open window in order to display these files in the selection list.

For information about creating and editing configuration files from the GUI, see the chapter "Using CA XCOM Data Transport."

Example 1:

In the following example, CA XCOM Data Transport is invoked from the command prompt, using XCOM62, and a configuration file is specified.

XCOM62 [ -cNUMBER] [ -f [CONFIGFILENAME]  [PARAMETER_NAME=VALUE ...] ]

Replace NUMBER, CONFIGFILENAME, and PARAMETER_NAME=VALUE with the desired transfer value, configuration file name, and/or parameter name and values.

For the complete syntax and options for using XCOM62 and XCOMTCP, see How to Transfer Files in this chapter.

Example 2:

In the following example, using XCOM62, a regional office transfers its accounting records daily to the mainframe headquarters.

For this transfer, create a configuration file named ACCOUNT.CNF that contains the following parameter values:

FILEOPTION=REPLACE
LOCAL_FILE=C:\USER\BILLS\JULY
REMOTE_FILE=BILLS.JUL

Then specify this configuration file to use for the transfer as follows:

XCOM62 -c1 -f ACCOUNT.CNF