Global Parameters

This article describes how you can add or modify the following global parameters.
xdtw1161
This article describes how you can add or modify the following global parameters.
 
 
These global parameters are manipulated using the xcom.glb text file.
These are the default values to be used by 
XCOM Data Transport
 to process transfers and other features of the product. 
XCOM Data Transport
 validates each parameter against expected valid values.
For any changes made on this page to take effect, restart the XCOMD
XCOM Scheduler service
.
Character Conversion Parameters
You can use the Global Parameters page to manage character conversion parameters.
To update default values for character conversion parameters
 
  1. Click the arrow in the Character Conversion pane to expand it, if it is not already expanded.
    The current default values of the character conversion parameters appear, in the following sections:
    • Character Conversion Identification
    • Internal Conversion Table
  2. To update the Character Conversion Identification section, do the following:
    1. Click the Browse button to select a value for the 
      ATOE Filename
       field.
      The name of the file containing the ASCII-to-EBCDIC character conversion table.
      Range:
       0 to 256 characters
      Default:
       %XCOM_HOME%\convtab\atoe.tab (Windows)
    2. Click the Browse button to select a value for the 
      ETOA Filename
       field.
      The name of the file containing the EBCDIC-to-ASCII character conversion table.
      Range:
       0 to 256 characters
      Default:
       %XCOM_HOME%\convtab\etoa.tab (Windows)
    3. Enter a value in the 
      Convert Classes
       field.
      A character string containing print classes for which EBCDIC-to-ASCII conversions will be performed. For incoming report transfers only.
      Range:
       1 to 64 characters
      Default:
       None
  3. To update the Internal Conversion Table section, check or uncheck the Use internal conversion tables for character conversions field.
    Indicates whether internal or external conversion tables should be used for ASCII-to-EBCDIC conversion and EBCDIC-to-ASCII conversion.
  4. Click the Update button to save your changes.
    The default values of the updated parameters are changed in the xcom.glb file.
Gateway Parameters
You can use the Global Parameters page to manage Gateway parameters.
To update default values for Gateway parameters.
 
  1. Click the arrow the Gateway pane to expand it, if it is not already expanded.
    The current default values of the Gateway parameters appear.
  2. To update the Gateway parameters:
    1. Enter values in the following fields:
      • IP Address
        Specifies the Gateway IP address that the 
        XCOM Data Transport
         server is allied to. For Gateway transfers only.
        Default:
         None
      • Port Number
        Specifies the Gateway port that the 
        XCOM Data Transport
         server is allied to. For Gateway transfers only.
        Default:
         None
    2. Click the Browse button to select a value for the 
      Certificate File Path 
      field.
      Specifies the file name of the certificate that will be passed to the Gateway server. It is used to confirm that the request is from an authorized 
      XCOM Data Transport
       server. For Gateway transfers only.
      Default:
       None
    3. Click the Browse button to select a value for the 
      Private Key File Path
       field.
      Specifies the file name of the certificates private Key. For Gateway transfers only.
      Default:
       None
    4. Enter a value in the 
      Pass Phrase
       field.
      Specifies the password that was set when the certificate was created. This is required only if a password was defined at the time of certificate creation. For Gateway transfers only.
      Default:
       None
    5. Click the Browse button to select a value for the 
      CAPKI Home Path
       field.
      Specifies the CAPKI/ETPKI library path. This needs to be set before using any of the following:
      • Encryption at rest
      • TLS/SSL transfers
      • Transfers using
        XCOM Data Transport for Windows
        Gateway
      Range:
       0 to 256 characters
      Default:
       Varies according to the version (32-bit or 64-bit) of 
      XCOM Data Transport
      :
      For 32-bit: %ProgramFiles%\CA\SC\CAPKI\CAPKI5\Windows\x86\32\lib
      For 64-bit: %ProgramFiles%\CA\SC\CAPKI\CAPKI5\Windows\amd64\64\lib
    6. Select a value from the drop-down list for the 
      Fips Mod
      e field.
      Specify the mode to use for encryption/decryption.
      Default:
       NO
    7. Select a value from the drop-down list for the Gateway Version field.
      Specify the
      XCOM Data Transport for Windows
      Gateway version to which this instance of the
      XCOM Data Transport for Windows
      server is allied.
      For
      XCOM Data Transport for Windows
      Gateway transfers only.
      • R116
        Indicates that the
        XCOM Data Transport for Windows
        server is allied to the R11.6 Gateway
      • R120
        Indicates that the
        XCOM Data Transport for Windows
        server is allied to the R12.0 Gateway
      Default:
       R120
  3. Click the Update button to save your changes.
    The default values of the updated parameters are changed in the xcom.glb file.
