How to Create and Use Configuration Files

Contents
xdtw116
Use configuration files to set default parameters for 
XCOM Data Transport
 transfers. Use XCOM.CNF to change default settings or to set transfer-specific variables for an individual locally initiated transfer. Use a text editor to modify the values in XCOM.CNF. All modifications go into effect the next time a transfer is initiated.
Configuration Files
XCOM Data Transport
 reads the parameter file XCOM.CNF or a user specified configuration file, and parameters that are specified at the command prompt, and executes the specified file transfer.
XCOM Data Transport
 automatically uses the defaults from the XCOM.GLB file, and the XCOM.CNF file if you do not specify any user configuration files, to supply any parameter values not specified on the command prompt. However, write new configuration files of your own to use for transfers.
For each transfer, 
XCOM Data Transport
 compiles a full set of parameter values. To collect these values, the program follows a search sequence. (When you are using the GUI, 
XCOM Data Transport
 collects parameter values in a different way.)
When using the command prompt or a script, the values are collected in the following order:
  • The 
    XCOM Data Transport
     program defaults.
  • Parameters that are defined in XCOM.GLB at the time the XCOMD
    XCOM Scheduler service
    was started.
  • Parameters that are defined in a user-created configuration file that is specified with the 
    -f
     option on the command line, or the XCOM.CNF file. If a copy of the configuration file is not found in the current directory, then the file %XCOM_HOME%\CONFIG\XCOM.CNF is used.
  • Parameters that are defined in the command prompt following the 
    -f
     option.
If you specify another configuration file at the command prompt, using the 
-f
 option, then parameters from the specified file are used instead of XCOM.CNF.
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 command:
    CD %XCOM_HOME%\config
    This brings you to the directory where 
    XCOM Data Transport
     configuration files are stored and makes it the current directory.
    Your configuration 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 
    XCOM Data Transport
    . For information about default directories, see Default Directories and Drives in How to Use the GUI. If you put the configuration file in another directory, 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:
    • "c:\xcomwin 32\config\myconfig.cnf"
    • "%XCOM_HOME%\config\myconfig.cnf "
    If you plan to use this configuration file with the GUI, it can be in any directory.
  2. Enter the following command:
    COPY XCOM.CNF FILENAME.CNF
    XCOM.CNF is copied and renamed to FILENAME.CNF.
    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 use the defaults that are set in XCOM.GLB or the XCOMD
    XCOM Scheduler service
    .
    If you specify a configuration file, then XCOM.CNF is not used. If you do not specify a configuration file, then 
    XCOM Data Transport
     looks in XCOM.CNF for parameter values.
  4. Save the file as ASCII text and exit the editor.
You 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 to display these files in the selection list.
Example 1:
 
In the following example, 
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.
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 that is 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