History Parameters
You can use the Global Parameters page to manage history parameters.
To update default values for history parameters.
 
  1. Click the arrow in the History pane to expand it, if it is not already expanded.
    The current default values of the history parameters appear.
    Where appropriate, the range of valid values is shown for each field.
  2. To update the history parameters:
    1. Enter values in the following fields:
      • History ODBC Name
        Specifies the name of the ODBC connection that is used to connect to the relational database.
        Default:
         No default value
      • History Table
        The name of the table that was created for the 
        XCOM Data Transport
         history records.
        Default:
         xcom_history_tbl
      • History User
        Specifies the user ID that has complete access to the history database.
        Default:
         No default value
      • History Password
        The password of History User (XCOMHIST_USER).
        Default:
         No default value
    2. Select values from the drop-down lists for the following fields:
      • History Split File
        Indicates when an insert fails whether the query will be written out as 72-byte records.
        Default:
         YES
      • History Backslash 
        Treat a backslash in a file name as a single backslash. This is dependent on the target ODBC system.
        Note:
         If the ODBC is z/OS or DB2, a single \ is needed in order to display the data correctly. If the ODBC is PC-based, like MySQL, for example, then \\ is treated as a single \.
        Default:
         No
    3. Click the Browse button to select a value for the 
      History File
       field.
      This is the name of the flat file to contain insert records if the database machine is not connected and available. Records are also written into this file as a result of an SQL failure.
      Range:
       0 to 256 characters
      Default:
       %XCOM_HOME%\config\history.inserts (Windows)
    4. Enter a value in the 
      History Owner
       field.
      Specifies the ID of the creator of the History Table. Can be omitted if it is the same as History User (XCOMHIST_USER).
      Default:
       No default value
  3. To test the connection to the history table, click the Test button next to the History Table field. A pop-up window appears, indicating whether the connection to the database was successful and how many rows exist in the table.
  4. Click the Update button to save your changes.
    The default values of the updated parameters are changed in the xcom.glb file.
Incoming Transfer Parameters
You can use the Global Parameters page to manage incoming transfer parameters.
To update default values for incoming transfer parameters
 
  1. Click the arrow in Incoming Transfers pane to expand it, if it is not already expanded.
    The current default values of the incoming transfer parameters appear, in the following sections:
    • Incoming Transfer Identification
    • Create Directories
    • Remove Trail Blanks
    • Add EOF Marker
  2. To update the 
    Incoming Transfer Identification
     section, enter values in the following fields:
    • EOL Classes
      A character string containing print classes for which an ASCII new line character will be appended to each record. For incoming report transfers only.
      Range:
       0 to 64 characters
      Default:
       None
    • Metacode Classes
      Classes of print jobs that will be saved in metacode format, a variable length record format. For incoming report transfers only.
      Range:
       0 to 64 characters
      Default:
       None
  3. To update the 
    Create Directories
     section, check or uncheck the Create a nonexistent Directory field.
    Indicates whether a new directory should be created to accommodate incoming file transfers.
  4. To update the 
    Remove Trail Blanks
     section, check or uncheck the Remove the blanks at the end of each record field.
    Indicates whether to remove the blanks at the end of each record when receiving a text file.
  5. To update the 
    Add EOF Marker
     section, check or uncheck the Add an EOF marker to the end of the file field.
    Indicates, when receiving a text file, whether to have the end-of-file character (CTRL + Z) written at the end of the file.
  6. Click the Update button to save your changes.
    The default values of the updated parameters are changed in the xcom.glb file.
Mail Parameters
You can use the Global Parameters page to manage mail parameters.
To update default values for mail parameters
 
  1. Click the arrow in the Mail pane to expand it, if it is not already expanded.
    The current default values of the mail parameters appear.
  2. To update the mail parameters, do the following:
    1. Select a value from the drop-down list for the 
      Mail Type
       field.
      Specifies the type of MAIL server used for sending mail notifications.
    2. If the Mail Type field has been set to SMTP, enter a value for the 
      SMTP Server 
      field .
      Specifies the name of the SMTP server.
      Range:
       0 to 64 characters
      Default:
       None
  3. Click the Update button to save your change.
    The default value of the updated parameter is changed in the xcom.glb file.
Queue Parameters
You can use the Global Parameters page to manage queue parameters.
To update default values for queue parameters
 
  1. Click the arrow in the Queue pane to expand it, if it is not already expanded.
    The current default values of the queue parameters appear, in the following sections:
    • Queue Identification
    • Expiration Time
    • Max Queue Entries
    • Max Session Entries
    • Age Time
    Where appropriate, the range of valid values is shown for each field.
  2. To update the 
    Queue Identification
     section, do the following:
    1. Click the Browse button to select a value for the 
      Queue Path
       field.
      Defines the path name for the transfer queue data files.
      Range:
       0 to 256 characters
      Default:
       %XCOM_HOME%\Q (Windows)
    2. Click the Browse button to select a value for the 
      Sessions File 
      field.
      Defines the path name of the XCOM.SES file. This file tells 
      XCOM Data Transport
       the number of parallel sessions available for locally initiated transfers for each remote system.
      Range:
       0 to 256 characters
      Default:
       %XCOM_HOME%\CONFIG\XCOM.SES (Windows)
  3. To update the 
    Expiration Time
     section, enter a value in the 
    Secs 
    field.
    The maximum time, in seconds, that a transaction is held in the transfer queue after it is executed. When the maximum time is reached, all references to the transaction are removed from the queue, including trace files and temporary files.
    Range:
     0 to 32767
    Default:
     6000
  4. To update the 
    Max Queue Entries
     section, enter a value in the 
    Entries 
    field.
    The maximum number of entries allowed in the transfer queue. Once the maximum number of queue entries is reached, 
    XCOM Data Transport
     rejects subsequent transfer attempts.
    Range:
     0 to 
    n
    , where 
    is the maximum allowed memory segment divided by 512.
    Default:
     50
  5. To update the 
    Max Session Entries
     section, enter a value in the 
    Partners 
    field.
    The maximum number of partners that can be described in the XCOM.SES file.
    Range:
     1 to 999
    Default:
     50 (Windows)
  6. To update the 
    Age Time
     section, enter a value in the 
    Secs 
    field.
    The number of seconds before waiting queue entries are removed from the queue. If the value is 0, the waiting queue entries never age and are never removed from the queue.
    Range:
     0 to 86313600 (999 days)
    Default:
     432000 (5 days)
  7. Click the Update button to save your changes.
    The default values of the updated parameters are changed in the xcom.glb file.
Security Parameters
You can use the Global Parameters page to manage security parameters.
To update default values for security parameters
 
  1. Click the arrow in the Security pane to expand it, if it is not already expanded.
    The current default values of the security parameters appear, in the following sections:
    • Defaults for accessing local files (Windows only)
    • Mail Notification settings (Windows only)
    • Defaults for remote initiated transfers
    • Overwrite local user
  2. To update the 
    Defaults for accessing local files
     section, enter values in the following fields:
    •  
      File Access Username
      Name of user for accessing local files. This is used for locally initiated transfers only.
      Range:
       0 to 20 characters
      Default:
       None
    •  
      Access Password
      Password for access to local files. This is used for locally initiated transfers only.
      Range:
       0 to 128 characters
      Default:
       None
  3. To update the 
    Mail Notification setting
    s section, enter values in the following fields:
    • Mail Username
      Specifies your messaging system profile name.
      Range:
       0 to 255 characters
      Default:
       XCOM
    • Mail Password
      Specifies your messaging system profile password.
      Range:
       0 to 18 characters
      Default:
       None
  4. To update the 
    Defaults for remote initiated transfers 
    section, enter values in the following fields:
    • CA XCOM User Id
      The default user ID for remotely initiated transfers.
      Range: 0 to 32 characters
      Default:
       XCOM
    • CA XCOM Password
      The default password for remotely initiated transfers.
      Range:
       0 to 128 characters
      Default:
       None
    • Domain
      The domain name for use in authenticating the user ID and password on a Windows system.
      Range:
       0 to 15 characters
      Default:
       None
  5. To update the 
    Overwrite local user section
    , check or uncheck the 
    Override Local User
     field.
    Specifies whether LUSERID can be overridden by LUSER
  6. Click the Update button to save your changes.
    The default values of the updated parameters are changed in the xcom.glb file.
System Parameters
You can use the Global Parameters page to manage system parameters.
To update default values for system parameters
 
  1. Click the arrow in the System pane to expand it, if it is not already expanded.
    The current default values of the system parameters appear, in the following sections:
    • System Identification
    • Stat Frequency
    • Daemon
    • Commands
    • Cache
    Where appropriate, the range of valid values is shown for each field.
  2. To update the 
    System Identification
     section, do the following:
    1. Enter values for the following fields:
      • SYSID
        Specifies the system ID for the local system.
        Note: 
        This initially gets set during the installation of XCOM.
        This value is used for Trusted Transfers and for getting history records.
        SYSID and SYSNAME together provide a unique system identifier.
        Range:
         1 to 4 characters
        Default:
         None
      • SYSNAME
        Specifies the system name for the local system.
        Note: 
        This initially gets set during the installation of XCOM.
        This value is used for Trusted Transfers and for getting history records.
        SYSID and SYSNAME together provide a unique system identifier.
        Range:
         1 to 8 characters
        Default:
         None
      • Shell Cmd
        The name of the command that runs jobs, reports, notification scripts, and post processing scripts on the local system.
        Range:
         1 to 256 characters
        Default:
         CMD.EXE /C (Windows)
    2. Click the Browse button to select a value for the 
      TempDir 
      field.
      Indicates the directory in which temporary files for jobs and reports can be created.
      Range:
       0 to 256 characters
      Default:
       %XCOM_HOME%\TMP (Windows)
    3. Click the Browse button to select a value for the 
      Xlogfile 
      field.
      The name of the file where 
      XCOM Data Transport
       logs activity.
      Range:
       0 to 256 characters
      Default:
       %XCOM_HOME%\ XCOM.LOG (Windows)
    4. To update the 
      Log Connect Message 
      field, select
       
      a value
       
      (YES or NO) from the drop-down list to indicate whether the informational connection messages will be written to the log or not.
  3. To update the 
    Stat Frequency
     section, enter a value in the 
    Transfer stats refresh 
    field.
    Indicates the frequency with which transfer statistics are made available to XCOMQM and the GUI. Intended for tuning high-speed links. Longer values help performance but byte/record counts in XCOMQM and the GUI may be slightly behind the actual counts.
    Range:
     1 to 9999
    Default:
     10
  4. To update the 
    Daemon 
    section, enter a value in the 
    Timeout 
    field.
    Specifies the number of minutes that 
    XCOM Data Transport
     will wait for a response from a partner before aborting a session. This ensures a transfer does not hang indefinitely waiting for a response.
    Range:
     10 to 1440
    Default:
     60
  5. To update the 
    Commands 
    section, select a value from the drop-down list and then click the Browse button to select a path and file name for the value selected in the drop-down list.
    •  
      TCP_CMD
      Path and name of the 
      XCOM Data Transport
       program started by the XCOMD
      XCOM Scheduler service
      that is used for transfers that use TCP/IP protocols.
      Range:
       0 to 256 characters
      Default:
       %XCOM_HOME%\XCOMTCP.EXE (Windows)
      $XCOM_HOME/bin/xcomtcp (UNIX and Linux)
    •  
      TP_CMD
      Path and name of the 
      XCOM Data Transport
       program started by the XCOMD
      XCOM Scheduler service
      that is used for transfers that use SNA/APPC protocols.
      Range:
       0 to 256 characters
      Default:
       %XCOM_HOME%\XCOMTP.EXE (Windows)
      $XCOM_HOME/bin/xcomtp (UNIX)
      None (Linux)
    • XEND_CMD
      The name of the post processing command file optionally invoked by the 
      XCOM Data Transport
       transfer program after any type of transfer is finished, whether successful or not. A sample command file is provided in %XCOM_HOME%\XCOMEND.BAT for Windows platforms and in $XCOM_HOME/cmd/xcomend for UNIX and Linux platforms.
      Range:
       0 to 256 characters
      Default:
       None
    •  
      XLPCMD
      Name of the post processing command file used to send print jobs to the spooler. For incoming reports only.
      Range:
       0 to 256 characters
      Default:
       %XCOM_HOME%\XCOMLP.BAT (Windows)
      $XCOM_HOME/cmd/xcomlp (UNIX and Linux)
    • XNOTIFYCMD
      The name of the command file that 
      XCOM Data Transport
       uses to notify users on the local system of the completion of a transfer. This is normally a shell script that composes a message and invokes mail or write as appropriate.
      Range:
       0 to 256 characters
      Default:
       %XCOM_HOME%\XCOMNTFY.BAT (Windows)
      $XCOM_HOME/cmd/xcomntfy (UNIX and Linux)
    • XPPCMD
      The name of the command file used for user defined post processing. A sample command file is provided in %XCOM_HOME%\XCOMPP.BAT for Windows platforms and in $XCOM_HOME/cmd/xcompp for UNIX and Linux platforms.
      Range:
       0 to 256 characters
      Default:
       None
  6. To update the 
    Cache 
    section, enter values in the following fields:
    • Cache Read Size
      Specifies the size (in KB) of the cache for reading files.
      Range:
       0 to 9999
      Default:
       0
    • Cache Write Size
      Specifies the size (in KB) of the cache for writing files.
      Range:
       0 to 9999
      Default:
       0
  7. Click the Update Button to save your changes.
    The default values of the updated parameters are changed in the xcom.glb file.
TCP/IP Parameters
You can use the Global Parameters page to manage TCP/IP parameters.
To update default values for TCP/IP parameters
 
  1. Click the arrow in the TCP/IP pane to expand it, if it is not already expanded.
    The current default values of the TCP/IP parameters appear, in the following sections. The range of valid values is also shown for each field, where appropriate.
    • TCP/IP Identification (Windows only)
    • Client Transfer Settings
    • Server Settings (Windows only)
    • Implicit Packing (Windows only)
    • Protocol
    • Secure Socket Server Settings
    • Server Ipv6 Port Number (Windows only)
  2. To update the 
    TCP/IP Identification
     section, click the Browse button to select a path value for the 
    Executable Program Path
     field.
    Range:
     0 to 256 characters
    Default: 
    %XCOM_HOME% (Windows)
  3. To update the 
    Client Transfer Setting
    s section, do the following:
    1. Enter values in the following fields:
      • Port Number
        The number of the TCP/IP port on the remote 
        XCOM Data Transport
         server. Used for TCP/IP transfers only.
        Range:
         1 to 65535
        Default:
         8044
      • Sock Rcv Bufsize
        This is the TCP/IP Socket option SO_RCVBUF and is the buffer size used for receive transfers. Use zero for the default size provided by the socket implementation. The value for SOCK_RCV_BUF_SIZE can be smaller than the value for TXPI_BUF_SIZE. Used for TCP/IP transfers only.
        Note:
         Socket options affect the way 
        XCOM Data Transport
         uses the TCP/IP stack implementation.
        Range:
         0 to 65536
        Default:
         0
      • Sock Send Bufsize
        This is the TCP/IP Socket option SO_SNDBUF and is the buffer size used for send transfers. Use zero for the default size provided by the socket implementation. The value for SOCK_SEND_BUF_SIZE can be smaller than the value for TXPI_BUF_SIZE. Used for TCP/IP transfers only.
        Note: 
        Socket options affect the way 
        XCOM Data Transport
         uses the TCP/IP stack implementation.
        Range:
         0 to 65536
        Default:
         0
    2. Check or uncheck the 
      Sock Delay
       field.
      This is the TCP/IP Socket option SO_RCVBUF and is the buffer size used for receive transfers. Use zero for the default size provided by the socket implementation. The value for SOCK_RCV_BUF_SIZE can be smaller than the value for TXPI_BUF_SIZE. Used for TCP/IP transfers only.
      Socket options affect the way 
      XCOM Data Transport
       uses the TCP/IP stack implementation.
       
      Range:
       0 to 65536
      Default:
       0
    3. Enter values in the following fields:
      • Txpi Term Timeout
        Maximum wait time, in seconds, for the partner to terminate TCP/IP communications. If a transfer terminates normally, both sides of the conversation coordinate the termination, and there should be no need to wait.
        This timeout occurs only during an error in the termination of the connection. Used for TCP/IP transfers only.
        Range:
         0 to 999 seconds
        Default:
         20 seconds
      •  
        Txpi Rcv Timeout
        Maximum wait time, in seconds, after a TCP/IP failure is detected before a socket error is generated. This defaults to zero and should remain at zero unless it becomes necessary for a broken connection to generate a retryable error.
        Changing this parameter from zero invokes the TCP/IP select function, which adds a measure of connection detection, but sacrifices some performance. This parameter is for TCP/IP only.
        Range:
         0 to 1200 seconds
        Default:
         0 seconds
      • Txpi Buf Size
        For TCP/IP transfers, the internal buffer size for sends and receives. The default size allows multiple 
        XCOM Data Transport
         records to be received in a single socket call. With this default, if your 
        XCOM Data Transport
         record size is less than 32K, 
        XCOM Data Transport
         attempts to receive multiple records in a single socket call. Used for TCP/IP transfers only.
        Range:
         0 to 65536
        Default:
         32768
      • Txpi Send Check Freq
        For TCP/IP transfers, the internal buffer size for sends and receives. The default size allows multiple 
        XCOM Data Transport
         records to be received in a single socket call. With this default, if your 
        XCOM Data Transport
         record size is less than 32K, 
        XCOM Data Transport
         attempts to receive multiple records in a single socket call. Used for TCP/IP transfers only.
        Range:
         0 to 65536
        Default:
         32768
  4. To update the 
    Server Settings 
    section, enter values in the following fields:
  5. Port Number
    The number of the TCP/IP port on the local 
    XCOM Data Transport
     server. Used for TCP/IP transfers only.
    Range:
     1 to 65535
    Default:
     8044
  6. Maximum Clients
    Range:
     0 to 9999
    Default:
     16
  7. Termination Loop
    Range:
     0 to 9999
    Default:
     5
  8. Termination Delay
    Range:
     0 to 9999
    Default:
     5
  9. To update the 
    Implicit Packing
     section, check or uncheck the 
    Default to use big packing 31K data buffer size
     field.
    Indicates whether TCP/IP should always use packing.
  10. To update the 
    Protocol 
    section, select a value from the drop-down list of the 
    Default protocol
     field.
    The type of communication protocol to use. This is dependent on what protocols are supported on the local system and if the SNA component (where applicable) was selected to be installed during the installation process.
    Range:
     SNA or TCPIP
    Default:
     SNA (Windows and UNIX)
  11. To update the 
    Secure Socket Server Settings
     section, do the following:
    1. Enter a value in the 
      TLS/SSL Port Numbe
      r field. This applies to Windows only.
      The number of the TCP/IP port on the remote 
      XCOM Data Transport
       server used for IPv4 TLS/SSL transfers. Used for TCP/IP transfers only.
      Range:
       1 to 65535
      Default:
       8045
    2. Check or uncheck the 
      Display Cipher in Queue Details
       field.
      Specifies whether to display encryption algorithms in the 
      XCOM Data Transport
       queue detailed information for transfers.
    3. Click the Browse button to select a value for the 
      Secure Socket Fil
      e field.
      Specifies the value of the configssl.cnf file path and file name.
      Range: 
      1 to 256 characters
      Default:
       %XCOM_HOME%\configssl.cnf (Windows)
  12. To update the 
    Server Ipv6 Port Numbe
    r section, do the following:
    1. Enter values in the following fields:
      • Ipv6 Port Number
        The number of the TCP/IP port on the remote 
        XCOM Data Transport
         server used for IPv6 transfers. Used for TCP/IP transfers only.
        Range:
         1 to 65535
        Default:
         8046
      • Ipv6 TLS/SSL Port Number
        The number of the TCP/IP port on the remote 
        XCOM Data Transport
         server used for IPv6 TLS/SSL transfers. Used for TCP/IP transfers only.
        Range: 1 to 65535
        Default:
         8047
    2. Select a value from the drop-down list of the 
      Choose Listeners
       field.
      Determines which TCP/IP listeners will be started when the XCOMD daemon is started.
      Default:
       IPv4 listeners
  13. Click the Update button to save your changes.
    The default values of the updated parameters are changed in the xcom.glb file.
Trace Parameters
You can use the Global Parameters page to manage trace parameters.
 
To update default values for trace parameters
 
  1. Click the arrow in the Trace pane to expand it, if it is not already expanded.
    The current default values of the trace parameters appear, in the following sections:
    • Xtrace
    • Debug Flag
    • System Level (Windows only)
    • Trace Path
    Where appropriate, the range of valid values is shown for each field.
  2. To update the 
    Xtrace 
    section, enter a value in the 
    Trace level
     field.
    Indicates the level of desired execution tracing.
    Range:
     0 to 10
    Default:
     0
  3. To update the 
    Debug Flag 
    section, check or uncheck the 
    Print trace to STDERR
     field.
    Indicates whether to print trace data to STDERR.
  4. To update the 
    System Level
     section, do the following:
    1. Select a value from the drop-down list of the 
      Component 
      field to specify which components will have the trace setting of either Trace Off, Trace On, or Trace Detail.
    2. Click the Browse button to select a value for 
      Component Trace File
      .
      Specifies the path and file name for the Component Trace File.
      Range:
       1 to 256 characters
      Default:
       %XCOM_HOME%\trace.trc
    3. Click one of the following:
      • Trace Off
      • Trace On
      • Trace Detail
  5. To update the 
    Trace Path 
    section, click Browse to select a value for 
    Trace Path
    .
    Specifies the path where trace files will be written to.
    Range:
     1 to 256 characters
    Default:
     %XCOM_HOME%\trace (Windows)
  6. Click the Update button to save your changes.
    The default values of the updated parameters are changed in the xcom.glb file.
Trusted Parameters
You can use the Global Parameters page to manage trusted parameters.
To update default values for trusted parameters
 
  1. Click the arrow in the Trusted pane to expand it, if it is not already expanded.
    The current default values of the trusted parameters appear.
    Where appropriate, the range of valid values is shown for each field.
  2. To update the trusted parameters, do the following:
    1. Enter values in the following fields:
      • Trusted Database Server
        Specifies the name of the database server where the trusted database was created.
        Range:
         1 to 256 characters
        Default:
         None
      • Trusted Database Port
        Specifies the port of the database server where the trusted database was created.
        Range:
         1 to 65535
        Default:
         50000
      • Trusted Database Name
        Specifies the name of the database where the trusted tables were created.
        Range:
         1 to 256 characters
        Default:
         None
    2. Select a value from the drop-down list for the 
      Trusted Database Type
       field.
      Specifies the database type that resides on the database server.
      Range:
       DB2 or MySQL
      Default:
       DB2
    3. Enter values in the following fields:
      • Trusted Table Prefix
        Specifies the prefix to use for the names of the Trusted Tables.
        Range:
         1 to 16 characters
        Default:
         XCOM_TRUSTED
      • Trusted Database Owner
        Specifies the ID of the creator of the Trusted Tables. May be omitted if it is the same as the Trusted Database User (TRUST_USER).
        Range:
         1 to 32 characters
        Default:
         No default value
      • Trusted Database User
        Specifies a generic user ID that has been defined to the RDMS for the Trusted Tables.
        Range:
         1 to 64 characters
        Default:
         No default value
      • Trusted Database Password
        Specifies the password of the Trusted Database User for the Trusted Tables.
        Range:
         1 to 128 characters
        Default:
         No default value
      • Trusted ODBC Data Source
        Specifies the ODBC Data Source Name for the Trusted Tables.
        Range:
         1 to 16 characters
        Default:
         No default value
  3. If you want to test the trusted database values, click the Test button next to the Trusted Database Port field. A pop-up window appears, indicating whether the JDBC and ODBC connections to the database were successful and how many rows exist in the trusted tables.
  4. Click the Update button to save your changes.
    The default values of the updated parameters are changed in the xcom.glb file.
Unicode Parameters
You can use the Global Parameters page to manage Unicode Parameters.
  • To update default values for Unicode parameters:
     
  • Click the arrow button in the Unicode pane to expand it, if it is not already expanded. The current default values of the Unicode parameters appear.
  • Enter a value in the Action to Take On the Input Character Error field.
    Action to Take On Input Character Error
    Specifies the default action when the input file contains data that is not consistent with the specified input character set.
    Range:
     FAIL, REPLACE, SKIP, or REPLACE#nnnnnnn where nnnnnnn is in the range of 0 through 1114111.
    Default:
     FAIL
  • Enter a value in the Action to Take On the Convert Character Error field.
    Action to Take On Convert Character Error
    Specifies the default action when the input file contains characters that cannot be converted as they are not included within the output character sets character repertoire.
    Range:
     FAIL, REPLACE, SKIP, or REPLACE#nnnnnnn where nnnnnnn is in the range of 0 through 1114111.
    Default:
     FAIL
  • Enter a value in the Default Character set field.
    Default Character set
    Specifies the default character set 
    XCOM Data Transport
     uses for Unicode transfers (Encoding=UTF8 or Encoding=UTF16).
    CCSID#nnnnn 
    nnnnnn - specifies the CCSID number that corresponds to the character set. Valid values are 1 - 65535.
    Alternatively, can be specified as an IANA character set name, or (ICU) acceptable alias name.
    Range:
     0 to 60 characters
    Default:
     ISO-8859-1
  • Enter a value in the Default Character set field.
    Default Delimiter
    Specifies default encoding for which the specified Character-set is based. The encoding can be either ASCII or EBCDIC. If specified, the encoding must be the first option in the list.
    Additionally, specifies a colon separated list of record delimiters that are used to mark and detect the end of a record.
    Range:
     0 to 60 characters
    Default:
     CRLF:LF
  • ICU Path
    Specifies the path to your ICU libraries for your current UNIX platform.
    Range:
     0 to 256 characters
Transmission Password Encryption
You can use the Global Parameters page to manage Transmission Password Encryption Parameters.
 
To update default values for Transmission Password Encryption parameters:
 
  1. Click the arrow button in the Transmission Password Encryption pane to expand it, if it is not already expanded. The current default values of the Transmission Password Encryption parameters appear.
  2. Enter a value in the Default Local Cipher List field.
    • Default Local Cipher List
      Specifies the default list of ciphers which are used to encrypt the password fields for locally initiated transfers or meta-transfers.
      Range:
       0 to 256 characters
      Default:
       COMPAT
  3. Enter a value in the Remote Permitted Cipher List field.
    • Remote Permitted Cipher List
      Specifies the permitted list of ciphers which are used to encrypt the password fields for remotely initiated transfers or meta-transfers.
      Range:
       0 to 256 characters
      Default:
       XCOM:ALL:COMPAT
  4. Select a value for the Remote DH Prime Number Size (in bits)field.
    • Remote DH Prime Number Size (in bits)
      Specifies the size (in bits) of the prime number that is used during DH (Diffie-Hellman) exchange for remotely initiated transfers or meta-transfers. The exchanged value generates the key that is used to encrypt the password fields transmitted in the 
      XCOM Data Transport
       header.
      Range:
       256, 512, 1024, 2048, 4096
      Default:
       1024