You are on page 1of 396

User Guide

r11

Unicenter

CA-XCOM

Data
Transport

for Windows NT
Server/Professional

J02577-2E



This documentation and related computer software program (hereinafter referred to as the Documentation) is for
the end users informational purposes only and is subject to change or withdrawal by Computer Associates
International, Inc. (CA) at any time.
This documentation may not be copied, transferred, reproduced, disclosed or duplicated, in whole or in part, without
the prior written consent of CA. This documentation is proprietary information of CA and protected by the copyright
laws of the United States and international treaties.
Notwithstanding the foregoing, licensed users may print a reasonable number of copies of this documentation for
their own internal use, provided that all CA copyright notices and legends are affixed t o each reproduced copy. Only
authorized employees, consultants, or agents of the user who are bound by the confidentiality provisions of the
license for the software are permitted to have access to such copies.
This right to print copies is limited to the period during which the license for the product remains in full force and
effect. Should the license terminate for any reason, it shall be the users responsibility to return to CA the reproduced
copies or to certify to CA that same have been destroyed.
To the extent permitted by applicable law, CA provides this documentation as is without warranty of any kind,
including without limitation, any implied warranties of merchantability, fitness for a particular purpose or
noninfringement. In no event will CA be liable to the end user or any third party for any loss or damage, direct or
indirect, from the use of this documentation, including without limitation, lost profits, business interruption,
goodwill, or lost data, even if CA is expressly advised of such loss or damage.
The use of any product referenced in this documentation and this documentation is governed by the end users
applicable license agreement.
The manufacturer of this documentation is Computer Associates International, Inc.
Provided with Restricted Rights as set forth in 48 C.F.R. Section 12.212, 48 C.F.R. Sections 52.227-19(c)(1) and (2) or
DFARS Section 252.227-7013(c)(1)(ii) or applicable successor provisions.
2011 Computer Associates International, Inc.
All trademarks, trade names, service marks, and logos referenced herein belong to their respective companies.




Contents

Chapter 1: Introduction
Unicenter CA-XCOM Data Transport Connectivity .............................................. 1-2
Network Levels in the SNA Model ............................................................. 1-3
End User Level ........................................................................... 1-3
Logical Level ............................................................................. 1-4
Physical Level ............................................................................ 1-4
Network Level Diagram ................................................................... 1-5
Benefits of LU 6.2 (APPC) .................................................................. 1-5
Improved Throughput ................................................................. 1-6
Support for Advanced Networking ..................................................... 1-6
Unicenter CA-XCOM Data Transport in the TCP/IP Network..................................... 1-7
TCP/IP Protocol Stack..................................................................... 1-7
Network Layer........................................................................ 1-8
Internetwork Layer .................................................................... 1-8
Transport Layer ....................................................................... 1-8
Application Layer ..................................................................... 1-9
Unicenter CA-XCOM Data Transport Nodes in the TCP/IP Network .......................... 1-9
TCP/IP Address ...................................................................... 1-9
TCP/IP Port .......................................................................... 1-9
Successful Send File Transfer Scenario ......................................................... 1-10
Chapter 2: Using Unicenter CA-XCOM Data Transport
Unicenter CA-XCOM Data Transport GUI ...................................................... 2-1
File Name, Path, and Directory Considerations .............................................. 2-1
Keyboard Commands ................................................................. 2-2
Default Directories and Drives ............................................................. 2-2
Requirements............................................................................. 2-3
Starting Unicenter CA-XCOM Data Transport ................................................... 2-3
Contents iii



Using the Unicenter CA-XCOM Data Transport Main Window .................................... 2-5
Main Window............................................................................. 2-5
Considerations ............................................................................ 2-6
Procedure................................................................................. 2-6
Menu Bar Selections ....................................................................... 2-7
Pushbuttons .............................................................................. 2-8
Using Transfer Configuration Files.............................................................. 2-9
Default Configuration Files ................................................................. 2-9
Precedence of Parameter Values ........................................................... 2-10
Modifying Options and Configurations..................................................... 2-10
Multiple Transfers from the GUI ........................................................... 2-10
Considerations ........................................................................... 2-11
Creating a Configuration File.................................................................. 2-11
Considerations ........................................................................... 2-11
Procedure................................................................................ 2-12
Editing an Existing Configuration File.......................................................... 2-14
Considerations ........................................................................... 2-14
Procedure................................................................................ 2-15
Using the Transfer List to Access and Perform Transfers ......................................... 2-16
Transfer List Fields ....................................................................... 2-17
Saving Displayed Transfers................................................................ 2-17
Considerations ........................................................................... 2-17
Procedure................................................................................ 2-18
Fields ................................................................................... 2-19
Transfer List Symbols ..................................................................... 2-19
Using the Edit Transfer Windows .............................................................. 2-20
Accessing the Edit Transfer Window ....................................................... 2-20
Menu Bar Selections ...................................................................... 2-21
Pushbuttons ............................................................................. 2-21
Fields ................................................................................... 2-22
RECORD_FORMAT ...................................................................... 2-26
Setting the Options on an Edit Transfer Window ................................................ 2-28
Modifying the Options Group ............................................................. 2-29
Encoding Options ........................................................................ 2-29
Maximum Record Length Field ............................................................ 2-30
CodeTable Option ........................................................................ 2-30
Truncation Option........................................................................ 2-31
Procedure................................................................................ 2-31
Edit Transfer Window Options Summary................................................... 2-32
iv User Guide

Sending a File Using an Edit Transfer Window ................................................. 2-33
Accessing the Send File Window .......................................................... 2-33
Considerations........................................................................... 2-34
Procedure ............................................................................... 2-34
Sending a Report Using an Edit Transfer Window .............................................. 2-35
Accessing the Send Report Window ....................................................... 2-35
Considerations........................................................................... 2-36
Procedure ............................................................................... 2-36
Sending a Job Using an Edit Transfer Window.................................................. 2-37
Accessing the Send Job Window........................................................... 2-37
Considerations........................................................................... 2-38
Procedure ............................................................................... 2-38
Receiving a File Using an Edit Transfer Window................................................ 2-39
Accessing the Receive File Window........................................................ 2-39
Considerations........................................................................... 2-39
Procedure ............................................................................... 2-40
Using the Version 2 WindowCheckpoint, Restart, Protocol, Port................................ 2-41
Accessing the Version 2 Window .......................................................... 2-41
Considerations........................................................................... 2-42
Procedure Checkpoint/Restart........................................................... 2-42
Procedure Protocol/Port ................................................................ 2-43
Fields ................................................................................... 2-43
Pushbuttons ............................................................................. 2-44
Specifying User IDs and Passwords for File Access.............................................. 2-44
Accessing the Security Window ........................................................... 2-45
Considerations........................................................................... 2-45
Procedure ............................................................................... 2-45
Remote System Access Fields ............................................................. 2-46
Local File Access Fields ................................................................... 2-46
Pushbuttons ............................................................................. 2-46
Notifying Local Users of Transfer Completion .................................................. 2-47
Accessing the Local Notify Dialog ......................................................... 2-47
Considerations........................................................................... 2-47
Procedure ............................................................................... 2-47
Drop-down Lists......................................................................... 2-48
Field.................................................................................... 2-48
Pushbuttons ............................................................................. 2-49
Contents v


Notifying Remote Users of Transfer Completion ................................................ 2-49
Accessing the Remote Notify Dialog........................................................ 2-49
Considerations ........................................................................... 2-49
Procedure................................................................................ 2-50
Drop-down List .......................................................................... 2-50
Field .................................................................................... 2-51
Pushbuttons ............................................................................. 2-51
Setting Compression Type for a Transfer ....................................................... 2-52
Accessing the Compression Window ....................................................... 2-52
Considerations ........................................................................... 2-52
Procedure................................................................................ 2-52
Drop-down List .......................................................................... 2-53
Pushbuttons ............................................................................. 2-53
Sending an Indirect Transfer .................................................................. 2-54
Accessing the Indirect Transfer Window.................................................... 2-54
Considerations ........................................................................... 2-54
Procedure................................................................................ 2-54
Field .................................................................................... 2-55
Pushbuttons ............................................................................. 2-55
Setting System Environment VariablesReports Containing Machine Code Characters ............. 2-55
Debugging Problems and Tracing.............................................................. 2-57
Accessing the Debugging Window......................................................... 2-57
Procedure................................................................................ 2-57
Drop-down List .......................................................................... 2-57
Pushbuttons ............................................................................. 2-58
Scheduling Transfers ......................................................................... 2-58
Accessing the Schedule Window........................................................... 2-58
Considerations ........................................................................... 2-59
Procedure................................................................................ 2-59
Priority Menu Options .................................................................... 2-60
Fields ................................................................................... 2-60
Pushbuttons ............................................................................. 2-60
Performing Secure Socket Transfers ............................................................ 2-61
Accessing the Secure Socket Window....................................................... 2-61
Procedure................................................................................ 2-61
Pushbuttons ............................................................................. 2-62
Browsing the Log File......................................................................... 2-62
Accessing the Log Browser Window........................................................ 2-63
Procedure................................................................................ 2-63
Pushbuttons ............................................................................. 2-63
vi User Guide

Searching for Information in the Log........................................................... 2-63
Accessing the Find Window............................................................... 2-64
Procedure ............................................................................... 2-64
Field.................................................................................... 2-64
Checkbox ............................................................................... 2-64
Pushbuttons ............................................................................. 2-65
Viewing and Controlling Transfer Status ....................................................... 2-65
Accessing the Queue Status Window ...................................................... 2-66
Procedure ............................................................................... 2-66
Menu Bar Selections...................................................................... 2-67
Pushbuttons ............................................................................. 2-68
Queue Status Direction Symbols........................................................... 2-68
Viewing Transfer Status Details ............................................................... 2-69
Accessing the Details Window ............................................................ 2-69
Procedure ............................................................................... 2-69
Fields ................................................................................... 2-70
Pushbutton.............................................................................. 2-70
Using the Properties Dialog Pages ............................................................. 2-70
Accessing the Properties Tab Pages ........................................................ 2-71
Considerations........................................................................... 2-72
Procedure ............................................................................... 2-72
Character Conversions Properties Tab Page ................................................ 2-73
Options ............................................................................. 2-74
Incoming Transfers Properties Tab Page.................................................... 2-75
Options ............................................................................. 2-76
Queue Properties Tab Page ............................................................... 2-77
Options ............................................................................. 2-78
Security Properties Tab Page .............................................................. 2-79
Options ............................................................................. 2-80
System Properties Tab Page ............................................................... 2-81
Options ............................................................................. 2-82
TCP/IP Properties Tab Page .............................................................. 2-84
Options ............................................................................. 2-85
Trace Properties Tab Page................................................................. 2-88
Options ............................................................................. 2-89
Contents vii


Chapter 3: The Command Line Interface
Command Prompt ............................................................................ 3-1
Using Configuration Files ...................................................................... 3-1
Configuration Files ........................................................................ 3-2
Creating Configuration Files from the Command Prompt ..................................... 3-2
Transferring Files ............................................................................. 3-4
Specifying Protocols ....................................................................... 3-4
XCOM62 ................................................................................. 3-5
XCOMTCP................................................................................ 3-5
Multiple Transfers ......................................................................... 3-5
Wildcard Characters ....................................................................... 3-5
Syntax.................................................................................... 3-5
Syntax for XCOM62.................................................................... 3-5
Syntax for XCOMTCP.................................................................. 3-6
Notes On Using Options................................................................ 3-6
Options................................................................................... 3-6
Transferring Files Using SNA/APPC Protocols .................................................. 3-8
Using SNA/APPC Protocols................................................................ 3-8
Transferring Files Using TCP/IP Protocols....................................................... 3-9
Using IP Addresses and Names ............................................................. 3-9
Specifying the Remote System ............................................................. 3-10
TCP/IP Name Resolution ................................................................. 3-11
Using TCP/IP Protocols with Unicenter CA-XCOM Data Transport ........................... 3-11
PROTOCOL.......................................................................... 3-13
Setting Communications Parameters ........................................................... 3-13
Communications and Data Transfer Parameters ............................................. 3-13
Parameters............................................................................... 3-14
CODETABL.......................................................................... 3-14
COMPRESS .......................................................................... 3-14
MAXRECLEN........................................................................ 3-15
REMOTE_SYSTEM ................................................................... 3-15
REMOTE_SYSTEM_RF................................................................ 3-16
REMOTE_SYSTEM_SJ ................................................................ 3-16
REMOTE_SYSTEM_SR................................................................ 3-16
TEMPDIR............................................................................ 3-17
TRUNCATION....................................................................... 3-17
VERSION............................................................................ 3-17
viii User Guide

Using the Send File Command ................................................................ 3-17
Parameters .............................................................................. 3-18
FILE_OPTION ....................................................................... 3-18
LOCAL_FILE ........................................................................ 3-20
REMOTE_FILE ...................................................................... 3-20
Using the Retrieve File Command ............................................................. 3-20
Parameters .............................................................................. 3-21
FILE_OPTION_RF ................................................................... 3-21
LOCAL_FILE_RF .................................................................... 3-23
REMOTE_FILE_RF ................................................................... 3-23
REMOTE_SYSTEM_RF ............................................................... 3-23
UNIT_RF............................................................................ 3-24
VOLUME_RF ........................................................................ 3-24
Creating a File on an IBM Mainframe .......................................................... 3-24
Parameters .............................................................................. 3-25
ALLOCATION_TYPE ................................................................ 3-25
BLKSIZE ............................................................................ 3-25
DATACLAS ......................................................................... 3-26
DSNTYPE ........................................................................... 3-26
LRECL .............................................................................. 3-26
MGMTCLAS ........................................................................ 3-27
NUM_OF_DIR_BLOCKS.............................................................. 3-27
PRIMARY_ALLOC................................................................... 3-27
RECORD_FORMAT.................................................................. 3-28
SECURE_SOCKET ................................................................... 3-29
STORCLAS .......................................................................... 3-30
SECONDARY_ALLOC ............................................................... 3-30
UNIT ............................................................................... 3-30
VOLUME ........................................................................... 3-30
XCOM_CONFIG_SSL ................................................................ 3-30
XCOM_SHOW_CIPHER.............................................................. 3-31
Tape Parameters for an IBM Mainframe .................................................... 3-31
DEN ................................................................................ 3-31
EXPDT .............................................................................. 3-32
LABEL .............................................................................. 3-32
LABELNUM......................................................................... 3-33
RETPD.............................................................................. 3-33
TAPE ............................................................................... 3-33
UNITCT............................................................................. 3-34
VOLCT.............................................................................. 3-34
VOLSQ.............................................................................. 3-34
Contents ix


Using a Send Report Command ............................................................... 3-35
Parameters............................................................................... 3-36
CARRIAGE_CONTROL_CHARACTERS ............................................... 3-36
CLASS............................................................................... 3-36
COPIES.............................................................................. 3-37
DESTINATION....................................................................... 3-37
DISPOSITION........................................................................ 3-37
FCB ................................................................................. 3-38
FORM ............................................................................... 3-38
HOLDFLAG ......................................................................... 3-38
LOCAL_FILE_SR ..................................................................... 3-38
REMOTE_SYSTEM_SR................................................................ 3-39
REPORT_TITLE ...................................................................... 3-39
SPOOL_FLAG........................................................................ 3-40
Using the Send Job Command ................................................................. 3-40
LOCAL_FILE_SJ...................................................................... 3-41
REMOTE_SYSTEM_SJ ................................................................ 3-41
ERRORLEVEL Return Codes from xcomtcp.exe and xcom62.exe.................................. 3-41
Tracing Problems ............................................................................ 3-42
XTRACE............................................................................. 3-43
Setting Up Log Files .......................................................................... 3-43
XLOGFILE ........................................................................... 3-44
Setting File Type Conversion .................................................................. 3-44
CARRIAGE_FLAG.................................................................... 3-45
CODE_FLAG......................................................................... 3-46
Creating Custom Character Sets for File Conversion ............................................. 3-47
Custom Character Sets .................................................................... 3-47
Procedure............................................................................ 3-47
Hexadecimal Numbers in Conversion Tables................................................ 3-48
Customizing Default Character Sets ........................................................ 3-49
Procedure............................................................................ 3-49
Specifying a Custom Character Set ......................................................... 3-49
Procedure............................................................................ 3-50
Using Store and Forward ..................................................................... 3-50
XIDEST .............................................................................. 3-52
Setting Password and User ID Security ......................................................... 3-52
DOMAIN ............................................................................ 3-53
FILE_ACCESS_PASSWORD........................................................... 3-53
FILE_ACCESS_USERNAME........................................................... 3-53
PASSWORD ......................................................................... 3-53
x User Guide

TRUSTED ........................................................................... 3-53
USERID ............................................................................. 3-54
Encrypting Parameter Values in Existing Configuration Files .................................... 3-54
Syntax .................................................................................. 3-54
Options ................................................................................. 3-55
Procedure ............................................................................... 3-55
Changing an Encrypted Value............................................................. 3-56
Scheduling Locally Initiated Transfers ......................................................... 3-56
Parameters .............................................................................. 3-57
PRIORITY ........................................................................... 3-57
QUEUE ............................................................................. 3-57
START_DATE ....................................................................... 3-58
START_TIME........................................................................ 3-58
Notifying of Transfer Completion ............................................................. 3-59
Example 1 ............................................................................... 3-59
Example 2 ............................................................................... 3-59
Parameters .............................................................................. 3-60
LCLNTFYL .......................................................................... 3-60
LOCAL_NOTIFY..................................................................... 3-60
NOTIFYL............................................................................ 3-61
NOTIFY_NAME ..................................................................... 3-61
NOTIFYR ........................................................................... 3-62
RMTNTFYL ......................................................................... 3-63
Checkpointing and Restarting Transfers ....................................................... 3-63
List of Parameters ........................................................................ 3-65
CHECKPOINT_COUNT.............................................................. 3-65
NUMBER_OF_RETRIES .............................................................. 3-65
RESTART_SUPPORTED.............................................................. 3-65
RETRY_TIME........................................................................ 3-66
Purging the Unicenter CA-XCOM Data Transport Log File ...................................... 3-66
Syntax .................................................................................. 3-66
Chapter 4: The Application Programming Interface
XcomAPI .................................................................................... 4-1
XcomQAPI ................................................................................... 4-2
Upgrading from Previous Releases ............................................................. 4-2
Link Libraries ................................................................................ 4-2
SNA Libraries ............................................................................ 4-2
TCP/IP Libraries.......................................................................... 4-3
Starting States ................................................................................ 4-3
Contents xi


Starting States in startst.h ...................................................................... 4-3
API Control Block Structure .................................................................... 4-4
Using API Member Names ..................................................................... 4-8
XcomAPI Member Names .................................................................. 4-8
allocation_type ........................................................................ 4-8
blksize................................................................................ 4-9
carriage_control_characters ............................................................. 4-9
carriage_flag ......................................................................... 4-10
checkpoint_count ..................................................................... 4-10
class ................................................................................. 4-11
code_flag ............................................................................ 4-11
codetabl ............................................................................. 4-11
compress............................................................................. 4-12
config_ssl ............................................................................ 4-13
convert_classes ....................................................................... 4-13
copies ............................................................................... 4-13
datacls ............................................................................... 4-13
debug_flag ........................................................................... 4-13
den.................................................................................. 4-14
destination ........................................................................... 4-14
disposition ........................................................................... 4-14
domain .............................................................................. 4-15
dsntype.............................................................................. 4-15
eol_classes ........................................................................... 4-15
expdt ................................................................................ 4-15
fcb .................................................................................. 4-16
file_option ........................................................................... 4-16
file_type ............................................................................. 4-17
form................................................................................. 4-17
hold ................................................................................. 4-18
label ................................................................................. 4-18
labelnum............................................................................. 4-18
lclntfyl ............................................................................... 4-19
local_file ............................................................................. 4-19
local_file_rf .......................................................................... 4-19
local_file_sj........................................................................... 4-20
local_file_sr .......................................................................... 4-20
local_notify .......................................................................... 4-20
lrecl ................................................................................. 4-21
maxreclen............................................................................ 4-21
metacode_classes ..................................................................... 4-21
xii User Guide

mgtclas.............................................................................. 4-22
notify_name ......................................................................... 4-22
notifyl............................................................................... 4-22
notifyr .............................................................................. 4-23
notify_term.......................................................................... 4-24
number_of_retries.................................................................... 4-24
num_of_dir_blocks ................................................................... 4-24
password............................................................................ 4-24
primary_alloc ........................................................................ 4-25
port ................................................................................. 4-25
protocol ............................................................................. 4-25
queue ............................................................................... 4-26
record_format........................................................................ 4-26
remote_file .......................................................................... 4-28
remote_file_rf ........................................................................ 4-28
remote_system....................................................................... 4-28
remove_trail_blanks .................................................................. 4-29
report_title .......................................................................... 4-29
restart_supported .................................................................... 4-29
retpd................................................................................ 4-30
rmtntfyl ............................................................................. 4-30
secondary_alloc ...................................................................... 4-30
shell_cmd ........................................................................... 4-31
spool_flag ........................................................................... 4-31
start_date............................................................................ 4-31
start_time ........................................................................... 4-31
stat_frequency ....................................................................... 4-32
storcls ............................................................................... 4-32
tape................................................................................. 4-32
tempdir ............................................................................. 4-32
transfer_id........................................................................... 4-33
transfer_usr_data..................................................................... 4-33
truncation ........................................................................... 4-33
trusted .............................................................................. 4-33
unit ................................................................................. 4-34
unitct ............................................................................... 4-34
userid ............................................................................... 4-34
user_data............................................................................ 4-34
version .............................................................................. 4-34
volct ................................................................................ 4-35
volsq................................................................................ 4-35
Contents xiii


volume .............................................................................. 4-35
xcomfullssl ........................................................................... 4-35
xendcmd............................................................................. 4-36
xidest ................................................................................ 4-36
xlogfile .............................................................................. 4-36
xlpcmd .............................................................................. 4-36
xmode ............................................................................... 4-37
xnotifycmd........................................................................... 4-37
xppcmd.............................................................................. 4-37
xprecmd ............................................................................. 4-37
xtrace................................................................................ 4-38
Using XcomQAPI Option Parameters .......................................................... 4-38
Option Parameters........................................................................ 4-38
funccode ............................................................................. 4-38
Parameters Set Within the XcomQAPI Program ............................................. 4-40
API Examples................................................................................ 4-40
About the XcomAPI Example.............................................................. 4-40
Unicenter CA-XCOM Data Transport for Windows NT API Return Codes ................. 4-41
XcomQAPI Example ...................................................................... 4-43
Chapter 5: Remote System Information
AS/400....................................................................................... 5-1
Naming Conventions ...................................................................... 5-1
Types of Files Supported ................................................................... 5-2
Additional Features........................................................................ 5-2
Configuration Issues ....................................................................... 5-2
Case Sensitivity ........................................................................... 5-2
z/OS......................................................................................... 5-3
Naming Conventions ...................................................................... 5-3
Types of Files Supported ................................................................... 5-4
DCB Information .......................................................................... 5-4
Additional Features........................................................................ 5-5
Novell NetWare............................................................................... 5-5
Naming Conventions ...................................................................... 5-5
Types of Files Supported ................................................................... 5-6
Destination Printer Information............................................................. 5-6
Restriction ................................................................................ 5-6
OpenVMS .................................................................................... 5-7
Naming Conventions ...................................................................... 5-7
Restrictions ............................................................................... 5-8
xiv User Guide

Stratus/System 88 ............................................................................ 5-9
Naming Conventions...................................................................... 5-9
Types of Files Supported.................................................................. 5-10
Additional Features ...................................................................... 5-10
Restrictions.............................................................................. 5-10
Tandem..................................................................................... 5-11
Naming Conventions..................................................................... 5-11
Types of Files Supported.................................................................. 5-11
File Type Specification.................................................................... 5-12
Remotely-Initiated Send Requests ......................................................... 5-13
UNIX....................................................................................... 5-13
Naming Conventions..................................................................... 5-13
Types of Files Supported.................................................................. 5-13
Restriction............................................................................... 5-14
VM......................................................................................... 5-14
Naming Conventions..................................................................... 5-14
Types of Files Supported.................................................................. 5-14
DCB Information......................................................................... 5-15
Restriction............................................................................... 5-15
VSE ........................................................................................ 5-16
VSAM Naming Conventions .............................................................. 5-16
SAM Naming Conventions ............................................................... 5-17
TAPE Naming Conventions............................................................... 5-19
DTF Information......................................................................... 5-20
Types of Files Supported.................................................................. 5-20
Restrictions.............................................................................. 5-20
Windows ................................................................................... 5-21
Naming Conventions..................................................................... 5-21
Restriction............................................................................... 5-22
Windows NT Server/Professional ............................................................. 5-22
Naming Conventions..................................................................... 5-23
Types of Files Supported.................................................................. 5-24
Additional Features ...................................................................... 5-24
Destination Printer Information ........................................................... 5-25
Restrictions.............................................................................. 5-25
Contents xv


Chapter 6: Performance Tuning
Appendix A: Unicenter CA-XCOM Data Transport
Parameters
Parameter Values Used in the GUI ............................................................. A-2
Parameter Values Used at the Command Prompt................................................ A-3
Parameter Format for Command Prompt and Scripts ........................................ A-3
Syntax................................................................................... A-4
Guidelines ............................................................................... A-4
List of Unicenter CA-XCOM Data Transport Parameters ......................................... A-5
Version 2 Parameters ..................................................................... A-5
AGE_TIME .............................................................................. A-5
ALLOCATION_TYPE..................................................................... A-6
ATOE_FILENAME ....................................................................... A-6
BLKSIZE ................................................................................ A-6
CARRIAGE_CONTROL_CHARACTERS ................................................... A-7
CARRIAGE_FLAG ....................................................................... A-7
CHECKPOINT_COUNT .................................................................. A-8
CLASS .................................................................................. A-9
CODE_FLAG ............................................................................ A-9
CODETABL............................................................................. A-10
COMPRESS............................................................................. A-10
CONTROL.............................................................................. A-11
CONVERT_CLASSES.................................................................... A-11
COPIES................................................................................. A-11
CREATE_DIRECTORIES................................................................. A-12
DAEMON_TIMEOUT ................................................................... A-12
DATACLAS ............................................................................ A-12
DEBUG_FLAG.......................................................................... A-12
DEN ................................................................................... A-13
DESTINATION ......................................................................... A-13
DESTINATION_TYPE ................................................................... A-13
DISPOSITION........................................................................... A-14
DOMAIN............................................................................... A-14
DSNTYPE .............................................................................. A-14
EOL_CLASSES .......................................................................... A-15
ETOA_FILENAME ...................................................................... A-15
EXPDT ................................................................................. A-15
EXPIRATION_TIME..................................................................... A-15
xvi User Guide

FCB.....................................................................................A-16
FILE_ACCESS_PASSWORD ..............................................................A-16
FILE_ACCESS_USERNAME ..............................................................A-16
FILE_OPTION...........................................................................A-16
FILE_OPTION_RF .......................................................................A-18
FORM ..................................................................................A-19
HOLDFLAG.............................................................................A-19
IMPLICIT_PACKING ....................................................................A-20
INTERNAL_CONVERSION_TABLES .....................................................A-20
LABEL..................................................................................A-20
LABELNUM ............................................................................A-21
LCLNTFYL..............................................................................A-21
LOCAL_FILE............................................................................A-22
LOCAL_FILE_RF ........................................................................A-22
LOCAL_FILE_SJ .........................................................................A-22
LOCAL_FILE_SR ........................................................................A-23
LOCAL_NOTIFY ........................................................................A-23
LRECL..................................................................................A-23
MAIL_USERNAME ......................................................................A-24
MAX_QUEUE_ENTRIES .................................................................A-24
MAX_SESSIONS_ENTRIES ...............................................................A-24
MAXRECLEN ...........................................................................A-25
METACODE_CLASSES ..................................................................A-25
MGMTCLAS ............................................................................A-25
NOTIFY_NAME .........................................................................A-26
NOTIFYL ...............................................................................A-26
NOTIFYR ...............................................................................A-27
NOTIFY_TERM..........................................................................A-28
NUMBER_OF_RETRIES ..................................................................A-28
NUM_OF_DIR_BLOCKS .................................................................A-28
PASSWORD.............................................................................A-28
PORT ...................................................................................A-29
PRIMARY_ALLOC ......................................................................A-29
PRIORITY...............................................................................A-29
PROTOCOL .............................................................................A-30
QUEUE .................................................................................A-30
QUEUE_PATH ..........................................................................A-30
RECORD_FORMAT......................................................................A-31
REMOTE_FILE ..........................................................................A-32
REMOTE_FILE_RF.......................................................................A-32
REMOTE_SYSTEM.......................................................................A-33
Contents xvii


REMOTE_SYSTEM_RF .................................................................. A-33
REMOTE_SYSTEM_SJ ................................................................... A-33
REMOTE_SYSTEM_SR................................................................... A-34
REMOVE_TRAIL_BLANKS .............................................................. A-34
REPORT_TITLE ......................................................................... A-34
RESTART_SUPPORTED ................................................................. A-35
RETPD ................................................................................. A-35
RETRY_TIME ........................................................................... A-35
RMTNTFYL............................................................................. A-36
SECONDARY_ALLOC .................................................................. A-36
SECURE_SOCKET....................................................................... A-36
SESSIONS_FILE......................................................................... A-37
SHELL_CMD ........................................................................... A-37
SOCK_DELAY .......................................................................... A-37
SOCK_RCV_BUF_SIZE .................................................................. A-38
SOCK_SEND_BUF_SIZE ................................................................. A-38
SPACE ................................................................................. A-39
SPOOL_FLAG .......................................................................... A-39
START_DATE........................................................................... A-39
START_TIME ........................................................................... A-40
STAT_FREQUENCY..................................................................... A-40
STORCLAS ............................................................................. A-40
TAPE................................................................................... A-40
TCP_CMD.............................................................................. A-41
TEMPDIR............................................................................... A-41
TP_CMD ............................................................................... A-41
TRACE_PATH .......................................................................... A-41
TRANSFER_ID.......................................................................... A-42
TRANSFER_TYPE....................................................................... A-42
TRANSFER_USR_DATA................................................................. A-42
TRUNCATION.......................................................................... A-43
TRUSTED .............................................................................. A-43
TXPI_BUF_SIZE......................................................................... A-43
TXPI_RECEIVE_TIMEOUT............................................................... A-44
TXPI_SEND_CHECK_FREQ.............................................................. A-44
TXPI_TERM_TIMEOUT.................................................................. A-44
UNIT................................................................................... A-45
UNITCT ................................................................................ A-45
UNIT_RF ............................................................................... A-45
USER_DATA ........................................................................... A-45
xviii User Guide

USERID.................................................................................A-45
VERSION ...............................................................................A-46
VOLCT .................................................................................A-46
VOLSQ .................................................................................A-46
VOLUME ...............................................................................A-46
VOLUME_RF............................................................................A-47
WRITE_EOF.............................................................................A-47
XBUFFSIZE .............................................................................A-47
XCOM_CONFIG_SSL ....................................................................A-47
XCOM_PASSWORD .....................................................................A-47
XCOM_SHOW_CIPHER..................................................................A-48
XCOM_USERID .........................................................................A-48
XENDCMD .............................................................................A-48
XIDEST .................................................................................A-49
XLOGFILE ..............................................................................A-49
XLPCMD................................................................................A-49
XLUNAME..............................................................................A-49
XMODE.................................................................................A-50
XNODESPEC............................................................................A-50
XNOTIFYCMD ..........................................................................A-50
XPPCMD................................................................................A-50
XPRECMD ..............................................................................A-51
XTRACE ................................................................................A-51
Appendix B: Messages
Error Message Example ....................................................................... B-1
Message ID Content ....................................................................... B-1
List of Messages .............................................................................. B-3
Service-Specific Messages................................................................. B-61
Appendix C: Logical Units
Physical Network Components ................................................................ C-1
Logical Network Components ................................................................. C-2
Session................................................................................... C-2
PCID................................................................................. C-2
SID .................................................................................. C-2
Logical Unit Types ............................................................................ C-3
Contents xix


Criteria for Independent Logical Units ......................................................... C-4
Systems Supporting ILUs ................................................................. C-4
Software Version Support for ILUs ......................................................... C-4
LU 6.2 Independent Implementations ...................................................... C-5
Direct Sessions with Dependent Logical Unit................................................ C-5
PU Type ................................................................................. C-5
Index
xx User Guide

Chapter
1
Introduction

This guide provides information about the use of the Unicenter

CA-XCOM


Data Transport

product with Microsoft Windows NT Server/Professional


(2000, 2003, and XP). Its scope ranges from an overview of the software to
descriptions of the parameters required to execute Unicenter CA-XCOM Data
Transport functions. Although there are extensive similarities between all of the
Unicenter CA-XCOM Data Transport components, you should always refer to
the corresponding users guide when requiring specific information about a
component.
Introduction 11
Unicenter CA-XCOM Data Transport Connectivity
Unicenter CA-XCOM Data Transport Connectivity
The following diagram shows how Unicenter CA-XCOM Data Transport can
provide connectivity across very diverse environments. Any client node using
Unicenter CA-XCOM Data Transport can send and receive files from any of the
remote systems shown in this example or any other Unicenter CA-XCOM Data
Transport component. For more information, see the section Modular Support of
Most Systems in the chapter Welcome in the Unicenter CA-XCOM Data
Transport for Windows NT Server/Professional Getting Started.

12 User Guide
Network Levels in the SNA Model
Network Levels in the SNA Model
An SNA network is divided into levels of physical and logical components. A
path control network that runs over the physical components interconnects the
logical components.
As data is passed up and down the SNA functional layers, each layer performs a
set of control functions and adds control information to the data in the form of a
header. The headers do not change the information in the data, but communicate
with the next layer of SNA to ensure that the data is understood.
As the data is passed through the layers, headers that are added at one end of
the network are stripped off and read by the receiving end. Thus, when the data
reaches its final destination, it is back to its original form.
End User Level
The end user level consists of transaction programs (like Unicenter CA-XCOM
Data Transport) that communicate with other transaction programs using LUs.
In a Unicenter CA-XCOM Data Transport transfer request, the local end user
specifies the following:
Type of transfer (send report, file, or job, or receive file)
Name of the local file
Name of the remote file to create, append, or replace
The request is then processed by the Unicenter CA-XCOM Data Transport
transaction program on the local system that sends an allocate verb and header
record to the remote system to establish an LU 6.2 session. When a session is
established and all of the parameters are confirmed by the remote system,
Unicenter CA-XCOM Data Transport on the local system will send the file,
broken into data records, across the physical connection.
The remote Unicenter CA-XCOM Data Transport transaction program is then
invoked by the allocate verb sent by the local system (some systems cannot be
automatically invoked and must already be active to receive the allocate verb).
The remote transaction program then creates or opens the requested file, receives
the data records, and places them in the file. When all the records have been
received, Unicenter CA-XCOM Data Transport on the remote system will send a
trailer record to the local system stating the number of records transmitted.
Introduction 13
Network Levels in the SNA Model
Logical Level
The logical level consists of logical units (LUs) that link the physical units (PUs)
and transaction programs (TPs). Each Unicenter CA-XCOM Data Transport user
should be assigned a unique LU name for gateway or workstation identification.
Each data record traveling across the line will contain LU 6.2 protocol
information containing instructions for the remote system.
Physical Level
The physical level consists of physical unit (PU) nodes linked by a physical
connection. Unicenter CA-XCOM Data Transport supports transfers between
physically connected systems whether they are directly or indirectly connected.
PU Type 2.1 nodes can make a direct logical link even without a direct physical
connection. Transfers involving PU Type 2.0 nodes (like VAX/VMS) can be
made using the store-and-forward feature of Unicenter CA-XCOM Data
Transport.
14 User Guide
Network Levels in the SNA Model
Network Level Diagram
The following diagram shows the various network levels used to communicate
with Unicenter CA-XCOM Data Transport:
END
USER
LEVEL
LOGICAL
LEVEL
PHYSICAL
LEVEL
Local
User
Remote
User
Physical Connection
Physical
Unit Node
Physical
Unit Node
LU 6.2 LU 6.2
Unicenter
CA-XCOM
Data Transport
Unicenter
CA-XCOM
Data Transport

Benefits of LU 6.2 (APPC)
Unicenter CA-XCOM Data Transport is built upon the LU 6.2 protocol. LU 6.2 is
also known as Advanced Program-to-Program Communications (APPC) and is
IBMs most powerful enhancement to the Systems Network Architecture (SNA)
suite of communications protocols.
Introduction 15
Network Levels in the SNA Model
Improved Throughput
When Unicenter CA-XCOM Data Transport uses the LU 6.2 protocol, it does not
place hardware restrictions on the size of the data that it sends. RJE-based data
transfer packages (LU Type 1) limit the size of a data frame (RU) to 80 characters,
while 3270-based transfer packages (LU Type 2) often limit the size to 1,920
characters, the size of one screen. LU 6.2 allows RU sizes of up to 65,536
characters.
Each transmitted string of data is wrapped in a protocol envelope. Larger RU
sizes, such as those allowed with Unicenter CA-XCOM Data Transport, mean
less protocol overhead and a higher percentage of actual data traveling across
your communication links.

Support for Advanced Networking
For SNA, LU 6.2 fully exploits the PU Type 2.1 peer protocol. This means that
LU 6.2 is the only protocol that can use advanced functions such as Low Entry
Networking (LEN), Advanced Peer-to-Peer Networking (APPN), and
Independent Logical Units (ILUs) that are changing the face of computer
networking today. For more information, see the appendix Logical Units.
APPC allows two programs running on distinctly different computers to
converse with each other in real time without regard to hardware. All other
protocols assume that one of the two devices communicating is a dumb terminal
and impose all the limitations of a particular terminal on the partner computer.
APPC and Unicenter CA-XCOM Data Transport recognize that distributed
processing employs intelligent processors so they can exploit the intelligence of
the computers on which they are running.
16 User Guide
Unicenter CA-XCOM Data Transport in the TCP/IP Network
Unicenter CA-XCOM Data Transport in the TCP/IP Network
The architectural and conceptual framework of the TCP/IP communications
protocol as it relates to the implementation of Unicenter CA-XCOM Data
Transport as a TCP/IP application is discussed in the following topics.
TCP/IP Protocol Stack
TCP/IP is a collection of specialized communications protocols and functions
organized into a stack of four layers. The layers that make up the TCP/IP
protocol stack are the following:
Network layer (the lowest protocol layer)
Internetwork layer
Transport layer
Application layer (the highest protocol layer)
Each layer in the TCP/IP protocol stack provides services to the layer above it
and uses the services below it.
The following table lists the protocols and functions that form the content of each
layer of the TCP/IP protocol stack. (The table shows only partial contents for the
top and bottom layer.)

TCP/IP Protocol Layer Protocols and Functions
Network layer Token Ring
Ethernet
X.25
and so on
Internetwork layer Internet Protocol (IP)
Control Message Protocol (ICMP)
Address Resolution Protocol (ARP)
Transport layer Transmission Control Protocol (TCP)
User Datagram Protocol (UDP)
Application layer Telnet
File Transfer Protocol (FTP)
Simple Mail Transfer Protocol (SMTP)
Domain Name System (DNS)
Sockets
and so on
Introduction 17
Unicenter CA-XCOM Data Transport in the TCP/IP Network
The next few sections provide a summary of the services that each layer of the
protocol stack performs in the TCP/IP network and a description of the
protocols that are particularly important for the functioning of Unicenter
CA-XCOM Data Transport as a TCP/IP network node.
Network Layer
The Network layer provides a set of protocols, such as Token Ring and Ethernet,
that define how data are transported over different physical networks.
Internetwork Layer
The protocols of the Internetwork layer provide connection services for TCP/IP.
The protocols in this layer connect physical networks and transport protocols.
The Internet Protocol (IP) of this layer integrates different physical networks
into a unified logical network known as the Internet and provides for the
universal addressing of computers (hosts) in a TCP/IP (Internet) network. IP
uses a 32-bit number (IP address) that identifies both a physical network and a
specific computer within that network. The IP address is the basic transport
mechanism for routing data from a source computer to a destination computer.
However, IP does not ensure a reliable communication, because it does not
require that the computers participating in a data exchange acknowledge the
reception of the transmitted data. The reliability of communication is
implemented at the next higher protocol layer.
Transport Layer
The protocols of the Transport layer allow communication between application
programs.
The Transmission Control Protocol (TCP) of this layer establishes a connection
between the sender and receiver and provides a continuous communication
service with reliability of transmissions. TCP divides the data to be transmitted
into smaller units (packets, datagrams), sends them individually using IP, and
reassembles them at the destination node, comparing the received data with the
data that were sent. TCP is capable of determining if the two are the same. If they
are not (for example, data were lost or damaged during transmission), TCP
resends the missing data.
18 User Guide
Unicenter CA-XCOM Data Transport in the TCP/IP Network
Application Layer
The Application layer, which is built on the services of the Transport layer,
provides a number of applications that allow users to use network services
(terminal-to-terminal communication, data transfer, electronic mail, and so on).
The Application layer provides an application-programming interface known as
Sockets for communications applications. Unicenter CA-XCOM Data Transport
uses this component of the Application layer to transfer files to machines in a
TCP/IP network.
Unicenter CA-XCOM Data Transport Nodes in the TCP/IP Network
Each computer in a TCP/IP network is assigned at least one unique address,
which is used by the IP and other higher-level protocols.
TCP/IP Address
TCP/IP employs an addressing scheme consisting of a 32-bit long field divided
into two parts. The first part of the address field contains a network address; the
second field contains the address of a specific computer.
A TCP/IP address is written in dotted-decimal notation, which is obtained by
first dividing the 32-bit long address into four 8-bit long fields and then
converting each of the four fields into a decimal number and separating the
fields with periods. The decimal numbers should be specified without leading
zeros.
Instead of using a numeric address, a symbolic name may be used to identify a
computer in a TCP/IP network. Each computer in a TCP/IP network is assigned
at last one name, which is resolved to a numeric address using either a
translation file or an application known as the name server (which is part of the
Domain Name System function of the Application layer).
TCP/IP Port
The notions of port and port number are extensions of the TCP/IP address. Once
the TCP/IP address has been used to deliver data to the desired computer in the
network, the port number is used to identify the process for which the data are
intended. By using ports and port numbers one computer can provide more than
one service. Unicenter CA-XCOM Data Transport uses a predefined port number
but it can be changed if it interferes with existing application services.
Introduction 19
Successful Send File Transfer Scenario
Successful Send File Transfer Scenario
The following flowchart illustrates a normal Unicenter CA-XCOM Data
Transport send file:

110 User Guide
Successful Send File Transfer Scenario
Compare the following steps with the Send File Flowchart to follow a typical
successful send file transfer.
1. The local Windows user invokes Unicenter CA-XCOM Data Transport and
requests a transfer.
2. Unicenter CA-XCOM Data Transport verifies the information contained in
the request.
For example, Unicenter CA-XCOM Data Transport checks to see if the local
file exists on the local system.
3. Unicenter CA-XCOM Data Transport establishes a connection with the
remote system and sends along the header record to the remote system. The
header record contains transfer information regarding the request, for
example, file names and compression. The local system then waits for
confirmation of the header record information.
4. Once the contents of the header record are verified, Unicenter CA-XCOM
Data Transport begins sending data records to the remote system. Unicenter
CA-XCOM Data Transport sends each data record, checking to see if any
sending errors occur. If no errors are found, the local system checks for an
end-of-file marker denoting the last record of the file. If no end-of-file
marker is found, another data record is sent.
5. If an end-of file marker is found, the local system sends a trailer record,
which indicates the number of data records sent. The local system then
awaits verification from the remote system that the number of records
received is equal to the number of records sent. If the number of records
matches, a successful send file message is sent to the user on the local system
and the conversation ends. If notification was specified, Unicenter
CA-XCOM Data Transport on the remote system notifies the user of a
successful transfer.

Introduction 111



Chapter
2
Using Unicenter CA-XCOM Data
Transport

This chapter contains information about using the Graphical User Interface (GUI)
of Unicenter CA-XCOM Data Transport. It describes the functions and options
available from the Unicenter CA-XCOM Data Transport for Windows NT main
window, and then describes how to create and edit transfer configuration files,
how to set options, and how to perform transfers. It also contains information
about using the GUI to manage Unicenter CA-XCOM Data Transport. In
addition, this chapter also contains information for administrators on using the
Properties Dialog pages to modify global defaults.
Unicenter CA-XCOM Data Transport GUI
The Graphical User Interface of Unicenter CA-XCOM Data Transport provides
access to all of the features of Unicenter CA-XCOM Data Transport. From the
GUI you can do the following:
Create and edit Unicenter CA-XCOM Data Transport transfer configuration
files
Specify transfer type
Initiate transfers
Monitor the log and trace functions
Update the status of active and pending transfers
File Name, Path, and Directory Considerations
Consider the following:
Before executing a file transfer request, be sure that you have properly set up
your directories and path variables.
Unicenter CA-XCOM Data Transport accesses files locally or from any file
server on the Microsoft Windows Network or the NetWare or Compatible
Network.
Universal Naming Convention (UNC) is supported.
Using Unicenter CA-XCOM Data Transport 21
Unicenter CA-XCOM Data Transport GUI
Standard Windows path names are supported. To specify a path name that
contains a blank or special character, put double quotes ( ) around it.
Standard Windows file types are supported (FAT, NTFS, HPFS).
In addition, administrators should be aware of the following:
Be sure that the XCOM_HOME environment variable is set to the directory
where Unicenter CA-XCOM Data Transport is installed.
Your PATH variable should include the directory where Unicenter
CA-XCOM Data Transport is installed. The default directory is
C:\XCOMNT.
The C:\XCOMNT directory is the default repository for the subdirectories
that Unicenter CA-XCOM Data Transport uses for log and configuration
files.
Keyboard Commands
When you use keyboard commands instead of mouse operations, note the
following:
Use Alt+Spacebar to open the list of control-menu box options for any Unicenter
CA-XCOM Data Transport window. (Use this instead of the Windows
Alt+Hyphen keyboard command.)
Use Alt+Underlined letter to open any menu. Then, to select a menu command,
use the underlined letter of that command. Note that if the Caps Lock key is on,
these commands do not function.
Default Directories and Drives
In this user guide we indicate C:\XCOMNT as the default path. Your installation
may have Unicenter CA-XCOM Data Transport under a different path or on a
different drive. If this default is changed during the installation of Unicenter
CA-XCOM Data Transport, the default values in the XCOM.GLB file will reflect
this change.
For further information on PATH and directory defaults, see the appendix
Unicenter CA-XCOM Data Transport Parameters.
22 User Guide
Starting Unicenter CA-XCOM Data Transport
Requirements
To use Unicenter CA-XCOM Data Transport you need the following:
Unicenter CA-XCOM Data Transport installed on your server or
workstation.
For using SNA/APPC protocols, appropriate APPC communications
software installed.
For using TCP/IP, TCP/IP capability installed and configured for your
server or workstation.
Your Windows Username and Password.
The XCOMD Unicenter CA-XCOM Scheduler service must be started.
To edit configuration files, you need the appropriate user rights to read and
write to those files.
To send a transfer using the GUI, you need the appropriate user rights to run
XCOMNT.EXE and XCOMTP.EXE.
For information about installing Unicenter CA-XCOM Data Transport, see the
Unicenter CA-XCOM Data Transport for Windows NT Server/Professional Getting
Started. For more information about the XCOMD Unicenter CA-XCOM
Scheduler service and the Unicenter CA-XCOM Data Transport operating
environment, administrators should see the following chapters:
The Command Line Interface in this guide
Operating Environment in the Unicenter CA-XCOM Data Transport for
Windows NT Server/Professional Administrator Guide
Starting Unicenter CA-XCOM Data Transport
Before you can use Unicenter CA-XCOM Data Transport to perform transfers,
the XCOMD Unicenter CA-XCOM Scheduler service must be running. For a
procedure for starting the XCOMD Unicenter CA-XCOM Scheduler service, see
the Unicenter CA-XCOM Data Transport for Windows NT Server/Professional Getting
Started.
You can start Unicenter CA-XCOM Data Transport for Windows NT in the same
ways that you start any Windows application:
By double-clicking the program icon
By selecting Start>Programs>Unicenter CA-XCOM Data Transport on your
Windows desktop
At the command prompt by typing XCOMNT and pressing ENTER.
Using Unicenter CA-XCOM Data Transport 23
Starting Unicenter CA-XCOM Data Transport
Note: For starting and stopping the Unicenter CA-XCOM Data Transport user
interface, ERRORLEVEL has no meaning. When executing the command-line
programs (xcomtcp.exe and xcom62.exe), the ERRORLEVEL indicates successful
or failed processing. An ERRORLEVEL of ZERO indicates successful operation
and termination. An ERRORLEVEL of NON_ZERO values indicates program
processing was not successful, and that the program has terminated.
The Unicenter CA-XCOM Data Transport interface displays:

24 User Guide
Using the Unicenter CA-XCOM Data Transport Main Window
Using the Unicenter CA-XCOM Data Transport Main Window
Use the Unicenter CA-XCOM Data Transport for Windows NT main window to
select, create, or edit transfers. This window provides access to files and provides
the ability to create, open or save transfer configurations. From here you can
submit transfers to the Unicenter CA-XCOM Data Transport queue. You can
add, duplicate, delete or edit transfers, save configuration files, and access the
queue and the log.

Main Window
The Unicenter CA-XCOM Data Transport for Windows NT main window is the
beginning point for all transfers. The first time this window is displayed, it is
blank. When you add or duplicate a transfer, the transfer appears in the transfer
list displayed in this window.
Note: In this chapter we will refer to this window as the main window. The title
bar displays Unicenter CA-XCOM Data Transport for Windows NT. In addition,
when a configuration file is open, the name of the file is displayed in the title bar.
The main window provides the following functions:
Management of configuration files
Access to other windows
Using Unicenter CA-XCOM Data Transport 25
Using the Unicenter CA-XCOM Data Transport Main Window
From the main window you can access other windows to configure parameters
for the four Unicenter CA-XCOM Data Transport transfer types:
Send File
Send Job
Send Report
Receive File
The functions and options of this window can be selected from the menu bar or
from the pushbuttons on the toolbar at the top of the window.
For information about configuration files, see Using Transfer Configuration Files
later in this chapter.
Considerations
Before using the main window to access a transfer you should know the values
of the options you wish to edit and the particular type of action you wish to
perform on the transfer. Each type of transfer operation is described later in this
chapter, with suggestions about the information you may need, along with
procedures for performing each type of transfer.
Procedure
To perform an action on a transfer listed in the Unicenter CA-XCOM Data
Transport main window, do one of the following:
Highlight a transfer on the list and click on one of the toolbar pushbuttons.
Highlight a transfer on the list and select an action from a drop-down list on
the menu bar.
Highlight a transfer on the list and double-click it to open an Edit Transfer
window.
The applicable window is displayed or the applicable action is performed.
Note: To select more than one transfer, hold down the CTRL key and click on
each appropriate transfer.
26 User Guide
Using the Unicenter CA-XCOM Data Transport Main Window
Menu Bar Selections
Use the following selections and options of the menu bar to perform functions
from the main window:

Selection Options
File The following options can be selected:
Option Function
New Clear the displayed Transfer List and create a
new configuration file.
Open Open a saved configuration file.
Save Save a configuration file.
Save As Save a configuration file under a different name.
Select all
transfers
Select all transfers from the list.
Queue
transfers
Submit all transfers that were selected from list.
Exit Exit Unicenter CA-XCOM Data Transport.
Edit The following options can be selected:
Option Function
Add transfer Add a new transfer with default parameters to
the transfer list.
Duplicate
transfer
Add a copy of the selected transfer(s) to the
transfer list.
Delete transfer Delete selected transfer(s) from the transfer list.
Edit transfer
parameters
Edit the selected transfers parameters. This
opens an Edit Transfer window for the selected
transfer type.
Connect The connect menu selection is dimmed, and does not apply to this
implementation of Unicenter CA-XCOM Data Transport.
Tools The following options can be selected:
Option Function
Queue
manager
Open the Queue Status window. Display the
status of transfers.
Log browser Open the Log Browser window. Display the
Unicenter CA-XCOM Data Transport log.
Using Unicenter CA-XCOM Data Transport 27
Using the Unicenter CA-XCOM Data Transport Main Window
Selection Options
Global
parameters
Open the Unicenter CA-XCOM Data Transport
for Windows NT Properties dialog, to access the
Properties dialog pages, for modifying global
defaults.
Trusted Access Open the Unicenter CA-XCOM Data Transport
for Windows NT Trusted Access user interface,
from which you can set up permissions to allow
Unicenter CA-XCOM Data Transport on other
platforms to initiate file transfers without
requiring a password.
Help The following options can be selected:
Help Contents Open the contents for Unicenter CA-XCOM Data
Transport online help.
About Displays information about this version of the
product.
Pushbuttons
Use the following toolbar pushbuttons to perform functions from the main
window. All the pushbuttons, except for Queue, can be used in place of menu
bar selections.

Button Icon Function
Add

Add a new transfer with default parameters to
the transfer list.
Duplicate

Add a copy of the selected transfer(s) to the
transfer list.
Delete

Delete selected transfers from the transfer list.
Edit

Edit the selected transfers parameters. This
opens an Edit Transfer window for the
selected transfer type.
Select All

Select all transfers in the list.
Queue

Queue submits selected transfers.
28 User Guide
Using Transfer Configuration Files
Button Icon Function
Queue
Manager

Open the Queue status window and display
the status of transfers.
Log

Open the Log Browser window and display
the Unicenter CA-XCOM Data Transport log.
Using Transfer Configuration Files
Unicenter CA-XCOM Data Transport uses transfer parameters stored in
configuration files to manage each transfer. You can control how Unicenter
CA-XCOM Data Transport performs transfers by specifying values for the
parameters for each transfer. You can use a combination of default values and
values you specify.
Using the GUI, you can create or open specific configuration files. You can create
any number of these transfer configuration files for different transfer situations.
You can edit a configuration on-screen, save it under another name and modify it
for your own use, or add and delete transfers to create different configuration
files. You can also simply modify the default values on-screen for a selected
transfer.
Default Configuration Files
Unicenter CA-XCOM Data Transport comes with default configuration files,
XCOM.GLB and XCOM.CNF, which can be modified as needed. Authority to
change these files should be controlled by an Administrator.
WARNING! The parameters in the XCOM.GLB files and the values of the options on
the Properties dialog pages in the GUI should only be changed by authorized Unicenter
CA-XCOM Data Transport administrators. Most users will not need to change these
values. The values should not be changed or deleted unnecessarily, and parameters
should not be deleted from XCOM.GLB unnecessarily. If these values or parameters are
deleted unnecessarily, the results are unpredictable.
Note: The installation process installs XCOM.GLB with parameters used for
TCP/IP transfers. Even if you are not using TCP/IP, you should not delete these
parameters from XCOM.GLB.
For information about modifying default values in XCOM.GLB using the GUI,
see Using the Properties Dialog Pages in this chapter.
Using Unicenter CA-XCOM Data Transport 29
Using Transfer Configuration Files
Precedence of Parameter Values
The GUI uses parameter values in the following ways:
Values specified on-screen take precedence over values in open user-
specified configuration files.
When using the GUI, parameter values in a user-created configuration file
only take effect if the file is open.
When you save a configuration, the file is updated to include the values you
have indicated on-screen.
Parameter values in the XCOM.GLB file are the global default values.
For more information about how parameter values take effect, see the chapter
Operating Environment in the Unicenter CA-XCOM Data Transport for Windows
NT Server/Professional Administrator Guide.
Modifying Options and Configurations
Each line displayed in the transfer list on the main window represents a transfer
with specific parameters associated with it. Modify the options for a particular
transfer by opening the appropriate Edit Transfer window.
For information about using the transfer list, see Using the Transfer List to
Access and Perform Transfers later in this chapter. For information about using
configuration files from the command prompt and in scripts, see the chapter
The Command Line Interface. For information about how configuration files
are edited and used from the command prompt, see Using Configuration Files in
the following chapters:
The Command Line Interface in this guide
Operating Environment in the Unicenter CA-XCOM Data Transport for
Windows NT Server/Professional Administrator Guide
Multiple Transfers from the GUI
You can create up to 99 transfers and save them as a single configuration file,
which lets you create configurations to control multiple transfers. When you
open a configuration file, the transfers are displayed on the main window.
Select multiple transfers by holding down the control key (CTRL), clicking the
desired transfers to highlight them, and then clicking the Queue pushbutton.
210 User Guide
Creating a Configuration File
Considerations
Before you create or edit a configuration file, get information from your
Administrator about Unicenter CA-XCOM Data Transport configuration files
and find out what parameters you may have to set on specific transfers.
Also, before attempting to queue a transfer, you need to know the name of some
or all of the following components:
Local file
Remote file
For transfers using SNA/APPC protocols, the CPI-C Symbolic Destination
Name for the remote system
For transfers using TCP/IP, the IP address, host name or domain name for
the remote system
Note: The local file is the name of the file on the local system that is being
transferred. The remote file is the name of the file on the remote system to which
the transferred data is being written.
Creating a Configuration File
When you first open Unicenter CA-XCOM Data Transport, the main window
does not display any transfers. When you create a new configuration file, the
default values for a new transfer configuration file come from the XCOM.GLB
file.
Considerations
Before you create a configuration file, read Using Transfer Configuration Files
previously discussed. Also, get information from your Administrator about
Unicenter CA-XCOM Data Transport configuration files and find out what
parameters you may have to set on specific transfers.
Note: If you want to create a new configuration file and transfers are displayed,
you can choose to save the displayed transfers as a configuration or delete them
from the transfer list.
Using Unicenter CA-XCOM Data Transport 211
Creating a Configuration File
Procedure
To create a configuration file, follow these steps:
1. From the Unicenter CA-XCOM Data Transport for Windows NT main
window, click the Add pushbutton.
The main window is displayed with a transfer listed:

Note: When you first open Unicenter CA-XCOM Data Transport, this
window does not display any transfers.
212 User Guide
Creating a Configuration File
2. Highlight the transfer and click the Edit pushbutton.
An Edit Transfer window is displayed.


3. Select an action (Send File, Send Job, Send Report, or Receive File) from the
drop down Action list.
The right side of this window will change the fields to reflect the type of
transfer you have selected.
4. Fill in the fields and change the options for a new configuration, and click the
Apply and Close pushbutton.
The transfer is displayed on the main window transfer list.
For information about using the Edit Transfer windows, see Using the Edit
Transfer Window in this chapter.
5. From the menu bar, choose File Save or File Save as.
The File drop-down list appears and the option is selected. Then the Save or
Save as directory window appears.
Using Unicenter CA-XCOM Data Transport 213
Editing an Existing Configuration File
6. In the Save or Save as directory window, type a new name for the file, using
an extension of .cnf and click OK.
The configuration file is saved.
Note: Any transfers in the list are saved as part of the configuration.
Editing an Existing Configuration File
The values for a transfer come from a user-specified configuration file if one is
open. Otherwise, the values for the transfer come from the XCOM.GLB file.
After you open a configuration file, the name of the highlighted file appears in
the title bar of the main window.
Considerations
Before editing a configuration file, read Using Transfer Configuration Files
discussed earlier in this chapter. Also get information from your Administrator
about Unicenter CA-XCOM Data Transport configuration files and find out what
parameters you may have to set on specific transfers.
When you choose File>Open, the Open directory window displays all the files
with .cnf extensions that are in the directory where Unicenter CA-XCOM Data
Transport is installed. If you use configuration files with other extensions, you
must change List Files of Type to All files (*.*) in order to display these files in
the selection list.
214 User Guide
Editing an Existing Configuration File
Procedure
To edit an existing configuration file, follow these steps:
1. From the menu bar on the main window click File.
The File drop-down list is displayed.
2. Click Open, select the directory where the configuration file is stored,
highlight the configuration file you want to edit and choose OK.
The following window is displayed, with the transfer selected:

Note: The display listed in the above window is only an example. Your
display will vary, based on the contents of your open configuration file.
3. Highlight the transfer and select a function. For descriptions of the options
available with this window, see Using the Unicenter CA-XCOM Data
Transport Main Window earlier in this chapter.
Using Unicenter CA-XCOM Data Transport 215
Using the Transfer List to Access and Perform Transfers
Using the Transfer List to Access and Perform Transfers
Use the transfer list on the main window to:
Select a transfer to edit
Submit a transfer to the queue
Select a transfer to delete or duplicate
Save transfer configurations

The main window displays a list of transfers that can be edited, queued, deleted,
or duplicated. New transfers can also be created.
A transfer entry appears on the list in the main window when you do any of the
following:
Add a transfer by clicking the Add pushbutton or selecting Add transfer
from the Edit drop-down list.
Select an existing transfer and duplicate it by clicking the Duplicate
pushbutton or selecting Duplicate transfer from the Edit drop-down list.
Open a configuration file by selecting Open from the File drop-down list.
Note: When you open a configuration file, all other transfers in the list are
cleared.
Each line in the list represents a transfer with a set of parameters specified for it.
216 User Guide
Using the Transfer List to Access and Perform Transfers
Transfer List Fields
Transfers are listed with the name of the local file, an arrow indicating the
direction of the transfer (from local to remote or remote to local), the remote
system (for transfers using SNA/APPC protocols, this is the CPI-C Symbolic
Destination Name; for transfers using TCP/IP, this is the IP address, the host
name or the domain name), and the name of the remote file. When the transfer is
a job, it is indicated with //JOB. When the transfer is a report, it is indicated with
a printer icon.
You can customize the size of each displayed field by selecting the left or right
border of the field title box and dragging it left or right.
Saving Displayed Transfers
If you modify the parameter values of a transfer using the fields and options in
the GUI, and you wish to use them again, you must save them in a configuration
file. After a transfer has been saved in a configuration file, deleting it from the list
only deletes it from memory, and has no effect on a file that has been saved.
You can clear the transfer list by saving the transfer list in a configuration file and
then selecting File>New, or you can highlight transfers and delete them from the
list using Edit>Delete transfer or the Delete button.
When you select File>New, if any displayed transfers have been changed or
added, a dialog box prompts you to choose Yes to save the configuration or No
to abandon the changes before the transfer list is cleared from the window.
Considerations
Before you perform a transfer, find out from your Administrator what
parameters you may have to set for specific transfers. You should know the type
of transfer you wish to perform:
Send File
Send Report
Send Job
Receive File
Also, before submitting a transfer to the Unicenter CA-XCOM Data Transport
queue, you need to know the names of some or all of the following transfer
components:
Local file
Remote file
Using Unicenter CA-XCOM Data Transport 217
Using the Transfer List to Access and Perform Transfers
For transfers using SNA/APPC protocols, the CPI-C Symbolic Destination
Name for the remote system
For transfers using TCP/IP, the IP address, host name or domain name for
the remote system
Procedure
To select a transfer for editing and processing, follow these steps:
1. Highlight a transfer in the list on the main window and click Edit or double-
click the highlighted transfer.
An Edit Transfer window for the selected transfer is displayed.
2. Enter values in fields and select options as needed. For more information, see
Using the Edit Transfer Windows and the transfer procedures described in
this chapter (for sending and receiving transfers).
3. Process a transfer by submitting it to the queue or applying the edited values
to the transfer and adding it to the transfer list in the main window.
4. To submit a transfer from the transfer list, highlight it and click the Queue
pushbutton. Refer to Using the Unicenter CA-XCOM Data Transport Main
Window discussed earlier for detailed information on using the main
window. For information about the queue, see Viewing and Controlling
Transfer Status later in this chapter.
218 User Guide
Using the Transfer List to Access and Perform Transfers
Fields
Refer to the following table for explanations of the fields on the transfer list:

Field Description
Local File The name of the local file.

The direction of the transfer. A right pointing arrow
means send, a left pointing arrow means receive.
Remote System For transfers using SNA/APPC protocols: the CPI-C
Symbolic Destination Name for the remote system that
receives or sends a file.
For transfers using TCP/IP: the IP address, host name or
domain name for the remote system that receives or sends
a file.
Note: If you use a host name or domain name, your
system must have a way to resolve that name to an IP
address. Using the IP address is the most efficient method
to use when specifying a remote system location. For
more information on TCP/IP, see Using the Version 2
WindowCheckpoint, Restart, Protocol, Port in this
chapter and Transferring Files Using TCP/IP Protocols in
the chapter The Application Programming Interface.
Remote File The name of the remote file.
Transfer List Symbols
The following table explains the transfer symbols in the transfer list:

Symbol Description

Right arrow indicates a transfer operation from local to
remote.

Left arrow indicates a transfer operation from remote to local.
//JOB Indicates a Send Job transfer.

Indicates a Send Report transfer.
Using Unicenter CA-XCOM Data Transport 219
Using the Edit Transfer Windows
Using the Edit Transfer Windows
Use the information in this section to refer to the options available for each
transfer type when using an Edit Transfer window.

Accessing the Edit Transfer Window
Access an Edit Transfer window by highlighting a transfer from the transfer list
on the main window and clicking the Edit pushbutton or double-clicking a
highlighted transfer. The Edit Transfer window that is displayed depends on the
transfer type.
220 User Guide
Using the Edit Transfer Windows
Menu Bar Selections
These selections and options are available from the Edit Transfer window menu
bar:

Selection Options
Action The following options can be selected:
Selection Function
Send File Change transfer type to send file and open the Edit
window for send file.
Send Job Change transfer type to send job and open the Edit
window for send job.
Send
Report
Change transfer type to send report and open the
Edit window for send report.
Receive File Change transfer type to receive file and open the Edit
window for receive file.
Close Close this window.
Pushbuttons
The following pushbuttons and functions are available at the bottom of each Edit
Transfer window:

Button Function
Submit Apply the parameter values and options specified on-
screen to the transfer and queue the transfer.
Apply Apply the entered parameters to the transfer. The Transfer
Edit window stays open.
Apply and close Apply the entered parameters to the transfer and close the
Transfer Edit window.
In addition, you can click the Control-menu box to close an Edit Transfer
window without taking any action.
Using Unicenter CA-XCOM Data Transport 221
Using the Edit Transfer Windows
Fields
The following table explains the fields found on the Edit Transfer windows.
Many of these fields are common to the different types of transfer operations. For
more information about parameter specifications, see the appendix Unicenter
CA-XCOM Data Transport Parameters.

Field Definition
Local file The name of the local file. Use the Local File Browse window
to select a file.
Remote System For transfers using SNA/APPC protocols: the CPI-C Symbolic
Destination Name of the remote system that receives files,
jobs, reports, and sends messages.
For transfers using TCP/IP: the IP address, host name or
domain name of the remote system that receives files, jobs,
reports, and sends messages.
Remote File Indicates the file on the remote computer to which the
transferred data is being written. If you are creating the file,
the file name must be consistent with the file naming
conventions of the remote system. The local Unicenter
CA-XCOM Data Transport system does not validate this
name. The remote I/O system determines whether the file
name is valid.
Remote system
type
Click the appropriate option button for MVS/VM, Midrange,
DOS/VSE, or Other.
File option Click the appropriate option button for Create, Replace or
Append.
222 User Guide
Using the Edit Transfer Windows
Field Definition
Destination
Printer
Identifies the printer or other device on the remote system
where the report is to be sent. If this parameter is not specified,
the remote system sends the report to the system's default
printer.
When sending a report to a Windows network printer, specify
the Destination parameter value or the Destination Printer
field in the following form:
\\servername\printerqueuename
Unicenter CA-XCOM Data Transport limits the length of this
field as indicated below. The actual name on the destination
system may be longer.
For direct transfers using Version 2 protocols: Up to 21
characters.
For indirect transfers or transfers using Version 1 protocols:
Up to 16 characters.
Report title Used by Unicenter CA-XCOM Data Transport on remote
systems in the following ways:
System Uses the Report title
AS/400 As the printer file name.
z/OS To interpret a non-blank value in this field as
specifying the generation of a separator
(banner) page for this value.
VAX/VMS To print with the report.
UNIX To allow Unicenter CA-XCOM Data
Transport to pass this field to the LP spooler
as a title field.
Other systems As a descriptive comment only and does not
print it as part of the report.
UNIT
(system-specific)
The unit for the remote file.
VOLUME
(system-specific)
The volume for the remote file.
DSNTYPE The data set type definition.
DATACLAS The name of the data class to use when allocating a new SMS-
managed data set.
MGMTCLAS The name of the management class to use when allocating a
new SMS-managed data set.
Using Unicenter CA-XCOM Data Transport 223
Using the Edit Transfer Windows
Field Definition
STORCLAS The name of the storage class to use for a new SMS-managed
data set.
RECFM
(system-specific)
The record format for the remote file. See RECORD_FORMAT
later in this chapter.
LRECL
(system-specific)
The actual or maximum length, in bytes, of a logical record for
the remote file. This parameter corresponds to the JCL LRECL
subparameter.
If the format is Variable Blocked Record, then the maximum
length of a logical record must be equal to the Maximum
record length plus 4.
If the format is Fixed or Fixed Block Record, then the
maximum length of a logical record must be equal to the
constant record length.
BLKSIZE
(system-specific)
The block size for the remote file. If the format is Fixed or
Fixed Block Record, then the block size must be a multiple of
the record length. If the format is Variable Record, then the
block size must be 4 bytes larger than the record length. If the
format is undefined, then the block size must be larger than
the largest record length.
SPACE
(system-specific)
The unit of storage allocation for the remote file. Values are as
follows:
CYL = Cylinders
TRK = Tracks
BLK = Blocks
Specify by
Primary allocation space for the remote file
Secondary allocation for the remote file
Directory blocks for the remote file
TAPE
(system-specific)
Indicates to the remote system whether the volume is a tape
volume or a disk file.
DEN
(system-specific)
The density to be used in creating a tape on the remote system.
Valid values are the same as those for the DEN parameter in
JCL.
224 User Guide
Using the Edit Transfer Windows
Field Definition
LABEL
(system-specific)
The type of label associated with a tape data set. Values are as
follows:
Sequence number = the sequence number of a data set on
tape
Processing type = AL, AUL, BLP, LTM, NL, NSL, SL, or SUL
(the types of processing to be applied to data sets on tape)
UNITCT
(system-specific)
The number of units to be allocated on the remote system.
VOLCT
(system-specific)
The maximum number of volumes to be used in processing a
multi-volume output tape data set on the remote system.
VOLSQ
(system-specific)
The sequence number of the first volume of a multi-volume
remote data set to be used.
EXPDT* The expiration date for the tape data set.
RETPD* The number of days (1 to 9999) that the tape data set being
created is to be retained
COPIES The number of copies to be printed.
FCB
(system-specific)
The FCB JCL parameter when sending the report to an IBM
mainframe.
CLASS
(system-specific)
The print class to be assigned to this report on the remote
system. If the remote system is an IBM mainframe, this field
designates the JES SYSOUT class. In this case, type B.
FORM
(system-specific)
Specifies to the remote user the type of form that this report is
to be printed on. When sending to a VAX computer, leave this
field blank.
DISPOSITION Specifies what the remote system does with the report file
after the report has been printed. For report transfers only.
Not used if the remote system is an IBM mainframe.
Values are:
DELETE = Delete after printing
KEEP = Keep after printing
HOLD = Hold after printing
Using Unicenter CA-XCOM Data Transport 225
Using the Edit Transfer Windows
Field Definition
CONTROL Specifies the type of printer carriage control codes, if any that
are included in the report file.
Values are:
ASA = ASA control codes in column 1
IBM = IBM machine characters (IBM mainframe only)
OTHER = No carriage control codes
SPOOL Specifies whether the report is to be spooled to disk or printed
immediately. For report transfers only. If the remote system is
an IBM mainframe, this parameter has no effect on the
transfer.
HOLD Specifies whether a transferred report file is to be placed on
HOLD on the remote system or is to be printed immediately.
For report transfers only.
* EXPDT and RETPD are mutually exclusive. Choose one from the drop-down
box that shows EXPDT.
RECORD_FORMAT
This parameter specifies the record format of a data set created on an IBM
mainframe. This corresponds to the JCL RECFM subparameter. This field is
unique to the Edit Transfer - Send File window. The following table describes the
available options:

Value Description Record Length Comment
F Fixed
unblocked
The same length
as the data set

FA Fixed
unblocked
ANSI
The same length
as the data set
Contains ISO/ANSI/FIPS control
characters
FB Fixed blocked Fixed Fixed record length with multiple
records per block
FBA Fixed blocked
ANSI
Fixed Multiple records per block where
these records contain
ISO/ANSI/FIPS control characters
FBS Fixed blocked
spanned
Fixed Multiple records per block written
as standard blocks
226 User Guide
Using the Edit Transfer Windows
Value Description Record Length Comment
FM Fixed
unblocked
machine
The same length
as the data set
Contains machine code control
characters
FS Fixed
unblocked
spanned
The same length
as the data set
Written as standard blocks where
these records do not contain any
truncated blocks or unfilled tracks
U Undefined Undefined
V Variable
unblocked
Variable
VA Variable
unblocked
ANSI
Variable Contains ISO/ANSI/FIPS control
characters
VB Variable
blocked
Variable Multiple records per block
VBA Variable
blocked ANSI
Variable Multiple records per block where
these records contain
ISO/ANSI/FIPS control characters
VBM Variable
blocked
machine
Variable Multiple records per block where
these records contain machine code
control characters
VBS Variable
blocked
spanned
Variable May have multiple records per
block where these records can span
more than one block
VM Variable
unblocked
machine
Variable Contains machine code control
characters
VS Variable
unblocked
spanned
Variable A record can span more than one
block
Using Unicenter CA-XCOM Data Transport 227
Setting the Options on an Edit Transfer Window
Setting the Options on an Edit Transfer Window
Use the Options group box to set the options for particular transfers and to
access windows to control other options available from this panel.

228 User Guide
Setting the Options on an Edit Transfer Window
Modifying the Options Group
The options appear on the right side of each Edit Transfer window. Values for
encoding, maximum record length and truncation can be indicated directly in the
upper group boxes of this window. The options in the lower group can be
modified by clicking the associated pushbuttons or empty checkboxes to open
windows that allow you to modify these options. However, you do not have to
modify the values of any of these options unless you wish to change the default
values.
Encoding Options
The following table describes the options available from the drop down list in the
Encoding group box:

Menu Description
Encoding Lets you select the following options for file encoding for a transfer.
Setting the option here changes the values of the CODE_FLAG and
CARRIAGE_FLAG parameters as indicated here. Also shown is
whether the option applies to transfers using SNA or TCP/IP.
Option CODE_FLAG CARRIAGE_FLAG Applies To
ASCII ASCII NO SNA and TCP/IP
ASCII (Text) ASCII YES SNA only
ASCII (2K
Pack)
ASCII MPACK SNA only
ASCII (31K
Pack)
ASCII XPACK SNA and TCP/IP
BINARY Binary NO SNA and TCP/IP
BINARY
(VLR)
Binary VLR SNA and TCP/IP
EBCDIC EBCDIC NO SNA and TCP/IP
EBCDIC
(Text)
EBCDIC YES SNA only
EBCDIC (2K
Pack)
EBCDIC MPACK SNA only
EBCDIC (31K
Pack)
EBCDIC XPACK SNA and TCP/IP
Using Unicenter CA-XCOM Data Transport 229
Setting the Options on an Edit Transfer Window
Maximum Record Length Field
The following table describes the Max. Record Length field:

Field Description
Max. Record
Length
For Windows and UNIX systems, the locally initiating
Unicenter CA-XCOM Data Transport system determines the
values for MAXRECLEN, TRUNCATION, and LRECL, for
send and receive operations. When the local Unicenter CA-
XCOM Data Transport system initiates a transfer of a text
file, this parameter designates the length, in bytes, of the
largest record that can be transferred. If a record length is
longer than this value, Unicenter CA-XCOM Data Transport
uses the value in the TRUNCATION parameter on the
initiating side to determine whether to terminate the transfer
or to truncate the record and continue the transfer. When
Unicenter CA-XCOM Data Transport transfers binary files,
this value indicates the length of the records that are
transferred. On a receive operation, MAXRECLEN is set to
whatever the LRECL value is on the initiating side.
For transfers between Windows NT and UNIX systems
(where the LRECL value is not visible in the GUI on a receive
operation) the value of Max. Record Length is used to set the
LRECL value. That is, the Max. Record Length value
specified by the initiating system is sent to the remote
system, which uses this value to set its Max. Record Length
value.
CodeTable Option
Note: Before completing this field, you must know the one- to three-character
prefix for the user ASCII-to-EBCDIC and EBCDIC-to-ASCII conversion table
names (atoe.tab and etoa.tab) that reside in the Unicenter CA-XCOM Data
Transport convtab directory that will be used for the transfer.
The following table describes the CodeTable field:

Field Description
CodeTable The prefix to the file names, atoe.tab and etoa.tab,
containing the external ASCII-to-EBCDIC and EBCDIC-to-
ASCII custom character conversion tables that determine
which external translation tables will be used by the
transfer.
230 User Guide
Setting the Options on an Edit Transfer Window
Truncation Option
The following table describes the Truncate Records option:

Checkbox Description
Truncate Records Lets you specify if a record exceeding the maximum
record length should be truncated. To activate, click the
check box to display an X.
Procedure
To select an option in the lower group box of this panel, select a method for
modifying an option based on the following:

If the option checkbox
displays
Then
X Click the

pushbutton to access the window for modifying that
option.
No X Click in the checkbox to access the window for
modifying that option.
The appropriate option window is displayed. For more information, see the
descriptions of each option window.
Note: When the Protocol option is set for TCP/IP, the checkbox for the Version 2
option is not displayed.
Using Unicenter CA-XCOM Data Transport 231
Setting the Options on an Edit Transfer Window
Edit Transfer Window Options Summary
Use the following table to find information you are interested in for modifying
the values of the options listed in the lower portion of the Options group:

Option Function
Version 2 Checkpointing and Restarting Transfers
Specifying SNA/APPC or TCP/IP protocols
Specifying TCP/IP Port
Security Specifying User IDs, Passwords, domain name, and Trusted
Access authority for File Access
Local notify Notifying Local Users of Transfer Completion
Remote notify Notifying Remote Users of Transfer Completion
Compression Setting Compression Type for a Transfer
Indirect Sending an Indirect Transfer
Debugging Tracing
Schedule Scheduling Transfers
Secure Socket Specify whether to use secure sockets, and the path name of
the secure socket configuration file.
232 User Guide
Sending a File Using an Edit Transfer Window
Sending a File Using an Edit Transfer Window
Use the Edit Transfer window - Send File to specify options for a Send File
transfer.

Accessing the Send File Window
Access the Edit Transfer window - Send File from the main window when the
type of transfer selected is send file. The fields will contain the values defined in
the open configuration file or in XCOM.GLB.
Using standard Windows wildcard characters, Unicenter CA-XCOM Data
Transport for Windows can:
Receive multiple PDS members from a z/OS system, with each member
saved as a separate file
Transfer multiple directory members to another Windows system or PDS
members on a z/OS system
Using Unicenter CA-XCOM Data Transport 233
Sending a File Using an Edit Transfer Window
Considerations
Before completing this window, you must know the following:
Remote system
Local file
Remote file
File option
Remote systemtype
Maximum record length
Depending upon the remote system type, additional information may be
required. Obtain this information before completing the following procedure.
Procedure
To complete the required fields in the Send File window, follow these steps:
Note: For more information, see Using the Edit Transfer Windows earlier in this
chapter.
1. Type the name of the remote system and click in Local File. (Use wildcard
characters transferring more than one file in a library-type transfer.)
The name of the remote system is specified and the cursor is positioned in
the Local File field.
2. Type the name of the local file and click in Remote File. (Use wildcard
characters transferring more than one file in a library-type transfer to another
Windows system.)
The name of the local file is specified and the cursor is positioned in the
Remote File field.
3. Type the name of the remote file.
The name of the remote file is specified.
4. In the File option group, click the Create, Append, or Replace option button.
The selected option button is filled in and some additional fields may be
displayed.
5. In the Remote system type group, click the MVS/VM, Midrange, DOS/VSE,
or Other option button.
The selected option button is filled in, and some additional fields may be
displayed.
234 User Guide
Sending a Report Using an Edit Transfer Window
6. Select options and complete fields, as appropriate.
7. After all entries are complete, click the appropriate pushbutton at the bottom
of the window.
Sending a Report Using an Edit Transfer Window
Use the Edit Transfer window - Send Report to specify options for a Send Report
transfer.

Accessing the Send Report Window
Access the Edit Transfer window - Send Report from the main window when the
type of transfer selected is a send report. The fields will contain the values
defined in the open configuration file or XCOM.GLB.
Using Unicenter CA-XCOM Data Transport 235
Sending a Report Using an Edit Transfer Window
Considerations
Before completing this window, you must know the following:
Remote system
Local file
Destination printer
Maximum record length
Obtain this information before completing the following procedure.
Procedure
To complete the required fields in the Send Report window, follow these steps:
1. Type the name of the remote system and click in Local File.
The name of the remote system is specified and the cursor is positioned in
the Local File field.
2. Type the name of the local file and click in Destination Printer.
The name of the local file is specified and the cursor is positioned in the
Destination Printer field.
3. Type the name of the printer on the remote system and click in Report Title.
The name of the printer is specified and the cursor is positioned in the Report
Title field.
4. Type a name for the report and click in Copies.
The report title is specified and the cursor is positioned in the Copies field.
5. Type the number of copies desired and specify other information in
remaining fields as required for the printer on the remote system. For
information about specific requirements for each remote system, see the
chapter Remote System Information.
6. Select options and complete fields, as appropriate.
7. After all entries are complete, click the appropriate pushbutton at the bottom
of the window.
236 User Guide
Sending a Job Using an Edit Transfer Window
Sending a Job Using an Edit Transfer Window
Use the Edit Transfer window - Send Job to specify options for a send job
transfer.

Accessing the Send Job Window
Access the Edit Transfer window - Send Job from the main window when the
type of transfer selected is send job. The fields will contain the values defined in
the open configuration file or in XCOM.GLB.
Using Unicenter CA-XCOM Data Transport 237
Sending a Job Using an Edit Transfer Window
Considerations
Before completing this window, you must know the following:
Remote System
Local File
Maximum Record Length
Obtain this information before completing the following procedure.
Procedure
To complete the required fields in the Send Job window, follow these steps:
1. Type the name of the remote system and click in Local File.
The name of the remote system is specified and the cursor is positioned in
the Local File field.
2. Type the name of the local file.
The name of a local file is specified.
3. Select options and complete fields, as appropriate.
4. After all entries are complete, click the appropriate pushbutton at the bottom
of the window.
238 User Guide
Receiving a File Using an Edit Transfer Window
Receiving a File Using an Edit Transfer Window
Use the Edit Transfer window - Receive File to specify options for a receive file
transfer.

Accessing the Receive File Window
Access the Edit Transfer window - Receive File from the main window when the
type of transfer selected is receive file. The fields will contain the values defined
in the open configuration file or in XCOM.GLB.
Considerations
Before completing this window, you must know the following:
Remote System
Local File
Remote File
Using Unicenter CA-XCOM Data Transport 239
Receiving a File Using an Edit Transfer Window
File Option
Remote System Type
Maximum Record Length
Obtain this information before completing the following procedure.
Procedure
To complete the required fields in the Receive File window, follow these steps:
Note: For more information, see Using the Edit Transfer Windows earlier in this
chapter.
1. Type the name of the remote system and click in Remote File.
The name of the remote system is specified and the cursor is positioned in
the Remote File field.
2. Type the name of the remote file and click in Local File.
The name of the remote file is specified and the cursor is positioned in the
Local File field.
3. Type the name of the local file.
The name of the local file is specified.
4. In the File option group, click the Create, Append, or Replace option button.
The selected option button is filled in, and some additional fields may be
displayed.
5. In the Remote system type group, click the MVS/VM, VSE, or Other option
button.
The option is selected, and some additional fields may be displayed.
6. Select options and complete fields, as appropriate.
7. After all entries are complete, click the appropriate pushbutton at the bottom
of the window.
240 User Guide
Using the Version 2 WindowCheckpoint, Restart, Protocol, Port
Using the Version 2 WindowCheckpoint, Restart, Protocol,
Port
Use the Version 2 window to specify settings for checkpoint count, number of
retries and retry interval, and to specify settings for SNA/APPC or TCP/IP
protocols and TCP/IP port options, only when the remote system is running
Unicenter CA-XCOM Data Transport Version 2.

Accessing the Version 2 Window
Access the Version 2 window by clicking on the Version 2 pushbutton in an Edit
Transfer window or clicking in the associated empty checkbox.
Note: When the Protocol option is set for TCP/IP, the checkbox for the Version 2
option is not displayed.
If the partner Unicenter CA-XCOM Data Transport is Version 2, you can use
either Version 1 or Version 2 Unicenter CA-XCOM Data Transport protocols. If
the partner Unicenter CA-XCOM Data Transport is Version 1, you cannot use
Version 2 protocols. Since most partners use Version 2, use this unless you
encounter a problem.
If you want Unicenter CA-XCOM Data Transport to perform checkpointing and
to enable automatic restart, you must use Version 2 protocols.
For a detailed explanation of checkpointing and restarting, see Checkpointing
and Restarting Transfers in the chapter The Command Line Interface.
If you want Unicenter CA-XCOM Data Transport to perform transfers using
TCP/IP, you must use Version 2 protocols.
Using Unicenter CA-XCOM Data Transport 241
Using the Version 2 WindowCheckpoint, Restart, Protocol, Port
If you are performing a transfer that uses a protocol value for SNA/APPC or
TCP/IP that is different from the default value, you must select the appropriate
protocol option in the Version 2 window.
Note: If only the TCP/IP Component is installed with the base components of
Unicenter CA-XCOM Data Transport, the default value for the protocol is set for
TCP/IP.
If you are performing a TCP/IP transfer that requires a port value for the remote
system that is different from the default value, specify the value in the Port
option box in the Version 2 window.
For more information about SNA/APPC protocols and TCP/IP, see the chapter
The Command Line Interface.
Considerations
Before completing this window, to use checkpoint/restart features, you must
determine the checkpoint count, number of retries and retry interval that you
wish to use. Obtain this information before completing the Checkpoint/Restart
procedure.
If you are performing a transfer that uses a protocol value for SNA/APPC or
TCP/IP that is different from the default value, you must know which protocol
to use. If you are performing a TCP/IP transfer that requires a port value for the
remote system that is different from the default value, you must know that port
value. Note that the default value for Port should be valid for most remote hosts.
Obtain this information before completing the Protocol/Port procedure.
Procedure Checkpoint/Restart
To complete the required fields for checkpointing and restarting transfers, follow
these steps:
1. Type the checkpoint count and click in Number of retries.
The checkpoint count is specified and the cursor is positioned in the Number
of retries field.
2. Type the number of retries and click in Retry interval.
The number of retries is specified and the cursor is positioned in the Retry
interval field.
Note: The default value for Port should be valid for most remote hosts.
3. Type the interval of time for each retry and click OK.
The options are specified and the Edit Transfer window is displayed.
242 User Guide
Using the Version 2 WindowCheckpoint, Restart, Protocol, Port
Procedure Protocol/Port
To change the default values of protocol or port, or both, follow these steps:
1. Select the SNA/APPC option button for a transfer using SNA/APPC, or
select the TCP/IP option button for a transfer using TCP/IP.
The protocol is specified. If you selected TCP/IP, the Port option becomes
available.
Note: If the SNA/APPC option is selected, the Port option is dimmed, and is
unavailable.
2. If you are required to change the Port value for the remote system, specify
the port number in the Port option box.
The Port is specified for a TCP/IP transfer.
3. Click OK.
The options are specified and the Edit Transfer window is displayed.
Fields
The following table describes the Version 2 window field names:

Field Description
Checkpoint count Defines how often (based on record count) the sending
system requests a checkpoint to be taken. The value 0
indicates no checkpointing.
Number of retries Indicates the maximum number of retries before a transfer
is logged as failed. If the value is 0, the transfer will not be
retried.
Retry time The number of seconds between retries of unsuccessful
transfers. If the value is 0, the transfer is retried without
delay.
SNA/APPC If this option is selected, the transfer uses SNA/APPC
protocols.
TCP/IP If this option is selected, the transfer uses TCP/IP protocols.
Port This option box is available if the TCP/IP protocol option
is selected. This option is dimmed and is unavailable if the
SNA/APPC protocol option is selected. This is the default
value for the remote system. The default Port value is 8044.
This value should be valid for most remote hosts.
Using Unicenter CA-XCOM Data Transport 243
Specifying User IDs and Passwords for File Access
Pushbuttons
The following pushbuttons are available at the bottom of this window:

Button Function
OK Accept the specified parameters. The Edit Transfer window is
displayed.
Cancel Exit this window without accepting any specified parameters. The
Edit Transfer window is displayed.
Specifying User IDs and Passwords for File Access
Use the Security window to specify user IDs and passwords for accessing files on
remote systems and local systems.

244 User Guide
Specifying User IDs and Passwords for File Access
Accessing the Security Window
Access the Security window by clicking on the Security pushbutton in an Edit
Transfer window or clicking in the associated empty checkbox.
In general, a remote system requires a password and user ID, and NT may
require a domain name, before Unicenter CA-XCOM Data Transport can
perform transfers. The access rights of the user ID on the remote system
determine the actions permitted for the transfer. You can also specify whether
this remote system has trusted access to the local system, as defined by
permissions set by the Trusted Access application. If the Security checkbox is not
checked, the default security on the remote system will be in effect.
For Local file access, specify user ID and Password name for the following:
To access a file on a server that you are not already attached to
To access a file under a Username that is different from the one you used to
attach to the server
Access to Unicenter CA-XCOM Data Transport for Windows NT and associated
files is governed by the security policies that are in effect for your Windows
environment. Passwords are case sensitive.
Considerations
Before completing this window, you must know the following:
User ID on the remote system
Password on the remote system
User ID on the local system for file access (optional)
Password on the local system for file access (optional)
The Windows domain name for the local system (optional)
Whether the remote system has Trusted Access or not
Procedure
To complete the required security fields, follow these steps:
1. In the Remote system access group, enter the user ID on the remote system.
2. Enter the password of the user on the remote system.
3. Enter the domain name of the remote system.
4. If this is to be a trusted transfer, check the Trusted Transfer box.
Using Unicenter CA-XCOM Data Transport 245
Specifying User IDs and Passwords for File Access
5. In the Local file access group, enter the user ID of the user on the local
system.
6. Enter the password of the user on the local system and click OK.
7. Click OK.
Remote System Access Fields
The following table describes the Remote system access field names:

Field Description
User ID The user ID that the security system on the remote system checks
before granting access for the file transfer.
Password The password associated with the user ID on the remote system.
Domain The domain name of the remote system.
Trusted
Transfer
button
Specifies whether this transfer is a Trusted Transfer. See Setting Up
Trusted Access in the chapter Operating Environment in the
Unicenter CA-XCOM Data Transport for Windows NT
Server/Professional Administrator Guide and the online help.
Local File Access Fields
The following table describes the local system access field names:

Field Description
User ID The Username associated with the local file.
Password The password associated with the local file.
Pushbuttons
The following pushbuttons are available at the bottom of this window:

Button Function
OK Accept the specified parameters. The Edit Transfer window is
displayed.
Cancel Exit this window without accepting any specified parameters. The
Edit Transfer window is displayed.
246 User Guide
Notifying Local Users of Transfer Completion
Notifying Local Users of Transfer Completion
Use the Local Notify dialog to specify the local user who is to be notified that a
transfer has been sent or received. Also, use this dialog to specify how the local
user will be notified.

Accessing the Local Notify Dialog
Access the Local Notify dialog by clicking on the Local Notify pushbutton in an
Edit Transfer window or clicking in the associated empty checkbox. Choose a
type of notification from the drop-down list and then indicate the name of the
local user to be notified.
Considerations
Before completing the Local Notify dialog, you must know the Local User name
and the type of notification you wish to use.
Procedure
To complete the required fields in the Local Notify dialog, follow these steps:
1. Use the drop-down lists to select a method and level for notifying the local
user and click in Local User.
The notification method and level are specified and the cursor is positioned
in the Local User field.
2. Type the name of the local user to whom notification is to be sent and click
OK.
The name of the local user is specified and the Edit Transfer window is
displayed.
Using Unicenter CA-XCOM Data Transport 247
Notifying Local Users of Transfer Completion
Drop-down Lists
The following options are available on the drop-down list associated with the
Local Notify dialog. Use these options to set the local user notification level.

Option Function
ALL Notify on transfer completion.
WARN Notify only if the transfer received a warning or an error.
ERROR Notify only if the transfer received an error.
The following options are available on the drop-down list associated with the
Local Notify dialog. Use these options to set the type of local user notification.

Option Function
ALL Notify all users.
WRITE Write to the operator.
MAIL Mail to the user.
NONE Do not notify.
A MAIL message is sent to the specified user only if a MAPI-compliant provider
is configured as a non-domain account and/or allows local accounts (such as the
xcomd service and the local user ID) access to the Windows system (for example,
Microsoft Mail boxes and address books on the local system).
Note: Some Microsoft Outlook 2003 security updates may prevent mail
notification from working.
Field
The following field is associated with the Local Notify dialog:

Field Definition
Local User The user on the local system who is to be notified when Unicenter
CA-XCOM Data Transport completes a transfer.
For mail notification, enter the name of a person listed in the
address book on the local system. This name must be 12 characters
or less.
248 User Guide
Notifying Remote Users of Transfer Completion
Pushbuttons
The following pushbuttons are available at the bottom of the Local Notify dialog:

Button Function
OK Accept the specified parameters. The Edit Transfer window is
displayed.
Cancel Exit this dialog without accepting any specified parameters. The Edit
Transfer window is displayed.
Notifying Remote Users of Transfer Completion
Use the Remote Notify dialog to specify the remote user who is to be notified
that a transfer has been sent or received. Also, use this dialog to specify how the
remote user will be notified.

Accessing the Remote Notify Dialog
Access the Remote Notify dialog by clicking on the Remote Notify pushbutton in
an Edit Transfer window or clicking in the associated empty checkbox. Choose a
type of notification from the drop-down list and then indicate the name of the
remote user to be notified.
Considerations
Before completing this dialog, you must know the Remote User name and the
type of notification you wish to use.
Using Unicenter CA-XCOM Data Transport 249
Notifying Remote Users of Transfer Completion
Procedure
To complete the required fields in the Remote Notify dialog, follow these steps:
1. Use the drop-down list to select a method and level for notifying the remote
user and click in Remote User.
The notification method and level are specified and the cursor is positioned
in the Remote User field.
2. Type the name of the remote user to whom notification is to be sent and click
OK.
The name of the remote user is specified and the Edit Transfer window is
displayed.
Drop-down List
The following options are available on the drop-down list associated with the
Remote Notify dialog. Use these options to set the remote user notification level.

Option Function
ALL Notify on transfer completion.
WARN Notify only if the transfer received a warning or an error.
ERROR Notify only if the transfer received an error.
The following options are available on the drop-down list associated with the
Remote Notify dialog. Use these options to set the type of remote user
notification.

Option Function
MAIL Mail to the user.
WRITE Write to the operator.
ALL Notify all users.
TSO Notify specified TSO user.
WTO Write to log only (WTO).
ROSCOE Notify specified Advantage CA-Roscoe user.
CICS Notify CICS user (not used for Version 1 type transfers).
LU Notify Logical Unit (not used for Version 1 type transfers).
NONE Do not notify.
250 User Guide
Notifying Remote Users of Transfer Completion
A MAIL message is sent to the specified user only if a MAPI-compliant provider
is configured as a non-domain account and/or allows local accounts (such as the
xcomd service and the local user ID) access to the Windows system (for example,
Microsoft Mail boxes and address books on the local system).
Note: Some Microsoft Outlook 2003 security updates may prevent mail
notification from working.
Field
The following field is associated with the Remote Notify dialog:

Field Definition
NOTIFY_NAME The user on the remote system who is to be notified when
Unicenter CA-XCOM Data Transport completes a transfer.
For MAIL notification, enter the name of a person in the
address book on the remote system. This name must be 12
characters or less.
Note: If the remote system is an IBM mainframe, Unicenter CA-XCOM Data
Transport uses the value of NOTIFYR to determine the type of notification to
deliver.
Pushbuttons
The following pushbuttons are available at the bottom of the Remote Notify
dialog:

Button Function
OK Accept the specified parameters. The Edit Transfer window is
displayed.
Cancel Exit this window without accepting any specified parameters. The
Edit Transfer window is displayed.
Using Unicenter CA-XCOM Data Transport 251
Setting Compression Type for a Transfer
Setting Compression Type for a Transfer
Use the Compression window to define the compression type to be used on a
transfer for the remote system.

Accessing the Compression Window
Access the Compression window by clicking on the Compression pushbutton in
an Edit Transfer window or clicking in the associated empty checkbox. Choose
the type of compression from the drop-down list.
Considerations
Before completing this window, you must know the type of compression to set.
Obtain this information before completing the following procedure.
Procedure
To complete the required fields in the Compression window, use the drop-down
list to select the type of compression to be applied to this transfer and click OK.
The compression type is specified and the Edit Transfer window is displayed.
252 User Guide
Setting Compression Type for a Transfer
Drop-down List
The following options are available on the drop-down list associated with the
Compression window. Use these options to set the type of compression.
Note: All compression types are not supported on all platforms. For supported
compression types, see the partner platform documentation.

Option Function
NONE Indicates no compression.
BLANKS Indicates run length encoding of binary zeros and blanks only.
COMPACT RJE compaction algorithm optimized for uppercase English text.
LCOMPACT RJE compaction algorithm optimized for lowercase English text.
RLE Run length encoding.
LZRW3 General-purpose algorithm that runs fast and gives reasonable
compression.
LZSMALL Activates LZ compression to search back 4K in the data stream
for a matching string.
LZMEDIUM Activates LZ compression to search back 16K in the data stream
for a matching string.
LZLARGE Activates LZ compression to search back 32K in the data stream
for a matching string.
ZLIB Greater compression than LZRW3 but less than LZSMALL,
LZMEDIUM, and LZLARGE. Equivalent to ZLIB6.
ZLIB(n) Greater compression than LZRW3 but less than LZSMALL,
LZMEDIUM, and LZLARGE. The optional n value can be 1
through 9.
Pushbuttons
The following pushbuttons are available at the bottom of this window:

Button Function
OK Accept the specified parameters. The Edit Transfer window is
displayed.
Cancel Exit this window without accepting any specified parameters. The
Edit Transfer window is displayed.
Using Unicenter CA-XCOM Data Transport 253
Sending an Indirect Transfer
Sending an Indirect Transfer
Use the Indirect Transfer window to send a transfer to a remote system through
an intermediary z/OS or VSE system. This feature is not available for Receive
File transfers.

Accessing the Indirect Transfer Window
Access the Indirect Transfer window by clicking on the Indirect Transfer
pushbutton in an Edit Transfer window or clicking in the associated empty
checkbox. Indirect transfers are used to temporarily store a file on an IBM
mainframe system when the remote system is unavailable. For more information
about indirect transfers, see Using Store and Forward in the chapter The
Command Line Interface.
Considerations
Before completing this window, you must know the name of the intermediate
system. Obtain this information before completing the following procedure.
Procedure
To complete the required fields in the Indirect Transfer window, type the name
of the Intermediate System and click OK.
The name of the intermediate system is specified and the Edit Transfer window
is displayed.
254 User Guide
Setting System Environment VariablesReports Containing Machine Code Characters
Field
The following field is associated with the Indirect Transfer window:

Field Definition
Intermediate
System
For transfers using SNA/APPC, specifies the name of the CPI-C
Symbolic Destination Name on the intermediate destination.
For transfers using TCP/IP, specifies the IP address, host name,
or domain name of the intermediate destination.
If this value is not set or null, a direct connection to the remote
system is attempted.
Pushbuttons
The following pushbuttons are available at the bottom of this window:

Button Function
OK Accept the specified parameters. The Edit Transfer window is
displayed.
Cancel Exit this window without accepting any specified parameters. The
Edit Transfer window is displayed.
Setting System Environment VariablesReports Containing
Machine Code Characters
Unicenter CA-XCOM Data Transport processes machine code characters in
reports sent from the mainframe under two conditions:
CODE=MACHINE is specified for FILETYPE=REPORT
For a PSO report, the report is sent from a machine code data set such as an
FBM data set
For each line that begins with a recognizable printer channel command code,
Unicenter CA-XCOM Data Transport inserts the appropriate ASCII printer
control characters at the beginning of the line.
Using Unicenter CA-XCOM Data Transport 255
Setting System Environment VariablesReports Containing Machine Code Characters
All channel commands (that is, Skip to Channel, Write and Skip to Channel) are
translated to a form feed character (0C) followed by a specified number of
carriage return line feed pairs. If no variables are set, no carriage return line feed
pairs will be inserted. The number of carriage return line feed pairs inserted
depends upon the value of the corresponding system environment variable. To
set an environment variable on Win2000, right click on My Computer, select
Properties, then click on the Environment tab. Add the variables as system
variables and reboot the machine.
Important! For information about setting environment variables on Windows NT and
Windows XP, see your Windows documentation.
There is an associated variable for each channel command (24 variables in all).

For Set Variables
Skip to Channel 1-12 XCOM_SKCH1, XCOM_SKCH2 through
XCOM_SKCH12
Write and Skip to Channel
1-12
XCOM_WRSKCH1, XCOM_WRSKCH2 through
XCOM_WRSKCH12
To turn off automatic machine code processing for all reports, add a system
environment variable XCOM_MACH=NO.
Examples
To have Skip to Channel One to skip 1 line after the top of form, set
XCOM_SKCH1 equal to 1.
To have Write and Skip to Channel One to skip 3 lines after the top of form, set
XCOM_WRSKCH1 equal to 3.
256 User Guide
Debugging Problems and Tracing
Debugging Problems and Tracing
Use the Debugging window to set the trace level when requested by Unicenter
CA-XCOM Data Transport Technical Services.

Accessing the Debugging Window
Access the Debugging window by clicking on the Debugging pushbutton in an
Edit Transfer window or clicking in the associated empty checkbox. The trace
output is primarily intended to provide information to Unicenter CA-XCOM
Data Transport Technical Services, and they will usually request a level of
tracing for you to use. This trace facility collects information about a transfer
from the point where a transfer is queued or submitted and a connection is
established. The resulting trace data is stored in a file named tidnumber.TRA,
where tidnumber = the transfer ID. For information about additional tracing
facilities for Unicenter CA-XCOM Data Transport system level components, see
Trace Properties Tab Page later in this chapter.
Procedure
to complete the required fields in the debugging window, use the drop-down list
to select the trace level to be applied to this transfer and click OK.
The trace level is specified and the Edit Transfer window is displayed.
Drop-down List
The following options are available on the drop-down list associated with the
Debugging window. Use these options to set the level of desired execution
tracing.

Option Function
None None is the default
1 to 10 A range, where 1 is minimum, and 10 is maximum
Using Unicenter CA-XCOM Data Transport 257
Scheduling Transfers
Pushbuttons
The following pushbuttons are available at the bottom of this window:

Button Function
OK Accept the specified parameters. The Edit Transfer window is
displayed.
Cancel Exit this window without accepting any specified parameters. The
Edit Transfer window is displayed.
Scheduling Transfers
Use the Schedule window to set a specific time and date for a particular transfer.

Accessing the Schedule Window
Access the Schedule window by clicking on the Schedule pushbutton from an
Edit Transfer window or clicking in the associated empty checkbox. You can
specify a start time, a start date and a priority level. Transfers can be scheduled
to run independently of whether or not the specific user is logged on. A
scheduled transfer is under the control of the XCOMD Unicenter CA-XCOM
Scheduler Service.
258 User Guide
Scheduling Transfers
If XCOMD Unicenter CA-XCOM Scheduler Service is running, the user does not
have to be logged on for a scheduled transfer to be processed. That is, you can
schedule a transfer and log off, and it will run as scheduled. Likewise, a remotely
initiated transfer can be processed without the local user being logged on, as long
as the XCOMD Unicenter CA-XCOM Scheduler Service is running.
Note: If the Schedule option in the Options group box is selected, it is the
equivalent of setting the QUEUE parameter to QUEUE=YES. When the transfer
is submitted, the transfer request goes into a queue and executes depending on
the traffic in the queue and the values in START_DATE and START_TIME. If the
Schedule option in the Options group box is not checked, when the transfer is
submitted, it starts immediately. This may or may not affect the performance of
the transfer, depending on your settings.
Considerations
Before completing this window, you must know the following:
Date on which the transfer is to be sent
Time at which the transfer is to be sent
Obtain this information before completing the following procedure.
Procedure
To complete the required fields in the Schedule window, follow these steps:
1. In the Start Time group, click the spin buttons to select a start time for this
transfer.
The Start Time is selected.
2. In the Start Date group, click the spin buttons to select a start date for this
transfer.
The Start Date is selected.
3. Use the Priority drop-down list to select a high, normal, or low priority level
for this transfer and click OK.
The priority is selected and the Edit Transfer window is displayed.
Using Unicenter CA-XCOM Data Transport 259
Scheduling Transfers
Priority Menu Options
The following scheduling priority options are available on the drop-down list
associated with the Schedule window. Use these options to set the priorities for
Unicenter CA-XCOM Data Transports scheduling of transfers.

Option Function
High Set high priority.
Normal Set medium priority.
Low Set low priority.
If two transfers are scheduled for the same time, the one with the high priority
would be processed before one with a normal or low priority.
Fields
The following table describes the Schedule window field names:

Field Definition
Start Date Set a scheduled date for a particular transfer.
Start Time Set a scheduled time for a particular transfer.
Pushbuttons
The following pushbuttons are available at the bottom of this window:

Button Function
OK Accept the specified parameters. The Edit Transfer window is
displayed.
Cancel Exit this window without accepting any specified parameters. The
Edit Transfer window is displayed.
260 User Guide
Performing Secure Socket Transfers
Performing Secure Socket Transfers
Use the Secure Socket window to indicate whether the PROTOCOL=TCPIP
transfer will use a secure or non-secure socket.

Accessing the Secure Socket Window
Access the Secure Socket window by clicking on the Secure Socket pushbutton in
an Edit Transfer window or clicking in the associated empty checkbox. The
Secure Socket window specifies whether the PROTOCOL=TCPIP transfer uses
either a secure or non-secure socket.
The Secure Socket window also defines the Unicenter CA-XCOM Data Transport
secure socket configuration file.
Procedure
To complete the Secure Socket window, follow these steps:
1. Select the Secure Socket option for a PROTOCOL=TCP/IP transfer using
Secure Sockets or select the Non Secure Sockets option for a
PROTOCOL=TCP/IP transfer using Non Secure Sockets.
The Secure Socket option is specified.
2. Type the full path and file name of the Unicenter CA-XCOM Data Transport
secure socket configuration file.
The Secure Socket File path and name is specified.
3. Click OK.
The options are specified and the Edit Transfer window displays.
Using Unicenter CA-XCOM Data Transport 261
Browsing the Log File
Pushbuttons
The following pushbuttons are available in the Secure Socket window:

Button Function
OK Accepts the specified parameters. The Edit Transfer window
displays.
Cancel Exits this window without accepting any specified parameters.
The Edit Transfer window displays.
Browsing the Log File
Use the Log Browser window to display the Unicenter CA-XCOM Data
Transport log file. The log file collects a list of transfer information.

262 User Guide
Searching for Information in the Log
Accessing the Log Browser Window
Access the Log Browser window by clicking on the Log pushbutton on the
Unicenter CA-XCOM Data Transport main window. The Log Browser window is
for inquiry only and is used as the starting point to find and filter specific details
on transfers. Unicenter CA-XCOM Data Transport automatically collects and
stores information about transfers such as when a transfer was started, stopped,
completed, deleted, suspended, or aged off of the queue.
Procedure
To select the Find Window, click Find.
The Find window is displayed.
Pushbuttons
The following pushbuttons are available in this window:

Button Function
Find Open the Find window to search for specified expression. For
more information, see Searching for Information in the Log in
this chapter.
Close Close this window.
Searching for Information in the Log
Use the Find window to specify a particular text string to use when searching for
information about a transfer in the log file.

Using Unicenter CA-XCOM Data Transport 263
Searching for Information in the Log
Accessing the Find Window
Access the Find window by clicking on the Find pushbutton in the Log Browser
window. Use this window to search for a string specified in the Find field. This
string can be case sensitive and you can search forward or backward through the
Unicenter CA-XCOM Data Transport log file. The results are displayed on the
Log Browser. You can search for information such as time, date, Transfer ID and
error message text.
Procedure
To set search criteria, follow these steps:
1. Type an expression to search for in the Find field.
The expression is displayed in the Find field.
2. Indicate whether search is case sensitive by clicking in checkbox and click
Next or Previous.
The Log Browser window is displayed with an occurrence of the selected
search criteria.
Field
The following field is associated with the Find window:

Field Description
Find Lets you specify the expression to search on.
Checkbox
The following checkbox is associated with the Find window:

Option Description
Case sensitive search Lets you indicate whether the search should be case
sensitive.
264 User Guide
Viewing and Controlling Transfer Status
Pushbuttons
The following pushbuttons are available at the bottom of this window:

Button Function
Next Start a forward search.
Previous Start a backward search.
Close Close this window.
Viewing and Controlling Transfer Status
Use the Queue Status window to view the status of transfers and perform actions
on transfers. This window can be used while the transfer is in progress or after it
has been completed.

Using Unicenter CA-XCOM Data Transport 265
Viewing and Controlling Transfer Status
Accessing the Queue Status Window
Access the Queue Status window by clicking on the Queue Manager pushbutton
in the main window. From this window, authorized users can perform functions
on the queued transfers, such as viewing detailed information or deleting,
suspending and putting a transfer on hold. Use the drop-down lists in the menu
bar to specify the information to be displayed here, including Transfer ID, status,
results of the transfer, and other useful information. The size of each displayed
field can be customized by selecting the left or right border of the field title box
and dragging it left or right. You can also delete a field from the display by
selecting the field title box and dragging it off the field title bar. For detailed
information about a selected transfer from this window, see Viewing Transfer
Status Details later in this chapter.
Transfer Failure in Starting State
When a queued transfer is initiated, it is entered into the transfer queue. Then,
when it is scheduled to run, it goes into the starting state. If for some reason the
transfer fails to go beyond this state within 10 minutes and does not go into the
started state (where the transfer connection has been initialized and the transfer
of information begins), it is treated as a failure. The transfer is attempted again,
depending on the values in the Version 2 window for Number of retries and
Retry interval. The corresponding parameters are RESTART_SUPPORTED and
RETRY_TIME.
Procedure
To manage transfers listed on the Queue Status window, do one of the following:
Highlight a transfer on the list and click a pushbutton.
The Detail window is displayed or the appropriate action is taken.
Highlight a transfer on the list and select an action from a drop-down list.
The Queue Status window is displayed with the selected information.
266 User Guide
Viewing and Controlling Transfer Status
Menu Bar Selections
See the following table for Queue Status menu bar selections and explanations:

Selection Options
Fields Use the following options to specify which fields you want
displayed on the transfer list:
Field Description
User Name of the user.
TID Transfer ID.
Status Transfer status, for example, started, active, done.
Condition Result of a transfer, for example, failed, succeeded.
Start time Time the transfer started.
End time Time the transfer ended.
Local File Name of the local file.
Direction Symbol that indicates who initiated the transfer and
the direction of the transfer. See Queue Status
Direction Symbols below.
Partner Name of the remote system.
Remote file The name of the file on the remote system.
Message Displays informational and error messages.
Default Display the Queue Status with the default set of
fields.
Scope Use the following options to set the scope of the transfers displayed:
Selection Definition
User Display a list of all transfers by a user.
All Display a list of all transfers.
Using Unicenter CA-XCOM Data Transport 267
Viewing and Controlling Transfer Status
Pushbuttons
The following pushbuttons are available from this window:

Button Function
Details Open the Details window.
Delete Delete a transfer. When a transfer is active, the pushbutton
changes to CANCEL.
Suspend
Resume
Suspend allows you to suspend an active transfer.
Resume allows you to resume a suspended transfer.
Put on Hold
Release
Put on Hold allows you to hold a scheduled transfer.
Release allows you to release a held transfer.
Close Close this window.
Queue Status Direction Symbols
Refer to the following table for explanations of the symbols for transfers in the
Queue status window:

Symbol Description

Right arrow indicates a locally initiated send transfer.

Indicates a locally initiated receive transfer.

Left arrow indicates a remotely initiated receive transfer.

Indicates a remotely initiated send transfer.

268 User Guide
Viewing Transfer Status Details
Viewing Transfer Status Details
Use the Details window to view the status of a transfer while it is in progress and
after it has completed. This window is for inquiry only.

Accessing the Details Window
Access the Details window by clicking on the Details pushbutton in the Queue
Status window or by double-clicking the transfer. The detailed information
provided includes the transfer ID (TID) number, the remote system, the local and
remote file names, the start and end times of the transfer, and other statistics, as
well as informational messages.
Procedure
To view the Details window, highlight a transfer on the Queue Status transfer list
and click Details, or double-click the transfer.
If the transfer is in progress, the window displays changes as they occur. If the
transfer has been completed, the window displays final transfer information.
Using Unicenter CA-XCOM Data Transport 269
Using the Properties Dialog Pages
Fields
Refer to the following table for Details window field names and descriptions.
These fields are informational and cannot be updated. If you are viewing this
window while a send transfer is in progress, a status bar displays the transfers
incremental progress.

Field Displays
Start time An estimated time to execute the transfer.
End time The time that the transfer operation ended.
Bytes The number of bytes sent.
Bytes/sec The number of bytes per second since the beginning of the
transfer.
Records The number of records sent.
Records/sec The number of records per second since beginning of the
transfer.
TP status The status of the transfer.
Pushbutton
The following pushbutton is available at the bottom of this window:

Button Function
Close Close this window. The Queue Status window is displayed.
Using the Properties Dialog Pages
The Properties dialog pages are primarily for use by Unicenter CA-XCOM Data
Transport administrators and system administrators.
WARNING! The values of the options on the Properties dialog pages should only be
changed by authorized Unicenter CA-XCOM Data Transport administrators. Most
users will not need to change these values. The values should not be changed or deleted
unnecessarily. If any of these values are deleted unnecessarily, the results are
unpredictable.
270 User Guide
Using the Properties Dialog Pages
Use the Properties dialog pages to change global parameters from the GUI, if
necessary. Changes made to these system parameters affect the values in
XCOM.GLB and in the Windows Registry. While you can use an editor to modify
the XCOM.GLB file and the Registry directly, we recommend that you use the
Unicenter CA-XCOM Data Transport for Windows NT Properties dialog if you
need to modify the values for the more common global parameters.
Accessing the Properties Tab Pages
Access the Unicenter CA-XCOM Data Transport for Windows NT Properties
dialog from the Unicenter CA-XCOM Data Transport for Windows NT Main
window, by selecting the Tools menu, and then the Global parameters option to
display the Unicenter CA-XCOM Data Transport for Windows NT Properties
dialog.
At the top of the Properties dialog there are seven tabs. Click a tab to display a
tab page. The following table lists the tabs and the functions of their associated
tab pages. Each tab page is described in detail in the sections that follow.

Tab Page Function
Character Conversions For modifying default locations of character
conversion files, and modifying character conversion
options.
Incoming Transfers For modifying default options to use for incoming
transfers.
Queue For modifying default paths and file names for queue
information, modifying default queue options, and
maximum session entries.
Security For modifying default security information and
notification options.
System For modifying default paths and file names for
Unicenter CA-XCOM Data Transport system
commands.
TCP/IP For modifying default values of system parameters
used for TCP/IP transfers.
Trace For modifying default values and options for
Unicenter CA-XCOM Data Transport tracing facilities.
Using Unicenter CA-XCOM Data Transport 271
Using the Properties Dialog Pages
Considerations
For more information about the parameters and values that correspond to the
options on the Properties dialog pages, see the appendix List of Unicenter
CA-XCOM Data Transport Parameters. If the functions of the options on the
Properties dialog pages differ from the parameters or require clarification, they
are described here.
Procedure
To access a tab page, modify options, and apply them, follow these steps:
1. With the Properties dialog displayed, click a tab to display a tab page.
2. Modify values in the following ways:
Enter values into the option boxes.
Click a Browse button to select a path or file.
Click an option box or option button to select or deselect an option.
Click an arrow to display a drop down list, and click an item to select it.
3. After you have made the desired changes on the tab page, do one of the
following:
Click the OK button to accept the changes and close the Properties
dialog.
The appropriate global files are updated.
Click the Cancel button to cancel the changes and close the Properties
dialog.
No changes are made to the global files.
Click the Apply button to accept the changes and keep the tab page
displayed.
A message is displayed stating that you must recycle Unicenter
CA-XCOM Data Transport for the changes to take effect. Click OK. Then
a message is displayed indicating that the appropriate global files are
updated. (You still need to Stop and Start XCOMD Unicenter CA-XCOM
Scheduler Service for the changes to take effect.)
Note: Clicking Apply without making any changes has no effect.
Note: If you make changes to any of the options in the Properties dialog, you
must Stop and Start XCOMD Unicenter CA-XCOM Scheduler Service for the
changes to take effect.
272 User Guide
Using the Properties Dialog Pages
Character Conversions Properties Tab Page
Use the Character Conversions Properties tab page to modify the global default
values for the locations of character conversion files, and to modify character
conversion option defaults. For more information, see Creating Custom
Character Sets for File Conversion in the chapter The Command Line Interface.

Using Unicenter CA-XCOM Data Transport 273
Using the Properties Dialog Pages
Options
The following table describes the available options on the Character Conversion
Properties tab page, and their associated parameters.

Option Description
ATOE Filename ATOE_FILENAME
Click the Browse button to select a different file to use for
the default for ASCII to EBCDIC conversions. Note that
the directory dialog filters for .TAB files.
ETOA Filename ETOA_FILENAME
Click the Browse button to select a different file to use for
the default for EBCDIC to ASCII conversions. Note that
the directory dialog filters for .TAB files.
Convert Classes CONVERT_CLASSES
A character string containing print classes for which
EBCDIC to ASCII conversions will be performed. For
incoming report transfers only.
Internal Conversion
Table
INTERNAL_CONVERSION_TABLES
Indicates whether internal or external conversion tables
should be used for ASCII-to-EBCDIC conversion and
EBCDIC-to-ASCII conversion.
274 User Guide
Using the Properties Dialog Pages
Incoming Transfers Properties Tab Page
Use the Incoming Transfers Properties tab page to modify global default options
to use for incoming transfers.

Using Unicenter CA-XCOM Data Transport 275
Using the Properties Dialog Pages
Options
The following table describes the available options on the Incoming Transfers
Properties tab page, and their associated parameters.

Option Description
EOL Classes EOL_CLASSES
A character string containing print classes for
which an ASCII newline character will be
appended to each record. For incoming report
transfers only.
Metacode Classes METACODE_CLASSES
Classes of print jobs that will be saved in metacode
format, a variable length record format.
Create Directories CREATE_DIRECTORIES
Indicates whether a non-existent directory should
be created to accommodate incoming file transfers.
Remove Trail Blanks REMOVE_TRAIL_BLANKS
Indicates whether or not to remove the blanks at
the end of each record when receiving a text file.
Add EOF Marker WRITE_EOF
When receiving a text file, set to YES to have the
end of file character (CTRL + Z) written at the end
of the file.
276 User Guide
Using the Properties Dialog Pages
Queue Properties Tab Page
Use the Queue Properties tab page to modify global default options for queue
information, and for XCOM.SES.

Using Unicenter CA-XCOM Data Transport 277
Using the Properties Dialog Pages
Options
The following table describes the available options on the Queue Properties tab
page, and their associated parameters.

Option Description
Queue Path QUEUE_PATH
Click the Browse button to select a different default
path for transfer queue data files.
Sessions File SESSIONS_FILE
Click the Browse button to select a different default
path and file name for XCOM.SES. Note that the
directory dialog filters for .SES files.
Expiration Time EXPIRATION_TIME
The maximum time, in seconds, that a transaction is
held in the transfer queue after it is executed.
Max Queue Entries MAX_QUEUE_ENTRIES
The maximum number of entries allowed in the
transfer queue.
Max Sessions Entries MAX_SESSIONS_ENTRIES
The maximum number of partners that can be
described in the XCOM.SES file.
Age Time AGE_TIME
The maximum time, in seconds, that a transaction is
held in the transfer queue.
278 User Guide
Using the Properties Dialog Pages
Security Properties Tab Page
Use the Security Properties tab page to modify global default options for security
and notification.

Using Unicenter CA-XCOM Data Transport 279
Using the Properties Dialog Pages
Options
The following table describes the available options on the Security Properties tab
page, and their associated parameters.

Option Description
File Access Username FILE_ACCESS_USERNAME
Name of user accessing local files.
File Access Password FILE_ACCESS_PASSWORD
Password for access to local files.
Mail Username MAIL_USERNAME
If NOTIFYR is set to MAIL, specify a value here to
use for your messaging system profile name.
Mail Password MAIL_PASSWORD
If NOTIFYR is set to MAIL, specify a value here to
use for your messaging system profile password.
Xcom Userid XCOM_USERID
The default user ID for remotely initiated transfers.
Xcom Password XCOM_PASSWORD
The default password for remotely initiated
transfers.
Domain DOMAIN
The Windows domain name for use in authenticating
the user ID and password
280 User Guide
Using the Properties Dialog Pages
System Properties Tab Page
Use the System Properties tab page to modify global default options for paths
and file names for Unicenter CA-XCOM Data Transport system commands. For
more information about the .BAT files used as scripts for Unicenter CA-XCOM
Data Transport, see the chapter Operating Environment in the Unicenter
CA-XCOM Data Transport for Windows NT Server/Professional Administrator Guide.

Using Unicenter CA-XCOM Data Transport 281
Using the Properties Dialog Pages
Options
The following table describes the available options on the System Properties tab
page, and their associated parameters.

Option Description
Shell Cmd SHELL_CMD
Name of the command that runs jobs, reports, notification
scripts, and post processing scripts on the local system.
TempDir TEMPDIR
Click the Browse button to select a different default path
for the directory in which temporary files for jobs and
reports can be created.
Xlogfile XLOGFILE
Click the Browse button to select a different default file
name for the file where Unicenter CA-XCOM Data
Transport logs activity. Note that the directory dialog
filters for .LOG files.
Stat Frequency /
Transfer statistics
refresh in seconds
STAT_FREQUENCY
Indicates the frequency with which transfer statistics are
made available to XCOMQM and the GUI.
Daemon Timeout DAEMON_TIMEOUT
Number of minutes Unicenter CA-XCOM Data Transport
will wait for a response from a partner before aborting a
session.
Commands group Click the arrow to display a drop down list of executable
commands that can be used by Unicenter CA-XCOM Data
Transport (.BAT, .EXE). Select a command for which you
want to change the directory, or the name of the file or
command that is called by that command. Then see
Details, below. (The associated parameters and file names
are listed here.)
TCP_CMD Path and name of the Unicenter CA-XCOM Data
Transport program started by the XCOMD Unicenter
CA-XCOM Scheduler service that is used for transfers that
use TCP/IP protocols.
File: XCOMTCP.EXE
282 User Guide
Using the Properties Dialog Pages
Option Description
TP_CMD Path and name of the Unicenter CA-XCOM Data
Transport program started by the XCOMD Unicenter
CA-XCOM Scheduler service that is used for transfers
that use SNA/APPC protocols.
File: XCOMTP.EXE
XENDCMD The name of the post processing command optionally
invoked by the Unicenter CA-XCOM Data Transport
transfer program after any type of transfer is finished,
whether successful or not. Invoked after partner
communications have ended.
File: XCOMEND.BAT
Note: No default.
XLPCMD Name of the post-processing command used to send print
jobs to the spooler.
File: XCOMLP.BAT
XNOTIFYCMD Path name of the command that Unicenter CA-XCOM
Data Transport will use to notify users on the local system
of the completion of a transfer.
File: XCOMNTFY.BAT
XPPCMD The name of the command used for user-defined post-
processing.
File: XCOMPP.BAT
Details The default directory and file name of the selected
command is displayed in the Details option box. Click the
Browse button to select a different directory or file, or
both, to be called by the selected command.
Note: The directory dialog filters for .BAT or .EXE files.
Using Unicenter CA-XCOM Data Transport 283
Using the Properties Dialog Pages
TCP/IP Properties Tab Page
Use the TCP/IP Properties tab page to modify global default options for system
values used for TCP/IP transfers.

284 User Guide
Using the Properties Dialog Pages
Options
The following table describes the available options on the TCP/IP Properties tab
page, and their associated parameters.

Option Description
Executable Program
Path
Default path where Unicenter CA-XCOM Data
Transport executable programs should reside, as
defined in the Registry.
Client Transfer Settings
group
The options in the Client Transfer Settings group are
used to specify default values for using TCP/IP,
including for tuning and performance. Do not change
the default settings unnecessarily.
Port
Number
PORT
The number of the TCP/IP port on the remote
Unicenter CA-XCOM Data Transport server. The
default should be valid for most remote systems.
Sock Rcv
Bufsize
SOCK_RCV_BUF_SIZE
TCP/IP Socket option SO_RCVBUF. The buffer size for
receives.
Sock Send
Bufsize
SOCK_SEND_BUF_SIZE
TCP/IP Socket option SO_SNDBUF. The buffer size for
sends.
Sock Delay SOCK_DELAY
TCP/IP Socket option TCP_NODELAY. Refers to the
Nagle algorithm for send coalescing.
Txpi Term
Timeout
TXPI_TERM_TIMEOUT
Maximum wait time, in seconds, for partner to
terminate TCP/IP communications.
Txpi Rcv
Timeout
TXPI_RECEIVE_TIMEOUT
Maximum wait time, in seconds, after a TCP/IP failure
is detected before a socket error is generated.
Txpi Buf
Size
TXPI_BUF_SIZE
For TCP/IP transfers, the internal buffer size for sends
and receives.
Using Unicenter CA-XCOM Data Transport 285
Using the Properties Dialog Pages
Option Description
Txpi Send
Check Freq
TXPI_SEND_CHECK_FREQ
Indicates the frequency that Unicenter CA-XCOM Data
Transport checks to see if incoming error information is
available when sending data
Server Settings group The options in the Server Settings group are used to
specify default values for the Unicenter CA-XCOM
Data Transport communications server. They affect
how the server functions for setting up the
environment for receiving clients, server termination,
and other functions. Values here are defined in the
Registry.
Port Number The port number for the local machine. The default
should be valid for most local systems.
Maximum
Clients
The maximum number of concurrent client
connections.
Termination
Loop
Indicates how often the caxcgsvr listener process waits
before terminating threads during XCOMD Unicenter
CA-XCOM Scheduler service shutdown.
Termination
Delay
Indicates how long the caxcgsvr listener process waits
before terminating threads during XCOMD Unicenter
CA-XCOM Scheduler service shutdown.
WARNING! Do not change these values unless you are
requested to do so by Computer Associates Customer
Support.
Protocol Setting
PROTOCOL The type of communication protocols to use.
Implicit Packing
Setting

IMPLICIT_
PACKING
Indicates whether TCP/IP should always use packing.
286 User Guide
Using the Properties Dialog Pages
Option Description
Secure Socket Server
Settings Group

SSL Port
Number
Specifies the number of the SSL port on the local
Unicenter CA-XCOM Data Transport server.
Secure Socket
File
XCOM_CONFIG_SSL
Specifies the value of the configssl.cnf file and file
name.
Display
Cipher in
Queue Details
XCOM_SHOW_CIPHER
Specifies whether to display encryption algorithms in
the Unicenter CA-XCOM Data Transport queue
detailed information, which is used for transfers.
Using Unicenter CA-XCOM Data Transport 287
Using the Properties Dialog Pages
Trace Properties Tab Page
Use the Trace Properties tab page to modify global default options for Unicenter
CA-XCOM Data Transport tracing facilities.

Note: You must enable tracing to cause a trace file to be created. To enable
tracing, go to the directory where Unicenter CA-XCOM Data Transport is
installed and enter the following command at the prompt:
card3 on
If this is not done, a trace file will not be created.
288 User Guide
Using the Properties Dialog Pages
To disable tracing, go to the directory where Unicenter CA-XCOM Data
Transport is installed and enter the following command at the prompt:
card3 off
For information about how to trace the XCOMD Scheduler Service, see Tracing
the Unicenter CA-XCOM Data Transport Scheduler Services in the Unicenter
CA-XCOM Data Transport for Windows NT Server/Professional Administrator Guide.
Options
The following table describes the available options on the Trace Properties tab
page, and their associated parameters.

Option Description
Xtrace Trace level XTRACE
Used to set the default tracing level to trace the activity of an
Unicenter CA-XCOM Data Transport transfer from the point
when a transfer is queued or submitted.
Debug Flag DEBUG_FLAG
Indicates whether to print trace data to STDERR.
System Level
group
Use these options to set tracing for system level components.
These options are used for initial tracing, to trace activity up
to the point where Unicenter CA-XCOM Data Transport has
resolved all parameters but before a connection is established
with a remote system.
Component Click the arrow to display a list of Unicenter CA-XCOM Data
Transport system level components that can be traced. Select
a component that you wish to trace.
Component
Trace File
Click the Browse button to select a different default path and
file name for the trace data for the component selected in the
Component option box. Note that the directory dialog filters
for .TRC files.
Trace Off
Trace On
Trace Detail
Click to turn tracing off.
Click to turn tracing on.
Click to view trace details.
Using Unicenter CA-XCOM Data Transport 289
Using the Properties Dialog Pages
Option Description
Trace Path TRACE_PATH
Click the Browse button to select a different default path for
trace data.
Trace data files have the following naming conventions:
tidnumber.TRAA trace file for a particular transfer.
tidnumber= The transfer ID.
TRACE.TRCA trace file for a selected Unicenter
CA-XCOM Data Transport component.
Note: Setting trace options may generate large files of trace data and
significantly impact performance.

290 User Guide

Chapter
3
The Command Line Interface

The command line interface allows you to enter commands at the Windows
command prompt to control Unicenter CA-XCOM Data Transport. All Unicenter
CA-XCOM Data Transport commands follow the conventional rules and
grammar of the Windows command language.
Command Prompt
To understand the use of parameters before using the commands in this chapter,
see File Name, Path, and Directory Considerations in the chapter Using
Unicenter CA-XCOM Data Transport. In addition, you should be aware of the
following:
The XCOMD Unicenter CA-XCOM Scheduler service must be running
before you can do any transfers.
To edit configuration files, you need the appropriate user rights to read and
write to those files.
To send a transfer using the command prompt, you need the appropriate
user rights to execute XCOM62 or XCOMTCP.
To specify a path name that contains a blank or special character, put double
quotes ( ) around it.
Using Configuration Files
Use configuration files to set default parameters for Unicenter CA-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.
The Command Line Interface 31
Using Configuration Files
Configuration Files
Unicenter CA-XCOM Data Transport reads the parameter file XCOM.CNF or a
user specified configuration file, and parameters specified at the command
prompt, and executes the specified file transfer.
Unicenter CA-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. You may, however, write new configuration files of your own
to use for transfers.
For each transfer, Unicenter CA-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, Unicenter CA-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 Unicenter CA-XCOM Data Transport program defaults.
Parameters defined in XCOM.GLB at the time the XCOMD Unicenter
CA-XCOM Scheduler service was started.
Parameters defined in a user-created configuration file 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
C:\XCOMNT\CONFIG\XCOM.CNF is used.
Parameters defined in the command prompt following the -f option.
Note: If you specify another configuration file at the command prompt, using
the -f option, then parameters from this file will be used instead of XCOM.CNF.
Creating Configuration Files from the Command Prompt
To create configuration files of your own for different types of transfers, follow
these steps:
1. From the Windows command prompt, enter the following:
CD C:\XCOMNT\CONFIG
This brings you to the default directory where Unicenter CA-XCOM Data
Transport configuration files are stored and makes it the current directory.
32 User Guide
Using Configuration Files
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 Unicenter CA-XCOM Data Transport. The
default directory is C:\XCOMNT. If you put the configuration file in another
directory, you must specify the full path name when referring to it. For
example, C:\XCOMNT\FILENAME.CNF.
To specify a path name that contains a blank or special character, put double
quotes ( ) around it. For example:
"c:\xcomnt 32\config\myconfig.cnf"
or
"%XCOM_HOME%\config\myconfig.cnf "
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 Unicenter 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 Unicenter 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 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 Unicenter CA-XCOM Data Transport.
The Command Line Interface 33
Transferring Files
Example 1
In the following example, Unicenter 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
Transferring 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
Transferring Files
Use XCOM62 or XCOMTCP to initiate file transfers from the command prompt.
Use XCOM62 for transfers that use SNA/APPC protocols.
Use XCOMTCP for transfers that use TCP/IP protocols.
Specifying Protocols
When using the XCOM62 or XCOMTCP commands, the choice of protocol to use
is indicated by the PROTOCOL parameter. This can be specified at the command
line, in a configuration file, or in the XCOM.GLB file, depending upon your
installations needs. If the protocol is not specified at the command line, the
defaults specified in the configuration file or in XCOM.GLB are used.
34 User Guide
Transferring Files
XCOM62
For performing transfers using SNA/APPC protocols, XCOM62 allows you to
initiate the transfer of a file, a job or a report from the command prompt, and to
specify the parameters to be used for that transfer. You need the appropriate
user rights and abilities to run XCOM62.
XCOMTCP
For performing transfers using TCP/IP, XCOMTCP allows you to initiate the
transfer of a file, a job or a report from the command prompt, and to specify the
parameters to be used for that transfer. You need the appropriate user rights and
abilities to run XCOMTCP.
Multiple Transfers
You may initiate multiple transfers from the command prompt, and by defining
them in configuration files and in scripts, by using the NEWXFER option of the
CONTROL parameter. For information about the CONTROL parameter, see the
appendix Unicenter CA-XCOM Data Transport Parameters.
You can use either XCOM62 or XCOMTCP to queue multiple transfers.
Note: You cannot use XCOM62 and XCOMTCP together on the same command
line.
Wildcard Characters
Unicenter CA-XCOM Data Transport supports the transfer of files using
wildcard characters.
Syntax
The syntax for using XCOM62 and XCOMTCP is identical, except for the choice
of command. The syntax for each is shown below.
Syntax for XCOM62
The syntax for using XCOM62 is as follows:
XCOM62 [-cNUMBER] [OPTION] [-f [CONFIGFILENAME][PARAMETER_NAME=VALUE ...] ]
The Command Line Interface 35
Transferring Files
Syntax for XCOMTCP
The syntax for using XCOMTCP is as follows:
XCOMTCP [-cNUMBER] [OPTION] [-f [CONFIGFILENAME][PARAMETER_NAME=VALUE ...] ]
Notes On Using Options
When Unicenter CA-XCOM Data Transport 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 prompt.
Options
The following table explains the options available for XCOM62 and XCOMTCP:

Option Explanation
-cNUMBER
The type of transfer to be attempted. Valid values for
NUMBER are:

Value Description

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.
-h
Unicenter CA-XCOM Data Transport displays help.
The usage message is displayed and XCOM62 or
XCOMTCP exits.
Note: All other options are ignored.
-r
Unicenter CA-XCOM Data Transport displays the
release level. The release level of the software is
displayed and XCOM62 or XCOMTCP exits.
-q
Unicenter CA-XCOM Data Transport queues the
transfer. This option works like the QUEUE=YES
parameter in XCOM.CNF.
-s
Unicenter CA-XCOM Data Transport sets silent mode,
which turns off all output to STDERR.
-t
Unicenter CA-XCOM Data Transport sends trace
output to the command prompt window (the standard
error output).
36 User Guide
Transferring Files
Option Explanation
-i
Unicenter CA-XCOM Data Transport ignores
configuration errors.
-f CONFIGFILENAME
Unicenter 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: While you can have Unicenter CA-XCOM Data
Transport read parameters from a file as well as from
the command prompt, the parameters on the command
prompt 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...
You can also set parameters on the command prompt.
The syntax is as follows:
PARAMETER1=VALUE PARAMETER2=VALUE
Each parameter value must be in uppercase.
Note: Parameters entered on the command prompt
take precedence over those in the parameter file.
no options
If you invoke Unicenter CA-XCOM Data Transport
without options, the defaults that are in XCOM.CNF
are used for the transfer.
The Command Line Interface 37
Transferring Files Using SNA/APPC Protocols
Transferring Files Using SNA/APPC Protocols
Use the information below as examples when performing transfers that use
SNA/APPC protocols.
Note: The syntax and options for using XCOM62 are identical to those for
XCOMTCP. For a description, see Transferring Files earlier in this chapter.
Using SNA/APPC Protocols
Your computer and the remote Unicenter CA-XCOM Data Transport system
must be configured for the appropriate SNA/APPC for you to use SNA/APPC
protocols with Unicenter CA-XCOM Data Transport.
The choice of protocol to use is indicated by the PROTOCOL parameter. This can
be specified at the command line, in a configuration file, or in the XCOM.GLB
file, depending upon your installations needs. If the protocol is not specified at
the command line, the defaults specified in the configuration file or in
XCOM.GLB are used.
For further information about your platforms SNA/APPC configuration, see
your Unicenter CA-XCOM Data Transport Getting Started and the SNA/APPC
vendor documentation.
Note: For Windows, the remote system names in the following examples are the
symbolic destination names from the CPI-C side information record.
Example 1
In the following example, the XCOM62 command is used to queue a file for a
send file transfer, using SNA/APPC protocols. The configuration file is
MYCONFIG.CNF, the local file is named TESTA.AAA, and the remote file is
named TESTB.BBB. The remote system is indicated by the value XCOMDEVT2
in the REMOTE_SYSTEM parameter. QUEUE is set to YES, so the transfer is
queued. The protocol is determined by the value of the PROTOCOL parameter
in the XCOM.GLB file, which should be set to SNA for an SNA/APPC transfer.
XCOM62 -c1 -f MYCONFIG.CNF LOCAL_FILE=TESTA.AAA REMOTE_FILE=TESTB.BBB
REMOTE_SYSTEM=XCOMDEVT2
QUEUE=YES
Note: The example above appears on more than one line here but is to be typed
at the command prompt as a continuous command. Press Enter only after you
have typed in all of your command information.
38 User Guide
Transferring Files Using TCP/IP Protocols
Example 2
In the following example, the XCOM62 command is used to send a file directly,
without sending it to the queue, using SNA/APPC protocols. The configuration
file is MYCONFIG.CNF, the local file is named TESTA.AAA, and the remote file
is named TESTB.BBB. The remote system is indicated by the value XCOMDEVT2
in the REMOTE_SYSTEM parameter. QUEUE is set to NO, so the transfer starts
immediately after you press Enter. The choice of protocols is indicated by the
value SNA in the PROTOCOL parameter. (If the default value in the
configuration file or the XCOM.GLB file is SNA, you do not need to specify this
value here.)
XCOM62 -c1 -f MYCONFIG.CNF LOCAL_FILE=TESTA.AAA REMOTE_FILE=TESTB.BBB
REMOTE_SYSTEM=XCOMDEVT2
QUEUE=NO PROTOCOL=SNA
Note: The example above appears on more than one line here but is to be typed
at the command prompt as a continuous command. Press Enter only after you
have typed in all of your command information.
Transferring Files Using TCP/IP Protocols
Use IP addresses, host names, or domain names when performing transfers that
use TCP/IP protocols.
Note: The syntax and options for using XCOMTCP are identical to those for
XCOM62. For a description, see Transferring Files earlier in this chapter.
Using IP Addresses and Names
Your computer and the remote Unicenter CA-XCOM Data Transport system
must be configured for TCP/IP for you to use TCP/IP protocols with Unicenter
CA-XCOM Data Transport.
Before performing a file transfer, you must know the IP address, the host name,
or the domain name of the remote system. Check with the network administrator
of the remote system for these values.
If your computer is not configured for TCP/IP, check with your network
administrator, and refer to the Microsoft Windows documentation for further
information.
The Command Line Interface 39
Transferring Files Using TCP/IP Protocols
The formats of the IP address, host name, and domain name are described in the
following table:

Value Description
IP address A unique number for a particular computer, used to
identify the computer on the TCP/IP network. IP
addresses are in the dotted decimal notation format.
Example:
123.123.78.91
Host Name The host name of a particular computer.
Example:
GOODSYS
Domain Name The Domain Name Service (DNS) name. Identifies the
computers group in the DNS hierarchy. The host name
and the domain name make up the fully qualified domain
name of the computer.
Example:
GOODSYS.GOODSITE.COM
GOODSYS is the name of the computer, and it is in the
GOODSITE.COM domain.
Specifying the Remote System
When using TCP/IP, the remote system can be specified in different ways. For
example, you can use the following forms:
By host name:
REMOTE_SYSTEM=GOODSYS
By fully qualified domain name:
REMOTE_SYSTEM=GOODSYS.GOODSITE.COM
By IP address:
REMOTE_SYSTEM=123.123.78.91
Using the IP address is the most efficient method to use when specifying a
remote system location.
310 User Guide
Transferring Files Using TCP/IP Protocols
Note: The examples above use the REMOTE_SYSTEM parameter, but the usage
applies to REMOTE_SYSTEM_RF, REMOTE_SYSTEM_SJ, and
REMOTE_SYSTEM_SR also.
TCP/IP Name Resolution
If you use a host name or domain name, your system must have a way to resolve
that name to an IP address.
You can use any symbolic name that can be mapped to an IP address, such as a
host name or a domain name. Your system must be set up to resolve the name to
an IP address. Check with your network administrator for further information
about your systems use of names.
If you are relying on name resolution to resolve names to IP addresses, this
capability must be installed and configured on your system. There are many
ways to implement name resolution, including the Domain Name Service (DNS),
and the use of host files.
For more information about name resolution, see the Microsoft System Guide for
your operating system.
Using TCP/IP Protocols with Unicenter CA-XCOM Data Transport
If you want to use TCP/IP protocols for a Unicenter CA-XCOM Data Transport
transfer, Unicenter CA-XCOM Data Transport must have the port specification
for the remote system and an indication that you wish to use TCP/IP protocols.
The port is specified by the PORT parameter. The default value in the
XCOM.GLB file should be valid for most remote hosts.
If you need to change the port value of the local system, see the chapter Using
Unicenter CA-XCOM Data Transport.
The choice of protocol to use is indicated by the PROTOCOL parameter. This can
be specified at the command line, in a configuration file, or in the XCOM.GLB
file, depending upon your installations needs. If the protocol is not specified at
the command line, the defaults specified in the configuration file or in
XCOM.GLB are used.
The Command Line Interface 311
Transferring Files Using TCP/IP Protocols
In addition, Unicenter CA-XCOM Data Transport uses other parameters for
TCP/IP functionality. These parameters will be of interest to system
administrators for tuning and performance considerations. For more
information, see the chapter Configuring Unicenter CA-XCOM Data Transport
in the Unicenter CA-XCOM Data Transport for Windows NT Server/Professional
Administrator Guide. These parameters are also listed in the appendix Unicenter
CA-XCOM Data Transport Parameters.
Example 1
In the following example, the XCOMTCP command is used to queue a file for a
send file transfer, using TCP/IP. The configuration file is MYCONFIG.CNF, the
local file is named TESTA.AAA, and the remote file is named TESTB.BBB. The
remote system is indicated by the host name GOODSYS in the
REMOTE_SYSTEM parameter. QUEUE is set to YES, so the transfer is queued.
TCP/IP is indicated by the value TCPIP in the PROTOCOL parameter. The port
is determined by the value of the PORT parameter in the XCOM.GLB file.
XCOMTCP -c1 -f MYCONFIG.CNF LOCAL_FILE=TESTA.AAA REMOTE_FILE=TESTB.BBB
REMOTE_SYSTEM=GOODSYS QUEUE=YES PROTOCOL=TCPIP
Note: The example above appears on more than one line here but is to be typed
at the command prompt as a continuous command. Press Enter only after you
have typed in all of your command information.
Example 2
In the following example, the XCOMTCP command is used to submit a transfer
directly, without sending it to the queue, using TCP/IP. The configuration file is
MYCONFIG.CNF, the local file is named TESTA.AAA, and the remote file is
named TESTB.BBB. The remote system is indicated by the fully qualified domain
name GOODSYS.GOODSITE.COM in the REMOTE_SYSTEM parameter.
QUEUE is set to NO, so the transfer starts immediately after you press Enter.
TCP/IP is indicated by the value TCPIP in the PROTOCOL parameter. (If the
default value in the configuration file or the XCOM.GLB file is TCPIP, you do
not need to specify this value here.) The port is indicated by the value 8044 in the
PORT parameter. (Note that the default value of PORT should be valid for most
hosts, and you should only specify a value for this parameter when needed.)
XCOMTCP -c1 -f MYCONFIG.CNF LOCAL_FILE=TESTA.AAA REMOTE_FILE=TESTB.BBB
REMOTE_SYSTEM=GOODSYS.GOODSITE.COM QUEUE=NO PROTOCOL=TCPIP PORT=8044
Note: The example above appears on more than one line here but is to be typed
at the command prompt as a continuous command. Press Enter only after you
have typed in all of your command information.
312 User Guide
Setting Communications Parameters
PROTOCOL
The type of communication protocols to use.
Range The range of values is listed in the following table.

Value Description
SNA For transfers using SNA/APPC communication protocols
TCPIP For transfers using TCP/IP communication protocols
Default SNA
Note: If only the TCP/IP Component is installed with the base components of
Unicenter CA-XCOM Data Transport, the default value is TCPIP.
Setting Communications Parameters
Use the following parameters in the XCOM.CNF file or in any Unicenter
CA-XCOM Data Transport configuration files to configure Unicenter CA-XCOM
Data Transport communication parameters and data transfer characteristics.
These parameters do not change for the different types of file transfers. We
recommend modifying these values in XCOM.CNF during the initial
configuration of Unicenter CA-XCOM Data Transport.
Communications and Data Transfer Parameters
Most of these parameters are general communications parameters used to
configure the communications addressing for the systems involved in transfers.
However, the COMPRESS, MAXRECLEN, TRUNCATION and VERSION
parameters are used to specify the data transfer attributes for specific transfers.
The Command Line Interface 313
Setting Communications Parameters
Parameters
The communications and data transfer configuration parameters are listed
below.
CODETABL
Specifies the prefix to the file names, atoe.tab and etoa.tab, that contain the
external ASCII-to-EBCDIC and EBCDIC-to-ASCII custom character conversion
tables. These custom character conversion tables determine which external
translation tables will be used by the transfer.
This parameter is valid only if INTERNAL_CONVERSION_TABLES=NO.
Range 1 to 3 characters
Default None
COMPRESS
Indicates the compression type. When communicating with an IBM mainframe,
if the data file contains any empty records or lines, COMPRESS must be set to
YES.
Note: All compression types are not supported on all platforms. For supported
compression types, see the partner platform documentation.
Range The range of values is listed in the following table.

Value Description
COMPACT RJE compaction algorithm optimized for uppercase English
text.
LCOMPACT RJE compaction algorithm optimized for lowercase English
text.
LZLARGE Activates LZ compression to search back 32K in the data
stream for a matching string.
LZMEDIUM Activates LZ compression to search back 16K in the
DataStream for a matching string.
LZRW3 General-purpose algorithm that runs fast and gives reasonable
compression.
LZSMALL Activates LZ compression to search back 4K in the DataStream
for a matching string.
314 User Guide
Setting Communications Parameters
Value Description
NO Indicates no compression.
RLE Run length encoding.
YES Indicates run length encoding of binary zeros and blanks only.
ZLIB Greater compression than LZRW3 but less than LZSMALL,
LZMEDIUM, and LZLARGE. Equivalent to ZLIB6.
ZLIB(n) Greater compression than LZRW3 but less than LZSMALL,
LZMEDIUM, and LZLARGE. The optional n value can be 1
through 9.
Note: The LZ values enable LZ (Lempel-Ziv) compression to replace sequences
of data bytes that occur more than once in a DataStream with a code value.
Default YES
MAXRECLEN
For Windows and UNIX systems, the locally initiating Unicenter CA-XCOM
Data Transport system determines the values for MAXRECLEN, TRUNCATION,
and LRECL, for send and receive operations. When the local Unicenter
CA-XCOM Data Transport system initiates a transfer of a text file, this parameter
designates the length, in bytes, of the largest record that can be transferred. If a
record length is longer than this value, Unicenter CA-XCOM Data Transport
uses the value in the TRUNCATION parameter on the initiating side to
determine whether to terminate the transfer or to truncate the record and
continue the transfer. When Unicenter CA-XCOM Data Transport transfers
binary files, this value indicates the length of the records that are transferred. On
a receive operation, MAXRECLEN is set to whatever the LRECL value is on the
initiating side.
Range 1 to 32767
Default 1024
REMOTE_SYSTEM
The name of the remote system that receives a file, job or report.
For SNA/APPC protocols, the name is the symbolic destination name from the
CPI-C side information record.
For TCP/IP protocols, the value can be the remote systems IP address, host
name, or domain name.
The Command Line Interface 315
Setting Communications Parameters
Range 1 to 256 characters
Default None
REMOTE_SYSTEM_RF
The name of the remote system that sends a file on a receive file operation.
For SNA/APPC protocols, the name is the symbolic destination name from the
CPI-C side information record.
For TCP/IP protocols, the value can be the remote systems IP address, host
name, or domain name.
Range 1 to 256 characters
Default None
REMOTE_SYSTEM_SJ
The name of the remote system to which a job is sent.
For SNA/APPC protocols, the name is the symbolic destination name from the
CPI-C side information record.
For TCP/IP protocols, the value can be the remote systems IP address, host
name, or domain name.
Range 1 to 256 characters
Default None
REMOTE_SYSTEM_SR
The name of the remote system to which a report is sent.
For SNA/APPC protocols, the name is the symbolic destination name from the
CPI-C side information record.
For TCP/IP protocols, the value can be the remote systems IP address, host
name, or domain name.
Range 1 to 256 characters
Default None
316 User Guide
Using the Send File Command
TEMPDIR
Indicates the directory in which temporary files for jobs and reports can be
created.
Range 1 to 256 characters
Default C:\XCOMNT\TMP
TRUNCATION
Indicates whether Unicenter CA-XCOM Data Transport truncates excess
characters in the source file if the record exceeds the maximum record length as
indicated by the MAXRECLEN parameter. If NO is selected, and the maximum
record length is exceeded, Unicenter CA-XCOM Data Transport aborts the
transfer. This parameter is ignored if CARRIAGE_FLAG=NO.
Note: Truncation is not applicable for BINARY data.
Range YES or NO
Default NO
VERSION
Indicates the version of the Unicenter CA-XCOM Data Transport protocol to be
used for this transfer. For using TCP/IP, only a value of 2 is valid.
Range 1 or 2
Default 2
Note: Version 2 parameter.
Using the Send File Command
Use the Send File command at the command prompt to send a copy of a file on
the local system to a file on a remote system.
The -c1 option specifies that this is a Send File transfer. The local file is indicated
by the LOCAL_FILE parameter. The file on the remote system is indicated by the
REMOTE_FILE parameter.
The Command Line Interface 317
Using the Send File Command
Example 1
In the following example, the XCOM62 command is used. The configuration file
is MYCONFIG.CNF, the local file is named TESTA.AAA, the remote file is named
TESTB.BBB, and the transferred file replaces a file on the remote system that
already exists.
XCOM62 -c1 -f MYCONFIG.CNF LOCAL_FILE=TESTA.AAA REMOTE_FILE=TESTB.BBB
FILE_OPTION=REPLACE
Note: The example above appears on more than one line here but is to be typed
at the command prompt as a continuous command. Press Enter only after you
have typed in all of your command information.
Example 2
In the following example, the XCOMTCP command is used. The configuration
file is MYCONFIG.CNF, the local file is named TESTA.AAA, the remote file is
named TESTB.BBB, and the transferred file replaces a file on the remote system
that already exists. The PROTOCOL parameter specifies the protocol as TCP/IP.
XCOMTCP -c1 -f MYCONFIG.CNF LOCAL_FILE=TESTA.AAA REMOTE_FILE=TESTB.BBB
FILE_OPTION=REPLACE PROTOCOL=TCPIP
Note: The example above appears on more than one line here but is to be typed
at the command prompt as a continuous command. Press Enter only after you
have typed in all of your command information.
Parameters
The Send File parameters are listed below.
FILE_OPTION
Indicates how the transferred data is to be processed by the receiving system. For
file transfers only.
Range The range of values for simple file transfers is listed in the following table.

Value Description
CREATE Create a new file on the receiving system.
APPEND Append the transferred data to an existing file on the
receiving system.
REPLACE Replace an existing file on the receiving system.
318 User Guide
Using the Send File Command
For library-type transfers, the range of values is as follows:

Value Description
CREATE Creates the PDS on the receiving system and adds the
transferred members. If the PDS already exists, the transfer will
fail. If the directory does not exist the reaction depends on the
value of CREATE_DIRECTORIES in the global file:
If CREATE_DIRECTORIES=YES, the transfer will create the
directory and add the transferred members.
If CREATE_DIRECTORIES=NO, the transfer will fail
ADD
APPEND
Adds or replaces transferred members on the receiving system. If
the PDS does not exist, the transfer will fail. The value of
CREATE_DIRECTORIES will also determine the outcome of the
transfer on the remote system.
If CREATE_DIRECTORIES=YES and the directory does not
exist then the directory will be created and the transfer
members will be added to this directory. If the directory does
exist, the transfer members will be added to this existing
directory.
If CREATE_DIRECTORIES=NO and the directory does not
exist, then the transfer will fail. If the directory does exist,
then the transfer will add the transfer members to the
directory.
REPLACE Adds or replaces transferred members. If the directory does not
exist, the reaction depends on the value of
CREATE_DIRECTORIES in the global file:
If CREATE_DIRECTORIES=YES, the transfer will create the
directory and add the transferred members.
If CREATE_DIRECTORIES=NO, the transfer will fail
Default CREATE
Note: When creating a file on an IBM mainframe system, some additional
information may be necessary. For more information, see the
RECORD_FORMAT, BLKSIZE, VOLUME, and UNIT parameters.
The Command Line Interface 319
Using the Retrieve File Command
LOCAL_FILE
The name of the file on the local system that is being transferred. At the
command prompt or in a script, if this variable is null or unset, standard input is
read. In this manner, Unicenter CA-XCOM Data Transport commands can be
used in a pipeline or with redirection. All Windows and UNC file naming
conventions apply. If more than one file is included in the transfer, LOCAL-FILE
must include wildcard characters (*).
Note: If QUEUE=YES, user must specify full path name.
Range 0 to 256 characters
Default None
REMOTE_FILE
Indicates the file on the remote computer to which the transferred data is being
written. If you are creating the file (FILE_OPTION=CREATE), the file name must
be consistent with the file naming conventions of the remote system. If the
receiving system is a Windows system and more than one file is included in the
transfer, REMOTE_FILE must include wildcard characters (*). The local
Unicenter CA-XCOM Data Transport system does not validate this name. The
remote I/O system determines whether the file name is valid.
Note: For send file transfers only.
Range 1 to 256 characters
Default None
Using the Retrieve File Command
Use the Retrieve File command at the command prompt to retrieve a copy of a
file from a remote system and write it to a specified file on the local system.
The -c4 option specifies that this is a Retrieve File transfer. The remote file to be
copied is indicated by the REMOTE_FILE_RF parameter. The file on the local
system is indicated by the LOCAL_FILE_RF parameter.
320 User Guide
Using the Retrieve File Command
Example 1
In the following example, the XCOM62 command is used. The remote file
CUSTOMER is retrieved into the local file ACCOUNTS. All other necessary
parameters are read from the default configuration file, XCOM.CNF.
XCOM62 -c4 -f REMOTE_FILE_RF=CUSTOMER LOCAL_FILE_RF=ACCOUNTS
Example 2
In the following example, the XCOMTCP command is used. The remote file
CUSTOMER is retrieved into the local file ACCOUNTS. All other necessary
parameters are read from the default configuration file, XCOM.CNF.
XCOMTCP -c4 -f REMOTE_FILE_RF=CUSTOMER LOCAL_FILE_RF=ACCOUNTS
Parameters
The Retrieve File parameters are listed below.
FILE_OPTION_RF
Indicates how the transferred data is to be processed by the receiving system
(that is, the local system). Used when the transfer type is Retrieve File. If a value
is not specified, then the value defaults to CREATE.
Range The range of values is listed in the following table.

Value Description
CREATE Create a new file on the receiving system.
APPEND Append the transferred data to an existing file on the
receiving system.
REPLACE Replace an existing file on the receiving system.
The Command Line Interface 321
Using the Retrieve File Command
For library-type transfers, the range of values is as follows:

Value Description
CREATE Creates the PDS on the receiving system and adds the
transferred members. If the PDS already exists, the transfer will
fail. If the directory does not exist the reaction depends on the
value of CREATE_DIRECTORIES in the global file:
If CREATE_DIRECTORIES=YES, the transfer will create the
directory and add the transferred members.
If CREATE_DIRECTORIES=NO, the transfer will fail
ADD
APPEND
Adds or replaces transferred members on the receiving system. If
the PDS does not exist, the transfer will fail. The value of
CREATE_DIRECTORIES will also determine the outcome of the
transfer on the remote system.
If CREATE_DIRECTORIES=YES and the directory does not
exist then the directory will be created and the transfer
members will be added to this directory. If the directory does
exist, the transfer members will be added to this existing
directory.
If CREATE_DIRECTORIES=NO and the directory does not
exist, then the transfer will fail. If the directory does exist,
then the transfer will add the transfer members to the
directory.
REPLACE Adds or replaces transferred members. If the directory does not
exist the reaction depends on the value of
CREATE_DIRECTORIES in the global file:
If CREATE_DIRECTORIES=YES, the transfer will create the
directory and add the transferred members.
If CREATE_DIRECTORIES=NO, the transfer will fail
Default CREATE
322 User Guide
Using the Retrieve File Command
LOCAL_FILE_RF
The file name that is created, appended, or replaced on the local system when it
receives a file. At the command prompt or in a script, if this value is null or
unset, then Unicenter CA-XCOM Data Transport writes to the standard out file.
All Windows and UNC file naming conventions apply. If more than one file is
included in the transfer, LOCAL-FILE must include wildcard characters (*).
Note: If QUEUE=YES, user must specify full path name.
Range 0 to 256 characters
Default None
REMOTE_FILE_RF
Indicates the name of the file to be retrieved from the remote system. If the
receiving system is a Windows system and more than one file is included in the
transfer, REMOTE_FILE_RF must include wildcard characters (*).
Note: For retrieve file transfers only
Range 1to 256 characters
Default None
REMOTE_SYSTEM_RF
The name of the remote system that sends a file on a receive file operation.
For SNA/APPC protocols, the name is the symbolic destination name from the
CPI-C side information record.
For TCP/IP protocols, the value can be the remote systems IP address, host
name, or domain name.
Range 1 to 256 characters
Default None
The Command Line Interface 323
Creating a File on an IBM Mainframe
UNIT_RF
Specifies the unit from which a data set is to be retrieved from an IBM
mainframe.
Range 0 to 6 characters
Default None
VOLUME_RF
Specifies the volume from which a data set is to be retrieved from an IBM
mainframe.
Range 0 to 6 characters
Default None
Creating a File on an IBM Mainframe
Use the following parameters at the command prompt and in configuration files
when creating a file on an IBM mainframe from a local system.
These parameters are used when FILE_OPTION=CREATE. The IBM mainframe
file system, unlike UNIX or Windows systems, may require that you specify a
variety of attributes in order to create a file on the mainframe. Check with your
IBM mainframe applications group to determine the appropriate values for these
parameters.
324 User Guide
Creating a File on an IBM Mainframe
Parameters
The mainframe file creation parameters are listed below.
ALLOCATION_TYPE
Indicates the unit of storage allocation for a data set created on an IBM
mainframe.
Range The range of values is listed in the following table.

Value Description
CYL Cylinders
TRK Tracks
BLK Blocks
Default None
Note: Version 2 parameter.
BLKSIZE
Specifies the block size of a data set created on an IBM mainframe.
Note: Used when FILE_OPTION=CREATE
Range 0 to 32767

If the format is Then the block size must be
Fixed or fixed block record A multiple of the record length
Variable record 4 bytes larger than the record length
Undefined record Larger than the largest record length
Default 800
The Command Line Interface 325
Creating a File on an IBM Mainframe
DATACLAS
Specifies the name of the data class to use when allocating a new SMS-managed
data set.
Note: This parameter applies only to mainframe SMS data sets.
Range 1 to 8 characters
Default None
DSNTYPE
Specifies the data set definition.
Note: This parameter applies only to mainframe SMS data sets.

Value Description
LIBRARY Defines a PDSE
PDS Defines a partitioned data set
Note: These values are IBM standards for SMS processing.
Range 1 to 8 characters
Default None
LRECL
Specifies the actual or maximum length, in bytes, of a logical record.
Corresponds to the JCL LRECL subparameter.
Range 0 to 32767

If the format is Then the maximum length of a logical record
must be equal to the
Variable blocked record Maximum record length plus 4
Fixed or fixed block record Constant record length
Default 160
326 User Guide
Creating a File on an IBM Mainframe
MGMTCLAS
Specifies the name of the management class to use when allocating a new SMS-
managed data set.
Note: This parameter applies only to mainframe SMS data sets.
Range 1 to 8 characters
Default None
NUM_OF_DIR_BLOCKS
Specifies the number of directory blocks to allocate for a data set created on an
IBM mainframe.
Range 0 to 32767
Default 0
Note: Version 2 parameter.
PRIMARY_ALLOC
Identifies primary storage allocation for a data set created on an IBM mainframe.
Range 0 to 99999
Default 1
Note: Version 2 parameter.
The Command Line Interface 327
Creating a File on an IBM Mainframe
RECORD_FORMAT
Specifies the record format of a data set created on an IBM mainframe. This
corresponds to the JCL RECFM subparameter. This field is unique to the Edit
Transfer - Send File Window.
Range The range of values is listed in the following table.

Value Description Record Length Comment
F Fixed unblocked The same length
as the data set

FA Fixed unblocked
ANSI
The same length
as the data set
Contains ISO/ANSI/FIPS
control characters.
FB Fixed blocked Fixed Fixed record length with
multiple records per block.
FBA Fixed blocked
ANSI
Fixed Multiple records per block
where these records contain
ISO/ANSI/FIPS control
characters.
FBS Fixed blocked
spanned
Fixed Multiple records per block
written as standard blocks.
FM Fixed unblocked
machine
The same length
as the data set
Contains machine code control
characters.
FS Fixed unblocked
spanned
The same length
as the data set
Written as standard blocks
where these records do not
contain any truncated blocks or
unfilled tracks.
U Undefined Undefined
V Variable
unblocked
Variable
VA Variable
unblocked ANSI
Variable Contains ISO/ANSI/FIPS
control characters.
VB Variable blocked Variable Multiple records per block
VBA Variable blocked
ANSI
Variable Multiple records per block
where these records contain
ISO/ANSI/FIPS control
characters.
328 User Guide
Creating a File on an IBM Mainframe
Value Description Record Length Comment
VBM Variable blocked
machine
Variable Multiple records per block
where these records contain
machine code control
characters.
VBS Variable blocked
spanned
Variable May have multiple records per
block where these records can
span more than one block.
VM Variable
unblocked
machine
Variable Contains machine code control
characters.
VS Variable
unblocked
spanned
Variable A record can span more than
one block.
Default VB
SECONDARY_ALLOC
Identifies secondary storage allocation for a data set created on an IBM
mainframe.
Range 0 to 99999
Default 1
Note: Version 2 parameter.
The Command Line Interface 329
Creating a File on an IBM Mainframe
SECURE_SOCKET
Specifies whether to use an OpenSSL socket or non-OpenSSL socket for transfers.
Range The range of values is listed in the following table.

Value Description
YES Performs secure transfer.
The transfer uses an OpenSSL socket and must to connect
to a SSL listener on the remote partner.
NO Performs non-secure transfer.
The transfer uses a non-OpenSSL socket.
Default: NO
STORCLAS
Specifies the name of the storage class for a new SMS-managed data set.
Note: This parameter applies only to mainframe SMS data sets.
Range 1 to 8 characters
Default None
UNIT
Intended for specifying to a remote system (primarily an IBM mainframe) the
unit that a data set is to be created on.
Range 0 to 6 characters
Default None
VOLUME
Specifies the volume on which a data set is to be created on an IBM mainframe.
Range 1 to 6 characters
Default None
330 User Guide
Creating a File on an IBM Mainframe
XCOM_CONFIG_SSL
Specifies the configssl.cnf file path and file name.
Range: 1 to 256 characters
Default: c:\xcomnt\configssl.cnf
XCOM_SHOW_CIPHER
Specifies whether to display encryption algorithms in the Unicenter CA-XCOM
Data Transport queue detailed information, which is used for transfers.
Range The range of values is listed in the following table.

Value Description
NO Do not display encryption algorithms in the queue detail
information.
YES Display encryption algorithms in the queue detail
information.
Default: NO
Tape Parameters for an IBM Mainframe
The parameters described in this section can be used when tape drives are
involved in the transaction. Allowable values for these parameters are the same
as for their IBM JCL counterparts, except where noted. You can also refer to this
section for parameter information when using the Menu Interface.
Note: When tape drives are involved in the transaction, it may be necessary to
use also some of the parameters discussed in the previous section, Creating a File
on an IBM Mainframesuch as UNIT and VOLUME.
DEN
Specifies the density to be used in creating a tape on the remote system. Valid
values are the same as those for the DEN parameter in JCL
Range 1 to 4
Default None
The Command Line Interface 331
Creating a File on an IBM Mainframe
EXPDT
Specifies the expiration date to be placed on the tape data set being created.
Range The following table lists the valid values for this parameter:

Value Definition
yyddd Specifies an expiration date for the tape data set as a two-digit
designation for the year and a three-digit designation for the day of
the year. For example, in the expiration date 06021, 06 is the year
(namely, 2006) and 021 is the 21st day of that year. The tape data set
will expire on January 21, 2006.
yyyy/ddd Specifies an expiration date for the tape data set in terms of a four-
digit designation for the year and a three-digit designation for the
day of the year. For example, in the expiration date 2006/021, 2006
is the year, and 021 is the 21st day of that year. The tape data set
will expire on January 21, 2006.
Note: EXPDT and RETPD are mutually exclusive; specify one or the other.
Default None
LABEL
Indicates the type of label associated with a tape data set.
Range The following table lists the valid values for this parameter:

Value Definition
Processing type:
AL, AUL, BLP, LTM,
NL, NSL, SL, SUL
Represent the types of processing to be applied to data
sets on tape.
Note: Unicenter CA-XCOM Data Transport for z/OS supports only standard
label tapes.
Example LABEL=BLP
The type of processing to be applied to this data set is BLP.
Default SL
332 User Guide
Creating a File on an IBM Mainframe
LABELNUM
Indicates the sequence number of the data set on the tape.
Range The following table lists the valid values for this parameter:

Value Definition
sequence number
(0001-9999)
This value identifies the sequence number of a data set
on tape.
Example LABELNUM=2
This specification refers to the 2nd data set on the tape.
Default 1
RETPD
Specifies the number of days that the tape data set being created is to be retained.
Range 1 to 9999
Default None
Note: RETPD and EXPDT are mutually exclusive; specify one or the other.
TAPE
Indicates to the remote system whether the volume is a tape volume or a disk
file.
Range The following table lists the valid values for this parameter:

Value Definition
YES Indicates that the transfer is to a tape volume and that mounts are
allowed when performing dynamic allocation.
NO Indicates that the transfer is to a disk file.
Default NO
The Command Line Interface 333
Creating a File on an IBM Mainframe
UNITCT
Specifies the number of units to be allocated on the remote system.
Range 1 to 20
Default None
VOLCT
Specifies the maximum number of volumes to be used in processing a
multivolume output tape data set on the remote system.
Range 1 to 225
Default None
VOLSQ
Specifies the sequence number of the first volume of a multivolume remote data
set to be used.
Range 1 to 225
Default None
334 User Guide
Using a Send Report Command
Using a Send Report Command
Use this command at the command prompt to send a copy of a report file from a
local system to a remote system for printing.
The -c2 option specifies that this is a Send Report transfer. The report file on the
local system is specified by the LOCAL_FILE_SR parameter.
If you are using a network printer, the DESTINATION must be fully qualified,
including the server name and printer; for example: \\servername\printername.
Example 1
In the following example, the XCOM62 command is used. The configuration file
is MYCONFIG.CNF, the local report file sent is named MYFILE.RPT, and it is
placed on HOLD status on the remote system until released by the remote
system.
XCOM62 -c2 -f MYCONFIG.CNF LOCAL_FILE_SR=MYFILE.RPT HOLDFLAG=YES
Example 2
In the following example, the XCOMTCP command is used. The configuration
file is MYCONFIG.CNF, the local report file sent is named MYFILE.RPT, and it is
placed on HOLD status on the remote system until released by the remote
system.
XCOMTCP -c2 -f MYCONFIG.CNF LOCAL_FILE_SR=MYFILE.RPT HOLDFLAG=YES
The Command Line Interface 335
Using a Send Report Command
Parameters
The Send Report parameters are listed below.
CARRIAGE_CONTROL_CHARACTERS
Indicates the type of printer carriage-control codes, if any, that are included in
the report file.
Note: For report transfers only.
Range The range of values is listed in the following table.

Value Description
ASA ASA control codes in column 1.
IBM IBM Machine Characters (valid only for IBM mainframes).
BYPASSASA If data is already in ASA format, bypass conversion.
OTHER No carriage-control codes are used.
Default OTHER
CLASS
The print class assigned to a report transferred to a remote system.
If the remote system is an IBM mainframe, this field designates the JES SYSOUT
class.
Note: For report transfers only.
Example Enter B to print the report through SYSOUT=B.
Range 1 character
Default None
336 User Guide
Using a Send Report Command
COPIES
The number of copies to be sent. If this parameter is not specified, the remote
system queues one copy of the report to the systems default printer. For report
transfers only.
Range 1 to 999
Default 1
DESTINATION
Identifies the printer or other device on the remote system where the report is to
be sent. If this parameter is not specified, the remote system sends the report to
the system's default printer. For report transfers only.
Range The range of values is listed in the following table.

Value Description
0 to 16 characters For indirect transfers and for Version 1.
0 to 21 characters For transfers that are not indirect and for Version 2.
Default None
DISPOSITION
Indicates what the remote system does with the report file after the report has
been printed. For report transfers only.
Note: This field is not used when the remote system is an IBM mainframe.
Range The range of values is listed in the following table.

If the value is Then after printing the report is
DELETE Deleted
KEEP Kept
HOLD Held
Default DELETE
The Command Line Interface 337
Using a Send Report Command
FCB
Identifies the FCB JCL parameter when sending the report file to an IBM
mainframe, defining print density, lines per page, and so on. For report transfers
only.
Range 0 to 4 characters
Default None
FORM
The type of form that should be used to print the report. Since Unicenter
CA-XCOM Data Transport places the print job in the remote system's print
queue, the print control functions depend on the remote system. The user must
verify beforehand that the requested form is available at the remote site. For
report transfers only.
Range 0 to 10 characters
Default None
HOLDFLAG
Indicates whether a transferred report file is to be placed on HOLD on the
remote system or is to be printed immediately. For report transfers only.
Range YES or NO
Default NO
LOCAL_FILE_SR
Local file name to be sent as a report to the remote system. At the command
prompt or in a script, if this value is null or unset, then Unicenter CA-XCOM
Data Transport reads the standard input file. All Windows and UNC file naming
conventions apply. For report transfers only.
Note: If QUEUE=YES, user must specify full path name.
Range 0 to 256 characters
Default None
338 User Guide
Using a Send Report Command
REMOTE_SYSTEM_SR
The name of the remote system to which a report is sent.
For SNA/APPC protocols, the name is the symbolic destination name from the
CPI-C side information record.
For TCP/IP protocols, the value can be the remote systems IP address, host
name, or domain name.
Range 1 to 256 characters
Default None
REPORT_TITLE
Used by Unicenter CA-XCOM Data Transport on remote systems in the
following ways:

System Uses the REPORT_TITLE
AS/400 As the printer file name.
z/OS To interpret a non-blank value in this field as specifying the
generation of a separator (banner) page for this value.
VAX/VMS To print with the report.
UNIX To allow Unicenter CA-XCOM Data Transport to pass this field
to the LP spooler as a title field.
Other systems As a descriptive comment only and does not print it as part of
the report.
Range 0 to 21 alphanumeric or blank characters
Default None
The Command Line Interface 339
Using the Send Job Command
SPOOL_FLAG
Indicates whether the report is to be spooled to disk or printed immediately. For
report transfers only.
Note: If the remote system is an IBM mainframe, this parameter has no effect on
the transfer.
Range YES or NO
Default YES
Using the Send Job Command
Use the Send Job Command at the command prompt to send an executable file to
a remote system to perform a job.
The -c3 option specifies that this is a Send Job transfer. The local job file is
specified by the LOCAL_FILE_SJ parameter.
The executable file or command script that contains the job must have in it the
control statements that are needed to execute the job on the remote system. These
control statements must be in a form that is recognized by the remote system.
For example, if you are sending to an IBM z/OS system, this file could contain
JCL statements. If you are sending to a UNIX system this file could contain a
UNIX shell script. For sending to a Windows system, the file would be a .bat file.
Example 1
In the following example, the XCOM62 command is used. The job sent for
execution on the remote system is in the file MYFILE.
XCOM62 -c3 -f LOCAL_FILE_SJ=MYFILE
All other necessary parameters are read from the default configuration file
XCOM.CNF.
Example 2
In the following example, the XCOMTCP command is used. The job sent for
execution on the remote system is in the file MYFILE.
XCOMTCP -c3 -f LOCAL_FILE_SJ=MYFILE
All other necessary parameters are read from the default configuration file
XCOM.CNF.
340 User Guide
ERRORLEVEL Return Codes from xcomtcp.exe and xcom62.exe
LOCAL_FILE_SJ
Indicates the name of the file on the local system to be sent as a job. At the
command prompt or in a script, if this variable is null or unset, standard input is
read. All Windows and UNC file naming conventions apply.
Note: If QUEUE=YES, user must specify full path name.
Range 0 to 256 characters
Default None
REMOTE_SYSTEM_SJ
The name of the remote system to which a job is sent.
For SNA/APPC protocols, the name is the symbolic destination name from the
CPI-C side information record.
For TCP/IP protocols, the value can be the remote systems IP address, host
name, or domain name.
Range 1 to 256 characters
Default None
ERRORLEVEL Return Codes from xcomtcp.exe and
xcom62.exe
When executing the command-line programs (xcomtcp.exe and xcom62.exe), the
ERRORLEVEL indicates successful or failed processing. An ERRORLEVEL of
ZERO indicates successful operation and termination. An ERRORLEVEL of
NON_ZERO values indicates program processing was not successful, and that
the program has terminated. Note that to know success or failure of a transfer,
you must set QUEUE=NO, otherwise ERRORLEVEL only indicates the success
or failure of queuing.
The Command Line Interface 341
Tracing Problems
Tracing Problems
The tracing parameters are used to collect information at the request of
Unicenter CA-XCOM Data Transport Customer Support in order to diagnose a
problem. The trace output is primarily intended to provide information to
Customer Support, and they will usually request a level of tracing for you to use.
The -t option of the XCOM62 or XCOMTCP command will direct trace output
to STDERR, the standard error output.
This trace facility collects information about a transfer from the point where a
transfer is queued or submitted and a connection is established. The resulting
trace data is stored in a file named TIDNUMBER.TRA, where TIDNUMBER =
the transfer ID.
Note: In the GUI, the Trace Properties Tab Page of the Properties dialog
provides access to Unicenter CA-XCOM Data Transport system-level trace
facilities. For more information, see the chapter Using Unicenter CA-XCOM
Data Transport.
Note that setting trace options may generate large files of trace data and
significantly impact performance.
Example 1
In the following example, the XCOM62 command is used. The configuration file
is MYCONFIG.CNF, the trace level is set to 9 to provide full tracing information
and the trace information is written to a trace file.
XCOM62 -f MYCONFIG.CNF XTRACE=9
Example 2
In the following example, the XCOMTCP command is used.
XCOMTCP -f MYCONFIG.CNF XTRACE=9 PROTOCOL=TCPIP
The configuration file is MYCONFIG.CNF, the trace level is set to 9 to provide
full tracing information and the trace information is written to a trace file. The
protocol is specified by the PROTOCOL parameter.
342 User Guide
Setting Up Log Files
XTRACE
Indicates the level of desired execution tracing.
Range The range of values is listed in the following table.

Value Description
0 No tracing.
1 to 8 Levels of tracing from 1 (lowest) to 8 (highest).
9 Show the contents of the data buffers.
10 Includes levels 1 through 9, plus some additional detailed technical
information.
Default 0
Setting Up Log Files
Unicenter CA-XCOM Data Transport automatically collects information about
transfers and stores it in a log file. Read the log file to see information about
transfers. The log indicates information such as when a transfer was started,
stopped, completed, deleted, suspended, or aged off of the queue. For each
transfer, it shows the time, date, Transfer ID, and number of blocks and bytes
transmitted.
Example 1
In the following example, the XCOM62 command is used. The configuration file
is MYCONFIG.CNF and the log file is MYLOG.
XCOM62 -f \MYCONFIG.CNF XLOGFILE=\PHIL\XCOMNT\MYLOG
Example 2
In the following example, the XCOMTCP command is used. The configuration
file is MYCONFIG.CNF and the log file is MYLOG.
XCOMTCP -f \MYCONFIG.CNF XLOGFILE=\PHIL\XCOMNT\MYLOG
The Command Line Interface 343
Setting File Type Conversion
XLOGFILE
The name of the file where Unicenter CA-XCOM Data Transport logs activity. If
you do not specify this parameter, the system-wide log file
C:\XCOMNT\XCOM.LOG is used. If you specify this parameter with a different
file name, the logging information is only sent to the specified file.
Note: Specify the full path name if QUEUE=YES.
Range 0 to 256 characters
Default C:\XCOMNT\XCOM.LOG
Setting File Type Conversion
Use the parameters below to specify the characteristics of the file and the data
involved in the transfer. For information about using custom character
conversion sets rather than the Unicenter CA-XCOM Data Transport defaults,
see Creating Custom Character Sets for File Conversion in this chapter.
Unicenter CA-XCOM Data Transport uses internal character conversion sets to
handle different data encoding methods when files are sent or received. These
default conversion sets are stored in files as conversion tables. When executing a
non-binary file transfer that requires an ASCII/EBCDIC conversion, Unicenter
CA-XCOM Data Transport uses these tables by default.
(INTERNAL_CONVERSION_TABLES=YES).
The default conversion tables are listed in the following table.

For this conversion Unicenter CA-XCOM Data Transport uses the
character set in
ASCII to EBCDIC C:\XCOMNT\CONVTAB\ATOE.TAB
EBCDIC to ASCII C:\XCOMNT\CONVTAB\ETOA.TAB
Note: If you have installed Unicenter CA-XCOM Data Transport in a directory
other than XCOMNT, these files will be in the CONVTAB subdirectory of that
directory.
344 User Guide
Setting File Type Conversion
Example 1
In the following example, the XCOM62 command is used. An EBCDIC text file is
being transferred:
XCOM62 -f CARRIAGE_FLAG=YES CODE_FLAG=EBCDIC
All other necessary parameters are read from the default configuration file,
XCOM.CNF.
Example 2
In the following example, the XCOMTCP command is used. An EBCDIC text file
is being transferred:
XCOMTCP -f CARRIAGE_FLAG=YES CODE_FLAG=EBCDIC
All other necessary parameters are read from the default configuration file,
XCOM.CNF.
CARRIAGE_FLAG
Specifies the type of file being transferred and some special characteristics of the
conversion done during the transfer.
Range The range of values is listed in the following table.

Value Description
YES Indicates that the transferred file is a text file and a newline
character should be added to the end of incoming records. Also,
newline characters are removed from the ends of lines before an
outgoing record is sent.
When the TCP/IP protocol is specified, YES will be changed to
XPACK automatically, if the value of MAXRECLEN is less than
31K. If the value of MAXRECLEN is greater than or equal to
31744, this value will not be changed automatically.
NO Indicates no special processing.
MPACK Indicates a text file with record packing. Uses 2K pack buffer.
When the TCP/IP protocol is specified, MPACK will be changed
to XPACK automatically, if the value of MAXRECLEN is less
than 31K. If the value of MAXRECLEN is greater than or equal to
31744, this value will not be changed automatically.
The Command Line Interface 345
Setting File Type Conversion
Value Description
VLR Indicates a binary file of variable-length records with a field of
4 bytes preceding each record. Applies to local initiated transfers
only.
XPACK Indicates a text file with record packing. Uses 31K pack buffer.
Note: MPACK does not support a MAXRECLEN (actual record length) over 2K.
XPACK does not support a MAXRECLEN (actual record length) over 31K.
Default YES
CODE_FLAG
Used to identify the type of data being transferred.
Range The range of values is listed in the following table.

Value Description
ASCII An ASCII file is being transferred. This indicates that the incoming
file is assumed to be ASCII format, and is not translated. Therefore
the file on the remote system should be in ASCII format before it is
transferred.
BINARY A binary file, such as an executable file, is being transferred. This
indicates to a remote system that it is not to translate the data it is
exchanging with your system.
EBCDIC An EBCDIC file is being transferred. The transferred data is
translated from EBCDIC to ASCII format when the local system
receives the data, and from ASCII to EBCDIC format when the local
system sends the data.
Default ASCII
346 User Guide
Creating Custom Character Sets for File Conversion
Creating Custom Character Sets for File Conversion
Use conversion processing when the following situations occur:
When a non-USA character set is being used.
When the transferred file is to be converted to all uppercase or lowercase
characters.
When Unicenter CA-XCOM Data Transports default character conversion
sets would not be appropriate.
For information about using Unicenter CA-XCOM Data Transports default
character conversion sets, see Setting File Type Conversion earlier in this
chapter.
Custom Character Sets
The custom character sets are stored in standard ASCII files as conversion tables.
Each original character and the character to which it is translated are defined by
a single line in the file. The line number of the file itself indicates the decimal
code value of the original character.
The character conversion table must be the only contents of the conversion file.
Do not insert any comments or additional numbers. Each conversion file must
contain 256 lines. If your text editor provides a line counter, you can use it to
help you keep track of the line numbers. The procedures and examples below
assume that the editors line counter begins at 1.
Procedure
To create a custom character translation table, follow these steps:
1. Use an editor that can generate ASCII text to create and open a file. It is
helpful to use a text editor that displays line numbers.
2. Define each character on a separate line. Do not use comments.
Note: Unicenter CA-XCOM Data Transport performs the EBCDIC to ASCII
translation in the following manner:
When an EBCDIC code 0 is received, Unicenter CA-XCOM Data Transport will
substitute the ASCII value from the first line (line 1) of the table; for EBCDIC
code 1, Unicenter CA-XCOM Data Transport takes the value from the second
line (line 2), etc. Because the first line is for code 0, it is necessary to add 1 to the
line number when determining which line of the table to modify.
The Command Line Interface 347
Creating Custom Character Sets for File Conversion
Example 1
A question mark (?) needs to be sent to the mainframe in EBCDIC. Set up the
translation table to translate it from ASCII to EBCDIC.
The ASCII code for ? is 63 (decimal).
The EBCDIC code for ? is 111 (decimal).
Take the ASCII code and add 1. This is 64. Go to line 64 of the ATOE table
and type the value 111.
Example 2
An A is received from the mainframe in EBCDIC. Set up the translation table to
translate it to ASCII:
The EBCDIC code for A is 193 (decimal).
The ASCII code for A is 65.
Take the EBCDIC code for A and add 1. This is 194. Go to line 194 of the
ETOA table and type the value 65.
Hexadecimal Numbers in Conversion Tables
An EBCDIC character can be represented by either its decimal code or its
hexadecimal equivalent. Hexadecimal numbers should be prefixed by 0x.
Example 3
In the following example, to translate the EBCDIC character A to the equivalent
ASCII code using a hexadecimal number, set line 194 of the ETOA file to contain
only the information below:
0x41
348 User Guide
Creating Custom Character Sets for File Conversion
Customizing Default Character Sets
In some cases it may be easier to build a conversion file by customizing a copy of
ATOE.TAB or ETOA.TAB and changing the character translations only where
necessary.
Procedure
To translate all lowercase ASCII characters to uppercase EBCDIC characters,
follow these steps:
1. From the command prompt, type
COPY C:\XCOMNT\CONVTAB\ATOE.TAB conversionfilename
C:\XCOMNT\CONVTAB\ATOE.TAB is copied to a new file and named
conversionfilename.
Note: conversionfilename can be any name you choose.
2. Use an editor that generates ASCII text to open the file and copy the values
from lines 66 to 91 to lines 98 to 123.
Note: The decimal ASCII code for a is 98 and the decimal ASCII code for z is
123.
The values in lines 98 to 123 are changed to represent uppercase EBCDIC
characters.
3. Save the file as an ASCII text file and exit the editor.
Specifying a Custom Character Set
To use a custom character set, change the parameter values for
INTERNAL_CONVERSION_TABLES and ETOA_FILENAME or
ATOE_FILENAME in XCOM.GLB. To activate changes in XCOM.GLB, restart
XCOMD.
To specify external character conversions tables for use by transfers, use the
CODETABL parameter (one to three characters with no default value). The
CODETABL parameter is a prefix to the name of the files containing the external
ASCII-to-EBCDIC and EBCDIC-to-ASCII character conversion tables.
Note: The CODETABL parameter is valid (resulting with the user defined
conversion tables loaded) only if the XCOM.GLB parameter
INTERNAL_CONVERSION_TABLES=NO. Failure to specify
CONVERSION_TABLES=NO results in the source or target system not loading
or using the defined conversion tables.
The Command Line Interface 349
Using Store and Forward
When creating external custom ASCII-to-EBCDIC and EBCDIC-to-ASCII
translation tables, create the ATOE/ETOA tables using the xxxATOE.TAB and
xxxETOA.TAB naming convention:
All custom translation tables must be in the C:\XCOMNT\CONVTAB directory.
The following files are supplied on your distribution media and contain tables
used to map ASCII-to-EBCDIC and EBCDIC-to-ASCII translations:
C:\XCOMNT\CONVTAB\ATOE.TAB
C:\XCOMNT\CONVTAB\ETOA.TAB
Procedure
To specify a custom character set in XCOM.GLB, follow these steps:
1. Use a text editor that can generate ASCII text to open XCOM.GLB.
2. Set INTERNAL_CONVERSION_TABLES= NO.
Change the values for ETOA_FILENAME and ATOE_FILENAME to the file
names containing the customized files you created.
3. Save XCOM.GLB as an ASCII text file and exit the editor.
Using Store and Forward
A store and forward transfer can be used to transfer a file indirectly when a
destination system is not available. You can send a file to the mainframe where it
is stored temporarily. When the destination system becomes available, the file is
automatically forwarded from the mainframe to the destination system.
This method is also used when you have two devices that cannot communicate
directly, such as an SNA-only platform and a TCP/IP-only platform. They must
use the mainframe as an intermediate device. (UNIX and Windows systems are
not intermediate devices.)
350 User Guide
Using Store and Forward
Example 1
In the following example, the XCOM62 command is used. The file MYTEST.TST
is sent to the intermediate z/OS node XCOMMVS2, which forwards the transfer
to the remote PC system ENDEST and into the file named MYTEST.TST.
XCOM62 -c1 -f XIDEST=XCOMMVS2 REMOTE_SYSTEM=ENDEST LOCAL_FILE=MYTEST.TST
REMOTE_FILE=MYTEST.TST
There must be a destination member created and enabled for the remote system
in the z/OS Dynamic Control Library in order for Unicenter CA-XCOM Data
Transport to forward the transfer successfully.
Note: The example above appears on more than one line here but is to be typed
at the command prompt as a continuous command. Press Enter only after you
have typed in all of your command information.
Example 2
In the following example, the XCOMTCP command is used. The file
MYTEST.TST is sent to the intermediate z/OS node XCOMMVS2, which
forwards the transfer to the remote PC system ENDEST and into the file named
MYTEST.TST.
XCOMTCP -c1 -f XIDEST=XCOMMVS2 REMOTE_SYSTEM=ENDEST LOCAL_FILE=MYTEST.TST
REMOTE_FILE=MYTEST.TST
There must be a destination member created and enabled for the remote system
in the z/OS Dynamic Control Library in order for Unicenter CA-XCOM Data
Transport to forward the transfer successfully.
Note: The example above appears on more than one line here but is to be typed
at the command prompt as a continuous command. Press Enter only after you
have typed in all of your command information.
Use the following parameter with the REMOTE_SYSTEM parameter for store
and forward transfers through an IBM mainframe system.
The Command Line Interface 351
Setting Password and User ID Security
XIDEST
Specifies the name of the remote system on the intermediate destination that is
designated for store-and-forward transfers. If this variable is null or unset, then a
direct connection to a remote system is attempted.
Note: For store-and-forward transfers only.
Range 1 to 256 characters
Default None
Setting Password and User ID Security
In general, a remote system requires a password and user ID before Unicenter
CA-XCOM Data Transport can perform transfers. The access rights of the user ID
on the remote system determine the actions permitted for the transfer.
Access to Unicenter CA-XCOM Data Transport and associated files is governed
by the security policies that are in effect for your Windows environment.
Example 1
In the following example, the XCOM62 command is used. MYNAME is the
USERID and MYPASSWORD is the PASSWORD.
XCOM62 -f USERID=MYNAME PASSWORD=MYPASSWORD
All other parameters are read from the default configuration file, XCOM.CNF.
Example 2
In the following example, the XCOMTCP command is used. MYNAME is the
USERID and MYPASSWORD is the PASSWORD.
XCOMTCP -f USERID=MYNAME PASSWORD=MYPASSWORD
All other parameters are read from the default configuration file, XCOM.CNF.
352 User Guide
Setting Password and User ID Security
DOMAIN
The Windows domain name for use in authenticating the user ID and password.
Range 1 to 15 characters.
Default None
FILE_ACCESS_PASSWORD
Password for access to local files. Used for locally initiated transfers only.
Range 0 to 14 characters
Default None
FILE_ACCESS_USERNAME
Name of user accessing local files. Used for locally initiated transfers only.
Range 0 to 20 characters
Default None
PASSWORD
The password associated with the user ID on a remote system.
Range 0 to 31 characters
Default None
TRUSTED
Allows the user to request a trusted transfer.
Range YES, NO, Y, or N
Default None
The Command Line Interface 353
Encrypting Parameter Values in Existing Configuration Files
USERID
The user ID that the security system on a remote system checks before granting
access for the file transfer.
Range 0 to 12 characters
Default None
Encrypting Parameter Values in Existing Configuration Files
Use XCOMENCR.EXE to encrypt selected parameter values in an existing
configuration file. When XCOMENCR encounters a line with #!ENCRYPT, it
changes the next non-comment line from
PARAMETER=VALUE
to
PARAMETER.ENCRYPTED=ENCRYPTEDVALUE
Example Before encryption:
PASSWORD=ENIGMA
After encryption:
PASSWORD.ENCRYPTED=12 0F 36 79 65 AB D0 37 ...
up to 32 hexadecimal characters.
Syntax
The syntax for using XCOMENCR.EXE is as follows:
XCOMENCR input_file output_file
354 User Guide
Encrypting Parameter Values in Existing Configuration Files
Options
The following table explains the options for XCOMENCR.EXE:

Option Explanation
-
(minus sign)
Send output to stdout.
Example: XCOMENCR input_file -
+
(plus sign)
Replace input_file.
Example: XCOMENCR input_file +
no options Displays help text.
Procedure
To encrypt a parameter value using XCOMENCR.EXE, follow these steps:
1. Using a text editor, open the configuration file you wish to modify, go to the
parameter you wish to encrypt, create a blank line above it, and type in the
following:
#!ENCRYPT
Repeat as necessary for each parameter you wish to encrypt.
Note: Because # denotes a comment line in the .cnf file, any line beginning
with #!ENCRYPT is ignored by Unicenter CA-XCOM Data Transport and is
used only by XCOMENCR. EXE.
2. Save the configuration file as an ASCII text file.
3. At the command prompt, enter the following:
XCOMENCR input_file output_file
Replace input_file with the name of the configuration file from Step 1.
The parameter value in the first non-comment line after each occurrence of
the #!ENCRYPT statement is changed to the encrypted parameter value
format.
Note: If you open an encrypted configuration file with a text editor, you
cannot see the values of the encrypted parameters. In the GUI, when you
open an encrypted configuration file, you can see the encrypted values,
except for the user id and password security parameters.
The Command Line Interface 355
Scheduling Locally Initiated Transfers
Changing an Encrypted Value
To change an encrypted value that is already specified, you must delete all text
after the parameter name and respecify it.
Example If the line you want to change is:
PASSWORD.ENCRYPTED=12 0F 36 79 65 AB D0 37 ...
you would have to delete:
.ENCRYPTED=12 0F 36 79 65 AB D0 37 ...
and then type in an equal sign and the new parameter value (in an unencrypted
form), replacing NEWVALUE with your desired value, as follows:
PASSWORD=NEWVALUE
Then save the file as ASCII text and encrypt it as in the encryption procedure
above.
Scheduling Locally Initiated Transfers
The queue contains the information that Unicenter CA-XCOM Data Transport
uses to perform a transfer.
Note: The XCOMQM command provides access to information about the
transfers in the queue. For information about using XCOMQM, see the chapter
Operating Environment in the Unicenter CA-XCOM Data Transport for Windows
NT Server/Professional Administrator Guide
Example 1
In the following example, the XCOM62 command is used. The transfer request
goes into the queue to execute on July 28, 2005 at one minute after noon.
XCOM62 -f QUEUE=YES START_DATE=07/28/05 START_TIME=12:01:00
All other necessary parameters are read from the default configuration file,
XCOM.CNF.
356 User Guide
Scheduling Locally Initiated Transfers
Example 2
In the following example, the XCOMTCP command is used. The transfer request
goes into the queue to execute on July 28, 2005 at one minute after noon.
XCOMTCP -f QUEUE=YES START_DATE=07/28/05 START_TIME=12:01:00
All other necessary parameters are read from the default configuration file,
XCOM.CNF.
Parameters
The following is the list of queue management parameters.
PRIORITY
Indicates the priority that Unicenter CA-XCOM Data Transport uses for
scheduling a transfer. If two transfers are scheduled for the same time, the one
with the high priority is processed before one with a normal or low priority.
Range The range of values is listed in the following table.

Value Description
HIGH Set high priority.
NORMAL Set medium priority.
LOW Set low priority.
Default NORMAL
QUEUE
Indicates whether to execute the transmission request immediately or to allow
the request to be queued. If the user does not specify a .cnf file, and has not
changed a .cnf file, the default value is YES.
Note: If NO is specified and the remote system is unavailable, the request aborts.
If YES is specified, START_TIME and START_DATE are read.
The Command Line Interface 357
Scheduling Locally Initiated Transfers
Range The range of values is listed in the following table.

Value Description
YES The transfer request goes into a queue and executes depending on
the traffic in the queue and START_DATE and START_TIME.
NO The transfer starts immediately.
Default YES
START_DATE
Indicates the date on which the transfer becomes eligible for execution. The
format is mm/dd/yy. If this field is blank, the current date is used.
Example A value of 02/21/05 indicates February 21, 2005 as the start date.
Range mm/dd/yy
Default None
START_TIME
Indicates the time when the transfer becomes eligible for execution. The military
format of hh:mm:ss is used. If this field is blank, then the current time is used.
Example A value of 14:00:00 indicates 2 p.m. as the start time.
Range hh:mm:ss
Default None
358 User Guide
Notifying of Transfer Completion
Notifying of Transfer Completion
Using notification parameters, Unicenter CA-XCOM Data Transport
automatically notifies a remote system or a particular user that a transfer is
complete without the user having to monitor the queue manually. Notification
parameters allow you to specify one of the following levels of notification:
Complete, Warning, or Error.
Example 1
The following example uses the xcom62 command. When the transfer completes,
local user user1 is notified with a mail message and remote user USER2 is
notified with a TSO message if the transfer receives an error.
xcom62 -f LOCAL_NOTIFY=user1 NOTIFYL=MAIL NOTIFY_NAME=USER2 NOTIFYR=TSO
RMTNTFYL=E LCLNTFYL=A
All other necessary parameters are read from the default configuration file,
XCOM.CNF.
Example 2
The following example uses the xcomtcp command. When the transfer
completes, local user user1 is notified with a mail message and remote user
USER2 is notified with a TSO message if the transfer receives an error.
xcomtcp -f LOCAL_NOTIFY=user1 NOTIFYL=MAIL NOTIFY_NAME=USER2 NOTIFYR=TSO
RMTNTFYL=E LCLNTFYL=A
All other necessary parameters are read from the default configuration file,
XCOM.CNF.
The Command Line Interface 359
Notifying of Transfer Completion
Parameters
The notification parameters are listed below.
LCLNTFYL
Specifies the local user notification level.
Range The range of values is listed in the following table:

Value Description
A or ALL NOTIFY on transfer completion.
W or WARN NOTIFY only if the transfer received a warning or error.
E or ERROR NOTIFY only if the transfer received an error.
Default ALL
LOCAL_NOTIFY
Specifies the user on the local system who is to be notified that Unicenter
CA-XCOM Data Transport has completed a transfer. Unicenter CA-XCOM Data
Transport uses the NOTIFYL parameter to determine the type of notification to
use.
Range 0 to 64 characters
Default None
360 User Guide
Notifying of Transfer Completion
NOTIFYL
The local user notification flag.
Range The range of values is listed in the following table:

Value Description
ALL A message is displayed on the local Windows system console.
WRITE A message is displayed on the screen.
MAIL A mail message is sent to the user.
NONE No notification is sent.
Default NONE
Note: The L in NOTIFYL indicates that the local system governs the processing
of the resulting notification on that system.
A MAIL message is sent to the specified user only if a MAPI-compliant provider
is configured as a non-domain account and/or allows local accounts (such as the
xcomd service and the local user ID) access to the Windows system (for example,
Microsoft Mail boxes and address books on the local system).
Note: Some Microsoft Outlook 2003 security updates may prevent mail
notification from working.

NOTIFY_NAME
The user on the remote system who is to be notified when Unicenter CA-XCOM
Data Transport completes a transfer.
Note: If the remote system is an IBM mainframe, Unicenter CA-XCOM Data
Transport uses the value of NOTIFYR to determine the type of notification to
deliver.
Range 0 to 12 characters
Default None
The Command Line Interface 361
Notifying of Transfer Completion
NOTIFYR
Specifies the remote user notification type when sending data to a remote
system.
Range The range of values is listed in the following table:

Value Description
MAIL Mail is sent to the user
WRITE A message is displayed on the local Windows system console.
ALL A message is displayed on the local Windows system console.
TSO Notify specified TSO user.
WTO Write to log only (WTO).
ROSCOE Notify the specified Advantage CA-Roscoe user.
CICS Notify CICS user (not used in Release 1).
LU Notify Logical Unit (not used in Release 1).
NONE No notification is sent.
Default NONE
Note: The R in NOTIFYR indicates that the remote system governs the
processing of the resulting notification on that system.
A MAIL message is sent to the specified user only if a MAPI-compliant provider
is configured as a non-domain account and/or allows local accounts (such as the
xcomd service and the local user ID) access to the Windows system (for example,
Microsoft Mail boxes and address books on the local system).
Note: Some Microsoft Outlook 2003 security updates may prevent mail
notification from working.
362 User Guide
Checkpointing and Restarting Transfers
RMTNTFYL
Specifies the remote user notification level when sending data to a remote
system.
Range The range of values is listed in the table below.

Value Description
A or ALL NOTIFY on transfer completion.
W or WARN NOTIFY only if the transfer received a warning or error.
E or ERROR NOTIFY only if the transfer received an error.
Default ALL
Checkpointing and Restarting Transfers
By setting the parameters in this section, a transfer is marked for checkpointing
and automatic restart if an interruption occurs during the transfer attempt. After
an interruption the XCOMD Unicenter CA-XCOM Scheduler service scans its
table of transfers and automatically attempts to restart eligible transfers.
The CHECKPOINT_COUNT parameter indicates where to restart the transfer
after it has been interrupted. If a transfer is interrupted, it is resumed from a
checkpoint rather than starting over from the beginning of the file. When
CHECKPOINT_COUNT=1000, Unicenter CA-XCOM Data Transport performs a
check after every 1000 records sent, to ensure that the records are stored on the
destination system. Then the next 1000 records are transmitted.
The restart parameters automatically restart a transfer after a transmission error,
based on the number of retries and the retry time specified. Transmission
conditions that permit restarts generally include most transmission errors.
Restarts will also be attempted when a transfer is suspended by the remote
system, and when a link goes down. Conditions that are not considered for
restart include errors such as invalid passwords and data set not cataloged
messages.
Note: Restart parameters can be specified without setting a checkpoint.
The Command Line Interface 363
Checkpointing and Restarting Transfers
Example 1
In the following example, the XCOM62 command is used. If the transfer is
interrupted, it restarts from the most recent checkpoint of every 2000 records,
and up to three attempts are made to retry the transfer at intervals of 30 seconds.
XCOM62 -f CHECKPOINT_COUNT=2000 NUMBER_OF_RETRIES=3 RESTART_SUPPORTED=YES
RETRY_TIME=30
All other necessary parameters are read from the default configuration file,
XCOM.CNF.
Note: The example above appears on more than one line here but is to be typed
at the command prompt as a continuous command. Press Enter only after you
have typed in all of your command information
Example 2
In the following example, the XCOMTCP command is used. If the transfer is
interrupted, it restarts from the most recent checkpoint of every 2000 records,
and up to three attempts are made to retry the transfer at intervals of 30 seconds.
XCOMTCP -f CHECKPOINT_COUNT=2000 NUMBER_OF_RETRIES=3 RESTART_SUPPORTED=YES
RETRY_TIME=30
All other necessary parameters are read from the default configuration file,
XCOM.CNF.
Note: The example above appears on more than one line here but is to be typed
at the command prompt as a continuous command. Press Enter only after you
have typed in all of your command information
364 User Guide
Checkpointing and Restarting Transfers
List of Parameters
The checkpoint and restart parameters are listed below.
CHECKPOINT_COUNT
Defines how often (based on record count) the sending system requests a
checkpoint to be taken. The value 0 indicates no checkpointing.
Note: Setting the CHECKPOINT_COUNT affects performance. Each time a
checkpoint is taken, the output buffers on the receiving system are written to the
disk. On Token Ring, Ethernet, and other high-speed networks, the
CHECKPOINT_COUNT should be set 0 or to the highest allowable value. The
CHECKPOINT_COUNT should not be set for small files.
Range 0 to 9999
Default 1000
Note: Version 2 parameter.
NUMBER_OF_RETRIES
Indicates the maximum number of retries before a transfer is logged as failed
and taken out of the transfer queue. If the value is 0, the transfer will not be
retried.
Range 0 to 255
Default 1
Note: Version 2 parameter.
RESTART_SUPPORTED
Specifies whether automatic restart is to be supported on a transfer.
Range YES or NO
Default YES
Note: Version 2 parameter.
The Command Line Interface 365
Purging the Unicenter CA-XCOM Data Transport Log File
RETRY_TIME
The number of seconds between retries of unsuccessful transfers. If the value is
0, the transfer is retried without delay.
Range 0 to 99999
Default 1
Note: Version 2 parameter.
Purging the Unicenter CA-XCOM Data Transport Log File
CLEANLOG.EXE allows the Unicenter CA-XCOM Data Transport transfer and
error log to be purged of items older than a specified age. This assures that the
file will not grow overly large. You can run CLEANLOG.EXE from the
command line or from a command file. Unicenter CA-XCOM Data Transport
should be idle when you run this program.
Syntax
The syntax for using CLEANLOG.EXE is as follows:
CLEANLOG Number_of_days_old [Log file name]

Operand Description
Number_of_days_old Entries that meet the number of days in the log
criterion will be purged
Log file name The name of the log file to clean (optional). The
default is the XCOM.LOG in the current directory.
Example
CLEANLOG 5
This command will remove entries in XCOM.LOG that are older than 5 days.
366 User Guide


Chapter
4
The Application Programming
Interface

The Application Programming Interface (API) is intended to give programmers
the capability of developing their own Unicenter CA-XCOM Data Transport
applications.
There are two Unicenter CA-XCOM Data Transport APIs. They are:

Data Transport API Description
XcomAPI The XcomAPI provides the ability to submit transfers to
Unicenter CA-XCOM Data Transport.
XcomQAPI The XcomQAPI provides the same functionality to
manage the queue as the XCOMQM command line
function, but through an API.
XcomAPI
The XcomAPI routine uses C structures defined in the xcomapi.h file to pass
information to Unicenter CA-XCOM Data Transport. The Unicenter CA-XCOM
Data Transport XcomAPI() function call takes a starting state and a parameter
block structure as its arguments. For transfers using SNA, before invoking
XcomAPI, an SNA session must be active with the desired remote system.
The Application Programming Interface 41
XcomQAPI
XcomQAPI
The XcomQAPI routine uses C structures defined in the xcomapi.h file to return
information from the Unicenter CA-XCOM Data Transport Queue. The
Unicenter CA-XCOM Data Transport XcomQAPI() function call takes a
parameter field as its argument, which allows you to:
Delete entries from the queue
Suspend a transfer
Resume a suspended transfer
Display the list of entries in the queue
Display detailed information about the queue entries
Upgrading from Previous Releases
The XcomAPI distributed with previous versions of Unicenter CA-XCOM Data
Transport is different from this API. The XcomQAPI is new. If you have versions
of the XcomAPI that were distributed prior to this version, recompile your
Unicenter CA-XCOM Data Transport applications with the current version.
Link Libraries
When linking libraries, you must use the appropriate Unicenter CA-XCOM Data
Transport libraries for non-queued transfers that use SNA/APPC or TCP/IP
protocols. (For queued transfers, either set of files is satisfactory.)
Sample links for use with both SNA and TCP/IP transfers are provided in the
makefile distributed with Unicenter CA-XCOM Data Transport. The Library and
API source files are located under the xcomnt\apisrc directory. Your
SNA/APPC software supplies the SNA/APPC object library wcpic32.lib.
SNA Libraries
The following libraries are required for performing non-queued SNA transfers:
xcomsna.lib
wcpic32.lib - Supplied by your SNA/APPC Software
xcom.lib
compapi.lib
card3log.lib
42 User Guide
Starting States
TCP/IP Libraries
The following libraries are required for performing non-queued TCP/IP
transfers:
xcomtcp.lib
cato3xpi.lib
xcom.lib
compapi.lib
card3log.lib
Starting States
Valid starting states are as follows:

Starting State Used For
LOCAL_SEND
Initiates the transmission of a local file to a remote system as a
report, job, or file transfer.
LOCAL_RECEIVE
Initiates the transmission of a remote file to the local system.
The value returned by XcomAPI is zero if the transfer was successful. If not, an
error code as defined in the startst.h header file will be generated.
Note: The sample API Program apitest.c should be edited to change the
starting_state to LOCAL_SEND for report, job, or file transfers. starting_state
should be changed to LOCAL_RECEIVE when initiating a receive file from a
remote system. See the description of file_type in this chapter under API Member
Names.
Starting States in startst.h
The startst.h file contains the following:
/* starting states to pass to XcomAPI */
#define LOCAL_SEND 152
#define LOCAL_RECEIVE 153
The Application Programming Interface 43
API Control Block Structure
API Control Block Structure
The following is the include file xcomapi.h. This is a C language header file
containing the necessary API definitions for the control block structure.
#ifndef XCOMAPI_INCLUDED
#define XCOMAPI_INCLUDED ONCE
#include "startst.h"
#define SEND_FILE "1"
#define SEND_REPORT "2"
#define SEND_JOB "3"
#define RECEIVE_FILE "4"
typedef struct {
char
*file_type, /* 1-file, 2-report, 3-job, 4-retrieve
( the same as starting_state=LOCAL_RECEIVE )*/
*protocol, /* communications protocol: SNA or TCPIP */
*port, /* TCPIP remote server port */
*remote_system, /* remote lu name */
*xluname, /* local lu name */
*xnodespec, /* node specification for SNA gateway node */
*xmode, /* mode */
*xidest, /* intermediate destination */
*local_file, /* local filename for send */
*remote_file, /* local filename for receive */
*local_file_rf, /* local filename for receive */
*remote_file_rf, /* remote filename for receive */
*remote_system_relay, /* remote system for relay transfer */
*remote_file_relay, /* remote filename for relay transfer */
*file_option, /* CREATE / REPLACE / APPEND */
*remove_trail_blanks, /* remove trailing blanks (MVS/R) */
*volume, /* volume */
*unit, /* unit */
*record_format, /* record format */
*lrecl, /* logical record length */
*blksize, /* block size */
/* remote printing parameters */
*local_file_sr, /* local filename for sending reports */
*class, /* printjob class */
*destination, /* name of remote printer */
*form, /* name of special forms to be used */
*fcb, /* Form Control Block */
*copies, /* number of copies to be printed */
*report_title, /* report name (banner) to be used on
separator sheet */
*hold, /* flag for MVS spoolers */
*spool_flag, /* turns on spooling on receiving side */
*disposition, /* MVS file disposition */
*carriage_control_characters, /* A - ASA chars in column 1 ,
M -IBM Machine chars (MVS) */
*local_file_sj, /* local filename for sending jobs */
*userid, /* user id */
*password, /* password */
*queue, /* YES - queue transactions
NO - execute immediately */
44 User Guide
API Control Block Structure
*start_time, /* time to start scheduled transaction */
*start_date, /* date to start scheduled transaction */
*notifyr, /* TSO / WTO / CICS / LU / VM */
*notify_name, /* who to notify */
*local_notify, /* user name for notification */
*notifyl, /* MAIL / WRITE */
*notify_term, /* user's terminal to notify if notifyl=WRITE */
*maxreclen, /* maximum record length */
*code_flag, /* ASCII / BINARY / EBCDIC */
*carriage_flag, /* specifies if it is a text file or a type of record
packing to use */
*truncation, /* YES - truncation is allowed for this transfer */
*compress, /* YES / NO */
*xtrace, /* trace level */
*stat_frequency, /* How often to put record stats to Q-record */
*debug_flag, /* YES - debug output printed to stderr */
*xlogfile, /* log for locally initiated transactions */
*tempdir, /* directory to hold temporary files */
/* parameters used by xcom62 version 2 and higher only */
*version,
*number_of_retries,
*allocation_type,
*checkpoint_count,
*num_of_dir_blocks,
*primary_alloc,
*secondary_alloc,
*restart_supported,
/* parameters used by xcom 3.1 and higher only */
*trusted,
*domain,
*den,
*expdt,
*retpd,
*label,
*tape,
*unitct,
*volct,
*volsq,
*labelnum,
*tapedisp, /* internal use */
/* xcv32kv parameters used by xcom r11 and higher only */
*storcls,
*datacls,
*mgtclas,
*dsntype,
*codetabl,
*lclntfyl,
*rmtntfyl,
/* SSL parameters used by xcom r11 and higher only */
*configssl,
*xcomfullssl,
/* Reserved for future use */
*hfs_flag,
*seclabel,
/* user data */
*user_data, /* user data -- system dependent */
*transfer_usr_data, /* user data -- transfer specific */
*transfer_id, /* allows user definable identification
for the transfer request */
The Application Programming Interface 45
API Control Block Structure
/* parameters normally taken from shared memory but may be overwritten in API */
*xlpcmd, /* print command with full path */
*xppcmd, /* print command with full path */
*xprecmd, /* pre-allocation exit command with full path */
*xendcmd,
*xpullcmd, /* Relay transfer pull command exit */
*xpushcmd, /* Relay transfer push command exit */
*xnotifycmd, /* path name of command to notify users */
*shell_cmd, /* command to run shell scripts */
*eol_classes, /* print classes having NL added at end of record
*/
*convert_classes, /* classes needing ebcdic-ascii translation */
*metacode_classes; /* classes needing variable length records */
/* *ppVersion; Enable xcompp.bat for all transfers? */
} XCOM_PARM;
typedef struct {
char user_name[128]; /* user name */
char array_message[128]; /* return text from multi-entries */
char array_message2[128]; /* return text from multi-entries */
char array_err_message[128]; /* return text from multi-entries */
} XCOM_QUEUE_ENTRY;
typedef XCOM_QUEUE_ENTRY XCOM_QUEUE[9999];
typedef struct {
char funccode[2]; /* function code */
char tid[7]; /* transfer id (6 characters + null) */
char global_tid[128]; /* local transfer id */
char remote_tid[128]; /* remote transfer id */
int queue_open_once; /* allow queue open once */
int nMax_Queue_Entries; /* Maximum number of queue_entry */
int nQueueEntries; /* number of queue_entry returned */
int trace_level; /* trace level */
FILE *trace_stream; /* file handle for trace file */
char trace_filename[256]; /* name of the trace file */
char start_time[128]; /* start time */
char end_time[128]; /* end time */
char user_name[128]; /* remote user name */
char group_name[128]; /* group name */
char transfer_name[128]; /* user definable id for transfer request */
char xferdata[128]; /* user data -- transfer specific */
char sysdata[128]; /* user data -- system dependent */
char in_out[128]; /* in_out value */
char pid[128]; /* process id */
char remote_system[128]; /* remote lu name */
char file_type[128]; /* file type */
char transfer_type[128]; /* transfer type */
char user_group[128]; /* owned by user from group */
char lfile[257]; /* local file */
char file[257]; /* temporary file */
char rfile[257]; /* remote file */
char file_option[128]; /* file creation option */
char curr_cond[128]; /* current condition */
char curr_status[128]; /* current status */
char curr_state[128]; /* current TP state */
char rec_read_write[128]; /* record read or written to file */
char byte_read_write[128]; /* bytes read or written to file */
char blocks_trans[128]; /* blocks transmitted */
char bytes_trans[128]; /* bytes transmitted */
char sdsmessage[160]; /* message test for SDSNOTE */
char head_message[128]; /* title message */
char queue_message[128]; /* return text from queue */
char start_message[128]; /* return text from start of xcomd service */
char start_message2[128]; /* return text from start of xcomd service */
char end_message[128]; /* return text from end of process */
XCOM_QUEUE *pQueue; /* A array of XCOM_QUEUE structure */
46 User Guide
API Control Block Structure
} XCOM_QUEUE_PARM;
int XcomAPI(int invocation_mode,XCOM_PARM xparmblock);
#ifndef _NO_PROTO
char *msgstrng(int state, int sense);
#else
char *msgstrng();
#endif
#ifdef _NO_PROTO
int XcomQAPI();
#else
int XcomQAPI(XCOM_QUEUE_PARM * xqueueblock);
#endif
/* volke01 12984613 added for QUEUE=NO API calls*/
#ifdef _NO_PROTO
int qSubmitAPITransfer();
#else
int qSubmitAPITransfer(int);
#endif
/* volke01 12984613 added for QUEUE=NO API calls*/
#ifdef _NO_PROTO
int LocalRequestNoFork_API();
#else
int LocalRequestNoFork_API(char **);
#endif
#else /* XCOMAPI_INCLUDED */
#define XCOMAPI_INCLUDED MORE_THAN_ONCE
#endif
The Application Programming Interface 47
Using API Member Names
Using API Member Names
The member names in the following list are for use by applications programmers
to create C structures that specify aspects about a transfer. The appropriate
information is then passed to Unicenter CA-XCOM Data Transport by the
XcomAPI routine.
Note: There are some parameters that appear in the header and sample files that
are not included in the following list of parameters. These parameters are either
internal, currently unused, or not applicable to the Unicenter CA-XCOM Data
Transport Windows platform.
XcomAPI Member Names
The following XcomAPI member names are listed in alphabetical order.
allocation_type
Indicates the unit of storage allocation for a data set created on an IBM
mainframe.
Range The range of values is listed in the following table.

Value Description
CYL Cylinders
TRK Tracks
BLK Blocks
Default CYL
Note: Version 2 parameter.
48 User Guide
Using API Member Names
blksize
Specifies the block size of the data set created on an IBM mainframe.
Range 0 to 32767

If the record format is Then the block size must be
Fixed or fixed block A multiple of the record length
Variable 4 bytes larger than the record length
Undefined Larger than the largest record length. A maximum
of 5 digits can be entered.
Default 800
carriage_control_characters
Indicates the type of printer carriage control codes, if any that are included in the
report file.
Note: For report transfers only.
Range The range of values is listed in the following table.

Value Description
ASA ASA control codes in column 1.
IBM IBM Machine Characters (valid only for IBM mainframes).
BYPASSASA If data is already in ASA format, bypass conversion.
OTHER No carriage-control codes are used.
Default OTHER
The Application Programming Interface 49
Using API Member Names
carriage_flag
Specifies the type of file being transferred and some special characteristics of the
conversion done during the transfer.
Range The range of values is listed in the following table.

Value Description
YES Indicates that the transferred file is a text file and a new-line
character should be added to the end of incoming records. Also,
new-line characters are removed from the ends of lines before an
outgoing record is sent.
NO Indicates no special processing.
MPACK Indicates a text file with record packing. Uses 2K pack buffer.
VLR Indicates a binary file of variable-length records with a field of
4 bytes preceding each record. Applies to local initiated transfers
only.
VLR2 Indicates a binary file of variable-length records with a field of
8 bytes preceding each record. Applies to local initiated transfers
only. Used for certain applications that require a z/OS-style BDW
and RDW preceding each record.
XPACK Indicates a text file with record packing. Uses 31K pack buffer.
Note: MPACK does not support a MAXRECLEN (actual record length) over 2K.
XPACK does not support a MAXRECLEN (actual record length) over 31K.
Default YES
checkpoint_count
Defines how often (based on record count) the sending system requests a
checkpoint to be taken. The value 0000 indicates no checkpointing.
Range 0000 to 9999
Default 1000
Note: Version 2 parameter.
410 User Guide
Using API Member Names
class
The print class assigned to a report transferred to a remote system. If the remote
system is an IBM mainframe, this field designates the JES SYSOUT class.
Note: For report transfers only.
Example Enter B to print the report through SYSOUT=B.
Range 1 character
Default None
code_flag
Used to identify the type of data being transferred.
Range The range of values is listed in the following table.

Value Description
ASCII An ASCII file is being transferred. This indicates that the
incoming file is assumed to be in ASCII format, and is not
translated. Therefore, the file on the remote system should be in
ASCII format before it is transferred.
BINARY A binary file, such as an executable file, is being transferred.
This indicates to a remote system not to translate the data it is
exchanging with your system.
EBCDIC An EBCDIC file is being transferred. The transferred data is
translated from EBCDIC to ASCII format when the local system
receives the data, and from ASCII to EBCDIC format when the
local system sends the data.
Default ASCII
codetabl
Specifies the prefix to the file names, atoe.tab and etoa.tab, that contain the
external ASCII-to-EBCDIC and EBCDIC-to-ASCII custom character conversion
tables. These custom character conversion tables determine which external
translation tables will be used by the transfer.
This parameter is valid only if INTERNAL_CONVERSION_TABLES=NO.
The Application Programming Interface 411
Using API Member Names
Range 1 to 3 characters
Default None
compress
Indicates the compression type. When communicating with an IBM mainframe,
if the data file contains any empty lines, COMPRESS can only be set to YES,
LZSMALL, LZMEDIUM, or LZLARGE.
Note: All compressions types are not supported on all platforms. For supported
compression types, see the partner platform documentation.
Range The range of values is listed in the following table.

Value Description
COMPACT RJE compaction algorithm optimized for uppercase English text.
LCOMPACT RJE compaction algorithm optimized for lowercase English text.
LZLARGE Activates LZ compression to search back 32K in the data stream
for a matching string.
LZMEDIUM Activates LZ compression to search back 16K in the data stream
for a matching string.
LZRW3 General-purpose algorithm that runs fast and gives reasonable
compression.
LZSMALL Activates LZ compression to search back 4K in the data stream
for a matching string.
NO Indicates no compression.
RLE Run length encoding.
YES Indicates run length encoding of binary zeros and blanks only.
ZLIB Greater compression than LZRW3 but less than LZSMALL,
LZMEDIUM, and LZLARGE. Equivalent to ZLIB6.
ZLIB(n) Greater compression than LZRW3 but less than LZSMALL,
LZMEDIUM, and LZLARGE. The optional n value can be 1
through 9
Note: The LZ values enable LZ (Lempel-Ziv) compression to replace sequences
of data bytes that occur more than once in a data stream with a code value.
Default YES
412 User Guide
Using API Member Names
config_ssl
Specifies the configssl.cnf file path and file name.
Range 1 to 256 characters
Default c:\xcomnt\configssl.cnf
convert_classes
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
copies
The number of copies that are to be sent. If this parameter is not specified, the
remote system queues one copy of the report to the systems default printer. For
report transfers only.
Range 1 to 999
Default 1
datacls
Specifies the name of the data class to be use when allocating a new SMS-
managed data set.
Note: This parameter applies only to mainframe SMS data sets.
Range 1 to 8 characters
Default None
debug_flag
Indicates whether to print trace data to STDERR.
Range YES or NO
Default NO
The Application Programming Interface 413
Using API Member Names
den
Specifies the density to be used in creating a tape on the remote system.

Value Definition
1 to 4 Specifies the density to be used in creating a tape on the remote
system. Valid values are the same as those for the DEN parameter
in JCL
Default None
destination
Identifies the printer or other device on the remote system where the report is to
be sent. If this parameter is not specified, the remote system sends the report to
the system's default printer. For report transfers only.
Range The range of values is listed in the following table.

Value Description
0 to 16 characters For indirect transfers and for Version 1.
0 to 21 characters For transfers that are not indirect and for Version 2.
Default None
disposition
Indicates what the remote system does with the report file after the report has
been printed. For report transfers only.
Note: This field is not used when the remote system is an IBM mainframe.
Range The range of values is listed in the following table.

If the value is Then after printing, the report is
DELETE Deleted
KEEP Kept
HOLD Held
Default DELETE
414 User Guide
Using API Member Names
domain
The Windows domain name for use in authenticating the user ID and password.
Range 1 to 15 characters.
Default None
dsntype
Specifies the data set definition.
Note: This parameter applies only to mainframe SMS data sets.

Value Description
LIBRARY Defines a PDSE
PDS Defines a partitioned data set
Note: These values are IBM standards for SMS processing.
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 1 to 64 characters
Default None
expdt
Specifies an expiration date for the tape data set in terms of a two-digit
designation for the year, and a three-digit designation for the day of the year. For
example, in the expiration date 02021, 02 is the year (namely, 2002) and 021 is the
21st day of that year when the tape data set expires. For example, if 02021 is an
expiration date, 2002 is the year and 021 is the 21st day of the year.
Range yyddd
Default None
Note: EXPDT and RETPD are mutually exclusive; specify one or the other.
The Application Programming Interface 415
Using API Member Names
fcb
Identifies the FCB JCL parameter when sending the report file to an IBM
mainframe, defining print density, lines per page, etc. For report transfers only.
Range 0 to 4 characters
Default None
file_option
Indicates how the transferred data is to be processed by the receiving system. For
file transfers only.
Range The range of values is listed in the following table.

Value Description
CREATE Create a new file on the receiving system.
APPEND Append the transferred data to an existing file on the receiving
system.
REPLACE Replace an existing file on the receiving system.
For library-type transfers, the range of values is as follows:

Value Description
CREATE Creates the PDS on the receiving system and adds the
transferred members. If the PDS already exists then the transfer
will fail. If the directory does not exist the reaction depends on
the value of CREATE_DIRECTORIES in the global file:
If CREATE_DIRECTORIES=YES, the transfer will create the
directory and add the transferred members.
If CREATE_DIRECTORIES=NO, the transfer will fail.
ADD Adds or replaces transferred members on the receiving system. If
the PDS does not exist, the transfer will fail.
REPLACE Adds or replaces transferred members. If the directory does not
exist the reaction depends on the value of
CREATE_DIRECTORIES in the global file:
If CREATE_DIRECTORIES=YES, the transfer will create the
directory and add the transferred members.
If CREATE_DIRECTORIES=NO, the transfer will fail
416 User Guide
Using API Member Names
Default CREATE
Note: When creating a file on an IBM mainframe system, some additional
information may be necessary. For more information, see the
RECORD_FORMAT, BLKSIZE, VOLUME, and UNIT parameters.
file_type
Indicates the type of transmission.
Range The following table lists the valid values for this parameter:

Value Description
SEND_FILE File transfer
SEND_REPORT Report to be printed
SEND_JOB Job
RECEIVE_FILE Retrieval of a file
Note:
starting_state needs to be changed
to:
if the transmission type is:
LOCAL_SEND SEND_FILE, SEND_REPORT, or
SEND_JOB
LOCAL_RECEIVE RECEIVE_FILE
form
The type of form that should be used to print the report. Since Unicenter
CA-XCOM Data Transport places the print job in the print queue of the remote
system, the print control functions depend on the remote system. The user must
verify beforehand that the requested form is available at the remote site. For
report transfers only.
Note: When sending a report to a VAX computer, leave this parameter blank
unless you are certain that this is a valid form type. VMS interprets this to mean
that no special form is being requested.
Range 0 to 10 characters
Default None
The Application Programming Interface 417
Using API Member Names
hold
Indicates whether this transferred report file is to be placed on HOLD status on
the remote system or is to be readied for immediate printing. Specify Y to request
that it be held (spooled on a z/OS system).
Range YES or NO
Default NO
label
Indicates the type of label associated with a tape data set.
Range The following table lists the valid values for this parameter:

Value Definition
Processing type:
AL, AUL, BLP, LTM, NL,
NSL, SL, SUL
Represent the types of processing to be applied to
data sets on tape.
Note: Unicenter CA-XCOM Data Transport for z/OS supports only standard
label tapes.
Example LABEL=BLP
The type of processing to be applied to this data set is BLP.
Default SL
labelnum
Indicates the sequence number of the data set on the tape.
Range The following table lists the valid values for this parameter:

Value Definition
sequence number (1-9999) This value identifies the sequence number of a data
set on tape.
418 User Guide
Using API Member Names
Example LABELNUM=2
This specification refers to the 2nd data set on the tape.
Default 1
lclntfyl
Specifies the local user notification level.
Range The range of values is listed in the following table:

Value Description
A or ALL NOTIFY on transfer completion.
W or WARN NOTIFY only if the transfer received a warning or error.
E or ERROR NOTIFY only if the transfer received an error.
Default ALL
local_file
The name of the file on the local system that is being transferred. If this variable
is null or unset, standard input is read. In this manner, Unicenter CA-XCOM
Data Transport commands can be used in a pipeline or with redirection. All
Windows file-naming conventions apply.
Note: If QUEUE=YES, user must specify full path name.
Range 0 to 256 characters
Default None
local_file_rf
The file name that is created, appended, or replaced on the local system when it
receives a file. All Windows file-naming conventions apply. If this value is null
or unset, then Unicenter CA-XCOM Data Transport writes to the standard input
file.
Note: If QUEUE=YES, user must specify full path name.
The Application Programming Interface 419
Using API Member Names
Range 0 to 256 characters
Default None
local_file_sj
Indicates the name of the file on the local system to be sent as a job. All the
Windows file-naming conventions apply. If this value is null or unset, then
Unicenter CA-XCOM Data Transport reads the standard input file.
Note: If QUEUE=YES, user must specify full path name.
Range 0 to 256 characters
Default None
local_file_sr
Local file name to be sent as a report to the remote system. If this value is null or
unset, then Unicenter CA-XCOM Data Transport reads the standard input file.
For report transfers only.
Note: If QUEUE=YES, user must specify full path name.
Range 0 to 256 characters
Default None
local_notify
Specifies the user on the local system who is to be notified that Unicenter
CA-XCOM Data Transport has completed a transfer. Unicenter CA-XCOM Data
Transport uses the NOTIFYL parameter to determine the type of notification to
use.
Range 0 to 64 characters
Default None
420 User Guide
Using API Member Names
lrecl
Specifies the actual or maximum length, in bytes, of a logical record.
Corresponds to the JCL LRECL subparameter.
Range 0 to 32767

If the format is Then the maximum length of a logical record
must be equal to the
Variable blocked record Maximum record length plus 4
Fixed or fixed block record Constant record length
Default 160
maxreclen
For Windows and UNIX systems, the locally initiating Unicenter CA-XCOM
Data Transport system determines the values for MAXRECLEN, TRUNCATION,
and LRECL, for send and receive operations. When the local Unicenter
CA-XCOM Data Transport system initiates a transfer of a text file, this parameter
designates the length, in bytes, of the largest record that can be transferred. If a
record length is longer than this value, Unicenter CA-XCOM Data Transport uses
the value in the TRUNCATION parameter on the initiating side to determine
whether to terminate the transfer or to truncate the record and continue the
transfer. When Unicenter CA-XCOM Data Transport transfers binary files, this
value indicates the length of the records that are transferred. On a receive
operation, MAXRECLEN is set to whatever the LRECL value is on the initiating
side.
Range 1 to 32767
Default 1024
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
The Application Programming Interface 421
Using API Member Names
mgtclas
Specifies the name of the management class to use when allocating a new
SMS-managed data set.
Note: This parameter applies only to mainframe SMS data sets.
Range 1 to 8 characters
Default None
notify_name
The user on the remote system who is to be notified when Unicenter CA-XCOM
Data Transport completes a transfer.
Note: If the remote system is an IBM mainframe, Unicenter CA-XCOM Data
Transport uses the value of NOTIFYR to determine the type of notification to
deliver.
Range 0 to 12 characters
Default None
notifyl
The local user notification flag.
Range The range of values is listed in the following table.

Value Description
MAIL A mail message is sent to the user.
WRITE A message is displayed on the workstation where the user is logged
in.
ALL A message is displayed on all workstations attached to the server.
NONE No notification is sent.
Default None
A MAIL message is sent to the specified user only if a MAPI-compliant provider
is configured as a non-domain account and/or allows local accounts (such as the
xcomd service and the local user ID) access to the Windows system (for example,
Microsoft Mail boxes and address books on the local system).
422 User Guide
Using API Member Names
Note: Some Microsoft Outlook 2003 security updates may prevent mail
notification from working.
notifyr
Specifies the remote user notification type when sending data to a remote
system.
Range The range of values is listed in the following table.

Value Description
MAIL A mail message is sent to the user.
WRITE A message is displayed on the screen.
ALL Writes to all users or the console depending on platform.
TSO The specified TSO user is notified.
WTO Unicenter CA-XCOM Data Transport writes to the log only (WTO).
ROSCOE Notify the specified Advantage CA-Roscoe user.
CICS The specified CICS user is notified (not used for Version 1 type
transfers).
LU Notify Logical Unit (not used for Version 1 type transfers).
NONE Do not notify.
Default None
Notes:
A MAIL message is sent to the specified user only if a MAPI-compliant
provider is configured as a non-domain account and/or allows local
accounts (such as the xcomd service and the local user ID) access to the
Windows system (for example, Microsoft Mail boxes and address books on
the local system).
Some Microsoft Outlook 2003 security updates may prevent mail notification
from working.
The Application Programming Interface 423
Using API Member Names
notify_term
Specifies terminals to write to if NOTIFYL=WRITE. If NOTIFY_TERM is not set.
All users specified in LOCAL_NOTIFY will be notified at the first terminal where
they are logged in as found in the system table.
Range 0 to 256 characters
Default None
number_of_retries
Maximum number of retries before a transfer is logged as failed and taken out of
the transfer queue. If the value is 0, no retries are attempted.
Range 0 to 255
Default 1
Note: Version 2 parameter.
num_of_dir_blocks
Specifies the number of directory blocks to allocate for a data set created on an
IBM mainframe.
Range 0 to 32767
Default 0
Note: Version 2 parameter
password
The password associated with the user ID on a remote system.
Range 0 to 31 characters
Default None
424 User Guide
Using API Member Names
primary_alloc
Identifies primary storage allocation for a data set created on an IBM mainframe.
Range 0 to 99999
Default 1
Note: Version 2 parameter
port
The number of the TCP/IP port on the remote Unicenter CA-XCOM Data
Transport server. Used for TCP/IP transfers only.
Range 0 to 65535
Default 8044
protocol
The type of communication protocols to use.
Range The range of values is listed in the following table.

Value Description
SNA For transfers using SNA/APPC communication protocols
TCPIP For transfers using TCP/IP communication protocols
Default SNA
The Application Programming Interface 425
Using API Member Names
queue
Indicates whether to execute the transmission request immediately or to allow
the request to be queued. If the user does not specify a .cnf file, and has not
changed a .cnf file, the default value is YES.
Note: If NO is specified and the remote system is unavailable, the request aborts.
If YES is specified, start_time and start_date are read.
Range The range of values is listed in the following table.

Value Description
YES The transfer request goes into a queue and executes depending on
the traffic in the queue and START_DATE and START_TIME.
NO The transfer starts immediately.
Default YES
record_format
Specifies the record format of a data set created on an IBM mainframe. This
corresponds to the JCL RECFM subparameter.
Range The range of values is listed in the following table.

Value Description Record Length Comment
F Fixed unblocked The same length as the
data set

FA Fixed unblocked
ANSI
The same length as the
data set
Contains
ISO/ANSI/FIPS control
characters
FB Fixed blocked Fixed Fixed record length with
multiple records per
block
FBA Fixed blocked
ANSI
Fixed Multiple records per
block where these
records contain
ISO/ANSI/FIPS control
characters
426 User Guide
Using API Member Names
Value Description Record Length Comment
FBS Fixed blocked
spanned
Fixed Multiple records per
block written as
standard blocks
FM Fixed unblocked
machine
The same length as the
data set
Contains machine code
control characters
FS Fixed unblocked
spanned
The same length as the
data set
Written as standard
blocks where these
records do not contain
any truncated blocks or
unfilled tracks
U Undefined Undefined
V Variable
unblocked
Variable
VA Variable
unblocked ANSI
Variable Contains
ISO/ANSI/FIPS control
characters
VB Variable blocked Variable Multiple records per
block
VBA Variable blocked
ANSI
Variable Multiple records per
block where these
records contain
ISO/ANSI/FIPS control
characters
VBM Variable blocked
machine
Variable Multiple records per
block where these
records contain machine
code control characters
VBS Variable blocked
spanned
Variable May have multiple
records per block where
these records can span
more than one block
VM Variable
unblocked
machine
Variable Contains machine code
control characters
VS Variable
unblocked
spanned
Variable A record can span more
than one block
Default VB
The Application Programming Interface 427
Using API Member Names
remote_file
Indicates the file on the remote computer to which the transferred data is being
written. If you are creating the file (FILE_OPTION=CREATE), the file name must
be consistent with the file naming conventions of the remote system. The local
Unicenter CA-XCOM Data Transport system does not validate this name. The
remote I/O system determines whether the file name is valid.
Note: For send file transfers only.
Range 1 to 256 characters
Default None
remote_file_rf
Indicates the name of the file to be retrieved from the remote system.
Note: For retrieve file transfers only.
Range 1 to 256 characters
Default None
remote_system
The name of the remote system that receives a file, job, or report.
For SNA/APPC protocols, the name is as specified in the SNA/APPC
configuration of the local system. For RS/6000, this is the LU6.2 Side Information
record.
For TCP/IP protocols, the value can be the remote systems IP address, host
name, or domain name.
Range 1 to 256 characters
Default None
428 User Guide
Using API Member Names
remove_trail_blanks
Indicates whether to remove the blanks at the end of each record when receiving
a text file.
Range YES or NO
Default NO
report_title
This field contains the report title and job number that will be printed on the
report. The field has the following format:

8 characters 2 characters 8 characters
Job Name Blanks Job Number
The Job ID is optional and can be skipped. The Job Name can also be skipped,
but if you skip the Job name and want to use the job number, you must pad the
number with 10 blanks. For more information, see the appendix Unicenter
CA-XCOM Data Transport Parameters.
Note: For report transfers only.
Range 0 to 21 alphanumeric or blank characters
Default None
restart_supported
Specifies whether automatic restart is to be supported on a transfer.
Range YES or NO
Default YES
Note: Version 2 parameter.
The Application Programming Interface 429
Using API Member Names
retpd
Specifies the number of days (1 to 9999) that the tape data set being created is to
be retained.
Range 1 to 9999
Default None
Note: RETPD and EXPDT are mutually exclusive; specify one or the other.
rmtntfyl
Specifies the remote user notification level when sending data to a remote
system.
Range The range of values is listed in the following table:

Value Description
A or ALL NOTIFY on transfer completion.
W or WARN NOTIFY only if the transfer received a warning or error.
E or ERROR NOTIFY only if the transfer received an error.
Default ALL
secondary_alloc
Identifies secondary storage allocation for a data set created on an IBM
mainframe.
Range 0 to 99999
Default 0
Note: Version 2 parameter.
430 User Guide
Using API Member Names
shell_cmd
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
spool_flag
Indicates whether the report is to be spooled to disk or printed immediately. For
report transfers only.
Note: If the remote system is an IBM mainframe, this parameter has no effect on
the transfer.
Range YES or NO
Default YES
start_date
Indicates the date on which the transfer becomes eligible for execution. The
format is mm/dd/yy. If this field is blank, the current date is used.
Range mm/dd/yy
Default None
start_time
Indicates the time when the transfer becomes eligible for execution. The military
format of hh:mm:ss is used. If this field is blank, then the current time is used.
Range hh:mm:ss
Default None
The Application Programming Interface 431
Using API Member Names
stat_frequency
Indicates the frequency with which transfer statistics are made available to
xcomqm. Intended for tuning high-speed links. Longer values help performance,
but byte/record counts in xcomqm -D may be slightly behind the actual counts.
Range 1 to 9999 records
Default 1
storcls
Specifies the name of the storage class for a new SMS-managed data set.
Note: This parameter applies only to mainframe SMS data sets.
Range 1 to 8 characters
Default None
tape
Indicates to the remote system whether the volume is a tape volume or a disk
file.
Range YES - Indicates a tape volume and that mounts are allowed when performing
dynamic allocation.
NO - Indicates that the transfer is to a disk file.
Default NO
tempdir
Indicates the directory in which temporary files for jobs and reports can be
created.
Range 1 to 256 characters
Default \TMP
432 User Guide
Using API Member Names
transfer_id
Allows the user to enter information to identify the file transfer request.
Range 0 to 10 characters
Default None
transfer_usr_data
An open field where a user can specify any text associated with the transfer.
Range 0 to 10 characters
Default None
truncation
Indicates whether Unicenter CA-XCOM Data Transport truncates excess
characters in the source file if the record exceeds the maximum record length as
indicated by the MAXRECLEN parameter. If NO is selected, and the maximum
record length is exceeded, Unicenter CA-XCOM Data Transport aborts the
transfer. This parameter is ignored if CARRIAGE_FLAG=NO.
Note: Truncation is not valid for BINARY data.
Range YES or NO
Default NO
trusted
To allow the user to request a trusted transfer.
Range YES, NO, Y, or N
Default None
The Application Programming Interface 433
Using API Member Names
unit
Specifies the unit on which a data set is to be created on an IBM mainframe.
Note: Used when FILE_OPTION=CREATE.
Range 0 to 6 characters
Default None
unitct
Specifies the number of units to be allocated on the remote system.
Range 1 to 20
Default None
userid
The user ID that the security system on a remote system checks before granting
access for the file transfer.
0 to 12 characters
Default None
user_data
An open field where a user can specify any text associated with the transfer.
Range 0 to 10 characters
Default None
version
Indicates the version of the Unicenter CA-XCOM Data Transport protocol to be
used for this transfer. For using TCP/IP, only a value of 2 is valid.
Range 1 or 2
Default 2
Note: Version 2 parameter.
434 User Guide
Using API Member Names
volct
Specifies the maximum number of volumes to be used in processing a multi-
volume output tape data set on the remote system.
Range 1 to 255
Default None
volsq
Specifies the sequence number of the first volume of a multi-volume remote data
set to be used.
Range 1 to 255
Default None
volume
Specifies the volume on which a data set is to be created on an IBM mainframe.
Range 0 to 6 characters
Default None
xcomfullssl
Specifies whether to use an OpenSSL socket or non-OpenSSL socket for transfers.
Range The range of values is listed in the following table:

Value Description
YES Performs secure transfer.
The transfer uses an OpenSSL socket and must to connect to
a SSL listener on the remote partner.
NO Performs non-secure transfer.
The transfer uses a non-OpenSSL socket.
Default NO
The Application Programming Interface 435
Using API Member Names
xendcmd
The name of the post processing command optionally invoked by the Unicenter
CA-XCOM Data Transport transfer program after any type of transfer is finished,
whether successful or not. Invoked after partner communications have ended.
Range 0 to 256 characters
Default None
xidest
Specifies the name of the LU or TCP/IP address on the intermediate destination
that is designated for store-and-forward transfers. If this variable is null or unset,
then a direct connection to a remote system is attempted. If it contains a value, it
is taken to be the name of an intermediate Unicenter CA-XCOM Data Transport
destination that will handle traffic to and from the named remote system.
Note: For store-and-forward transfers only.
Range 0 to 14 characters
Default None
xlogfile
The name of the file where Unicenter CA-XCOM Data Transport logs activity. If
you do not specify this parameter, the systemwide log file c:\xcomnt\xcom.log
is used. If you specify this parameter with a different file name, the logging
information is only sent to the specified file.
Note: Specify the full pathname if QUEUE=YES.
Range 0 to 256 characters
Default c:\xcomnt\xcom.log
xlpcmd
Name of the post-processing command used to send print jobs to the spooler. For
incoming reports only.
Range 0 to 256 characters
Default c:\xcmnt\xcomlp.bat
436 User Guide
Using API Member Names
xmode
Indicates the mode name associated with the SNA/APPC configuration for the
Local-Remote LU name pair. This name must match the mode name defined on
the remote system.
Range 1 to 8 characters
Default XCOMMODE
xnotifycmd
Pathname of the command that Unicenter CA-XCOM Data Transport will use 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 1 to 64 characters
Default c:\xcomnt\xcomntfy.bat
xppcmd
Pathname of the command used for user-defined post processing, for file
transfers only. Only used when the local system is receiving the file.
Range 1 to 64 characters
Default c:\xcomnt\xcompp.bat
xprecmd
Pathname of the command used for user-defined pre-allocation processing, for
locally and remotely initiated transfers. Specify this parameter in xcom.glb to
invoke the pre-allocation exit xcompre.
Range 0 to 64 characters
Default None
The Application Programming Interface 437
Using XcomQAPI Option Parameters
xtrace
Indicates the level of desired execution tracing.
Range The range of values is listed in the following table.

Value Description
0 No tracing
1 to 8 Levels of tracing from 1 (lowest) to 8 (highest)
9 Show the contents of the data buffers
10 Includes levels 1 - 9, plus some additional detailed technical
information
Default 0
Using XcomQAPI Option Parameters
The XcomQAPI option parameters are for use by application programmers to
pass and retrieve information in a C structure to and from the XcomQAPI
routine. These parameters need to be supplied by you and passed on to the
XcomQAPI. The rest of the parameters are a receive buffer. They will receive
data from XcomQAPI.
Option Parameters
The option parameters in the following list are used to pass and retrieve
information from the queue request.
funccode
Used to define a function parameter to pass to XcomQAPI().
Function Parameters:

Value Description
r Display the version of Unicenter CA-XCOM Data Transport
software installed.
Aentryname Release a held transfer.
438 User Guide
Using XcomQAPI Option Parameters
Value Description
Centryname Get a trace of a transfer.
Dentryname Display details about a queue entry.
Hentryname Hold a scheduled transfer.
L List your queued transfers.
La List all queued transfers.
Rentryname Remove a queue entry.
Rfentryname Force the entry to be removed from the queue. Use this
command when you want to remove a transfer that is still
active.
R* Remove all completed or scheduled entries from the queue. If
you use this option on an active transfer, it interrupts the
transfer.
Tentryname Terminate an active transfer.
Tfentryname Force termination of a transfer. Use this command when you
want to remove a transfer that is still active.
Caution: When using SNA/APPC protocols, the TP will
abend and it may be necessary to restart the underlying SNA
software. When using TCP/IP, xcomtcp will abend.
Sentryname Suspend a transfer.
Eentryname Resume a suspended transfer.
d Create a trace file.
gentryname Display queue entry information.
pentryname Used to change the value of: FILE_OPTION, LOCAL_FILE
and REMOTE_FILE.
Note: You are only allowed to use this option from the
XCOMPRE exit.
Note: entryname represents the Transaction ID, which is the six-digit number of
the transfer entry in the queue.
The Application Programming Interface 439
API Examples
Parameters Set Within the XcomQAPI Program
The following are parameters that can be set within the XcomQAPI program:

Parameter Description
tid A queue entry TID number.
queue_open_once Open queue flag. Define this only once at the first call
of XcomQAPI. The value should be set to 0.
nMax_Queue_Entries Defines maximum queue entries. The value should be
set equal to MAX_QUEUE_ENTRIES in the xcom.glb
file.
trace_level Defines the trace level. The values can be set to 0, 1,
or 9.
trace_filename Defines a trace file name and its location, such as
C:\temp\xcomqapi.tra
API Examples
This section contains C language examples of applications written using the
APIs. Examples are for reference only.
About the XcomAPI Example
The program below is an example of a file transfer. It uses the XcomAPI routine
to pass information to Unicenter CA-XCOM Data Transport. This sample API
program is the apitest.c file distributed with Unicenter CA-XCOM Data
Transport. Please note that the API example provided on your distribution
media may have been updated for your Unicenter CA-XCOM Data Transport
system and may be different from the example shown below.
440 User Guide
API Examples
Unicenter CA-XCOM Data Transport for Windows NT API Return Codes
Unicenter CA-XCOM Data Transport for Windows NT Server/Professional API
has the following return codes:

Return Code Explanation
603 The TP state is invalid.
602 There was a general error in queue function.
601 Permission denied.
600 Transfer is not active.
469 XCOMD CA-XCOM Scheduler service is not running or is not
compatible
0 The transfer was successful.
-1 The named file does not exist or is not accessible in the given
mode.
-9 XCOMQM detected an unknown error.
-1100 XCOMQM is unable to find the entry in the queue.
-1801 XCOMQM is unable to open the index file.
-1802 XCOMQM is unable to close the index file.
-1803 XCOMQM detected invalid command line options
Example
The following is a C language example of a program using the API that receives
a remote file named /u/user/test.txt and replaces the local file named
d:\temp\test.txt2 using the TCP/IP protocol.
/* apitest.c - This is a sample program for calling the XcomAPI. */
/* Modify this according to your needs and make it */
/* with the sample 'apitcp.mak' / 'apisna.mak' */
/* in this directory. */
/* Please note that XcomAPI is not thread safe. */
#include <stdio.h>
#include "xcomapi.h"
main(int argc,char **argv)
{
int rc;
XCOM_PARM xcomparm;
int starting_state;
memset(&xcomparm,0,sizeof(xcomparm));
The Application Programming Interface 441
API Examples
/* xcomparm.file_type = SEND_FILE; "1" */
xcomparm.file_type = RECEIVE_FILE; /* "4" */
/* remember to link with the appropriate xcom libraries for
each protocol */
xcomparm.protocol = "TCPIP"; /* "SNA" or "TCPIP" */
xcomparm.remote_system = "0.0.0.0";
xcomparm.port = "8044";
xcomparm.xluname = "";
xcomparm.xmode = "";
xcomparm.local_file = "d:\\temp\\test.txt2";
xcomparm.remote_file = "/u/user/test.txt";
xcomparm.local_file_rf = "d:\\temp\\test.txt2";
xcomparm.remote_file_rf = "/u/user/test.txt";
xcomparm.file_option = "REPLACE";
xcomparm.userid = "";
xcomparm.password = "";
/* if queue = NO, must link with right xcom lib */
xcomparm.queue = "NO";
xcomparm.code_flag = "ASCII";
xcomparm.truncation = "YES";
xcomparm.xtrace = "10";
xcomparm.stat_frequency = "1";
xcomparm.trusted = NULL;
xcomparm.domain = NULL;
xcomparm.den = NULL;
xcomparm.expdt = NULL;
xcomparm.retpd = NULL;
xcomparm.label = NULL;
xcomparm.tape = NULL;
xcomparm.unitct = NULL;
xcomparm.volct = NULL;
xcomparm.volsq = NULL;
/* These parms are new for r11 XCOM */
xcomparm.xcomfullssl = NULL;
xcomparm.configssl = NULL;
xcomparm.codetabl = NULL;
xcomparm.rmtntfyl = NULL;
xcomparm.lclntfyl = NULL;
xcomparm.storcls = NULL;
xcomparm.datacls = NULL;
xcomparm.mgtclas = NULL;
xcomparm.dsntype = NULL;
starting_state=LOCAL_RECEIVE;
printf("==== API Started ====\n");
rc=XcomAPI(starting_state, xcomparm);
if (rc)
printf("==== %s\n", msgstrng(rc,0));
printf("==== API Ended ====\n");
return rc;
}
442 User Guide
API Examples
XcomQAPI Example
The XcomQAPI sample is an example of a queue request. It uses the
XcomQAPI() routine to pass information to Unicenter CA-XCOM Data
Transport. This sample API program is the qapitest.c file distributed with
Unicenter CA-XCOM Data Transport.
Note: The API example provided on your distribution media may have been
updated for your Unicenter CA-XCOM Data Transport system and may be
different from the example shown below.
Example
The following is a C language example of a program using the API to call the
XcomQAPI.
/* qapitest.c - This is a sample program for calling the XcomQAPI. */
/* Modify this according to your needs and make it */
/* with the sample 'qapitcp.mak' / 'qapisna.mak' */
/* in this directory. */
/* Please note that XcomQAPI is not thread safe. */
#include <stdio.h>
#include <stdlib.h>
#include <malloc.h>
#include "xcomapi.h"
main(int argc,char **argv)
{
int rc, i;
XCOM_QUEUE_PARM *xcomqparm;
/* allocate memory for structure of xcomqparm */
xcomqparm = (XCOM_QUEUE_PARM *)malloc(sizeof(XCOM_QUEUE_PARM));
if (xcomqparm == NULL)
printf("Could not allocate memory to run QAPI process !\n");
else {
/* Reset allocated memory to all zeros */
memset(xcomqparm,0,sizeof(XCOM_QUEUE_PARM));
/* xcomqparm->nMax_Queue_Entries should equal to MAX_QUEUE_ENTRIES in
xcom.glb file */
xcomqparm->nMax_Queue_Entries = 50;
/* allocate memory for structure of pQueue */
xcomqparm->pQueue = (XCOM_QUEUE *)malloc(xcomqparm->nMax_Queue_Entries
* sizeof(XCOM_QUEUE_ENTRY));
if (xcomqparm->pQueue == NULL)
printf("Could not allocate memory to run QAPI process !\n");
else {
/* Reset allocated memory to all zeros */
memset(xcomqparm->pQueue,0,xcomqparm->nMax_Queue_Entries *
sizeof(XCOM_QUEUE_ENTRY));
printf("==== QAPI started ===\n");
/* call option 'r' to display Unicenter CA-XCOM Data Transport
version */
xcomqparm->funccode[0] = 'r';
rc=XcomQAPI(xcomqparm);
if (strlen(xcomqparm->start_message))
printf("%s", xcomqparm->start_message);
if (xcomqparm->nQueueEntries == 1)
printf("%s", (*xcomqparm->pQueue)[0].array_message);
The Application Programming Interface 443
API Examples
/* call option 'd' to turn on trace file */
xcomqparm->trace_level = 9;
strcpy(xcomqparm->trace_filename, "c:\\xcomnt\\trace\\xcomqapi.tra");
xcomqparm->funccode[0] = 'd';
rc=XcomQAPI(xcomqparm);
/* call option 'La' to list all queue entries */
xcomqparm->funccode[0] = 'L';
xcomqparm->funccode[1] = 'a';
rc=XcomQAPI(xcomqparm);
/* check for error message */
if (strlen((*xcomqparm->pQueue)[0].array_err_message))
printf("%s", (*xcomqparm->pQueue)[0].array_err_message);
/* print detail information for all queue entries */
for (i = 0; i < xcomqparm->nQueueEntries; i++) {
printf("%s", (*xcomqparm->pQueue)[i].user_name);
printf("%s", (*xcomqparm->pQueue)[i].array_message);
}
if ((xcomqparm->nQueueEntries == 0) && strlen((*xcomqparm-
>pQueue)[0].array_message))
printf("%s", (*xcomqparm->pQueue)[0].array_message);
/* call option 'Z' to list entries log messages */
xcomqparm->funccode[0] = 'Z';
strcpy(xcomqparm->tid, "000001");
rc=XcomQAPI(xcomqparm);
/* check for error message */
if (strlen((*xcomqparm->pQueue)[0].array_err_message))
printf("%s", (*xcomqparm->pQueue)[0].array_err_message);
/* print detail information for all queue entries */
for (i = 0; i < xcomqparm->nQueueEntries; i++) {
printf("%s", (*xcomqparm->pQueue)[i].user_name);
printf("%s", (*xcomqparm->pQueue)[i].array_message);
}
if ((xcomqparm->nQueueEntries == 0) && strlen((*xcomqparm-
>pQueue)[0].array_message))
printf("%s", (*xcomqparm->pQueue)[0].array_message);
/* call option 'Dxxxxxx' to display detail record information */
memset(xcomqparm->lfile,0,sizeof(xcomqparm->lfile));
memset(xcomqparm->rfile,0,sizeof(xcomqparm->rfile));
strcpy(xcomqparm->tid, "000001");
xcomqparm->funccode[0] = 'D';
rc=XcomQAPI(xcomqparm);
/* check for error message */
if (strlen((*xcomqparm->pQueue)[0].array_err_message))
printf("%s", (*xcomqparm->pQueue)[0].array_err_message);
/* display detail record information */
if (strlen(xcomqparm->head_message))
printf("%s", xcomqparm->head_message);
if (strlen(xcomqparm->global_tid))
printf("%s", xcomqparm->global_tid);
if (strlen(xcomqparm->remote_tid))
printf("%s", xcomqparm->remote_tid);
if (strlen(xcomqparm->group_name))
printf("%s", xcomqparm->group_name);
if (strlen(xcomqparm->transfer_name))
printf("%s", xcomqparm->transfer_name);
if (strlen(xcomqparm->xferdata))
printf("%s", xcomqparm->xferdata);
if (strlen(xcomqparm->sysdata))
printf("%s", xcomqparm->sysdata);
if (strlen(xcomqparm->start_time))
printf("%s", xcomqparm->start_time);
if (strlen(xcomqparm->transfer_type))
printf("%s", xcomqparm->transfer_type);
if (strlen(xcomqparm->lfile))
printf("%s", xcomqparm->lfile);
if (strlen(xcomqparm->file))
444 User Guide
API Examples
printf("%s", xcomqparm->file);
if (strlen(xcomqparm->sdsmessage))
printf("%s", xcomqparm->sdsmessage);
if (strlen(xcomqparm->rfile))
printf("%s", xcomqparm->rfile);
if (strlen(xcomqparm->in_out))
printf("%s", xcomqparm->in_out);
if (strlen(xcomqparm->remote_system))
printf("%s", xcomqparm->remote_system);
if (strlen(xcomqparm->end_time))
printf("%s", xcomqparm->end_time);
if (strlen(xcomqparm->pid))
printf("%s", xcomqparm->pid);
if (strlen(xcomqparm->user_group))
printf("%s", xcomqparm->user_group);
if (strlen(xcomqparm->curr_cond))
printf("%s", xcomqparm->curr_cond);
if (strlen(xcomqparm->curr_status))
printf("%s", xcomqparm->curr_status);
if (strlen(xcomqparm->curr_state))
printf("%s", xcomqparm->curr_state);
if (strlen(xcomqparm->rec_read_write))
printf("%s", xcomqparm->rec_read_write);
if (strlen(xcomqparm->byte_read_write))
printf("%s", xcomqparm->byte_read_write);
if (strlen(xcomqparm->blocks_trans))
printf("%s", xcomqparm->blocks_trans);
if (strlen(xcomqparm->bytes_trans))
printf("%s", xcomqparm->bytes_trans);
if (strlen((*xcomqparm->pQueue)[0].array_message))
printf("%s", (*xcomqparm->pQueue)[0].array_message);
/* call option 'R*' to remove queue entries */
xcomqparm->funccode[0] = 'R';
xcomqparm->funccode[1] = '*';
rc=XcomQAPI(xcomqparm);
/* check for error message */
if (strlen((*xcomqparm->pQueue)[0].array_err_message))
printf("%s", (*xcomqparm->pQueue)[0].array_err_message);
/* display detail information for removed queue entries */
for (i = 0; i < xcomqparm->nQueueEntries; i++) {
printf("%s", (*xcomqparm->pQueue)[i].array_message);
printf("%s", (*xcomqparm->pQueue)[i].array_message2);
}
if ((xcomqparm->nQueueEntries == 0) && strlen((*xcomqparm-
>pQueue)[0].array_message))
printf("%s", (*xcomqparm->pQueue)[0].array_message);
if (!rc)
printf("==== Call XcomQAPI successful !\n");
else
printf("==== %s\n", msgstrng(rc, 0));
/* call option 'gxxxxxx' to display queue entry information */
memset(xcomqparm->lfile,0,sizeof(xcomqparm->lfile));
memset(xcomqparm->rfile,0,sizeof(xcomqparm->rfile));
memset(xcomqparm->file_option,0,sizeof(xcomqparm->file_option));
xcomqparm->funccode[0] = 'g';
strcpy(xcomqparm->tid, "000001");
rc=XcomQAPI(xcomqparm);
/* check for error message */
if (strlen((*xcomqparm->pQueue)[0].array_err_message))
printf("%s", (*xcomqparm->pQueue)[0].array_err_message);
/* display queue entry information */
if (strlen((*xcomqparm->pQueue)[0].array_message))
printf("%s", (*xcomqparm->pQueue)[0].array_message);
if (strlen(xcomqparm->group_name))
printf("%s", xcomqparm->group_name);
The Application Programming Interface 445
API Examples
if (strlen(xcomqparm->lfile))
printf("%s", xcomqparm->lfile);
if (strlen(xcomqparm->rfile))
printf("%s", xcomqparm->rfile);
if (strlen(xcomqparm->user_name))
printf("%s", xcomqparm->user_name);
if (strlen(xcomqparm->transfer_type))
printf("%s", xcomqparm->transfer_type);
if (strlen(xcomqparm->file_type))
printf("%s", xcomqparm->file_type);
if (strlen(xcomqparm->file_option))
printf("%s", xcomqparm->file_option);
/* call option 'pxxxxxx' to change value: FILE_OPTION LOCAL_FILE
REMOTE_FILE
note: This option only allow to be called when xcbp->state is in
PREALLOCATION_STATE */
xcomqparm->funccode[0] = 'p';
strcpy(xcomqparm->tid, "000001");
strcpy(xcomqparm->file_option, "CREATE");
strcpy(xcomqparm->lfile, "c:\\user\\user\\test.txt");
strcpy(xcomqparm->rfile, "c:\\temp\\test.del");
rc=XcomQAPI(xcomqparm);
/* check for error message */
if (strlen((*xcomqparm->pQueue)[0].array_err_message))
printf("%s", (*xcomqparm->pQueue)[0].array_err_message);
/* print out queue entry information */
if (strlen((*xcomqparm->pQueue)[0].array_message))
printf("%s", (*xcomqparm->pQueue)[0].array_message);
printf("==== QAPI ended ===\n");
}
}
/* free memory */
if (xcomqparm->pQueue != NULL)
free(xcomqparm->pQueue);
if (xcomqparm != NULL)
free(xcomqparm);
}

446 User Guide

Chapter
5
Remote System Information

The following topics are covered for each platform, as appropriate:
Naming conventions
Types of files supported
Additional features
Restrictions
For more specific information about operating Unicenter CA-XCOM Data
Transport on a specific platform, see the Unicenter CA-XCOM Data Transport
guides for that platform and the manufacturers guides.
AS/400
Use the following format to specify an AS/400 file:
libraryname/filename(membername)
Naming Conventions
The following table describes the parts of an AS/400 file name:

Part Description
libraryname The name of the library that holds the file.
filename The name of the file you wish to access. Periods are allowed
within the file name.
membername The name of the member in the file. If this component is
omitted, it defaults to the file name.
Remote System Information 51
AS/400
Types of Files Supported
In addition to the standard file type discussed above, the Save File format is also
supported. When you wish to send such a file to an AS/400 from a z/OS system,
the file must exist on the target system prior to your transmission.
Additional Features
XQUE is a Unicenter CA-XCOM Data Transport feature that allows the
unattended transfer of reports from output queues to other Unicenter CA-XCOM
Data Transport nodes.
XQUE can select specific classes of reports (based on the user, job name, form,
and so forth) from output queues. XQUE also allows user and/or workstation
groups to be equated to printer destinations on remote Unicenter CA-XCOM
Data Transport nodes. You may use XQUE, for example, to get reports back to
your host system that are generated on an AS/400 that you reach through IBMs
HCF facility, or between multiple AS/400s connected within a pass-through
environment.
Configuration Issues
If you are configuring the VTAM LU that represents the AS/400 on a mainframe,
make sure that the VTAM USS message 10 is not sent to that LU. IBMs APPC
software cannot start a session when this message, commonly called the
welcome message, is sent.
To prevent this problem, the VTAM or NCP USSTAB definition must be set to a
table that does not have a USSMSG10. The table that IBM originally provided
with VTAM is a good alternative because it does not include message 10.
Case Sensitivity
Because the IBM AS/400 is case-sensitive, you must enter the user ID and
password in uppercase.
52 User Guide
z/OS
z/OS
Use the following format to name a z/OS file (data set):
[level1.level2.level3...level7].level8[(membername)]
Naming Conventions
The following table describes the parts of a z/OS file name:

Part Description
level Required.
A file name can consist of multiple levels separated by a
period. Each level has the following characteristics:
It can be up to eight uppercase characters long.
It starts with either an alphabetic character or a national
character. For example, $, #, or @.
There is a limit of eight levels with a total of 44 characters,
including the separating periods.
In most z/OS environments, a data set name is further
restricted by security rules created by the installation. Contact
the appropriate personnel within your organization for
details. Typically, the high-level name (first-level name) must
match your z/OS user ID or some other predefined index.
membername Required for z/OS partitioned data sets only.
Specifies the particular member in a z/OS partitioned data set
(PDS). A PDS is a library containing members that are each
separate sequential files. The member name is appended to
the end of the file name in parentheses. Range: 1 to 8
alphanumeric or national characters.
Note: Most sites catalog all files through the system master catalog. In short, this
means that the system will be able to locate the file you specify by name only.
With the rare occurrence of an uncataloged file, you need to specify the volume
and unit information for the device that holds the file.
Remote System Information 53
z/OS
Examples
The following are examples of valid z/OS data set names:
SYS1.VTAMLST
C54684.UTILITY.CNTL(JOBCARD)
PROD.PAYROLL.SEPT90.TIMECARD.DATA
TESTDATA
A.$DDD.LOAD
Types of Files Supported
Sequential files are the most common forms of data transferred. Individual
members of PDS files may also be sent as sequential files. Entire PDS libraries or
multiple selected members may be transferred between two z/OS systems or
between a Windows system and a z/OS system.
All three types of VSAM files (KSDS, ESDS, and RRDS) may be transferred
between z/OS systems. These VSAM files must be pre-allocated, or they may be
sent to non-z/OS systems as sequential files.
ISAM, BDAM (direct access), IMS, FDR, and DFDSS data sets are not directly
supported, but they can be put into a sequential format using native utilities
prior to transmission.
DCB Information
When creating a new file, z/OS file characteristics must be pre-defined.
Collectively, the following characteristics are known as Data Control Block
(DCB) parameters:
Blocksize
Logical record length
Record format
Volume
Unit
For more information about any of these fields, see an IBM JCL reference
manual.
54 User Guide
Novell NetWare
Additional Features
You should be aware of the following additional features of Unicenter
CA-XCOM Data Transport for z/OS:
CICS interfaceTurn this on by indicating that you wish to notify CICS in
the appropriate remote system notify field in your version of Unicenter
CA-XCOM Data Transport. To do this, provide the VTAM APPLID of the
CICS system in the related ID field. Your z/OS/CICS application
development team can provide you with this. Invoking this interface should
start a CICS transaction program following the successful completion of a
transfer if one has been provided at the host.
Store-and-forwardPerform transfers between two nodes connected to an
intermediate z/OS system by invoking the indirect transfer feature in your
version of Unicenter CA-XCOM Data Transport. This asks you for the final
destination LU name and sends a transfer in two stages. The first stage goes
to the z/OS JES spool, where it waits for the final destination to be connected
before the second stage occurs.
Novell NetWare
Use the following format to name a NetWare file:
Note: Unicenter CA-XCOM Data Transport for LAN Workstation accesses files
from any Novell file server in a NetWare network.
[server\]volume:directory\subdirectory\...\filename
Naming Conventions
The following table describes the parts of a NetWare file name:

Part Description
server Name of the file server
volume: The highest level in a file servers directory and file
structure
Remote System Information 55
Novell NetWare
Part Description
directory\subdirectory One or more optional directories, which allow you to
assign organization to the drive. Range: 1 to eight
characters with an optional 3-character extension (like a
file). If you specify a destination file name with a
directory that does not exist, Unicenter CA-XCOM Data
Transport for Windows creates the directory for you.
Note: If you do not specify a directory, the default
(current) directory is used.
filename The name of the data file.
Types of Files Supported
Unicenter CA-XCOM Data Transport for NetWare LAN supports standard
NetWare file types.
Destination Printer Information
When sending a report to a NetWare system, specify the Destination parameter
value or the Destination Printer field in the following form:
\\server name\printer queue name
Unicenter CA-XCOM Data Transport limits the length of this field as indicated
below. The actual name on the destination system may be longer.

Type of transfer Specify
Direct transfers using Version 2 protocols. Up to 21 characters.
Indirect transfers or transfers using Version 1
protocols.
Up to 16 characters.
Restriction
Unicenter CA-XCOM Data Transport for NetWare LAN does not support library
transfers to Novell NetWare systems.
56 User Guide
OpenVMS
OpenVMS
Use the following format to name an OpenVMS Alpha file or an OpenVMS VAX
file:
device[directory]filename.type;version
The entire file specification can be a maximum of 255 characters. The file type
can be a maximum of 31 characters.
Naming Conventions
The following table describes the parts of an OpenVMS file name:

Part Description
device A disk drive name. If the device is not specified, the default
provided in the SYSUAF (as defined on the DEC system) for
that user is used. Range: 1 to 15 characters.
Note: The Unicenter CA-XCOM Data Transport remote
USERID field determines the SYSUAF USERID.
directory Directory and subdirectory information. If this information is
not provided, defaults will be selected as described under
device above.
Note: Unicenter CA-XCOM Data Transport accepts angle
brackets (< >) in OpenVMS file names, which are converted to
square brackets on the DEC computer.
Example:
PLAYERS1:<BRIDGE>CARD.DAT
is treated as equivalent to:
PLAYERS1:[BRIDGE]CARD.DAT
filename.type The specific file within the directory. OpenVMS null file names
are used if the file name and type are not provided.
version The version of the file. The OpenVMS operating system can
keep multiple versions of a file each time that file is saved. It is
normal to omit this number to indicate that you want the most
recent version of a file, the highest version number.
For more information about OpenVMS file specifications, see the OpenVMS
documentation.
Remote System Information 57
OpenVMS
Restrictions
The following restrictions apply to Unicenter CA-XCOM Data Transport for
OpenVMS Alpha and Unicenter CA-XCOM Data Transport for OpenVMS VAX:
Specifying transfer typeAll transfers must be TYPE=SCHEDULE (for
batch) or QUEUED (from ISPF).
Non-queued host transfersDue to restrictions in the DEC SNA software,
the z/OS TYPE=EXECUTE (non-queued) transfer feature fails with an 8003
sense code. It is not supported by Unicenter CA-XCOM Data Transport to an
OpenVMS system.
Operating systemUnicenter CA-XCOM Data Transport currently supports
the OpenVMS Alpha and OpenVMS VAX operating systems. The Unicenter
CA-XCOM Data Transport guides frequently abbreviate the name of this
operating system as VAX. This is not meant to imply support for UNIX.
ConnectivityThe DECNET/SNA software is based on the Physical Unit
2.0 standard and not on the more flexible 2.1. This means that the system
must be connected to a VTAM (PU 5) system in an SNA network. Unicenter
CA-XCOM Data Transport uses the store-and-forward function (described
previously as an additional z/OS, VM, and VSE feature) to transfer files with
other Unicenter CA-XCOM Data Transport partners.
Multiple session configurationDigital does not support parallel sessions
with a z/OS system. However, if three file transfers are needed concurrently
with an OpenVMS system, it does allow you to define three APPC logical
units as a group. A group name can be from one to eight characters. The first
character must be alphabetic, while the rest can be any combination of
alphanumeric or national characters. Try to use mnemonic names. This
feature is useful for assigning nicknames as well.
The following example calls three logical units, LUD1, LUD2, and LUD3,
and assigns them a group name of LAVAX. Code the GROUP and LU
parameters for this #PSOTAB entry as follows:
GROUP=LAVAX,
LU=(LUD1,LUD2,LUD3)
Type LAVAX as the remote system name to schedule transmissions to this
VAX through the menu interface. When using the batch interface, use the
GROUP parameter instead of the LU parameter. Use the following code:
GROUP=LAVAX
Groups can be used with all the Unicenter CA-XCOM Data Transport
interfaces, including the Process SYSOUT Interface.
58 User Guide
Stratus/System 88
Initiating the session bind requestAlthough separate VTAM LU names
can be used for Unicenter CA-XCOM Data Transport sessions, you should
not LOGAPPL these LUs to Unicenter CA-XCOM Data Transport when
configuring on z/OS or VM. This will fail with an 0801 or 8003 sense code
since the DEC software must initiate the session bind request.
Compression optionsPack options are not supported. Only
COMPRESS=YES is supported for compression.
ASCII basedThe OpenVMS platform is an ASCII based system.
Stratus/System 88
Use the following format to name Stratus files:
#top_directory>group_directory>home_directory>filename.suffix
All names must be unique to that level.
Naming Conventions
The following table describes the parts of a Stratus file name:

Part Description
top_directory The physical disk(s). Range: 1 to 32 characters.
group_directory A group of user home directories. Range: 1 to 32 characters.
home_directory The users home directory. This directory resides in a group
directory. Range: 1 to 32 characters.
filename Required.
The name of the Stratus file. Range: 1 to 32 characters.
suffix A file classification. You can have multiple suffixes at the end
of a file name. Each suffix starts with a period. The following
table describes some common Stratus suffixes:
File type Suffixes Examples
source .pl1, .cobol,
.c
payroll.c, application.cobol
object .obj payroll.obj, application.obj
list .list payroll.list, application.list
error .error payroll.error, application.error
Remote System Information 59
Stratus/System 88
program
module
.pm payroll.pm, application.pm
command
macro
.cm start_up.cm, compile_and_bind.cm
backup .backup payroll.c.backup
Types of Files Supported
Stratus supports the following filetypes for remotely initiated transfers:
FixedThis type of file contains records of the same size. Each record is
stored in a disk or tape region holding a number of bytes that is the same for
all the records in the file.
SequentialThis type of file contains records of varying sizes in a disk or
tape region holding approximately the same number of bytes as the record
(for example, the record storage regions vary from record to record). Records
can only be accessed on a record-by-record basis.
Additional Features
The following are additional features of Unicenter CA-XCOM Data Transport for
Stratus of which you should be aware:
Security optionUnicenter CA-XCOM Data Transport for Stratus can use
its own account file to verify the user ID and password and to map the
Unicenter CA-XCOM Data Transport user ID to a VOS user ID to check for
file access. If this option is turned on and the remote user ID/password
combination is invalid, Unicenter CA-XCOM Data Transport for Stratus
rejects the request.
Restart/Recovery facilityUnicenter CA-XCOM Data Transport for Stratus
can attempt periodic data transmissions after the initial file transfer has
failed. A certain number of retries can be specified through the xcom_ser.pm
file.
Restrictions
The following restrictions apply to Unicenter CA-XCOM Data Transport for
Stratus:
No checkpoint/restartUnicenter CA-XCOM Data Transport for Stratus
Version 1 does not support checkpoint/restart.
No library transfersUnicenter CA-XCOM Data Transport for Stratus does
not support the transfer of libraries from z/OS.
510 User Guide
Tandem
Tandem
Use the following format to name a Tandem file:
\system.volume.subvolume.filename
All of these components are restricted to eight characters, except as indicated
below.
Naming Conventions
The following table describes the parts of a Tandem file name:

Part Description
system The system name. Up to seven characters.
volume The disk name
subvolume Can be thought of as a directory name
filename The name of your file
Example
The following example uses a volume of $CLX12, a subvolume of SCI, and a file
name of FILE1:
$CLX12.SCI.FILE1
The Tandem file system is not a tree structure. Each volume.subvolume is
independent, that is, it has no subvolumes above or below.
Types of Files Supported
Unicenter CA-XCOM Data Transport for Tandem supports the following file
types through ENSCRIBE, Tandems disk file architecture:
Edit files
Unstructured files
Entry-sequenced files
Relative files
Key-sequenced files (for Replace only)
Remote System Information 511
Tandem
Unstructured filesUnstructured files are large-byte arrays. Data in these files
is accessed by using the relative byte address and the READ-COUNT or WRITE-
COUNT parameters in the system procedure calls. The application program
determines the way in which they are used. An EDIT file is a type of
unstructured file signified by the file code 101.
For more information about ENSCRIBE and unstructured files, see the
ENSCRIBE Programmers Guide.
Structured filesUnicenter CA-XCOM Data Transport supports entry-
sequenced and relative structured files.
Entry-sequenced filesEntry-sequenced files are sequential files. Records
are stored in the order in which they are entered. These records are variable
in length and cannot be added or deleted. They are accessed by their record
address.
Relative filesRelative files are ordered by relative record number. The
space allocated for each record is specified when the file is created. Records
in these files can be deleted and added again in place.
Key-sequenced filesKey-sequenced files are supported only for the
Replace operation. The file must already exist for Unicenter CA-XCOM Data
Transport to perform an action on it.
File Type Specification
Locally Initiated Send
Requests
When you send a file from the Tandem, the remote Unicenter CA-XCOM Data
Transport determines the file type when it opens the file.
Receive Requests For locally or remotely initiated receive requests, the file type must be specified
by the GUARDIAN_FILE_TYPE parameter. Use one of the following values:
EDIT
UNSTRUCTURED
ENTRY_SEQ
RELATIVE
512 User Guide
UNIX
Remotely-Initiated Send Requests
For remotely-initiated transfer requests (that is, send a file, job, or report), use the
following:

Record Format Guardian File Type Created
F Relative
FB Entry Sequence
VB Edit
U Unstructured
Note: Key sequence files are supported only if the file exists. You can do a
replace but not a create.
UNIX
Use the following format to name a UNIX file:
/directory/subdirectory/.../filename
Use up to 256 characters for the entire path of the file; there are no restrictions on
size for the individual parts of the path.
Naming Conventions
The following table describes the parts of a UNIX path:

Part Description
/ (slash) The root directory when it is in the first position: otherwise, the slash
separates directories and file names in the path.
directory The directory that contains the file. You can specify more than one
directory in a path.
filename The name of the UNIX file.
Types of Files Supported
Unicenter CA-XCOM Data Transport for UNIX supports standard UNIX file
types.
Remote System Information 513
VM
Restriction
Unicenter CA-XCOM Data Transport does not support library transfers to UNIX
systems.
VM
Use the following format to name VM files under the CMS operating system:
filename.filetype
Naming Conventions
The two parts can be a maximum of eight characters in length. They can consist
of letters, numbers, and/or national characters ($, #, @, +, -, :, _). In general,
lowercase letters are not allowed. In the Unicenter CA-XCOM Data Transport for
VM parameters FILE and LFILE, the file name and file type are specified as one
string with a period as a separator.
For minidisk specifications:
CP OWNER is taken from the volume field, if present. Otherwise, the userid
field is used.
CP address is taken from the unit specification. The default is 191.
Note: You may have two files with the same file name and file type, but they
cannot reside on the same minidisk.
Types of Files Supported
The Unicenter CA-XCOM Data Transport Service Virtual Machine runs IBMs
GCS (Group Control System) operating system. Due to the limitations of this
environment, Unicenter CA-XCOM Data Transport for VM only supports the
CMS extended file system format. This covers CMS files on minidisks formatted
with 512, 1,024K, 2,048K, and 4,096K block sizes.
Note: It does not support the following: CMS Shared File System, minidisks
formatted with 800-byte blocks, or tape I/O.
514 User Guide
VM
DCB Information
CMS file characteristics must be predetermined when creating a new file. You
must specify the following parameters:
Record format - This can be fixed (F) or variable (V).
Logical record length - This is the number of characters in the longest line of
the file.
Restriction
The following table lists the maximum logical record lengths for different file
types:

File type Maximum logical record length
Disk file 32767 bytes
Job (RDR file) 80 bytes
Report (PRT file) 133 bytes
Remote System Information 515
VSE
VSE
When accessing a file on a VSE system, the Remote file name field indicates the
file-id as it would be specified on the DLBL (an indicator of whether the file is
VSAM or SAM) and, optionally, additional information needed for locating the
file.
Format for VSAM file
names
Use the following format to name a VSAM file:
file-id,V[,catalog-id]
VSAM Naming Conventions
The following table describes the parts of a VSAM file name:

Part Description
file-id The name given to the data set when it was defined using
IDCAMS by including the following line in the JCL:
DEFINE CLUSTER (NAME (file-id)...
V Indicates that this is a VSAM file.
catalog-id Optional.
The name of the user catalog that owns the VSAM data set as
defined using IDCAMS by including the following line in the JCL:
DEFINE USERCATALOG (NAME (catalog-id)...
Leave this field blank if the data set is owned by the master
catalog.
516 User Guide
VSE
SAM Naming Conventions
Format for SAM file
names
Use the following format to name a SAM file:
file-id,S,[unit],[location],[size],[override]
The following table describes the parts of a SAM file name:

Part Description
file-id The name that identifies this data set in the VTOC of the specific
DASD volume. This is the file-id you specify on the DLBL JCL
statement. Range: 1 to 44 characters.
Note: Do not enclose it in quotes.
S Indicates that this is a SAM file.
unit The physical device address as defined by the CUU parameter on the
ASSGN JCL statement. It identifies the disk drive on which this file
resides. This parameter can be omitted if the UNIT or VOL
parameters are specified, or if a DASD manager is in use.
location Optional for output files.
The starting location of the file on the disk, as defined on the
EXTENT JCL statement. If a DASD manager is in use, specify a value
of 1.
size Optional for output files.
Indicates how much space this data set will use, as defined on the
EXTENT JCL statement. For CKD devices, this is the number of
tracks. For FBA devices, this is the number of blocks.
Remote System Information 517
VSE
Part Description
override Optional for output files.
Indicates whether this file should be processed as if the FLLTAB
option for DASDM were coded as indicated by the override
parameter. The override applies only to the processing for the file
whose data set name is on the statement that the statement where the
override appears. The following are the available override
parameters and their equivalent DFLTAB option:
DMYES to force DASDM=YES for this file.
DMNO to force DASDM=NO for this file
DMEPIC to force DADSM=EPIC for this file.
Note: If you are running with a DASD manager, the DASD
managers STRTTRK or Trigger value is placed in the location field.
DASD manager pools should be indicated by putting the pool name
in the Volume parameter.
For EPIC/VSE users, you may omit the following:
The location if you want EPIC to default to its STRTTRK value.
The size if you want EPIC to default to its DEFEXT value.
The Volume information if you want EPIC to default to its
DEFPOL value.
For BrightStor CA-Dynam users who want to access Dynam catalog
controlled files (included GDG data sets), no extent information
should be entered. (No cuu, location, size, or override information
and no Volume or Unit parameters for the files you are referencing.)
518 User Guide
VSE
TAPE Naming Conventions
Format for TAPE file
names
Use the following format to name a TAPE file:
file-id,T,[unit],[unit],[unit],[override]
The following table describes the parts of a TAPE file name:

Part Description
file-id The name that identifies this data set in the tape manager catalog or
in the HDR1 label on the tape. This is the file ID you specify on the
TLBL JCL statement. Range: 1 to 44 characters.
Note: When the file ID contains imbedded spaces or commas, it
should be enclosed in quotes.
Note: IBM only supports a 17-character file ID in a tape header label.
If you have a tape manager, 44-character tape file IDs may be
supported. Unicenter CA-XCOM Data Transport does not validate
your file ID, but takes whatever you put on the statement and passes
it along to IBMs OPEN routine or to your tape manager as you have
entered it.
T Indicates that this is a TAPE file.
Note: If you enter a transfer request from a platform that has not yet
implemented the extended tape processing parameters or menu
interface fields for controlling tape processing to a Unicenter
CA-XCOM Data Transport/VSE server, you must use the T option.
You are restricted to standard label tape processing.
unit The physical device address as defined by the CUU parameter on the
ASSGN JCL statement. If you are using TAPEM=YES|EPIC,
Unicenter CA-XCOM Data Transport ignores any units coded and
the tape manager does the tape AVR and assignment. If you are not
using the tape manager, the primary assignment is made to the first
unit Unicenter CA-XCOM Data Transport finds. Other units found
are assigned as temporary alternates.
This parameter can be omitted if you prefer to use the UNIT
parameter to specify a unit or two units (primary and alternate). This
parameter can be used in conjunction with the UNIT parameter to
specify a primary unit and up to four alternate units that will be
assigned by Unicenter CA-XCOM Data Transport prior to open.
Units specified on the statement containing the file-id will be
assigned before units specified on the UNIT parameter. Prior to
Unicenter CA-XCOM Data Transport/VSE Version 2.3.0, the unit
parameter is ignored because tape processing is supported only
when you have a tape manager on your VSE system.
Remote System Information 519
VSE
DTF Information
VSE file characteristics must be predetermined when creating the files. If sending
to or receiving from a VSE system you must specify the following:
The record format (RECFM), which can be either fixed (F), fixed blocked
(FB), variable (V) or variable blocked (VB).
The logical record length (LRECL) indicates the number of characters in the
longest record in the file.
The block size (BLKSIZE), which can be either equal to the LRECL for fixed
files, a multiple of the LRECL for fixed blocked files, the LRECL +4 for
variable files or the BLKSIZE +4 for variable blocked files.
Types of Files Supported
IBM VSE supports VSAM (RRDS, KSDS, and ESDS) and SAM files.
Restrictions
The following restrictions apply to Unicenter CA-XCOM Data Transport for
VSE:
No FILEOPT=ADD for receiving VSEUnicenter CA-XCOM Data
Transport for VSE does not support FILEOPT=ADD if the VSE is receiving
the file.
No Checkpoint/Restart for SAMUnicenter CA-XCOM Data Transport for
VSE does not support checkpoint/restart for SAM jobs.
520 User Guide
Windows
Windows
Unicenter CA-XCOM Data Transport for Windows only supports the FAT file
system. Use the following format to name Windows files:
d:\[directory name]\..\filename.[ext]
Naming Conventions
The following table describes the parts of a Windows file name:

Part Description
d A particular device. The C drive is the most common local hard
drive, the A drive is the most common floppy, and the F drive is the
most common network drive. PCs support a facility in which a
section of memory (RAM) can also be used as a virtual disk drive.
In high-speed link environments, the performance of Unicenter
CA-XCOM Data Transport is directly related to the speed of the disk
drive. In most environments, the fastest to the slowest devices are as
follows:
RAM disks (D drive)
Directly connected hard disks (C drive)
Network disks (F drive)
Floppy disks (A or B drive)
Note: If you do not specify a drive, the default (current) drive is
used. This directory in Windows changes, depending on the last
application accessed.
directory
name
One or more optional directories that allow you to assign
organization to the drive. Range: 1 to eight characters with an
optional 3-character extension (like a file). If you specify a destination
file name with a directory that does not exist, Unicenter CA-XCOM
Data Transport for Windows creates the directory for you.
Note: If you do not specify a directory, the default (current) directory
is used.
filename Required.
The name of the data file. Range: 1 to 8 characters (characters past
position eight generate an error).
Remote System Information 521
Windows NT Server/Professional
Part Description
ext The file extension used to further identify the file. Executable
programs must use the extension .EXE or .COM. Range: 1 to 3
characters.
Note: If you do not specify an extension, Unicenter CA-XCOM Data
Transport does not supply a default.
Restriction
The following restriction applies to Unicenter CA-XCOM Data Transport for
Windows:
APPC restrictionsDue to the vast number of vendor APPCs and link types
supported by Unicenter CA-XCOM Data Transport, consult the APPC
vendors manual for restrictions on the services provided by that vendor.
These restrictions may impact such features as z/OS TYPE=EXECUTE
transfers, environments to which you can send, etc.
Windows NT Server/Professional
Unicenter CA-XCOM Data Transport for Windows NT Server/Professional
supports the standard Windows NT file names and the Universal Naming
Convention (UNC). The file naming conventions for Windows NT are similar to
those for Windows, with some significant differences, some of which are
outlined below.
Use the following format to name files when using standard Windows file
names:
d:[\][directory name\..\]filename[.ext]
Use the following format to name files when using UNC file names:
\\server name\share name\directory\filename
522 User Guide
Windows NT Server/Professional
Naming Conventions
The following table describes the parts of Windows file names and UNC file
names:

Part Description
d Required.
A particular device, indicated as a drive letter.
directory
name
Required.
One or more optional directories and subdirectories.
Subdirectories can take the form of name[.ext].
Note: The form of the directory name and file name depend on the
operating system running on the server.
filename Required.
The name of the data file.
For FAT file systems, filename is 1 to 8 characters.
NTFS and HPFS file systems support long file names, up to 256
characters, including the extension.
Names may or may not be case sensitive, depending on the file
system on the server.
For FAT, NTFS and HPFS, names are not case sensitive. You can use
uppercase and lowercase when creating a name, and they will
display as typed, but internally Windows makes no distinction for
this. For example, Windows would consider MYFILE and MyFiLe as
references to the same file.
Windows also creates an MS-DOS-style name based on the long
name for compatibility with environments where long file names are
not always supported.
ext The file extension used to further identify the file.
For FAT file systems, the extension is up to 3 characters.
For NTFS and HPFS, the extension is included in the long file name
limit of 256 characters.
Note: If you do not specify an extension, Unicenter CA-XCOM Data
Transport does not supply a default.
server
name
The name of the server.
Remote System Information 523
Windows NT Server/Professional
Part Description
share
name
The share name is network provider dependent.
For Microsoft Windows networks this is the name of the share.
For NetWare networks this is the name of the volume.
Types of Files Supported
Unicenter CA-XCOM Data Transport supports standard Windows file types.
Additional Features
Additional features include the following:
File Systems The standard Windows file systems are:
File Allocation Table format (FAT)
Windows NT File System format (NTFS)
High-performance File System format (HPFS)
File Access Unicenter CA-XCOM Data Transport accesses files locally or from any file server
on the Microsoft Windows Network or the NetWare or Compatible Network, or
any other network provider installed on the Windows system.
Security User IDs and passwords are case sensitive.
Home Directory A Windows user can have a default home directory assigned by the Windows
administrator.
524 User Guide
Windows NT Server/Professional
Destination Printer Information
When sending a report to a Windows system, specify the Destination parameter
value or the Destination Printer field in the following form:
\\server name\printer queue name
Unicenter CA-XCOM Data Transport limits the length of this field as indicated
below. The actual name on the destination system may be longer.

Type of transfer Specify
Direct transfers using Version 2 protocols. Up to 21 characters.
Indirect transfers or transfers using Version 1
protocols.
Up to 16 characters.
Restrictions
Access to directories and files on drives formatted for NTFS can be controlled
with the security features of Windows.
Access to all files on a Windows system can be controlled by the permissions set
on a directory or file. The access rights of the user ID on the remote system
determine the actions permitted for the transfer. Users cannot use a directory or
file unless they have been granted the appropriate permissions.
Remote System Information 525


Chapter
6
Performance Tuning

The following suggestions are listed in the order that will, in general, provide the
best performance from Unicenter CA-XCOM Data Transport:

Suggestion Impact
Improve the Link
Speed
For SNA/APPC. Throughput is dictated by the speed of
the slowest link when using a gateway, bridge, or router.
Faster links provide faster performance. The link with the
best performance is the Token Ring (local Token Rings
onlyremote controllers are significantly slower), then
Coax (locally connected), then SDLC (or any remote
cluster controller). 3174-attached Token Rings normally
produce higher throughput than 37xx Token Ring links.
Transfer Big Blocks Big blocks transfer much faster than small blocks. For
client-initiated transfers, use BINARY mode rather than
TEXT mode and specify a large value for maximum record
length. Or you can use record packing by specifying
CARRIAGE_FLAG=MPACK. When using the GUI, these
values are set in the Encoding options on an Edit Transfer
window. Select ASCII (Pack), BINARY, or EBCDIC (Pack).
Tune the SNA
Request/response
Unit
For SNA/APPC. The maximum RU size parameter of the
configuration can have a significant bearing on
productivity. On a typical packet-switched network, using
an RU size of 256 should yield the best performance. For
other network environments, a larger RU size will yield
better performance when sending large amounts of data.
To increase the RU size on a token ring link, increase the
frame size to support the largest RU sent.
Note: The maximum RU size (and frame size for token
ring environments) on the partner side must match the
sizes specified on the local side. Otherwise, the value is
negotiated downwards
Performance Tuning 61
Suggestion Impact
Tune the SNA
Pacing Count
For SNA/APPC. The receive pacing count can also
significantly influence Unicenter CA-XCOM Data
Transport productivity. The setting of the pacing count
value should closely correlate with the communication
line quality. As a guiding rule, the better the line quality,
the higher the pacing count should be.
Note: The pacing value on the partner side must match
that on the local side. Otherwise, the value is negotiated
downwards.
Enable/disable
Compression
Data compression may provide the best throughput and
line utilization. Unicenter CA-XCOM Data Transport
compresses any group of four or more blanks or binary
zeros and sends out a compressed data stream. The data
compression feature should provide maximum savings
when transmitting text files that usually have a large
percentage of blank space. However, data compression
also increases the CPU usage for each data transfer and
may, in some cases, create additional overhead. The new
zlibn compressions have been developed for maximum
throughput with minimum overhead.
To decide whether the use of data compression may be
helpful (especially for bulk data transmission), send a
small sample of the data twice, once with data
compression and once without. Check the Unicenter
CA-XCOM Data Transport.LOG file (located in your
Unicenter CA-XCOM Data Transport DataPath) for the
character per second throughput.
Tune Checkpointing Checkpointing is the process where transfers that failed
due to a communication failure can be restarted at the last
checkpoint record. It is especially useful for large files, but
it can slow down transmission speed dramatically.
For a maximum increase in the rate of transfer, turn
checkpointing off completely by setting the Checkpoint
Count to zero.
However, if you are transferring a large file, being able to
restart from the last checkpoint may well justify a decrease
in transfer rates. In this case, you can minimize the speed
loss by choosing the highest checkpoint value appropriate
for the size of your file.

62 User Guide

Appendix
A
Unicenter CA-XCOM Data
Transport Parameters

Use parameter values to control the variables that govern Unicenter CA-XCOM
Data Transports behavior. The parameter values can be set through the
Graphical User Interface, from the command prompt, in configuration files or in
a script.
Unicenter CA-XCOM Data Transport Parameters A1
Parameter Values Used in the GUI
Parameter Values Used in the GUI
Parameter values can be defined to Unicenter CA-XCOM Data Transport when
using the GUI as indicated in the following table. The values take precedence
depending on where they are specified. The order in which parameter values
take precedence is as follows:

Order Parameter
Value Specified
in
Explanation
1. Fields and
options on-screen
in the GUI and in
an open
configuration file
If the user specifies a value for a parameter on-
screen through the GUI, this overrides every other
specification in an open configuration file that has
not been saved, and overrides any values in the
program.
If a configuration file is open, the unchanged values
specified in that file are used and they override the
values in the XCOM.GLB file.
Note: When the configuration file is saved, the file is
updated with the values that have been specified in
the GUI.
2. XCOM.GLB If the value is specified in the XCOM.GLB file, it
overrides the value in the program. The values
specified in XCOM.GLB are system-wide defaults
that are generally specified by the system
administrator for use with Unicenter CA-XCOM
Data Transport when it is started.
3. Program defaults If a value is not specified anywhere, the program
has its own (hard-coded) defaults.
A2 User Guide
Parameter Values Used at the Command Prompt
Parameter Values Used at the Command Prompt
Parameter values can be defined to Unicenter CA-XCOM Data Transport from
the command prompt or in a script as indicated in the following table. The
values take precedence depending on where they are specified. The order in
which parameter values take precedence is as follows:

Order Parameter
Value Specified
in
Explanation
1. Command
prompt
If the user specifies a value for a parameter at the
command prompt, this overrides every other
specification in the configuration files or the
program.
2. XCOM.CNF or
FILENAME.CNF
If the value is specified in the XCOM.CNF file, or
in a user-customized configuration file specified
on the command line (for example,
FILENAME.CNF) it overrides the value in the
XCOM.GLB file.
3. XCOM.GLB If the value is specified in the XCOM.GLB file, it
overrides the value in the program. The values
specified in XCOM.GLB are system-wide defaults
that are generally specified by the system
administrator for use with Unicenter CA-XCOM
Data Transport when it is started.
4. Program defaults If a value is not specified anywhere, the program
has its own (hard-coded) defaults.
Parameter Format for Command Prompt and Scripts
When using the command prompt or a script, the Unicenter CA-XCOM Data
Transport parameters consist of assignment statements. The format for
assignment statements is as follows:
PARAMETER_NAME (Always all uppercase, with underscore character (_)
when indicated.)
An equal sign (=)
A character string terminated by a newline
Note: Parameter values are always in uppercase. However, when specifying
directories, file names, user IDs and passwords, you may use uppercase and
lowercase.
Unicenter CA-XCOM Data Transport Parameters A3
Parameter Values Used at the Command Prompt
Syntax
The syntax for assignment statements is as follows:
PARAMETER_NAME=value
Example
In the following example, the parameter EXPIRATION_TIME is set to a value of
6000 seconds.
EXPIRATION_TIME=6000
This controls the maximum time in seconds that a transaction is held in the
transfer queue after execution.
Guidelines
Note the following guidelines for using Unicenter CA-XCOM Data Transport
parameters:
When you type trailing spaces and tabs from the command prompt as part
of a parameter value, they are stripped by the command prompt processor.
When you type trailing spaces and tabs into a file or script with an editor,
using any editor that generates ASCII text, they are treated as part of a
parameter value. In most cases these trailing spaces and tabs should be
removed. If they are not removed they can cause confusion and/or
undesirable results.
Empty lines and lines beginning with a pound sign (#) are discarded.
Examples
In the following examples, the spacespacespace represents trailing spaces.
If you type the following at the command prompt, the trailing spaces are
ignored:
XCOM62 -c1 LOCAL_FILE=XYZspacespacespace
If you type the following into any configuration file using an editor, the
spacespacespace would be treated as part of the name of the LOCAL_FILE.
LOCAL_FILE=XYZspacespacespace
A4 User Guide
List of Unicenter CA-XCOM Data Transport Parameters
List of Unicenter CA-XCOM Data Transport Parameters
The following is a full list of parameters for Unicenter CA-XCOM Data
Transport for Windows NT, with the range of values and defaults for each
parameter. The default values listed here are based on the defaults as supplied in
the sample files XCOM.GLB and XCOM.CNF that come with Unicenter
CA-XCOM Data Transport. Any defaults not specified by these files come from
the programs own defaults.
Note: In this user guide we indicate C:\XCOMNT as the default path. Your
installation may have Unicenter CA-XCOM Data Transport under a different
path or on a different drive. If this default is changed during the installation of
Unicenter CA-XCOM Data Transport, the default values in the XCOM.GLB file
will reflect this change.
Version 2 Parameters
Some parameters are indicated as Version 2 parameters. This refers to Unicenter
CA-XCOM Data Transport Version 2 protocols and Unicenter CA-XCOM Data
Transport Version 1 protocols. If the partner Unicenter CA-XCOM Data
Transport is Version 2, you can use either Version 1 or Version 2 protocols. If the
partner Unicenter CA-XCOM Data Transport is Version 1, you cannot use
Version 2 protocols. Version 1 protocols will ignore Version 2 protocols. Most
Unicenter CA-XCOM Data Transport partners use Version 2.
AGE_TIME
.
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)
Unicenter CA-XCOM Data Transport Parameters A5
List of Unicenter CA-XCOM Data Transport Parameters
ALLOCATION_TYPE
Indicates the unit of storage allocation for a data set created on an IBM
mainframe.
Range The range of values is listed in the following table.

Value Description
CYL Cylinders
TRK Tracks
BLK Blocks
Default None
Note: Version 2 parameter.
ATOE_FILENAME
The name of the file containing the ASCII-to-EBCDIC character conversion table.
This is a custom file used only for creating custom translation tables from ASCII
to EBCDIC, if needed.
Range 0 to 256 characters
Default C:\XCOMNT\CONVTAB\ATOE.TAB
BLKSIZE
Specifies the block size of a data set created on an IBM mainframe.
Note: Used when FILE_OPTION=CREATE
Range 0 to 32767

If the format is Then the block size must be
Fixed or fixed block record A multiple of the record length
Variable record 4 bytes larger than the record length
Undefined record Larger than the largest record length
Default 800
A6 User Guide
List of Unicenter CA-XCOM Data Transport Parameters
CARRIAGE_CONTROL_CHARACTERS
Indicates the type of printer carriage-control codes, if any, that are included in
the report file.
Note: For report transfers only.
Range The range of values is listed in the following table.

Value Description
ASA ASA control codes in column 1.
IBM IBM Machine Characters (valid only for IBM mainframes).
BYPASSASA If data is already in ASA format, bypass conversion.
OTHER No carriage-control codes are used.
Default OTHER
CARRIAGE_FLAG
Specifies the type of file being transferred and some special characteristics of the
conversion done during the transfer.
Range The range of values is listed in the following table.

Value Description
YES Indicates that the transferred file is a text file and a newline
character should be added to the end of incoming records. Also,
newline characters are removed from the ends of lines before an
outgoing record is sent.
When the TCP/IP protocol is specified, YES will be changed to
XPACK automatically, if the value of MAXRECLEN is less than
31K. If the value of MAXRECLEN is greater than or equal to 31744,
this value will not be changed automatically.
NO Indicates no special processing.
Unicenter CA-XCOM Data Transport Parameters A7
List of Unicenter CA-XCOM Data Transport Parameters
Value Description
MPACK Indicates a text file with record packing. Uses 2K pack buffer.
When the TCP/IP protocol is specified, MPACK will be changed to
XPACK automatically, if the value of MAXRECLEN is less than
31K. If the value of MAXRECLEN is greater than or equal to 31744,
this value will not be changed automatically.
VLR Indicates a binary file of variable-length records with a field of 4
bytes preceding each record. Applies to local initiated transfers
only.
XPACK Indicates a text file with record packing. Uses 31K pack buffer.
Note: MPACK does not support a MAXRECLEN (actual record length) over 2K.
XPACK does not support a MAXRECLEN (actual record length) over 31K.
Default YES
CHECKPOINT_COUNT
Defines how often (based on record count) the sending system requests a
checkpoint to be taken. The value 0 indicates no checkpointing.
Note: Setting the CHECKPOINT_COUNT affects performance. Each time a
checkpoint is taken, the output buffers on the receiving system are written to the
disk. On Token Ring, Ethernet, and other high-speed networks, the
CHECKPOINT_COUNT should be set 0 or to the highest allowable value. The
CHECKPOINT_COUNT should not be set for small files.
Range 0 to 9999
Default 1000
Note: Version 2 parameter.
A8 User Guide
List of Unicenter CA-XCOM Data Transport Parameters
CLASS
The print class assigned to a report transferred to a remote system.
If the remote system is an IBM mainframe, this field designates the JES SYSOUT
class.
Note: For report transfers only.
Example Enter B to print the report through SYSOUT=B.
Range 1 character
Default None
CODE_FLAG
Used to identify the type of data being transferred.
Range The range of values is listed in the following table.

Value Description
ASCII An ASCII file is being transferred. This indicates that the incoming
file is assumed to be ASCII format, and is not translated. Therefore
the file on the remote system should be in ASCII format before it is
transferred.
BINARY A binary file, such as an executable file, is being transferred. This
indicates to a remote system that it is not to translate the data it is
exchanging with your system.
EBCDIC An EBCDIC file is being transferred. The transferred data is
translated from EBCDIC to ASCII format when the local system
receives the data and from ASCII to EBCDIC format when the local
system sends the data.
Default ASCII
Unicenter CA-XCOM Data Transport Parameters A9
List of Unicenter CA-XCOM Data Transport Parameters
CODETABL
Specifies the prefix to the file names, atoe.tab and etoa.tab, that contain the
external ASCII-to-EBCDIC and EBCDIC-to-ASCII custom character conversion
tables. These custom character conversion tables determine which external
translation tables will be used by the transfer.
This parameter is valid only if INTERNAL_CONVERSION_TABLES=NO.
Range 0 to 12 characters
Default None
COMPRESS
Indicates the compression type. When communicating with an IBM mainframe,
if the data file contains any empty lines, COMPRESS must be set to YES.
Note: Not all compression types are supported on all platforms. For supported
compression types, see the partner platform documentation.
Range The range of values is listed in the following table.

Value Description
COMPACT RJE compaction algorithm optimized for uppercase English
text.
LCOMPACT RJE compaction algorithm optimized for lowercase English text.
LZLARGE Activates LZ compression to search back 32K in the data stream
for a matching string.
LZMEDIUM Activates LZ compression to search back 16K in the data stream
for a matching string.
LZRW3 General-purpose algorithm that runs fast and gives reasonable
compression.
LZSMALL Activates LZ compression to search back 4K in the data stream
for a matching string.
NO Indicates no compression.
RLE Run length encoding.
A10 User Guide
List of Unicenter CA-XCOM Data Transport Parameters
Value Description
YES Indicates run length encoding of binary zeros and blanks only.
ZLIB(n) Greater compression than LZRW3 but less than LZSMALL,
LZMEDIUM, and LZLARGE. The optional n value can be 1
through 9.
Note: The LZ values enable LZ (Lempel-Ziv) compression to replace sequences
of data bytes that occur more than once in a data stream with a code value.
Default YES
CONTROL
For multiple transfers. Use the syntax for performing a single transfer and then
separate parameters for different transfers in the same configuration file by
using this parameter.
Range NEWXFER or NONE
Default NEWXFER
CONVERT_CLASSES
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
COPIES
The number of copies that are to be sent. If this parameter is not specified, the
remote system queues one copy of the report to the systems default printer. For
report transfers only.
Range 1 to 999
Default 1
Unicenter CA-XCOM Data Transport Parameters A11
List of Unicenter CA-XCOM Data Transport Parameters
CREATE_DIRECTORIES
Indicates whether a non-existent directory should be created to accommodate
incoming file transfers. CREATE_DIRECTORIES=YES causes the non-existent
directory to be created.
Range YES or NO
Default YES
DAEMON_TIMEOUT
Specifies the number of minutes Unicenter CA-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.
DAEMON_TIMEOUT can be set in the xcom.glb file or from the Properties
Dialog Pages of the GUI.
Range 10 to 1440
Default 60
DATACLAS
Specifies the name of the data class to be use when allocating a new SMS-
managed data set.
Note: This parameter applies only to mainframe SMS data sets.
Range 1 to 8 characters
Default None
DEBUG_FLAG
Indicates whether to print trace data to STDERR.
Range YES or NO
Default NO
A12 User Guide
List of Unicenter CA-XCOM Data Transport Parameters
DEN
Specifies the density to be used in creating a tape on the remote system.
Range 1 to 4Valid values are the same as those for the DEN parameter in JCL.
Default None
DESTINATION
Identifies the printer or other device on the remote system where the report is to
be sent. If this parameter is not specified, the remote system sends the report to
the system's default printer. For report transfers only.
Range The range of values is listed in the following table.

Value Description
0 to 16 characters For indirect transfers and for Version 1.
0 to 21 characters For transfers that are not indirect and for Version 2.
Default None
DESTINATION_TYPE
The type of target system.
Range HOST, MIDRANGE, or OTHER
Default OTHER
Note: This parameter is saved in the .cnf file by the GUI. It is used by the GUI to
determine what menus should be displayed and is not required for transfers.
Unicenter CA-XCOM Data Transport Parameters A13
List of Unicenter CA-XCOM Data Transport Parameters
DISPOSITION
Indicates what the remote system does with the report file after the report has
been printed. For report transfers only.
Note: This field is not used when the remote system is an IBM mainframe.
Range The range of values is listed in the following table.

If the value is Then after printing the report is
DELETE Deleted
KEEP Kept
HOLD Held
Default DELETE
DOMAIN
The Windows domain name for use in authenticating the user ID and password.
Range 1 to 15 characters
Default None
DSNTYPE
Specifies the data set definition.
Note: This parameter applies only to mainframe SMS data sets.

Value Description
LIBRARY Defines a PDSE
PDS Defines a partitioned data set
Note: These values are IBM standards for SMS processing.
Range 1 to 8 characters
Default None
A14 User Guide
List of Unicenter CA-XCOM Data Transport Parameters
EOL_CLASSES
A character string containing print classes for which an ASCII newline character
will be appended to each record. For incoming report transfers only.
Range 1 to 64 characters
Default None
ETOA_FILENAME
The name of the file containing the EBCDIC-to-ASCII character conversion table.
This is a custom file used only for creating custom translation tables from
EBCDIC to ASCII, if needed.
Range 1 to 256 characters
Default C:\XCOMNT\CONVTAB\ETOA.TAB
EXPDT
Specifies an expiration date for the tape data set in terms of a two-digit
designation for the year and a three-digit designation for the day of the year. For
example, in the expiration date 02021, 02 is the year (namely, 2002) and 021 is the
21st day of that year when the tape data set expires. For example, if 02021 is an
expiration date, 2002 is the year and 021 is the 21st day of the year.
Range yyddd
Default None
EXPIRATION_TIME
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.
Note: If EXPIRATION_TIME is set to no value in XCOM.GLB, the program
default of 6000 is used.
Range 0 to 32767
Default 6000
Unicenter CA-XCOM Data Transport Parameters A15
List of Unicenter CA-XCOM Data Transport Parameters
FCB
Identifies the FCB JCL parameter when sending the report file to an IBM
mainframe, defining print density, lines per page. For report transfers only.
Range 0 to 4 characters
Default None
FILE_ACCESS_PASSWORD
Password for access to local files.
Range 0 to 14 characters
Default None
FILE_ACCESS_USERNAME
Name of user accessing local files.
Range 0 to 20 characters
Default None
FILE_OPTION
Indicates how the transferred data is to be processed by the receiving system. For
file transfers only.
Range The range of values is listed in the following table.

Value Description
CREATE Create a new file on the receiving system.
APPEND Append the transferred data to an existing file on the
receiving system.
REPLACE Replace an existing file on the receiving system.
A16 User Guide
List of Unicenter CA-XCOM Data Transport Parameters
For library-type transfers, the range of values is as follows:

Value Description
CREATE Creates the PDS on the receiving system and adds the
transferred members. If the PDS already exists, the transfer
fails. If the directory does not exist the reaction depends on
the value of CREATE_DIRECTORIES in the global file:
If CREATE_DIRECTORIES=YES , the transfer creates the
directory and adds the transferred members.
If CREATE_DIRECTORIES=NO, the transfer fails.
ADD
APPEND
Adds or replaces transferred members on the receiving
system. If the PDS does not exist, the transfer fails. The value
of CREATE_DIRECTORIES also determines the outcome of
the transfer on the remote system.
If CREATE_DIRECTORIES=YES and the directory does
not exist then the directory is created and the transfer
members are added to this directory. If the directory does
exist, the transfer members are added to this existing
directory.
If CREATE_DIRECTORIES=NO and the directory does
not exist, then the transfer fails. If the directory does exist,
then the transfer adds the transfer members to the
directory.
REPLACE Adds or replaces transferred members. If the directory does
not exist the reaction depends on the value of
CREATE_DIRECTORIES in the global file:
If CREATE_DIRECTORIES=YES , the transfer creates the
directory and adds the transferred members.
If CREATE_DIRECTORIES=NO, the transfer fails.
Note: The DirTree feature does not support SUSPEND and RESUME transfers
using wildcards.
Default CREATE
Note: When creating a file on an IBM mainframe system, some additional
information may be necessary. For more information, see the
RECORD_FORMAT, BLKSIZE, VOLUME, and UNIT parameters.
Unicenter CA-XCOM Data Transport Parameters A17
List of Unicenter CA-XCOM Data Transport Parameters
FILE_OPTION_RF
Indicates how the transferred data is to be processed by the receiving system
(that is, the local system). Used when the transfer type is Retrieve File. If a value
is not specified, then the value defaults to CREATE.
Range The range of values is listed in the following table.

Value Description
CREATE Create a new file on the receiving system.
APPEND Append the transferred data to an existing file on the
receiving system.
REPLACE Replace an existing file on the receiving system.
For library-type transfers, the range of values is as follows:

Value Description
CREATE Creates the PDS on the receiving system and adds the
transferred members. If the PDS already exists, the transfer
fails. If the directory does not exist the reaction depends on the
value of CREATE_DIRECTORIES in the global file:
If CREATE_DIRECTORIES=YES, the transfer creates the
directory and adds the transferred members.
If CREATE_DIRECTORIES=NO, the transfer fails.
ADD
APPEND
Adds or replaces transferred members on the receiving system. If
the PDS does not exist, the transfer fails. The value of
CREATE_DIRECTORIES also determines the outcome of the
transfer on the remote system.
If CREATE_DIRECTORIES=YES and the directory does not
exist then the directory is created and the transfer members
are added to this directory. If the directory does exist, the
transfer members are added to this existing directory.
If CREATE_DIRECTORIES=NO and the directory does not
exist, then the transfer fails. If the directory does exist, then
the transfer adds the transfer members to the directory.
A18 User Guide
List of Unicenter CA-XCOM Data Transport Parameters
Value Description
REPLACE Adds or replaces transferred members. If the directory does not
exist the reaction depends on the value of
CREATE_DIRECTORIES in the global file:
If CREATE_DIRECTORIES=YES, the transfer creates the
directory and adds the transferred members.
If CREATE_DIRECTORIES=NO, the transfer fails.
Note: The DirTree feature does not support SUSPEND and RESUME transfers
using wildcards.
Default CREATE
FORM
The type of form that should be used to print the report. Since Unicenter
CA-XCOM Data Transport places the print job in the remote system's print
queue, the print control functions depend on the remote system. The user must
verify beforehand that the requested form is available at the remote site. For
report transfers only.
Note: When sending a report to a VAX computer, leave this parameter blank
unless you are certain that this is a valid form type. VMS interprets this to mean
that no special form is being requested.
Range 0 to 10 characters
Default None
HOLDFLAG
Indicates whether a transferred report file is to be placed on HOLD on the
remote system or is to be printed immediately. For report transfers only.
Range YES or NO
Default NO
Unicenter CA-XCOM Data Transport Parameters A19
List of Unicenter CA-XCOM Data Transport Parameters
IMPLICIT_PACKING
Indicates whether TCP/IP should always use packing.
Range YES or NO
Default YES
INTERNAL_CONVERSION_TABLES
Indicates whether internal or external conversion tables should be used for
ASCII-to-EBCDIC conversion and EBCDIC-to-ASCII conversion. The external
conversion files may be customized to meet your needs. For the appropriate
directory and file name, see ATOE_FILENAME and ETOA_FILENAME.
Range The range of values is listed in the following table.

Value Description
YES Use internal conversion tables.
NO Use the external tables contained in ATOE_FILENAME and
ETOA_FILENAME.
Default YES
LABEL
Indicates the type of label associated with a tape data set.
Range The following table lists the valid values for this parameter:

Value Definition
Processing type:
AL, AUL, BLP, LTM,
NL, NSL, SL, SUL
Represent the types of processing to be applied to data
sets on tape.
Note: Unicenter CA-XCOM Data Transport for z/OS supports only standard
label tapes.
A20 User Guide
List of Unicenter CA-XCOM Data Transport Parameters
Example LABEL=BLP
The type of processing to be applied to this data set is BLP.
Default SL
LABELNUM
Indicates the sequence number of the data set on the tape.
Range The following table lists the valid values for this parameter:

Value Definition
sequence number
(1-9999)
This value identifies the sequence number of a data set
on tape.
Example LABELNUM=2
This specification refers to the second data set on the tape.
Default 1
LCLNTFYL
Specifies the local user notification level.
Range The range of values is listed in the following table:

Value Description
A or ALL NOTIFY on transfer completion.
W or WARN NOTIFY only if the transfer received a warning or error.
E or ERROR NOTIFY only if the transfer received an error.
Default ALL
Unicenter CA-XCOM Data Transport Parameters A21
List of Unicenter CA-XCOM Data Transport Parameters
LOCAL_FILE
The name of the file on the local system that is being transferred. At the
command prompt or in a script, if this variable is null or unset, standard input is
read. In this manner, Unicenter CA-XCOM Data Transport commands can be
used in a pipeline or with redirection. All Windows NT and UNC file naming
conventions apply.
Note: If QUEUE=YES, user must specify full path name.
Range 0 to 256 characters
Default None
LOCAL_FILE_RF
The file name that is created, appended, or replaced on the local system when it
receives a file. At the command prompt or in a script, if this value is null or
unset, then Unicenter CA-XCOM Data Transport writes to the standard output
file. All Windows NT and UNC file naming conventions apply.
Note: If QUEUE=YES, user must specify full path name.
Range 0 to 256 characters
Default None
LOCAL_FILE_SJ
Indicates the name of the file on the local system to be sent as a job. At the
command prompt or in a script, if this variable is null or unset, Unicenter
CA-XCOM Data Transport reads the standard input file. All Windows NT and
UNC file naming conventions apply.
Note: If QUEUE=YES, user must specify full path name.
Range 0 to 256 characters
Default None
A22 User Guide
List of Unicenter CA-XCOM Data Transport Parameters
LOCAL_FILE_SR
Local file name to be sent as a report to the remote system. At the command
prompt or in a script, if this value is null or unset, Unicenter CA-XCOM Data
Transport reads the standard input file. All Windows NT and UNC file naming
conventions apply. For report transfers only.
Note: If QUEUE=YES, user must specify full path name.
Range 0 to 256 characters
Default None
LOCAL_NOTIFY
Specifies the user on the local system who is to be notified that Unicenter
CA-XCOM Data Transport has completed a transfer. Unicenter CA-XCOM Data
Transport uses the NOTIFYL parameter to determine the type of notification to
use.
Range 0 to 64 characters
Default None
LRECL
Specifies the actual or maximum length, in bytes, of a logical record.
Corresponds to the JCL LRECL subparameter.
Range 0 to 32767

If the format is Then the maximum length of a logical record must be
equal to the
Variable blocked
record
Maximum record length plus 4
Fixed or fixed
block record
Constant record length
Default 160
Unicenter CA-XCOM Data Transport Parameters A23
List of Unicenter CA-XCOM Data Transport Parameters
MAIL_USERNAME
If NOTIFYR is set to MAIL, specify a value here to use for your messaging
system profile name.
Range 0 to 255 characters
Default xcom
MAX_QUEUE_ENTRIES
The maximum number of entries allowed in the transfer queue. Once the
maximum number of queue entries is reached, subsequent transfer attempts are
rejected by Unicenter CA-XCOM Data Transport.
Note: This value depends on the memory available when Unicenter CA-XCOM
Data Transport is started.
Range 0 to n
The value of n is the maximum allowed memory segment divided by 512.
Default 50
MAX_SESSIONS_ENTRIES
The maximum number of partners that can be described in the XCOM.SES file.
Range 1 to 999
Default 50
A24 User Guide
List of Unicenter CA-XCOM Data Transport Parameters
MAXRECLEN
For Windows and UNIX systems, the locally initiating Unicenter CA-XCOM
Data Transport system determines the values for MAXRECLEN, TRUNCATION,
and LRECL, for send and receive operations. When the local Unicenter
CA-XCOM Data Transport system initiates a transfer of a text file, this parameter
designates the length, in bytes, of the largest record that can be transferred. If a
record length is longer than this value, Unicenter CA-XCOM Data Transport
uses the value in the TRUNCATION parameter on the initiating side to
determine whether to terminate the transfer or to truncate the record and
continue the transfer. When Unicenter CA-XCOM Data Transport transfers
binary files, this value indicates the length of the records that are transferred. On
a receive operation, MAXRECLEN is set to whatever the LRECL value is on the
initiating side.
Range 1 to 32767
Default 1024
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
MGMTCLAS
Specifies the name of the management class to use when allocating a new SMS-
managed data set.
Note: This parameter applies only to mainframe SMS data sets.
Range 1 to 8 characters
Default None
Unicenter CA-XCOM Data Transport Parameters A25
List of Unicenter CA-XCOM Data Transport Parameters
NOTIFY_NAME
The user on the remote system who is to be notified when Unicenter CA-XCOM
Data Transport completes a transfer.
Note: If the remote system is an IBM mainframe, Unicenter CA-XCOM Data
Transport uses the value of NOTIFYR to determine the type of notification to
deliver.
Range 0 to 12 characters
Default None
NOTIFYL
The local user notification flag.
Range The range of values is listed in the following table.

Value Description
ALL A message is displayed on the local Windows system console.
WRITE A message is displayed on the local Windows system console.
MAIL Send mail to the user.
NONE No notification is sent.
Default NONE
Notes:
The L in NOTIFYL indicates that the local system governs the processing of
the resulting notification on that system.
A MAIL message is sent to the specified user only if a MAPI-compliant
provider is configured as a non-domain account and/or allows local
accounts (such as the xcomd service and the local user ID) access to the
Windows system (for example, Microsoft Mail boxes and address books on
the local system).
Some Microsoft Outlook 2003 security updates may prevent mail notification
from working.

A26 User Guide
List of Unicenter CA-XCOM Data Transport Parameters
NOTIFYR
Specifies the remote user notification type when sending data to a remote
system.
Range The range of values is listed in the following table.

Value Description
MAIL A mail message is sent to the user.
WRITE A message is displayed on the screen.
ALL Notify all users.
TSO The specified TSO user is notified.
WTO Unicenter CA-XCOM Data Transport writes to the log only (WTO).
ROSCOE Notify the specified Advantage CA-Roscoe user.
CICS The specified CICS user is notified (not used for Version 1 type
transfers).
LU The specified Logical Unit is notified (not used for Version 1 type
transfers).
NONE No notification is sent.
Default NONE
Notes:
The R in NOTIFYR indicates that the local system governs the processing of
the resulting notification on that system.
A MAIL message is sent to the specified user only if a MAPI-compliant
provider is configured as a non-domain account and/or allows local
accounts (such as the xcomd service and the local user ID) access to the
Windows system (for example, Microsoft Mail boxes and address books on
the local system).
Some Microsoft Outlook 2003 security updates may prevent mail notification
from working.

Unicenter CA-XCOM Data Transport Parameters A27
List of Unicenter CA-XCOM Data Transport Parameters
NOTIFY_TERM
Specifies terminals to write if NOTIFYL=WRITE. If NOTIFY_TERM is not set, all
users specified in LOCAL_NOTIFY will be notified at the first terminal where
they are logged in as found in the system table.
Range 0 to 256 characters
Default None
NUMBER_OF_RETRIES
Indicates the maximum number of retries before a transfer is logged as failed. If
the value is 0, the transfer will not be retried.
Range 0 to 255
Default 1
Note: Version 2 parameter.
NUM_OF_DIR_BLOCKS
Specifies the number of directory blocks to allocate for a data set created on an
IBM mainframe.
Range 0 to 32767
Default 0
Note: Version 2 parameter.
PASSWORD
The password associated with the user ID on a remote system.
Range 0 to 31 characters
Default None
A28 User Guide
List of Unicenter CA-XCOM Data Transport Parameters
PORT
The number of the TCP/IP port on the remote Unicenter CA-XCOM Data
Transport server. Used for TCP/IP transfers only.
Range 1 to 65535
Default 8044
PRIMARY_ALLOC
Identifies primary storage allocation for a data set created on an IBM mainframe.
Range 0 to 99999
Default 1
Note: Version 2 parameter.
PRIORITY
Indicates the priority that Unicenter CA-XCOM Data Transport uses for
scheduling a transfer. If two transfers are scheduled for the same time, the one
with the high priority is processed before one with a normal or low priority.
Range The range of values is listed in the following table.

Value Description
HIGH Set high priority.
NORMAL Set medium priority.
LOW Set low priority.
Default NORMAL
Unicenter CA-XCOM Data Transport Parameters A29
List of Unicenter CA-XCOM Data Transport Parameters
PROTOCOL
The type of communication protocols to use.
Range The range of values is listed in the following table.

Value Description
SNA For transfers using SNA/APPC communication protocols
TCPIP For transfers using TCP/IP communication protocols
Default SNA
Note: If only the TCP/IP Component is installed with the base components of
Unicenter CA-XCOM Data Transport, the default value is TCPIP.
QUEUE
Indicates whether to execute the transmission request immediately or to allow
the request to be queued. If the user does not specify a .cnf file, and has not
changed a .cnf file, the default value is YES.
Note: If NO is specified and the remote system is unavailable, the request aborts.
If YES is specified, START_TIME and START_DATE are read.
Range The range of values is listed in the following table.

Value Description
YES The transfer request goes into a queue and executes depending on
the traffic in the queue and START_DATE and START_TIME.
NO The transfer starts immediately.
Default YES
QUEUE_PATH
Directory containing the transfer queue data files.
Range 0 to 256 characters
Default C:\XCOMNT\Q
A30 User Guide
List of Unicenter CA-XCOM Data Transport Parameters
RECORD_FORMAT
Specifies the record format of a data set created on an IBM mainframe. This
corresponds to the JCL RECFM subparameter. This field is unique to the Edit
Transfer - Send File Window.
Range The range of values is listed in the following table.

Value Description Record Length Comment
F Fixed
unblocked
The same
length as the
data set

FA Fixed
unblocked
ANSI
The same
length as the
data set
Contains ISO/ANSI/FIPS control
characters.
FB Fixed
blocked
Fixed Fixed record length with multiple
records per block.
FBA Fixed
blocked
ANSI
Fixed Multiple records per block where
these records contain ISO/ANSI/FIPS
control characters.
FBS Fixed
blocked
spanned
Fixed Multiple records per block written as
standard blocks.
FM Fixed
unblocked
machine
The same
length as the
data set
Contains machine code control
characters.
FS Fixed
unblocked
spanned
The same
length as the
data set
Written as standard blocks where
these records do not contain any
truncated blocks or unfilled tracks.
U Undefined Undefined
V Variable
unblocked
Variable
VA Variable
unblocked
ANSI
Variable Contains ISO/ANSI/FIPS control
characters.
VB Variable
blocked
Variable Multiple records per block.
VBA Variable
blocked
ANSI
Variable Multiple records per block where
these records contain ISO/ANSI/FIPS
control characters.
Unicenter CA-XCOM Data Transport Parameters A31
List of Unicenter CA-XCOM Data Transport Parameters
Value Description Record Length Comment
VBM Variable
blocked
machine
Variable Multiple records per block where
these records contain machine code
control characters.
VBS Variable
blocked
spanned
Variable May have multiple records per block
where these records can span more
than one block.
VM Variable
unblocked
machine
Variable Contains machine code control
characters.
VS Variable
unblocked
spanned
Variable A record can span more than one
block.
Default VB
REMOTE_FILE
Indicates the file on the remote computer to which the transferred data is being
written. If you are creating the file (FILE_OPTION=CREATE), the file name must
be consistent with the file naming conventions of the remote system. If the
receiving system is a Windows NT system and more than one file is included in
the transfer, REMOTE_FILE must include a wildcard character (* ). The local
Unicenter CA-XCOM Data Transport system does not validate this name. The
remote I/O system determines whether the file name is valid.
Note: For send file transfers only.
Range 1 to 256 characters
Default None
REMOTE_FILE_RF
Indicates the name of the file to be retrieved from the remote system.
Note: For retrieve file transfers only
Range 1 to 256 characters
Default None
A32 User Guide
List of Unicenter CA-XCOM Data Transport Parameters
REMOTE_SYSTEM
The name of the remote system that receives a file, job or report.
For SNA/APPC protocols, the name is the symbolic destination name from the
CPI-C side information record.
For TCP/IP protocols, the value can be the remote systems IP address, host
name, or domain name.
Range 1 to 256 characters
Default None
REMOTE_SYSTEM_RF
The name of the remote system that sends a file on a receive file operation.
For SNA/APPC protocols, the name is the symbolic destination name from the
CPI-C side information record.
For TCP/IP protocols, the value can be the remote systems IP address, host
name, or domain name.
Range 1 to 256 characters
Default None
REMOTE_SYSTEM_SJ
The name of the remote system to which a job is sent.
For SNA/APPC protocols, the name is the symbolic destination name from the
CPI-C side information record.
For TCP/IP protocols, the value can be the remote systems IP address, host
name, or domain name.
Range 1 to 256 characters
Default None
Unicenter CA-XCOM Data Transport Parameters A33
List of Unicenter CA-XCOM Data Transport Parameters
REMOTE_SYSTEM_SR
The name of the remote system to which a report is sent.
For SNA/APPC protocols, the name is the symbolic destination name from the
CPI-C side information record.
For TCP/IP protocols, the value can be the remote systems IP address, host
name, or domain name.
Range 1 to 256 characters
Default None
REMOVE_TRAIL_BLANKS
Indicates whether or not to remove the blanks at the end of each record when
receiving a text file.
Range YES or NO
Default NO
REPORT_TITLE
Used by Unicenter CA-XCOM Data Transport on remote systems in the
following ways:

System Uses the REPORT_TITLE
AS/400 To assume this to be the printer file name.
MVS To interpret a non-blank value in this field as specifying the
generation of a separator (banner) page for this value.
VAX/VMS To print with the report.
UNIX To allow Unicenter CA-XCOM Data Transport to pass this field
to the LP spooler as a title field.
Other systems As a descriptive comment only and does not print it as part of
the report.
Range 0 to 21 alphanumeric or blank characters
Default None
A34 User Guide
List of Unicenter CA-XCOM Data Transport Parameters
RESTART_SUPPORTED
Specifies whether automatic restart is to be supported on a transfer.
Range YES or NO
Default YES
Note: Version 2 parameter.
RETPD
Specifies the number of days (1 to 9999) that the tape data set being created is to
be retained.
Range 1 to 9999
Default None
Note: RETPD and EXPDT are mutually exclusive; specify one or the other.
RETRY_TIME
The number of seconds between retries of unsuccessful transfers. If the value is
0, the transfer is retried without delay.
Range 0 to 99999
Default 1
Note: Version 2 parameter.
Unicenter CA-XCOM Data Transport Parameters A35
List of Unicenter CA-XCOM Data Transport Parameters
RMTNTFYL
Specifies the remote user notification level when sending data to a remote
system.
Range The range of values is listed in the following table:

Value Description
A or ALL NOTIFY on transfer completion.
W or WARN NOTIFY only if the transfer received a warning or error.
E or ERROR NOTIFY only if the transfer received an error.
Default ALL
SECONDARY_ALLOC
Identifies secondary storage allocation for a data set created on an IBM
mainframe.
Range 0 to 99999
Default 1
Note: Version 2 parameter.
SECURE_SOCKET
Specifies whether to use an OpenSSL socket or non-OpenSSL socket for transfers.
Range The range of values is listed in the following table:

Value Description
YES Performs secure transfer.
The transfer uses an OpenSSL socket and must to connect
to a SSL listener on the remote partner.
NO Performs non-secure transfer.
The transfer uses a non-OpenSSL socket.
Default NO
A36 User Guide
List of Unicenter CA-XCOM Data Transport Parameters
SESSIONS_FILE
The path name of the XCOM.SES file. This file tells Unicenter CA-XCOM Data
Transport the number of parallel sessions available for locally initiated transfers
for each remote system.
Range 0 to 256 characters
Default C:\XCOMNT\CONFIG\XCOM.SES
SHELL_CMD
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
SOCK_DELAY
TCP/IP Socket option TCP_NODELAY. Refers to the Nagle algorithm for send
coalescing. By default, small sends may be delayed. Should have no impact for
normal Unicenter CA-XCOM Data Transport record sizes. Used for TCP/IP
transfers only.
Note: Socket options affect the way Unicenter CA-XCOM Data Transport uses
the TCP/IP stack implementation.
Range The range of values is listed in the following table.

Value Description
YES Small sends may be delayed. (Does not disable the Nagle algorithm.)
NO All sends are immediate. (Disables the Nagle algorithm.)
Default YES
Unicenter CA-XCOM Data Transport Parameters A37
List of Unicenter CA-XCOM Data Transport Parameters
SOCK_RCV_BUF_SIZE
TCP/IP Socket option SO_RCVBUF. The buffer size for receives. 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 Unicenter CA-XCOM Data Transport uses
the TCP/IP stack implementation.
Range 0 to 65536
Default 0
SOCK_SEND_BUF_SIZE
TCP/IP Socket option SO_SNDBUF. The buffer size for sends. 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 Unicenter CA-XCOM Data Transport uses
the TCP/IP stack implementation.
Range 0 to 65536
Default 0
A38 User Guide
List of Unicenter CA-XCOM Data Transport Parameters
SPACE
The unit of storage allocation for the remote file.
Range
Value Description
CYL Cylinders
TRK Tracks
BLK Blocks
Specify by
Primary allocation space for the remote file
Secondary allocation for the remote file
Directory blocks for the remote file
Default CYL
SPOOL_FLAG
Indicates whether the report is to be spooled to disk or printed immediately. For
report transfers only.
Note: If the remote system is an IBM mainframe, this parameter has no effect on
the transfer.
Range YES or NO
Default YES
START_DATE
Indicates the date on which the transfer becomes eligible for execution. The
format is mm/dd/yy. If this field is blank, the current date is used.
Example A value of 02/21/03 indicates February 21, 2003 as the start date.
Range mm/dd/yy
Default None
Unicenter CA-XCOM Data Transport Parameters A39
List of Unicenter CA-XCOM Data Transport Parameters
START_TIME
Indicates the time when the transfer becomes eligible for execution. The military
format of hh:mm:ss is used. If this field is blank, then the current time is used.
Example A value of 14:00:00 indicates 2 p.m. as the start time.
Range hh:mm:ss
Default None
STAT_FREQUENCY
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 1
STORCLAS
Specifies the name of the storage class for a new SMS-managed data set.
Note: This parameter applies only to mainframe SMS data sets.
Range 1 to 8 characters
Default None
TAPE
Indicates to the remote system whether the volume is a tape volume or a disk
file.
Range YES - Indicates a tape volume and that mounts are allowed when performing
dynamic allocation.
NO - Indicates that the transfer is to a disk file.
Default NO
A40 User Guide
List of Unicenter CA-XCOM Data Transport Parameters
TCP_CMD
Path and name of the Unicenter CA-XCOM Data Transport program started by
the XCOMD Unicenter CA-XCOM Scheduler service that is used for transfers
that use TCP/IP protocols.
Range 0 to 256
Default C:\XCOMNT\XCOMTCP.EXE
TEMPDIR
Indicates the directory in which temporary files for jobs and reports can be
created.
Range 1 to 256 characters
Default C:\XCOMNT\TMP
TP_CMD
Path and name of the Unicenter CA-XCOM Data Transport program started by
the XCOMD Unicenter CA-XCOM Scheduler service that is used for transfers
that use SNA/APPC protocols.
Range 0 to 256 characters
Default C:\XCOMNT\XCOMTP.EXE
Note: If only the TCP/IP Component is installed with the base components of
Unicenter CA-XCOM Data Transport, there will be no default value.
TRACE_PATH
The directory containing the trace data files.
Range 0 to 256 characters
Default C:\XCOMNT\TRACE
Unicenter CA-XCOM Data Transport Parameters A41
List of Unicenter CA-XCOM Data Transport Parameters
TRANSFER_ID
Allows the user to enter information to identify the file transfer request.
Note: This is equivalent to the IDENT field on UNIX and Linux.
Range 0 to 10 characters
Default None
TRANSFER_TYPE
Generated by the graphical user interface to specify the type of transfer to
initiate.
Can also be used in a configuration file that has multiple transfers in it, to specify
a different transfer type from the default value.
Range 1 to 4

Value Description
1 Send job
2 Send report
3 Send file
4 Receive file
Default 3
Note: The functionality of this parameter is similar to using the -cNUMBER
command with XCOM62 or XCOMTCP at the command line. However, the
values used to indicate the type of transfer are different.
TRANSFER_USR_DATA
An open field where a user can specify any text associated with the transfer.
Note: This is equivalent to the XFERDATA field on UNIX and Linux.
Range 0 to 10 characters
Default None
A42 User Guide
List of Unicenter CA-XCOM Data Transport Parameters
TRUNCATION
Indicates whether Unicenter CA-XCOM Data Transport truncates excess
characters in the source file if the record exceeds the maximum record length as
indicated by the MAXRECLEN parameter. If NO is selected, and the maximum
record length is exceeded, Unicenter CA-XCOM Data Transport aborts the
transfer. This parameter is ignored if CARRIAGE_FLAG=NO.
Note: Truncation is not applicable for BINARY data.
Range YES or NO
Default NO
TRUSTED
To allow the user to request a trusted transfer.
Range YES, NO, Y, or N
Default None
TXPI_BUF_SIZE
For TCP/IP transfers, the internal buffer size for sends and receives. The default
size allows multiple Unicenter CA-XCOM Data Transport records to be received
in a single socket call. With this default, if your Unicenter CA-XCOM Data
Transport record size is less than 32K, Unicenter CA-XCOM Data Transport will
attempt to receive multiple records in a single socket call. Used for TCP/IP
transfers only.
Range 0 to 65536
Default 32768
Unicenter CA-XCOM Data Transport Parameters A43
List of Unicenter CA-XCOM Data Transport Parameters
TXPI_RECEIVE_TIMEOUT
Indicates the 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 function,"select",
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_SEND_CHECK_FREQ
Indicates the frequency that Unicenter CA-XCOM Data Transport checks to see if
incoming error information is available when sending data. For example, if the
value is 5, a check is made every fifth time that data is sent, to determine if data
is available for receiving. Larger values give better performance. Smaller values
minimize the sending of data after the partner reports an error. Used for TCP/IP
transfers only.
Range 0 to 9999
Default 10
TXPI_TERM_TIMEOUT
Maximum wait time, in seconds, for 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
will occur only during an error in the termination of the connection. Used for
TCP/IP transfers only.
Range 0 to 999 seconds
Default 20 seconds
A44 User Guide
List of Unicenter CA-XCOM Data Transport Parameters
UNIT
Intended for specifying to a remote system (primarily an IBM mainframe) the
unit that a data set is to be created on.
Range 0 to 6 characters
Default None
UNITCT
Specifies the number of units to be allocated on the remote system.
Range 1 to 20
Default None
UNIT_RF
Specifies the unit from which a data set is to be retrieved from an IBM
mainframe.
Range 0 to 6 characters
Default None
USER_DATA
An open field where a user can specify any text associated with the transfer.
Note: This is equivalent to the SYSDATA field on UNIX and Linux.
Range 0 to 10 characters
Default None
USERID
The user ID which the security system on a remote system checks before
granting access for the file transfer.
Range 0 to 12 characters
Default None
Unicenter CA-XCOM Data Transport Parameters A45
List of Unicenter CA-XCOM Data Transport Parameters
VERSION
Indicates the version of the Unicenter CA-XCOM Data Transport protocol to be
used for this transfer. For using TCP/IP, only a value of 2 is valid.
Range 1 or 2
Default 2
Note: Version 2 parameter.
VOLCT
Specifies the maximum number of volumes to be used in processing a multi-
volume output tape data set on the remote system.
Range 1 to 255
Default None
VOLSQ
Specifies the sequence number of the first volume of a multi-volume remote data
set to be used.
Range 1 to 255
Default None
VOLUME
Specifies the volume on which a data set is to be created on an IBM mainframe.
Range 1 to 6 characters
Default None
A46 User Guide
List of Unicenter CA-XCOM Data Transport Parameters
VOLUME_RF
Specifies the volume from which a data set is to be retrieved from an IBM
mainframe.
Range 0 to 6 characters
Default None
WRITE_EOF
When receiving a text file, set to YES to have the end of file character (CTRL + Z)
written at the end of the file.
Range YES or NO
Default NO
XBUFFSIZE
The size of Unicenter CA-XCOM Data Transports internal buffer.
Warning! Do not change this parameter unless you are instructed to do so by Unicenter
CA-XCOM Data Transport Customer Support.
Range 1 to 32767
Default 32767
XCOM_CONFIG_SSL
Specifies the configssl.cnf file path and file name.
Range 1 to 256 characters
Default C:\XCOMNT\CONFIGSSL.CNF
XCOM_PASSWORD
The default password for remotely initiated transfers.
Range 0 to 128 characters
Default None
Unicenter CA-XCOM Data Transport Parameters A47
List of Unicenter CA-XCOM Data Transport Parameters
XCOM_SHOW_CIPHER
Specifies whether to display encryption algorithms in the Unicenter CA-XCOM
Data Transport queue detailed information, which is used for transfers.
Range The range of values is listed in the following table:

Value Description
NO Do not display encryption algorithms in the queue detail
information.
YES Display encryption algorithms in the queue detail
information.
Default NO
XCOM_USERID
The default user ID for remotely initiated transfers. If this value begins with a
blank or is set to no value, Unicenter CA-XCOM Data Transport will not require
remotely initiated transfers to specify a USERID. The transfer will run under the
same security level as the XCOMD Unicenter CA-XCOM Scheduler service.
Range 0 to 32 characters
Default XCOM
XENDCMD
The name of the post processing command optionally invoked by the Unicenter
CA-XCOM Data Transport transfer program after any type of transfer is
finished, whether successful or not. Invoked after partner communications have
ended. A sample file is provided in C:\XCOMNT\XCOMEND.BAT.
Range 0 to 256 characters
Default None
A48 User Guide
List of Unicenter CA-XCOM Data Transport Parameters
XIDEST
Specifies the name of the remote system on the intermediate destination that is
designated for store-and-forward transfers. If this variable is null or unset, then a
direct connection to a remote system is attempted.
Note: For store-and-forward transfers only.
Range 1 to 256 characters
Default None
XLOGFILE
The name of the file where Unicenter CA-XCOM Data Transport logs activity. If
you do not specify this parameter, the systemwide log file
C:\XCOMNT\XCOM.LOG is used. If you specify this parameter with a different
file name, the logging information is only sent to the specified file.
Note: Specify the full path name if QUEUE=YES.
Range 0 to 256 characters
Default C:\XCOMNT\XCOM.LOG
XLPCMD
Name of the post-processing command used to send print jobs to the spooler.
For incoming reports only.
Range 0 to 256 characters
Default C:\XCOMNT\XCOMLP.BAT
XLUNAME
Indicates the name of the local LU. This name must match the remote LU name
on the remote system.
Range 1 to 17 characters
Default None
Note: Not used in Unicenter CA-XCOM Data Transport for RS/6000 SNA
Services or RS/6000 SNA Server.
Unicenter CA-XCOM Data Transport Parameters A49
List of Unicenter CA-XCOM Data Transport Parameters
XMODE
Indicates the mode name associated with the SNA/APPC configuration for the
XLUNAME-Remote LU name pair. This name must match the mode name
defined on the remote system.
Range 1 to 8 characters
Default XCOMMODE
XNODESPEC
Required for Brixton and SunLink APPCs. Indicates the name of the node that
specifies the gateway to use for the transfer. Does not apply to other APPCs.
Range 1 to 64 characters
Default None
XNOTIFYCMD
Path name of the command that Unicenter CA-XCOM Data Transport will use 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 C:\XCOMNT\XCOMNTFY.BAT
XPPCMD
The name of the command used for user-defined post-processing.
Range 0 to 256 characters
Default C:\XCOMNT\XCOMPP.BAT
A50 User Guide
List of Unicenter CA-XCOM Data Transport Parameters
XPRECMD
Path name of the command used for user-defined pre-allocation processing, for
locally and remotely initiated transfers. Specify this parameter in XCOM.GLB to
invoke the pre-allocation exit xcompre.
Range 0 to 64 characters
Default None
XTRACE
Indicates the level of desired execution tracing.
Range The range of values is listed in the following table.

Value Definition
0 No tracing.
1-8 Levels of tracing from 1 (lowest) to 8 (highest).
9 Show the contents of the data buffers.
10 Includes levels 1 to 9, plus some additional detailed technical
information.
Default 0
Unicenter CA-XCOM Data Transport Parameters A51


Messages B1
Appendix
B
Messages

The Unicenter CA-XCOM for Windows NT messages contained in this section
are listed in ascending numerical order. These messages are written to a specified
log file on the local system (see the XLOGFILE parameter). Some messages are
also displayed on the users terminal and sent to the remote system.
Error Message Example
Messages with numbers ranging from 0 to 255 are informational or prompt
messages. Messages numbering between 100 and 255 represent CA-XCOM states
and are used in such things as traces. Message numbers of 256 and above are
error messages. The following is an example of a CA-XCOM message:
XCOMN0010I XCOM62 STARTING TRANSFER
Message ID Content
The first four characters of the message ID, XCOM, are constant. The CA-XCOM
system that generated the message is indicated by the fifth character of the
message ID.
The system identifier convention of the fifth character is as follows:

Character
Position
Explanation
1 to 4 The first through fourth characters are always the string XCOM.
5 The fifth character is used as follows:
Character Refers to the following system
C IBM or Microsoft PC-DOS, MS-DOS, and OS/ 2
D Digital Equipment Corp. VAX/ VMS, OpenVMS
Alpha, OpenVMS VAX, and Data General AOS/ VS
E IBM VSE
Error Message Example
B2 User Guide
Character
Position
Explanation
G Data General AOS/ VS
K IBM CICS
M IBM z/ OS
N Windows NT
R Netware
S IBM AS/ 400
T Tandem
U UNIX
V IBM VM
W Windows
8 Stratus Computer and IBM System/ 88
Note: Some of the system identifiers in this list represent systems
that are supported for existing customers but that are no longer
generally available. For a list of currently available Unicenter
CA-XCOM Data Transport platforms, see the Getting Started.
6 to 9 The sixth through ninth characters are used for the message
number, for example, 0001
10 The tenth character is used as follows
Character Indicates
I An informational message. No action is required on
the part of the user.
E An error message. Usually some action is necessary to
correct the problem or to determine the cause.
P A prompt requesting a response by the user.
W A warning message that some type of failure is
occurring which may or may not be fatal to what you
are doing.
List of Messages
Messages B3
List of Messages
The following pages list messages that CA-XCOM can return in response to job
requests, with reasons and recommended user actions, where appropriate. In the
list, the four-character constant (XCOM) and the component identifier (for
Windows NT, this is N), have been deleted from each message ID. The messages
are listed in numerical order.
0007I Major code: 0x00000000 Descriptive message
Reason:
This is a return code from the underlying system software. It is usually followed
by a message describing the meaning of the code.
Action:
Refer to the documentation for the SNA LU 6.2 or other system software.
0008I Minor code: 0x00000000 Descriptive message
Reason:
This is a return code from the underlying SNA APPC.
Action:
Refer to the documentation for the SNA LU 6.2 software.
0010I Starting XCOM Transfer on date_and_time
Reason:
This start of transfer message is issued when a locally initiated transfer is begun.
It is simultaneously placed in the transfer log.
Action:
None.
List of Messages
B4 User Guide
0011I Transfer ended; 0 blocks (0 bytes) transmitted in 0 seconds (0 bytes/ second)
Reason:
This message marks the completion of a locally initiated transfer. It is placed in
the log and written to standard error at the end of a transfer.
Action:
None.
0016E Transfer started by a remote system.
Reason:
This message is issued when a transfer is started by a remote system by allocating
the Unicenter CA-XCOM Data Transport transaction program.
Action:
None.
0017I Transfer expired and was removed from queue.
Reason:
The transfer has expired and has been removed from the queue.
Action:
None.
0022I Transfer suspended by user
Reason:
The transfer has been suspended by the user. This is an informational message
that is sent to the remote side of the conversation to inform the remote system
(and user) that the transfer has been suspended.
Action:
None.
List of Messages
Messages B5
0023I Transfer resumed by RESUME command.
Reason:
The transfer has been resumed by a RESUME command issued from the screen
interface or by the use of the XCOMQM command.
Action:
None.
0024I Transfer scheduled for future execution.
Reason:
The transfer is placed in the XCOMD Unicenter CA-XCOM Scheduler service's
queue.
Action:
None.
0025I Remotely initiated retry.
Reason:
The retry was initiated by the remote system.
Action:
None.
0026I Remotely initiated first try.
Reason:
The transfer was initiated by the remote system.
Action:
None.
List of Messages
B6 User Guide
0027I Remotely initiated restart.
Reason:
The restart was initiated by the remote system.
Action:
None.
0028I Starting locally initiated transfer.
Reason:
The locally initiated transfer is starting.
Action:
None.
0029I Locally initiated transfer started.
Reason:
The locally initiated transfer has started.
Action:
None.
0030E Cannot process a TCPIP transfer from XCOM62.
Reason:
The XCOM62 command was specified with parameters QUEUE=NO and
PROTOCOL=TCPIP in effect.
Action:
Use the XCOMTCP command for transfers using TCP/ IP protocols.
List of Messages
Messages B7
0031E Cannot process an SNA/ APPC transfer from XCOMTCP.
Reason:
The XCOM62 command was specified with parameters QUEUE=NO and
PROTOCOL=SNA in effect.
Action:
Use the XCOM62 command for transfers using SNA/ APPC protocols.
0032I RESUME command enabled transfer for remote restart.
Reason:
RESUME has been requested for a remote-initiated transfer. The transfer will
resume when resumed or automatically restarted from the remote Unicenter
CA-XCOM Data Transport partner.
Action:
None.
0046I CONFIRMED_CHECKPOINT
Reason:
Unicenter CA-XCOM Data Transport is confirming a checkpoint.
Action:
None.
0047I Local transfer restarted.
Reason:
The local transfer has restarted.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
List of Messages
B8 User Guide
0052I Transfer held.
Reason:
The transfer was held from starting at the time for which it was scheduled.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0053I Transfer released.
Reason:
The transfer was released to start at the time for which it was scheduled.
Action:
None.
0075P Warning: XCOMD Unicenter CA-XCOM Scheduler service will abort. Data may be lost.
Go ahead?
Reason:
This is a warning message allowing you one last chance before forcefully
bringing down the XCOMD Unicenter CA-XCOM Scheduler service.
Action:
Respond with y if you want to stop the XCOMD Unicenter CA-XCOM Scheduler
service. Any other reply will not stop the process.
0077I Aborting XCOMD Unicenter CA-XCOM Scheduler service; PID=0
Reason:
Unicenter CA-XCOM Scheduler service is being forced down.
Action:
None. The XCOMD Unicenter CA-XCOM Scheduler service will stop.
List of Messages
Messages B9
0078P Please answer y(yes) or n(no).
Reason:
Please answer y(yes) or n(no).
Action:
Reply to the prompt with a y or an n.
0079I XCOMD Unicenter CA-XCOM Scheduler service: stop requested.
Reason:
A user has requested that the Unicenter CA-XCOM scheduler to stop gracefully.
Action:
None.
0080I XCOMD Unicenter CA-XCOM Scheduler service: stop request received.
Reason:
A user has requested that the XCOMD Unicenter CA-XCOM Scheduler service
stop, and that request has been received by the running XCOMD Unicenter
CA-XCOM Scheduler service process.
Action:
None.
0081I XCOMD Unicenter CA-XCOM Scheduler service: stop request rejected.
Reason:
The XCOMD Unicenter CA-XCOM Scheduler service has rejected a user's request
to stop. Unicenter CA-XCOM Scheduler service cannot be stopped while there
are started or active transfers in the queue.
Action:
Suspend all active transfers and retry the operation.
List of Messages
B10 User Guide
0082I XCOMD Unicenter CA-XCOM Scheduler service: stop request accepted.
Reason:
The XCOMD Unicenter CA-XCOM Scheduler service has accepted a user's
request to stop.
Action:
None.
0085P Configuration cannot be read correctly. Defaults will be taken.
Reason:
Some parameters cannot be taken from the configuration file. This may be caused
by the following reasons:
The configuration file contains errors.
The read() system call returned an error.
Action:
Reply to the prompt. If you do not want defaults to be taken for parameters that
cannot be parsed, reply cancel and check your configurat ion file. Otherwise,
reply ok.
0086P Configuration cannot be read correctly. No action will be taken.
Reason:
Some parameters cannot be taken from the configuration file. This may be caused
by the following reasons:
The configuration file contains errors.
The read() system call returned an error.
Action:
Reply ok. If you do not want defaults to be taken for parameters that cannot be
parsed, check your configuration file and try to open it again.
List of Messages
Messages B11
0087P Do you want to save changes?
Reason:
This warning message appears when you are about to loose some changes you
made to Unicenter CA-XCOM Data Transport parameters to give you the last
chance to save the changes in file.
Action:
Reply to the prompt.
0088I XCOMD Unicenter CA-XCOM Scheduler service started.
Reason:
The XCOMD Unicenter CA-XCOM Scheduler service has started.
Action:
None.
0089I XCOMD Unicenter CA-XCOM Scheduler service ended.
Reason:
The XCOMD Unicenter CA-XCOM Scheduler service has ended.
Action:
None.
0090I Problems starting xwait, Retrying...
Reason:
The Unicenter CA-XCOM Data Transport wait process is unable to start.
Action:
None.
List of Messages
B12 User Guide
0091I xcomxped started.
Reason:
The Unicenter CA-XCOM Data Transport XPE interface has started.
Action:
None.
0092I xwait started.
Reason:
The Unicenter CA-XCOM Data Transport wait process has started.
Action:
None.
0100I XEXIT
Reason:
The Unicenter CA-XCOM Data Transport transaction program is about to exit.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0102I CLEANUP
Reason:
The state machine is about to enter CLEANUP state. In this state, the LU 6.2
conversation is deallocated.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
List of Messages
Messages B13
0103I TP_VALID
Reason:
The state machine is about to enter TP_VALID state. In this state, Unicenter
CA-XCOM Data Transport accepts incoming remote allocates if the
GET_ALLOCATE verb has been issued.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0105I ALLOCATE_CONVERSATION
Reason:
The state machine is about to enter ALLOCATE_CONVERSATION state. It is
about to issue the allocate verb for the remote transaction program.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0106I GET_ALLOCATE
Reason:
The state machine is about to enter GET_ALLOCATE state. In this state,
incoming allocates are sought by the local transaction program.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
List of Messages
B14 User Guide
0107I DEALLOCATE_CONVERSATION
Reason:
The state machine is about to enter DEALLOCATE_CONVERSATION state.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0108I SEND_HEADER
Reason:
The state machine is about to enter SEND_HEADER state. In this state, a buffer is
allocated, the Unicenter CA-XCOM Data Transport header record is created from
the transfer parameters, and the header is sent.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0109I REQUEST_HEADER_CONFIRMATION
Reason:
The state machine is about to enter REQUEST_HEADER_CONFIRMATION state
where the incoming header is confirmed, and, if necessary, the connection is
turned around.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
List of Messages
Messages B15
0111I SEND_MAXLRECL
Reason:
The state machine is about to enter SEND_MAXLRECL state. Here, the state
machine will send the maximum logical record length as specified in the
configuration file.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0112I SENDING_DATA
Reason:
The state machine is about to enter SENDING_DATA state. Unicenter CA-XCOM
Data Transport sends one data record each time it enters this state.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0113I DATA_CONFIRM
Reason:
The state machine is about to enter DATA_CONFIRM state. In this state, the
transaction program issues the confirm that is sent at the end of a data file.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
List of Messages
B16 User Guide
0114I SEND_TRAILER
Reason:
The state machine is about to enter SEND_TRAILER state. The trailer record
containing the number of records is sent.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0115I TRAILER_CONFIRM
Reason:
The state machine is about to enter TRAILER_CONFIRM state. The Unicenter
CA-XCOM Data Transport transaction program is about to issue a deallocate
confirm verb for the conversation.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0116I RECEIVE_HEADER
Reason:
The state machine is about to enter RECEIVE_HEADER state. In this state,
Unicenter CA-XCOM Data Transport receives the incoming header.
Action:
None. This message is used to report the state of t he Unicenter CA-XCOM Data
Transport transaction program.
List of Messages
Messages B17
0117I CONFIRM_HEADER
Reason:
The state machine is about to enter CONFIRM_HEADER state. The Unicenter
CA-XCOM Data Transport transaction program is about to issue the confirmed
LU 6.2 verb.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0118I RECEIVE_MAXLRECL
Reason:
The state machine is about to enter RECEIVE_MAXLRECL state. The transaction
program receives the maximum record length record and uses it to initialize
system parameters.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0119I RECEIVE_DATA
Reason:
The state machine is about to enter RECEIVE_DATA state. In this state, the data
records are received, decompressed, unpacked, and written to the target file.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
List of Messages
B18 User Guide
0120I DATA_CONFIRMED
Reason:
The state machine is about to enter DATA_CONFIRMED state. It issues the
confirmed verb and closes the received file in preparation for receiving the trailer
record.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0121I RECEIVE_TRAILER
Reason:
The state machine is about to enter RECEIVE_TRAILER state. A
receive_and_wait verb is issued for the incoming Unicenter CA-XCOM Data
Transport trailer record.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0122I TRAILER_CONFIRMED
Reason:
The state machine is about to enter TRAILER_CONFIRMED state.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
List of Messages
Messages B19
0123I PROCESS_DATA
Reason:
The state machine is about to enter PROCESS_DATA state. In this state, the
transaction program compares the record count actually received to the count
sent in the trailer record. If they don't match, the state machine enters an invalid
trailer state.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0125I TERMINATE_INITIATE_CHECK
Reason:
The state machine is about to enter TERMINATE_INITIATE_CHECK stat e.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0127I TP_DONE
Reason:
The state machine is about to enter TP_DONE state.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0128I RECEIVE_FEATURE_RECORD
Reason:
The state machine is about to enter RECEIVE_FEATURE_RECORD state.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
List of Messages
B20 User Guide
0129I SEND_FILE_DESCRIPTOR
Reason:
The state machine is about to enter SEND_FILE_DESCRIPTOR state.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0130I REQUEST_FEATURE_RECORD_CONFIRM
Reason:
The state machine is about to enter REQUEST_FEATURE_RECORD_CONFIRM
state.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0131I CONFIRMED_FEATURE_RECORD
Reason:
The state machine is about to enter CONFIRMED_FEATURE_RECORD state.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0152I LOCAL_SEND
Reason:
The state machine is about to enter LOCAL_SEND state. In this state, the
transaction program initializes several internal variables, logs the startup
message, and sets the userid for this transfer.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
List of Messages
Messages B21
0153I LOCAL_RECEIVE
Reason:
The state machine is about to enter LOCAL_RECEIVE state. In this state, the
transaction program initializes several internal variables, logs the startup
message, and sets the userid for this transfer.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0154I REMOTE_SEND
Reason:
The state machine is about to enter REMOTE_SEND state.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0155I REMOTE_RECEIVE
Reason:
The state machine is about to enter REMOTE_RECEIVE state.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0156I OPEN_REMOTE_INPUT_FILE
Reason:
The state machine is about to enter OPEN_REMOTE_INPUT_FILE state.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
List of Messages
B22 User Guide
0157I OPEN_LOCAL_INPUT_FILE
Reason:
The state machine is about to enter OPEN_LOCAL_INPUT_FILE state. The local
input file is about to be opened.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0158I OPEN_OUTPUT_FILE
Reason:
The state machine is about to enter OPEN_OUTPUT_FILE state. The output file is
about to be opened.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0159I LOCAL_ATTACH
Reason:
The state machine is about to enter LOCAL_ATTACH state. In this state, the
transaction program tries to establish a connection to the local LU 6.2 SNA server.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
List of Messages
Messages B23
0161I REMOTE_ATTACH
Reason:
The state machine is about to enter REMOTE_ATTACH state. In this state, the
invoked transaction program tries to establish a connection to the local LU 6.2
SNA server.
Action:
This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0162I SET_UP_OVERLAY
Reason:
The state machine is about to enter SET_UP_OVERLAY state. In this state, the
indirect transfer header record is created.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0163I SEND_OVERLAY
Reason:
The state machine is about to enter SEND_OVERLAY state. In this state, it sends
the overlay record that is part of the indirect transfer protocol.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
List of Messages
B24 User Guide
0164I RECEIVE_OVERLAY
Reason:
The state machine is about to enter RECEIVE_OVERLAY state. An indirect
transfer has been requested by the remote side and the overlay record is abou t to
be received.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0165I DO_SYSTEM
Reason:
The state machine is about to enter DO_SYSTEM state.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0167I SET_REMOTE_USER_ID
Reason:
The state machine is about to enter SET_REMOTE_USER_ID state.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0168I DO_COMMAND
Reason:
The state machine is about to enter DO_COMMAND state.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
List of Messages
Messages B25
0169I SEND_FEATURE_RECORD
Reason:
The state machine is about to enter SEND_FEATURE_RECORD state.
Action:
None. This message is used to report the state of the CA-XCOM transaction
program.
0170I RECEIVE_FILE_DESCRIPTOR
Reason:
The state machine is about to enter RECEIVE_FILE_DESCRIPTOR state.
Action:
None. This message is used to report the state of the CA-XCOM transaction
program.
0171I RESTART_TRANSFER
Reason:
The state machine is about to enter RESTART_TRANSFER state.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0172I CHECKPOINT_CONFIRM_REQUEST
Reason:
The state machine is about to enter CHECKPOINT_CONFIRM_REQUEST state.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
List of Messages
B26 User Guide
0180I SENDING_ERROR
Reason:
The state machine is about to enter SENDING_ERROR state.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0182I RECEIVE_ERROR
Reason:
An error message is being received from the remote partner. The Unicenter
CA-XCOM Data Transport transaction program issues a receive and wait verb to
retrieve the text.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0185I SEND_ERROR_MESSAGE
Reason:
The state machine is about to enter SEND_ERROR_MESSAGE state. A send error
verb has been issued and the text of the error encountered is sent.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0186I WAIT_FOR_REMOTE_DEALLOCATE
Reason:
The state machine is about to enter WAIT_FOR_REMOTE_DEALLOCATE state.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
List of Messages
Messages B27
0187I TRANSFER_FAILED
Reason:
The Unicenter CA-XCOM Data Transport transfer has failed.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0188I CHECK_RETURN_CODES
Reason:
Unicenter CA-XCOM Data Transport is checking return codes at the end of a
transfer.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0200I LOCAL_NOTE
Reason:
The state machine is about to enter LOCAL_NOTE state. In this state, the
transaction program initializes several internal variables, logs the startup
message, and sets the userid for this transfer.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0201I REMOTE_NOTE
Reason:
The state machine is about to enter REMOTE_NOTE state.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
List of Messages
B28 User Guide
0202I LOCAL_NOTE_ATTACH
Reason:
The state machine is about to enter LOCAL_NOTE_ATTACH state. In this state,
the transaction program tries to establish a connection to the local LU 6.2 SNA
server.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0203I ALLOCATE_NOTE_CONVERSATION
Reason:
The state machine is about to enter ALLOCATE_NOTE_CONVERSATION state.
It is about to issue the allocate verb for the remote transaction program.
Action:
None. This message is used to r eport the state of the Unicenter CA-XCOM Data
Transport transaction program.
0204I SENDING_NOTE_DATA
Reason:
The state machine is about to enter SENDING_NOTE_DATA state. Unicenter
CA-XCOM Data Transport sends one Eponyms when it enters this state.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
List of Messages
Messages B29
0205I DATA_NOTE_CONFIRM
Reason:
The state machine is about to enter DATA_NOTE_CONFIRM state. In this state,
the transaction program issues the confirm that is sent at the end of an
SDSNOTE.
Action:
None. This message is used to report the state of the Unicenter CA-XCOM Data
Transport transaction program.
0211I queue entry (TID=000000) removed.
Reason:
Queue entry was removed from the queue.
Action:
None. This message is used to report the status of the transfer.
0212I transfer (TID=000000) suspended.
Reason:
Transfer was suspended.
Action:
None. This message is used to report the status of the transfer.
0213I transfer (TID=000000) terminated.
Reason:
Transfer was terminated.
Action:
None. This message is used to report the status of the transfer.
List of Messages
B30 User Guide
0214I transfer (TID=000000) resumed.
Reason:
Transfer was resumed.
Action:
None. This message is used to report the status of the transfer.
0215I transfer (TID=000000) held.
Reason:
Transfer was held.
Action:
None. This message is used to report the status of the transfer.
0216I transfer (TID=000000) released.
Reason:
Transfer was released.
Action:
None. This message is used to report the status of the transfer.
0283E Error allocating send buffer
Reason:
An error was encountered when trying to increase the send buffer size using
realloc() call.
Action:
Retry the transfer. This error may be caused by memory fragmentation.
List of Messages
Messages B31
0284E Error forking: Error 0
Reason:
Cannot create an additional process. Either the user or system process limit has
been reached.
Action:
Check your system and user process limits. Your system administrator may be
able to supply you with this information and/ or raise these limits.
0286E Error setting local user id
Reason:
An error occurred in setting the local user ID. The call to setuid failed.
Action:
Be sure that the local Unicenter CA-XCOM Data Transport transaction program
is either owned by the invoking user or is running setuid root.
0287E Error setting remote user id
Reason:
An error was encountered while trying to set the remote user ID.
Action:
Check that the remotely requested user ID is valid on your system, that the
remote initiator has correctly entered it and the password for it, and that the user
ID has "logon locally" authority.
List of Messages
B32 User Guide
0288E System function failed
Reason:
A call to system( ) has failed. This function is used to initiate command functions
from within Unicenter CA-XCOM Data Transport.
If wait timed out is specified after the error message text, this indicates that the
transferred job did not complete before the DAEMON_TIMEOUT period
expired.
Action:
Retry the transfer. This message may indicate the failure of a system call in a
sendjob or in a pre or post processing script. If the problem persists, take a trace
and contact Computer Associates Customer Support.
If wait timed out is specified, it may be necessary to increase the XCOM.GLB
parameter, DAEMON_TIMEOUT.
0289E Command failed, RC=0
Reason:
A command issued using the system() call has returned a non-zero completion
code.
Action:
Retry the transfer. If the problem persists, contact Computer Associates Customer
Support.
0291E Send of indirect transfer record failed: Descriptive message
Reason:
An error has occurred while attempting to send the overlay record for an indirect
file transfer.
Action:
Check the SNA connectivity and retry. If the problem persists, contact Computer
Associates Customer Support.
List of Messages
Messages B33
0292E Error sending error message to remote system: Descriptive message
Reason:
An error was encountered while sending an error message to the remote system.
Action:
Check the SNA connectivity and retry the transfer. If the problem persists,
contact Computer Associates Customer Support.
0293E Preallocation User Exit failed, RC=n
Reason:
The system() command issued to process the preallocation user exit has returned
non-zero RC=n.
Action:
Investigate the failure of the xcompre.bat exit by doing one of the following:
Running it outside <xcom> under the same user ID as the one used for the
transfer
Setting "echo on" in xcompre.bat and "Allow service to interact with desktop"
in the <xcom> service xcomdsrv
0296E Error deallocating conversation: Descriptive message
Reason:
An error was detected while deallocating a send conversation. This deallocate
occurred after sending a file.
Action:
Check the SNA connectivity and retry the transfer. If the problem persists,
contact Computer Associates Customer Support.
List of Messages
B34 User Guide
0297E Error requesting header confirmation: Descriptive message
Reason:
The remote Unicenter CA-XCOM Data Transport transaction program did not
confirm the transfer request header that it received.
Action:
Check the SNA connectivity and retry the transfer. If the problem persists,
contact Computer Associates Customer Support.
0298E Unable to allocate remote transaction program: Descriptive message
Reason:
The APPC interface returned an error after an attempt was made to allocate a
Unicenter CA-XCOM Data Transport transaction program on a remote LU.
Action:
Check that the remote transaction program can be allocated. On z/ OS, this means
that the APPL is active. On other systems, there are different criteria for
accessibility.
0299E Cannot attach to LU 6.2 facility on local initiate: Descriptive message
Reason:
An error was detected when a locally initiated transfer request attempted to
attach to the APPC manager process.
Action:
Check the SNA status as well as your connection status. Check the
REMOTE_SYSTEM parameter to make sure that it contains the name of the
connection profile that you want to use for this transfer.
List of Messages
Messages B35
0300E Cannot attach to LU 6.2 facility on remote allocate: Descriptive message
Reason:
An error was detected when a remotely initiated transfer request transaction
program attempted to attach to the APPC manager process.
Action:
Check the SNA configuration and retry the transfer. If the problem persists,
contact Computer Associates Customer Support.
0302E Unable to open local input file: No such file or directory. Descriptive message
Reason:
A problem was encountered while trying to open a Unicenter CA-XCOM Data
Transport input file; the data following the explanation is the sense.
Action:
Check the existence and permissions on the file you have specified.
0303E Send of XCOM header failed: Descriptive message
Reason:
An error has occurred while attempting to send a transfer header record.
Action:
Check the SNA connectivity and retry. If the problem persists, cont act Computer
Associates Customer Support.
0304E Send of Maximum Record Length failed: Descriptive message
Reason:
An error has occurred while attempting to send the maximum logical record
length as part of the file transfer setup procedure.
Action:
Check the SNA connectivity and retry. If the problem persists, contact Computer
Associates Customer Support.
List of Messages
B36 User Guide
0305E Receive of incoming header failed: Descriptive message
Reason:
An error was detected while attempting to receive a transfer request header from
a remote system.
Action:
Check the SNA connectivity and retry. If the problem persists, contact Computer
Associates Customer Support.
0309E Error reading local input file: Error 0
Reason:
An error occurred while reading the input file. The system call read() r eturned
-1. The error number displayed is the value of the system variable errno.
Action:
Check the sense code on the message, fix the problem, and retry the transfer.
0310I Received error from remote system.
Reason:
An error has been received from the remote system and has been placed in the
log.
Action:
Check the error received from the remote system and fix the problem detailed
there. Error messages from partner Unicenter CA-XCOM Data Transport systems
can be found in the manuals for those platforms.
List of Messages
Messages B37
0311E Send of user data record failed: Descriptive message
Reason:
An error was returned from the APPC interface while attempting to send data to
a remote system.
Action:
Check the SNA connectivity and retry. If the problem persists, contact Computer
Associates Customer Support.
0312E Confirm to last data record failed: Descriptive message
Reason:
The APPC interface has returned an error when attempting to issue a confirm
following the last data record in a transfer.
Action:
Check the SNA connectivity and retry. If the problem persists, contact Computer
Associates Customer Support.
0313E Negative response to data confirm request: Descriptive message
Reason:
Negative response to data confirm request.
Action:
Contact Computer Associates Customer Support.
0314E Send of trailer record failed: Descriptive message
Reason:
The send of trailer record failed. An error was returned by the SNA subsystem
after the Unicenter CA-XCOM Data Transport trailer was sent.
Action:
Check the SNA connectivity and retry the transfer. If the problem persists,
contact Computer Associates Customer Support.
List of Messages
B38 User Guide
0315E Trailer record not confirmed
Reason:
The trailer record was not confirmed. The remote side has detected an error in
the Unicenter CA-XCOM Data Transport trailer, either in its for mat or in the
number of records transferred.
Action:
This error may be the result of a send text file which contains zero-length records.
If this is the case, try to send the file with the compression turned on.
0319E Error confirming checkpoint: Descriptive message
Reason:
There is an error in confirming the checkpoint.
Action:
Check the SNA connectivity and retry the transfer. If the problem persists,
contact Computer Associates Customer Support.
0320E Error issuing confirmed for checkpoint: Descriptive message
Reason:
There is an error issuing confirmed for the checkpoint.
Action:
Check the SNA connectivity and retry the transfer. If the problem persists,
contact Computer Associates Customer Support.
0321E Error requesting trailer confirmation: Descriptive message
Reason:
An error was encountered when requesting trailer confirmation.
Action:
Check the SNA connectivity and retry. If the problem persists, contact Computer
Associates Customer Support.
List of Messages
Messages B39
0322E Cannot open output file: xxxxxxxx
Reason:
Refer to xxxxxxxx, which may be a Unicenter CA-XCOM Data Transport message
or a Windows message. This error usually involves path error specifications, or
security authorizations of FILE_ACCESS user name or password.
Action:
Check if your target file name is correctly specified. If so, check the user ID and
password for proper authorization.
0403E Cannot open output file: Error 0
Reason:
Cannot open the output file using the requested action.
Action:
Check the sense code on the message, fix the problem, and retry t he transfer.
0404E Error confirming header: Descriptive message
Reason:
An error was encountered when attempting to issue a confirmed response to an
incoming header.
Action:
Check the SNA connectivity and retry the transfer. If the problem persists,
contact Computer Associates Customer Support.
List of Messages
B40 User Guide
0405E Error receiving maxreclen: Descriptive message
Reason:
An error was encountered when trying to read an incoming maximum record
length record or when trying to realloc() a read buffer of the size specified in th e
record received.
Action:
Check the SNA connectivity and retry the transfer. If the problem persists,
contact Computer Associates Customer Support.
0406E Error while trying to read Feature Negotiation Record: Descriptive message
Reason:
An error was encountered while trying to read a feature negotiation record.
Action:
Check the SNA connectivity and retry the transfer. If the problem persists,
contact Computer Associates Customer Support.
0407E Error compress flag in feature negotiation protocol
Reason:
Compression type provided by the remote system is not supported.
Action:
Check Unicenter CA-XCOM Data Transport configuration file on the remote
system and retry.
0408E Error encountered in feature negotiation protocol
Reason:
An error was encountered in feature negotiation protocol.
Action:
Check the SNA connectivity and retry the transfer. If the problem persists,
contact Computer Associates Customer Support.
List of Messages
Messages B41
0409E Error encountered trying to confirm feature negotiation record: Descriptive message
Reason:
An error was encountered in trying to confirm a feature negotiation record.
Action:
Check the SNA connectivity and retry the transfer. If the problem persists,
contact Computer Associates Customer Support.
0410E Error sending feature negotiation record: Descriptive message
Reason:
An error occurred in sending a feature negotiation record.
Action:
Check the SNA connectivity and retry the transfer. If the problem persists,
contact Computer Associates Customer Support.
0411E Error while confirming feature negotiation record: Descriptive message
Reason:
An error occurred while confirming a feature negotiation record.
Action:
Check the SNA connectivity and retry the transfer. If the problem persists,
contact Computer Associates Customer Support.
0412E Error receiving data: Descriptive message
Reason:
An error was detected by the APPC receive and wait verb while reading
incoming data.
Action:
Check the SNA connectivity and retry the transfer. If the problem persists,
contact Computer Associates Customer Support.
List of Messages
B42 User Guide
0413E Trailer invalid
Reason:
The count in the received trailer record did not match the actual number of
records received.
Action:
Check the SNA connectivity and retry the transfer. If the problem persists,
contact Computer Associates Customer Support.
0415E Error receiving trailer: Descriptive message
Reason:
The receive and wait issued for an incoming trailer record has failed.
Action:
Check the SNA connectivity and retry the transfer. If the problem persists,
contact Computer Associates Customer Support.
0416E Error writing output file: Error 0
Reason:
The write() system call has returned a -1. This probably means that the file
system is out of space.
Action:
Check the free space in the file system. Repair the problem and retry the transfer.
0418E Transmission interrupted: signal received
Reason:
An interrupt signal has been received and transmission has been interrupted.
Action:
Retry the transfer. If the problem persists, contact Computer Associates Customer
Support.
List of Messages
Messages B43
0422E Login incorrect.
Reason:
User ID and/ or password do not match security database.
Action:
Provide correct user ID and/ or password.
0423I Error receiving file descriptor record.
Reason:
An error occurred while trying to receive a file descriptor record.
Action:
Check the SNA connectivity and retry the transfer. If the problem persists,
contact Computer Associates Customer Support.
0424E Attempting to create an existing file
Reason:
You cannot create an existing file.
Action:
Decide whether you want to replace the target file or create one using a different
name. Set the parameters appropriately and retry the transfer.
0425E Cannot seek to position on restart
Reason:
When trying to reposition a file to restart a transfer, the fseek() call returned a -1.
This usually indicates a file that has been updated since its transfer was
interrupted.
Action:
Determine why the file was updated and/ or retry the transfer.
List of Messages
B44 User Guide
0426E Restarting from beginning of file
Reason:
Neither alpha nor beta counts match.
Action:
None. The transfer will restart from the beginning of the file.
0427E Error starting TP: no retry possible
Reason:
A call to execl() subroutine returned a non-zero return code; the data following
the explanation is the sense.
Action:
Check if the file specified in TP_CMD parameter in your XCOM.GLB file exists
and has execute permission.
0435I Waiting for an available session.
Reason:
Unicenter CA-XCOM Data Transport is waiting for available sessions to start a
transfer.
Action:
Wait until a session becomes available or increase the session limits in the
XCOM.SES file, restart XCOMD Unicenter CA-XCOM Scheduler service, and
retry the transfer.
0436E TP ended abnormally.
Reason:
The XCOMD Unicenter CA-XCOM Scheduler service has detected a transaction
program failure.
Action:
Retry the transfer. If the problem persists, contact Computer Associates Customer
Support.
List of Messages
Messages B45
0437E Record larger than input buffer.
Reason:
The length of a file record is greater than the length of the input buffer.
Action:
Adjust the size of the buffer and retry.
0438E Record length greater than maxreclen, but truncation not allowed.
Reason:
The length of the received record is greater than maxreclen, but truncation is not
allowed.
Action:
Adjust the size of the buffer and retry.
0440E Internal buffer < maxreclen received.
Reason:
The internal buffer is smaller than the maxreclen received.
Action:
Adjust the size of the buffer and retry.
0441E Remote restart request does not match any queue entry.
Reason:
A remote-initiated transfer is attempting to restart from a checkpoint, but no
matching transfer was found in the local queue. The original transfer may not
have ended before the restart was attempted.
Action:
Restart a new transfer from the remote partner. Increase the value for
RETRY_TIME on the remote partner.
List of Messages
B46 User Guide
0442E Remote restart request matches suspended queue entry.
Reason:
A remotely-initiated transfer was suspended and cannot be restarted.
Action:
Resume the transfer so that it is enabled for restart. The next restart attempt will
not fail with this error.
0443E Record exceeds maxreclen following compression.
Reason:
A compressed record is larger than permitted by MAXRECLEN.
Action:
Increase the MACRECLEN value.
0448E Type of record packing not supported.
Reason:
An unsupported type of record packing was specified in the header.
Action:
Check that the remote system is generating a packing type that corresponds to an
XCOM-supported packing type: YES, NO or MPACK. For AT&T or NCR
systems, the value of the mode definition code set field must be set to A for
ASCII.
0454E Invalid starting date format.
Reason:
The transfer was not scheduled because the starting date cannot be parsed.
Action:
Repair the date format and retry the transfer.
List of Messages
Messages B47
0455E Invalid starting time format.
Reason:
The transfer was not scheduled because the starting time cannot be parsed.
Action:
Repair the time format and retry the transfer.
0456E Cannot open EBCDIC-ASCII translation file.
Reason:
Internal conversion is set to NO but the specified EBCDIC-ASCII translation file
cannot be opened.
Action:
Check that the EBCDIC to ASCII conversion table file specified in the Unicenter
CA-XCOM Data Transport configuration file variable ETOA_FILENAME exists
and is readable.
0457E Cannot open ASCII-EBCDIC translation file.
Reason:
Internal conversion is set to NO but the specified ASCII-EBCDIC translation file
cannot be opened.
Action:
Check that the ASCII to EBCDIC conversion table file specified in the Unicenter
CA-XCOM Data Transport configuration file variable ATOE_FILENAME exists
and is readable.
List of Messages
B48 User Guide
0458E Cannot open EBCDIC-ASCII translation file.
Reason:
An error was encountered while trying to parse the EBCDIC-ASCII translation
file.
Action:
Check the EBCDIC to ASCII file. It must be 256 lines long and contain a single
integer specified according to C conventions: a leading 0 indicates an octal
number, a leading 0x indicates a hexadecimal; anything else is decimal.
0459E Cannot open ASCII-EBCDIC translation file.
Reason:
An error was encountered while trying to parse the ASCII-EBCDIC translation
file.
Action:
Check the ASCII to EBCDIC file. It must be 256 lines long and contain a single
integer specified according to C conventions: a leading 0 indicates an octal
number, a leading 0x indicates a hexadecimal; anything else is decimal.
0460E Unable to Queue: Reason.
Reason:
Unicenter CA-XCOM Data Transport is unable to perform an enqueue function.
The reason follows.
Action:
This message may appear for a number of reasons. If the reason is queue is full,
remove some unnecessary entries from the queue, wait for them to be removed
automatically, or increase QUEUE-SIZE and restart XCOMD Unicenter
CA-XCOM Scheduler service. If the reason is cannot close data file, then the file
system is full. Use File Manager to list file systems and check to see which file
system is full, and then clear disk space as needed.
List of Messages
Messages B49
0461E Cannot get shared memory.
Reason:
The Unicenter CA-XCOM Data Transport queue manager cannot get shared
memory.
Action:
Retry the transfer. If the problem persists, contact Computer Associates Customer
Support.
0463E Cannot allocate shared memory.
Reason:
The Unicenter CA-XCOM Data Transport queue manager cannot allocate shared
memory.
Action:
Retry the transfer. If the problem persists, contact Computer Associates Customer
Support.
0464E Cannot create shared memory.
Reason:
The Unicenter CA-XCOM Data Transport queue manager cannot create shared
memory.
Action:
Retry the transfer. If the problem persists, contact Computer Associates Customer
Support.
List of Messages
B50 User Guide
0465E Check of XCOM.GLB pathnames failed.
Reason:
You must specify full paths to XLPCMD, TP_CMD, TRACE_PATH, and
QUEUE_PATH in your XCOM.GLB file.
Action:
Check the XCOM.GLB file to be sure that path names have been specified for
each of the variables listed in the Explanation. Restart the XCOMD Unicenter
CA-XCOM Scheduler service after you fix any problems.
0466E Unable to create an index file for queue.
Reason:
Unable to create an index file for the queue.
Action:
Check the permissions on the directory specified in the QUEUE_PATH variable
in XCOM.GLB. Restart the XCOMD Unicenter CA-XCOM Scheduler service after
you have repaired the problem.
0467E Queue entry passed to XCOMTP is NULL.
Reason:
This is an internal error. The queue entry passed to XCOMTP is NULL.
Action:
Retry the operation. If the problem persists, contact Computer Associates
Customer Support.
0468E Cannot allocate memory.
Reason:
Cannot allocate memory.
Action:
Retry the operation. If the problem persists, contact Computer Associates
Customer Support.
List of Messages
Messages B51
0469E XCOMD Unicenter CA-XCOM Scheduler service is not running or not compatible.
Reason:
The XCOMD Unicenter CA-XCOM Scheduler service, is not running, or the
version of its running copy is not compatible to the version of the Unicenter
CA-XCOM Data Transport package you are using.
Action:
Try to start the XCOMD Unicenter CA-XCOM Scheduler service. If it does not
start, use XCOMD -cy to clean up. If it still does not start, make sure that you
have installed the right version of XCOMD Unicenter CA-XCOM Scheduler
service. Reinstall Unicenter CA-XCOM Data Transport, if necessary.
0470E Invalid number of parameters passed to XCOMTP.
Reason:
An invalid number of parameters has been passed to XCOMTP.
Action:
Retry the transfer. If the problem persists, contact Computer Associates Customer
Support.
0471E Invocation mode undefined.
Reason:
This is an internal error. The invocation mode is undefined.
Action:
Retry the operation. If the problem persists, contact Computer Associates
Customer Support.
List of Messages
B52 User Guide
0472E Current mode undefined.
Reason:
This is an internal error. The current mode is u ndefined.
Action:
Retry the operation. If the problem persists, contact Computer Associates
Customer Support.
0473E Error(s) parsing XCOM.GLB; XCOMD Unicenter CA-XCOM Scheduler service cannot
start.
Reason:
Error(s) found in parsing XCOM.GLB; XCOMD Unicent er CA-XCOM Scheduler
service cannot start.
Action:
Check the XCOM.GLB file and fix any syntax errors you find there. Restart the
XCOMD Unicenter CA-XCOM Scheduler service.
0474E XCOMD Unicenter CA-XCOM Scheduler service is already running. Multiple instances
not supported.
Reason:
XCOMD Unicenter CA-XCOM Scheduler service is already running. Multiple
instances are not supported.
Action:
None required, since the XCOMD Unicenter CA-XCOM Scheduler service is
already running.
List of Messages
Messages B53
0483E Error: unable to fork.
Reason:
Either the system or the user process limit has been reached and no additional
processes can be created.
Action:
Stop some processes, or raise process limits, and retry the operation.
0486E Error writing configuration.
Reason:
An error was encountered while writing the Unicenter CA-XCOM Data
Transport configuration file.
Action:
Check the free space in the file system. If free space is not the problem, check the
permissions on the configuration file that is being written. Repair the problem
and retry the operation.
0488E Input file not specified, but stdin cannot be used.
Reason:
When the local input file is not specified, Unicenter CA-XCOM Data Transport
normally uses console input stream (stdin). This message indicates that stdin
cannot be used for this transfer.
Action:
Specify an input file and retry.
List of Messages
B54 User Guide
0489E Output file not specified: stdout cannot be used.
Reason:
When the local output file is not specified, Unicenter CA-XCOM Data Transport
normally uses console output stream (stdout). This message indi cates that stdout
cannot be used for this transfer.
Action:
Specify an output file and retry.
0491E Versions of different XCOM components are not compatible.
Reason:
The versions of the Unicenter CA-XCOM Data Transport modules are not
compatible.
Action:
Contact Computer Associates Customer Support.
0492E MAXRECLEN exceeds limit for record packing.
Reason:
The maximum block size for packing is 2048 for CARRIAGEFLAG=MPACK and
31744 for CARRIAGEFLAG=XPACK. MAXRECLEN exceeded this limit.
Action:
Reduce the value for MAXRECLEN.
0493E Cannot generate internal transaction id
Reason:
This is an internal error.
Action:
Reduce the EXPIRATION_TIME and increase MAX_QUEUE_ENTRIES and then
stop and restart XCOMD Unicenter CA-XCOM Scheduler service.
List of Messages
Messages B55
0494E Duplicate transfer request number
Reason:
This is an internal error.
Action:
Retry the operation. If the problem persists, contact Computer Associates
Customer Support.
0500E Attempting to write to a directory as a regular file
Reason:
Unicenter CA-XCOM Data Transport is attempting to write a file, but directory
exists with the same name.
Action:
Change the name of the file or delete directory.
0503E RC=503 SENSE=n
Reason:
There may be a problem internal to Unicenter CA-XCOM Data Transport.
Action:
Create a trace of Unicenter CA-XCOM Data Transport for Windows and contact
Computer Associates Customer Support.
0505E Received a signal from APPC.
Reason:
An interrupt signal has been received from APPC and transmission has been
interrupted.
Action:
Retry the transfer. If the problem persists, contact Computer Associates Customer
Support.
List of Messages
B56 User Guide
0508E Error replacing or creating file
Reason:
Unicenter CA-XCOM Data Transport received an error when trying to replace or
create a file.
Action:
Retry the transfer. If the problem persists, take a trace and contact Computer
Associates Customer Support.
0509E The remote partner does not support 31K packing (CARRIAGE_FLAG=XPACK).
Reason:
The remote partner returned an error indicating that the value specified for the
CARRIAGE_FLAG parameter is not supported by that version of Unicenter
CA-XCOM Data Transport.
Action:
Switch to 2K packing (CARRIAGE_FLAG=MPACK) or no packing
(CARRIAGE_FLAG=NO).
0510E 31K packing (CARRIAGE_FLAG=XPACK) is not supported with VERSION=1.
Reason:
CARRIAGE_FLAG=XPACK was specified with VERSION=1.
Action:
Switch to 2K packing (CARRIAGE_FLAG=MPACK) or no packing
(CARRIAGE_FLAG=NO).
0513E VERSION=1 is not valid with PROTOCOL=TCPIP.
Reason:
PROTOCOL=TCPIP was specified with VERSION=1.
Action:
Use VERSION=2 with PROTOCOL=TCPIP or VERSION=1 with
PROTOCOL=SNA.
List of Messages
Messages B57
0514E DESTINATION cannot exceed 16 characters for an indirect transfer.
Reason:
An indirect transfer of a report was requested with a DESTINATION value of
more than 16 characters.
Action:
Change the DESTINATION value to no more than 16 characters.
0600E transfer is not active.
Reason:
The operation which caused this message applicable to active transfers only.
Action:
Wait till the transfer becomes active or try another operation.
0601E Permission denied.
Reason:
You do not have security rights necessary to perform the operation which caused
this message.
Action:
None.
0602E General error in queue function; rc=0.
Reason:
Unicenter CA-XCOM Data Transport is unable to perform an enqueue function.
The reason follows.
Action:
If the reason is cannot write/ open, check to see if your file system is full. If the
reason is queue is full, remove some unnecessary entries from the queue, wait
for them to be removed automatically, or increase QUEUE-SIZE and restart
XCOMD Unicenter CA-XCOM Scheduler service. If the reason is cannot
generate TID, contact Computer Associates Customer Support.
List of Messages
B58 User Guide
0603E the TP state is invalid.
Reason:
The operation that caused this message requires that TP is in some particular
state(s). The current TP state is invalid for this operation.
Action:
Wait for TP to enter the proper state or try different operation.
0604E the maximum number of clients for this server is exceeded.
Reason:
There is a fixed maximum number of clients for each server. This number is
exceeded.
Action:
Log off some of the clients or wait for clients to log off.
0605E the client is already connected to this server.
Reason:
The client with the same XPE name is already logged to the server.
Action:
Try again. If the problem persists, cont act Computer Associates Customer
Support.
0606I the z-request is unknown to this server.
Reason:
A client submitted request that is not supported by the server. The server will
ignore this request.
Action:
Get a server upgrade when available.
List of Messages
Messages B59
0608E Removing client --
Reason:
Server removed client from the list of logged -on clients.
Action:
Logout from the server and connect to it again.
0609E timeout waiting for SEND_COMPLETE event; removing client
Reason:
Server removed client from the list of logged clients because of timeout waiting
for SEND_COMPLETE event
Action:
Logout from the server and connect to it again.
0611E timeout waiting for POLL_COMPLETE event; removing client
Reason:
Server removed client from the list of logged clients because of timeout waiting
for POLL_COMPLETE event
Action:
Logout from the server and connect to it again.
0612E Transport error - please reconnect.
Reason:
Connection to server is broken.
Action:
Disconnect from server and reconnect.
List of Messages
B60 User Guide
0650E XCOM_HOME is not set
Reason:
XCOMD Unicenter CA-XCOM Scheduler service could not find the
XCOM_HOME environment variable.
Action:
Set the XCOM_HOME system environment variable to point to the directory
where Unicenter CA-XCOM Data Transport is installed.
0651E SNAROOTis not set.
Reason:
XCOMD Unicenter CA-XCOM Scheduler service could not find the SNAroot
environment variable in the system environment..
Action:
Check whether SNA is installed. Set the SNAroot system environment variable
to point to the directory where tpstart.exe is installed.
0652E Cannot spawn tpstart.
Reason:
XCOMD Unicenter CA-XCOM Scheduler service could not execute the TPSTART
program.
Action:
Check whether SNA is installed. Verify the directory the SNAroot system
environment variable points to has tpstart.exe installed.
List of Messages
Messages B61
Service-Specific Messages
473 Error(s) parsing xcom.glb; xcomd cannot start.
Reason:
The XCOMD Unicenter CA-XCOM Scheduler Service cannot start. There were
problems parsing XCOM.GLB or XCOM.TID.
Action:
Check that the following conditions apply:
All parameters are in upper case except paths, userids, passwords, or
anything that must be in upper case.
The drive letter is correct for the specific path.
There are no blank lines.
All comments are properly commented out.
There are no extraneous characters on a line.
All parameters are valid for the release and are spelled correctly.
XCOM.TID contains a non-zero, six-digit number. This is your transfer id
number.
474 xcomd is already running. Multiple instances not supported.
Reason:
XCOMD is already running. Multiple instances are not supported.
Action:
None.
List of Messages
B62 User Guide
651 SNAROOTis not set
Reason:
There were errors setting the PROTOCOL and TP_CMD parameters.
Action:
If you are using TCP/ IP protocol only, TP_CMD should be set to blank (not
commented out).
If SNA is installed for Unicenter CA-XCOM Data Transport, the SNA stack must
be installed and running to bring up XCOMD Unicenter CA-XCOM Scheduler
service.
652 Cannot spawn tpstart
Reason:
Unicenter CA-XCOM Data Transport cannot find SNA.
Action:
Check the registry.
0785I Starting TCP/ IP Connection
Reason:
A TCP/ IP connection is being started to a remote partner.
Action:
None.
0786I TCP/ IP Connection Established
Reason:
A TCP/ IP connection was successfully made to a remote partner.
Action:
None.
List of Messages
Messages B63
0793I Remote TCP/ IP Connection Established
Reason:
A TCP/ IP remote connection was successfully established from a remote partner.
Action:
None.
0805I TCP/ IP Connection Ended
Reason:
A TCP/ IP connection completed.
Action:
None.
0811I Starting Secure TCP/ IP Connection
Reason:
A Secure TCP/ IP connection is being started to a remote partner.
Action:
None.
0812I Remote Secure TCP/ IP Connection Requested
Reason:
A request for a Secure TCP/ IP remote connection was received from a remote
partner.
Action:
None.
List of Messages
B64 User Guide
0813I Secure TCP/ IP Handshake Complete
Reason:
Secure Socket Layer (SSL) negotiation for the connection successfully completed.
The connection is now a secure TCP/ IP connection.
Action:
None.
0814I Secure TCP/ IP Connection Requested
Reason:
A request for a secure TCP/ IP connection was sent to the remote partner.
Action:
None.
0818I Secure TCP/ IP Connection Ended
Reason:
A secure TCP/ IP connection completed.
Action:
None.

Appendix
C
Logical Units

A logical unit (LU) is the addressable connection point into an SNA network
through which an end-user can send and receive messages. An LU is a set of
rules and responsibilities. LUs can be either dependent or independent, and each
LU type is associated with a protocol (for example, LU 0, LU 6.2).
The LU provides a connection into SNA for the end-user, which may either be an
individual or a transaction program (for example, Unicenter CA-XCOM Data
Transport). It allows end-users to communicate with each other and with other
network addressable units (NAUs) in the network.
Physical Network Components
An SNA network is divided into physical and logical components.
The physical network consists of the following:
Actual processors called nodes
Data links between the nodes
Logical Units C1
Logical Network Components
Logical Network Components
The logical network consists of a set of software components called network
addressable units (NAUs) that include the following:
Logical units (LUs)
Physical units (PUs)
System services control points (SSCPs)
Session
The logical connection between two NAUs is a session. Although several types
of sessions exist, the end-user is aware of only one type, which is LU-to-LU.
Sessions are established when one LU sends another LU an SNA request known
as a BIND.
PCID
Each session has its own procedure correlation identifier (PCID). This is an eight-
byte field placed in the BIND, UNBIND, and other SNA requests to help an LU
distinguish one session from another. It is required when you are running
parallel sessions.
SID
A PCID is also known as a session identifier (SID) in VTAM displays. For each
session, VTAM prompts you to note the primary or secondary node and displays
the Session ID (SID) in hex. This SID is the PCID. If a trace of the BIND is taken,
the PCID vector is towards the end.
The following VTAM operator command lists all sessions generated for that LU:
DISPLAY NET, ID=XXX,E
C2 User Guide
Logical Unit Types
Logical Unit Types
The following table describes all of the LU types that are in use today:

LU Type Definition
0 A customizable protocol, which eliminates standardization beyond
layers of SNA. This was commonly used in the late 1970s (before the
advent of LU 6.2).
1 The protocol used as early as the 1960s by remote job entry devices
such as the 3770 RJE terminal. Designed for use with printers and card
readers, this protocol is most typically used in asymmetrical links
where one node is a slave to the host.
2 The protocol for 3270 video display stations. It defines the data
streams used by dumb terminals to communicate with the host.
3 This was a variant subset of the 3270 protocol that was used to drive
printers attached to 3274 cluster controllers. Today it is still used to
support old hardware.
4 This protocol was intended for use on word processors attached to a
host network. You may still see it on old IBM word processors.
6.1 Developed during the late 1970s, this was SNAs prototype protocol
defined for program-to-program communication. It was a first attempt
to provide a standardized mechanism for communication between
intelligent peer computers.
6.2 LU 6.2 defines standard functions or verbs such as SEND, RECEIVE,
and CONFIRM that simplify the work of making two programs
running on different platforms talk to each other. This protocol is also
referred to as "Advanced Program-to-Program Communications"
(APPC).
7 This protocol specifies the data stream of the 5250 video display
stations commonly used with the IBM mid-range computers.
Logical Units C3
Criteria for Independent Logical Units
Criteria for Independent Logical Units
Unicenter CA-XCOM Data Transport supports independent logical units (ILUs).
An ILU is a logical unit that can generate sessions independent of the host. An
ILU also meets the following criteria:
It utilizes LU 6.2.
It works on top of PU 2.1.
It can be a primary logical unit and therefore can send a BIND.
It supports an extended BIND (one that contains a Procedure Correlation
Identifier [PCID]) and works with the new NCP PU 2.1 support.
Systems Supporting ILUs
Systems that currently support ILUs include the following:
z/OS
VM (all versions)
AS/400
IBM PC (APPC/PC)
Windows NT, 2000, and XP
Sun 386I
Most minicomputers and UNIX workstations that support PU 2.1
Software Version Support for ILUs
ACF/VTAM Version 3 Release 2 is required for full use of ILUs. The release of
ACF/NCP required depends on the front-end processor being used. An IBM
3725 requires ACF/NCP Version 4 Release 3. A 3270 and 3745 require
ACF/NCP Version 5 Release 2.1. Users working with ILUs over a Token Ring
Interface Coupler (TIC) into a host must have Release 2.1.1, as older releases
permit a token ring-attached PC to push an NCP into slowdown. When using
Unicenter CA-XCOM Data Transport over COAX (event DFT LU 6.2 COAX),
dependent LUs are used because 3174/3274 cluster controllers do not support
PU 2.1.
C4 User Guide
Criteria for Independent Logical Units
LU 6.2 Independent Implementations
Only Type 6 LUs can be independent. All other LU types are dependent.
However, not all LU 6.2 implementations are independent. For example, the
DECnet (VAX) APPC version of Unicenter CA-XCOM Data Transport is said to
be a dependent LU because it works on top of PU 2.0, not PU 2.1.
Not every LU 6.2/PU 2.1 implementation can work with independent LUs.
There are some aspects of PU 2.1 that NCP requires with which not all PU 2.1
implementations work correctly. This reflects the fact that not all minicomputer
and PC SNA Gateway vendors had the latest NCP and VTAM for testing.
However, PU 2.1 support can be enhanced to work with ILUs without changes to
Unicenter CA-XCOM Data Transport. NCP supports ILUs over SDLC, the most
common configuration using ILUs. A local area network gateway attached
through an SDLC link to a host can also use ILUs. NCP also supports ILUs over
a token ring through the (TIC).
Direct Sessions with Dependent Logical Unit
An independent logical unit can have an LU 6.2 session with a dependent LU.
For example, an SDLC-attached PC running PU 2.1 can have an LU 6.2 session
with a Coax-attached PC through a 3174 thats running PU 2.0. (This has been
successfully tested using NSAs APPC.) This allows for direct sessions from an
AS/400 to a VAX/VMS over the SNA background network, even though the
VTAM is PU Type 2.0. In this environment, the VTAM LOGAPPL parameter and
the VTAM VARY NET LOGON command do not work.
Note: The ILU must initiate the session; it must send to the BIND.
PU Type
When using ILUs with VTAM and Netview displays, VTAM shows the PU type
in its status display (PU Type 2 or PU Type 2.1). All PUs originally display as
PU 2.0. Once they become active, they display as PU 2.1.
Logical Units C5


Index1


Index

#
#!ENCRYPT, 3-54
A
accessing the queue, 2-65
adding a new transfer, 2-8
AGE_TIME, A-5
allocation_type API, 4-8
ALLOCATION_TYPE, mainframe file creation
parameter, 3-25, A-6
API
allocation_type, 4-8
blksize, 4-9
carriage_control_characters, 4-9
carriage_flag, 4-10
checkpoint_count, 4-10
class, 4-11
code_flag, 4-11
codtabl, 4-11
compress, 4-12
config_ssl, 4-13
convert_classes, 4-13
copies, 4-13
datacls, 4-13
debug_flag, 4-13
den, 4-14
destination, 4-14
disposition, 4-14
domain, 4-15
dsntype, 4-15
eol_classes, 4-15
example, 4-40
expdt, 4-15
fcb, 4-16
file_option, 4-16
file_type, 4-17
form, 4-17
hold, 4-18
label, 4-18
labelnum, 4-18
lclntfyl, 4-19
local, 4-19
local_file_rf, 4-19
local_file_sj, 4-20
local_file_sr, 4-20
localnotify, 4-20
lrecl, 4-21
maxreclen, 4-21
metacode_classes, 4-21
mgtclas, 4-22
notify_name, 4-22
notify_term, 4-24
notifyl, 4-22
notifyr, 4-23
num_of_dir_blocks, 4-24
number_of_retries, 4-24
password, 4-24
port, 4-25
primary_alloc, 4-25
protocol, 4-25
queue, 4-26
record_format, 4-26
remote_file, 4-28
remote_file_rf, 4-28
remote_system, 4-28
remove_trail_blanks, 4-29
report_title, 4-29
restart_supported, 4-29
retpd, 4-30
return codes, 4-41
rmtntfyl, 4-30
secondary_alloc, 4-30
shell_cmd, 4-31
spool_flag, 4-31
start_date, 4-31
start_time, 4-31

Index2 User Guide
stat_frequency, 4-32
storcls, 4-32
tape, 4-32
tempdir, 4-32
truncation, 4-33
trusted, 4-33
unit, 4-34
unitct, 4-34
userid, 4-34
version, 4-34
volct, 4-35
volsq, 4-35
volume, 4-35
xcomfullssl, 4-35
xendcmd, 4-36
xidest, 4-36
xlogfile, 4-36
xlpcmd, 4-36
xmode, 4-37
xnotifycmd, 4-37
xppcmd, 4-37
xprecmd, 4-37
xtrace, 4-38
apitest.c file, API, 4-40
AS/400, XQUE, 5-2
ASCII/EBCDIC conversion, 3-44
ATOE_FILENAME, global parameter, A-6
B
BAT files, specifying in GUI, 2-82
before performing transfers, 2-16
blksize API, 4-9
BLKSIZE, mainframe file creation parameter, 3-25,
A-6
block transfer, 6-1
browsing log file, 2-62
C
C structures, API, 4-8
carriage_control_characters API, 4-9
CARRIAGE_CONTROL_CHARACTERS, send report
parameter, 3-36, A-7
CARRIAGE_FLAG
encoding options in GUI, 2-29
file type conversion parameter, 3-45, A-7
carriage_flag API, 4-10
changed default directories and drives, 2-2
changing
encrypted parameter values, 3-56
local port, in GUI, 2-86
character conversion, 3-44, 3-47
options, GUI, 2-73
checkboxes, Version 2 options, 2-31
checkpoint
count, 2-43
parameters
CHECKPOINT_COUNT, 3-65, A-8
NUMBER_OF_RETRIES, 3-65
tuning, 6-2
checkpoint/restart, 3-63
Version 2 window, 2-41
checkpoint_count API, 4-10
CHECKPOINT_COUNT, checkpoint/restart
parameter, 3-65, A-8
class API, 4-11
CLASS, send report parameter, 3-36, A-9
clearing the transfer list display, 2-17
CODE_FLAG
encoding options in GUI, 2-29
file type conversion parameter, 3-46, A-9
code_flag API, 4-11
CODETABL, A-10
communications parameter, 3-14
codetabl API, 4-11
CodeTable field, 2-30
commands, modifying in GUI, 2-82

Index3
communications parameters
CODETABL, 3-14
COMPRESS, 3-14
DESTINATION_TYPE, A-13
REMOTE_SYSTEM, 3-15, A-33
REMOTE_SYSTEM_RF, 3-16, A-33
REMOTE_SYSTEM_SJ, 3-16
REMOTE_SYSTEM_SR, 3-16, A-34
setting, 3-13
TEMPDIR, 3-17, A-41
COMPRESS
communications parameter, 3-14
data transfer parameter, A-10
compress API, 4-12
Compression window, 2-52
config_ssl API, 4-13
configuration files, 3-1
creating, 3-2
using in GUI, 2-9
XCOM.CNF, 3-13
control block structure API, 4-4
CONTROL parameter, A-11
controlling transfer status, 2-65
convert_classes API, 4-13
CONVERT_CLASSES, global parameter, A-11
copies API, 4-13
COPIES, send report parameter, 3-37, A-11
CREATE_DIRECTORIES, global parameter, A-12
creating configuration
files, 3-2
procedure in GUI, 2-12
D
DAEMON_TIMEOUT, global parameter, A-12
data transfer parameters
CODETABL, A-10
COMPRESS, A-10
MAXRECLEN, 3-15, A-25
TRUNCATION, 3-17, A-43
VERSION, 3-17, A-46
DATACLAS, mainframe file creation parameter, 3-26,
A-12
datacls API, 4-13
debug_flag API, 4-13
DEBUG_FLAG, global parameter, A-12
debugging problems, 2-57
Debugging window, 2-57
DEC, 5-7
default directories and drives, 2-2
deleting
fields from queue status display, 2-66
transfers from transfer list, 2-8
den API, 4-14
DEN, tape parameter, 3-31, A-13
DESTINATION, 3-35
send report parameter, 3-37, A-13
destination API, 4-14
DESTINATION_TYPE, communications parameter,
A-13
Details window, 2-69
directories, 2-1
defaults, 2-2
disposition API, 4-14
DISPOSITION, send report parameter, 3-37, A-14
DOMAIN
global parameter, A-14
security parameter, 3-53
domain API, 4-15
drives, defaults, 2-2
dsntype API, 4-15
DSNTYPE, mainframe file creation parameter, 3-26,
A-14

Index4 User Guide
E
EBCDIC conversion, 3-44
Edit Transfer window
common functions, 2-20
common uses, 2-20
fields, 2-22
menu bar selections, 2-21
options group box, 2-28
editing configuration files from GUI, 2-14
encoding options, Edit Transfer window, 2-29
encrypted parameter values, changing, 3-56
eol_classes API, 4-15
EOL_CLASSES,global parameter, A-15
error messages, system identifier, B-1
ERRORLEVEL return codes, 3-41
ETOA_FILENAME, global parameter, A-15
expdt API, 4-15
EXPDT, tape parameter, 3-32, A-15
EXPIRATION_TIME, global parameter, A-15
F
fcb API, 4-16
FCB, send report parameter, 3-38, A-16
file access, specifying user IDs and passwords, 2-44
file conversion parameters
CARRIAGE_FLAG, 3-45, A-7
CODE_FLAG, 3-46, A-9
file name considerations, 2-1
file types
conversion, 3-44
supported, 2-2
FILE_ACCESS_PASSWORD, security parameter, 3-
53, A-16
FILE_ACCESS_USERNAME, security parameter,
3-53, A-16
FILE_OPTION, 3-24
send and retrieve file parameter, A-16
send file parameter, 3-18
file_option API, 4-16
FILE_OPTION_RF, retrieve file parameter, 3-21, A-18
file_type API, 4-17
Find window, 2-63
form API, 4-17
FORM, send report parameter, 3-38, A-19
fully qualified domain name, 3-10
G
global parameters
AGE_TIME, A-5
ATOE_FILENAME, A-6
CONVERT_CLASSES, A-11
CREATE_DIRECTORIES, A-12
DAEMON_TIMEOUT, A-12
DEBUG_FLAG, A-12
DOMAIN, A-14
EOL_CLASSES, A-15
ETOA_FILENAME, A-15
EXPIRATION_TIME, A-15
INTERNAL_CONVERSION_TABLES, A-20
MAIL_USERNAME, A-24
MAX_QUEUE_ENTRIES, A-24
MAX_SESSIONS_ENTRIES, A-24
METACODE_CLASSES, A-25
modifying in GUI, 2-71
NUMBER_OF_RETRIES, A-28
PORT, A-29
PROTOCOL, A-30
QUEUE_PATH, A-30
REMOVE_TRAIL_BLANKS, A-34
SESSIONS_FILE, A-37
SHELL_CMD, A-37
SOCK_DELAY, A-37
SOCK_RCV_BUF_SIZE, A-38
SOCK_SEND_BUF_SIZE, A-38
STAT_FREQUENCY, A-40
TCP_CMD, A-41
TP_CMD, A-41
TRACE_PATH, A-41

Index5
TXPI_BUF_SIZE, A-43
TXPI_RECEIVE_TIMEOUT, A-44
TXPI_SEND_CHECK_FREQ, A-44
TXPI_TERM_TIMEOUT, A-44
WRITE_EOF, A-47
graphical user interface (GUI), 2-1
H
hold API, 4-18
HOLDFLAG, send report parameter, 3-38, A-19
I
IBM mainframe
creating a file on, 3-24
record format parameter, GUI, 2-26
IBM mainframe file creation parameters
ALLOCATION_TYPE, 3-25, A-6
BLKSIZE, 3-25, A-6
DATACLAS, 3-26, A-12
DSNTYPE, 3-26, A-14
LRECL, 3-26, A-23
MGMTCLAS, 3-27, A-25
NUM_OF_DIR_BLOCKS, 3-27, A-28
PRIMARY_ALLOC, 3-27, A-29
RECORD_FORMAT, 3-28, A-31
SECONDARY_ALLOC, 3-30, A-36
SECURE_SOCKET, 3-29, A-36
STORCLAS, 3-30, A-40
UNIT, 3-30, A-45
UNIT_RF, 3-24, A-45
VOLUME, 3-30, A-46
VOLUME_RF, 3-24, A-47
XCOM_CONFIG_SSL, 3-30, A-47
XCOM_SHOW_CIPHER, 3-31, A-48
IMPLICIT_PACKING, send report parameter, A-20
improving link speed, 6-1
incoming transfers, global defaults, GUI, 2-75
Indirect Transfer window, 2-54
indirect transfers, 2-54, 3-51
intermediate system, 2-55
INTERNAL_ CONVERSION_ TABLES, global
parameter, A-20
IP addresses and names, 3-9
L
label API, 4-18
LABEL, tape parameter, 3-32, 4-18, A-20
labelnum API, 4-18
LABELNUM, tape parameter, 3-33, 4-18, A-21
lclntfyl API, 4-19
LCLNTFYL, notification parameter, 3-60, A-21
Local Notify dialog, 2-47
local port, changing in GUI, 2-86
local_file API, 4-19
LOCAL_FILE, send file parameter, 3-20, A-22
local_file_rf API, 4-19
LOCAL_FILE_RF, retrieve file parameter, 3-23, A-22
local_file_sj API, 4-20
LOCAL_FILE_SJ, send job parameter, 3-41, A-22
local_file_sr API, 4-20
LOCAL_FILE_SR, send report parameter, 3-38, A-23
LOCAL_NOTIFY, notification parameter, 3-60, A-23
LOCAL_RECEIVE, 4-3
LOCAL_SEND, 4-3
locally initiated transfers, 3-56
localnotify API, 4-20
Log Browser, 2-9, 2-62
log files
browsing, 2-62
setting up, 3-43
logging, 3-43
logging parameter, XLOGFILE, 3-44

Index6 User Guide
logical units
dependent logical units, direct sessions, C-5
independent logical units (ILUs), C-4
direct sessions with dependent logical units,
C-5
LU 6.2 independent implementations, C-5
PU type, C-5
software version support for LU 6.2, C-4
LU type 0, C-3
LU type 1, C-3
LU type 2, C-3
LU type 3, C-3
LU type 4, C-3
LU type 6.1, C-3
LU type 7, C-3
types, C-3
lrecl API, 4-21
LRECL, mainframe file creation parameter, 3-26, A-23
LU. See logical units
LU 6.2
benefits, 1-6
independent implementations, C-5
M
MAIL_USERNAME, global parameter, A-24
main window
menu bar options, 2-7
pushbuttons, 2-8
Unicenter CA-XCOM Data Transport, 2-5, 2-12
mainframe file creation, 3-25
managing transfers in progress, 2-65
Max. Record Length field, 2-30
MAX_QUEUE_ENTRIES, global parameter, A-24
MAX_SESSIONS_ENTRIES, global parameter, A-24
maxreclen API, 4-21
MAXRECLEN, data transfer parameter, 3-15, A-25
menu bar selections
edit transfer window, 2-21
Queue Status bar, 2-67
metacode_classes API, 4-21
METACODE_CLASSES, global parameter, A-25
MGMTCLAS, mainframe file creation parameter,
3-27, A-25
mgtclas API, 4-22
modifying global values, GUI, 2-71
multiple transfers
from command prompt, 3-5
from the GUI, 2-10
N
network
levels
diagram, 1-5
end user level, 1-3
logical level, 1-4
physical level, 1-4
send file flowchart, 1-10
logical and physical components, C-1, C-2
LU, C-1
procedure correlation identifier (PCID), C-2
session, C-2
notification parameters
LCLNTFYL, 3-60, A-21
LOCAL_NOTIFY, 3-60, A-23
NOTIFY_NAME, 3-61, A-26
NOTIFYL, 3-61, A-26
NOTIFYR, 3-62, A-27
RMTNTFYL, 3-63, A-36
using, 3-59
xcom62 command, 3-59
xcomtcp command, 3-59
notify_name API, 4-22
NOTIFY_NAME, notification parameter, 3-61, A-26
notify_term API, 4-24
NOTIFY_TERM parameter, A-28
notifying of transfer completion
local users, using GUI, 2-47
remote users, 2-49
using command line and parameters, 3-59
notifyl API, 4-22
NOTIFYL, notification parameter, 3-61, A-26

Index7
notifyr API, 4-23
NOTIFYR, notification parameter, 3-62, A-27
Novell NetWare, naming conventions, 5-5
num_of_dir_blocks API, 4-24
NUM_OF_DIR_BLOCKS, mainframe file creation
parameter, 3-27, A-28
NUMBER_OF_RETRIES
checkpoint/restart parameter, 3-65
global parameter, A-28
number_of_retries API, 4-24
O
opening Log Browser, 2-9
OpenVMS, 5-7
OpenVMS Alpha, 5-7
OpenVMS VAX, 5-7
option parameters, 4-38
P
parameters
alphabetical listing of, A-5
encrypting, 3-54
option, 4-38
values in GUI, 2-10
password API, 4-24
PASSWORD, security parameter, 3-53, A-28
passwords, specifying for file access, 2-44
paths
considerations, 2-1
names, 2-2
PCID (procedure correlation ID), C-2
performing file transfers
command prompt, 3-4, 3-8, 3-9
using TCP/IP, command line, 3-9
port
GUI, 2-42
number, default in GUI
local system, 2-86
remote system, 2-85
option on Version 2 window, 2-43
setting in GUI, 2-43
port API, 4-25
PORT, global parameter, A-29
primary_alloc API, 4-25
PRIMARY_ALLOC, mainframe file creation
parameter, 3-27, A-29
printer, network, 3-35
PRIORITY, queue parameter, 3-57, A-29
problems, tracing, 3-42
protocol, 3-4
selecting in GUI, 2-42
setting in GUI, 2-43
protocol API, 4-25
PROTOCOL, global parameter, 3-13, A-30
PU 2.0 devices and store and forward, 3-50
PU type, C-5
pushbuttons
Edit Transfer window, 2-21
main window, 2-8
Queue Status window, 2-68
Q
queue
accessing, 2-65
parameters
PRIORITY, 3-57, A-29
QUEUE, 3-57, A-30
START_DATE, 3-58, A-39
START_TIME, 3-58, A-40
using, 3-56
queue API, 4-26
Queue Manager, 2-9, 2-66
Queue Manager (XCOMQM), 3-56

Index8 User Guide
Queue Properties, GUI, 2-77
Queue Status
direction symbols, 2-68
menu bar, 2-67
window, 2-65
QUEUE, queue parameter, 3-57, A-30
QUEUE_PATH, global parameter, A-30
queuing transfers, 2-8
R
Receive File, performing, 2-39
receive pacing count, 6-2
receiving files, 2-39, 3-20
RECORD_FORMAT, 2-26
mainframe file creation parameter, 3-28, A-31
record_format API, 4-26
remote
file, 2-22
LU, 2-19
system, 2-22
TCP/IP, 3-10
Remote Notify dialog, 2-49
remote_file API, 4-28
REMOTE_FILE, send file parameter, 3-20, A-32
remote_file_rf API, 4-28
REMOTE_FILE_RF, retrieve file parameter, 3-23, A-32
remote_system API, 4-28
REMOTE_SYSTEM, communications parameter, 3-15,
A-33
REMOTE_SYSTEM_RF
communications parameter, 3-16, A-33
retrieve file parameter, 3-23
REMOTE_SYSTEM_SJ
communications parameter, 3-16
send job parameter, 3-41
REMOTE_SYSTEM_SR
communications parameter, 3-16, A-34
send report parameter, 3-39
remove_trail_blanks API, 4-29
REMOVE_TRAIL_BLANKS, global parameter, A-34
report_title API, 4-29
REPORT_TITLE, send report parameter, 3-39, A-34
resizing transfer list fields, 2-17
resolving symbolic names, TCP/IP, 3-11
restart parameters
RESTART_SUPPORTED, 3-65, A-35
RETRY_TIME, 3-66, A-35
restart_supported API, 4-29
RESTART_SUPPORTED, checkpoint/restart
parameter, 3-65, A-35
restarting
transfers, 3-63
Version 2 window, 2-41
retpd API, 4-30
RETPD, tape parameter, 3-33, A-35
retrieve file parameters
FILE_OPTION_RF, 3-21, A-18
LOCAL_FILE_RF, 3-23, A-22
REMOTE_FILE_RF, 3-23, A-32
REMOTE_SYSTEM_RF, 3-23
UNIT_RF, 3-24
VOLUME_RF, 3-24
RETRY_TIME, checkpoint/restart parameter, 3-66,
A-35
return codes API, 4-41
rmtntfyl API, 4-30
RMTNTFYL, notification parameter, 3-63, A-36
RU size, 6-1
S
sample API program, 4-40
Schedule window, 2-58
scheduled transfers and user availability, 2-59
Scheduler service, XCOMD, 2-3
scheduling transfers
command line, 3-56
using GUI, 2-58

Index9
scripts, defaults in GUI, 2-82
searching log, 2-63
secondary_alloc API, 4-30
SECONDARY_ALLOC, mainframe file creation
parameter, 3-30, A-36
Secure Socket
transfers, performing, 2-61
window, 2-61
SECURE_SOCKET, mainframe file creation
parameter, 3-29, A-36
security parameters
DOMAIN, 3-53, A-14
FILE_ACCESS_PASSWORD, 3-53, A-16
FILE_ACCESS_USERNAME, 3-53, A-16
PASSWORD, 3-53, A-28
TRUSTED, 3-53, A-43
USERID, 3-54, A-45
using, 3-52
Security Properties, GUI, 2-79
Security window, 2-44
selecting
multiple transfers, 2-10
port, in GUI, 2-42
protocol, in GUI, 2-42
transfers for editing, 2-18
send and retrieve file parameter, FILE_OPTION, A-16
send file parameters
FILE_OPTION, 3-18
LOCAL_FILE, 3-20, A-22
REMOTE_FILE, 3-20, A-32
Send File, performing, 2-33
send job command, 3-40
send job parameters
LOCAL_FILE_SJ, 3-41, A-22
REMOTE_SYSTEM_SJ, 3-41, A-33
Send Job, performing in GUI, 2-37
send report command, 3-35
send report parameters
CARRIAGE_CONTROL_CHARACTERS, 3-36,
A-7
CLASS, 3-36, A-9
COPIES, 3-37, A-11
DESTINATION, 3-37, A-13
DISPOSITION, 3-37, A-14
FCB, 3-38
FCB, A-16
FORM, 3-38, A-19
HOLDFLAG, 3-38, A-19
IMPLICIT_PACKING, A-20
LOCAL_FILE_SR, 3-38, A-23
REMOTE_SYSTEM_SR, 3-39
REPORT_TITLE, 3-39, A-34
SPOOL_FLAG, 3-40, A-39
sending
files, 2-33
from command prompt, 3-17
indirect transfers, 2-54
jobs, 2-37
from command line, 3-40
reports, from command line, 3-35
session ID (SID), C-2
SESSIONS_FILE, global parameter, A-37
setting
communications parameters, 3-13
compression type in GUI, 2-52
shell_cmd API, 4-31
SHELL_CMD, global parameter, A-37
SID (session ID), C-2
SNA
option on Version 2 window, 2-43
protocol in GUI, 2-42
SNA/APPC protocols, transfers using, command line,
3-8
SOCK_DELAY, global parameter, A-37
SOCK_RCV_BUF_SIZE, global parameter, A-38
SOCK_SEND_BUF_SIZE, global parameter, A-38
SPACE, A-39
specifying
port in GUI, 2-42
remote system, TCP/IP, 3-10
user IDs and passwords for file access, 2-44
spool_flag API, 4-31
SPOOL_FLAG, send report parameter, 3-40, A-39
start_date API, 4-31
START_DATE, queue parameter, 3-58, A-39
start_time API, 4-31

Index10 User Guide
START_TIME, queue parameter, 3-58, A-40
starting states API, 4-3
startst.h, 4-3
stat_frequency API, 4-32
STAT_FREQUENCY, global parameter, A-40
STORCLAS, mainframe file creation parameter, 3-30,
A-40
storcls API, 4-32
store and forward parameter
using, 3-50
XIDEST, 3-52
submitting transfers, 2-18
to queue, 2-5
System Properties, GUI, 2-81
T
tab pages, Properties dialog, 2-71
tape API, 4-32
tape parameters
DEN, 3-31, 4-14, A-13
EXPDT, 3-32, 4-15, A-15
LABEL, 3-32, 4-18, A-20
LABELNUM, 3-33, 4-18, A-21
RETPD, 3-33, 4-30, A-35
TAPE, 3-33, 4-32, A-40
UNITCT, 3-34, A-45
VOLCT, 3-34, 4-35, A-46
VOLSQ, 3-34, 4-35, A-46
TAPE, tape parameter, 3-33, A-40
TCP/IP
and Unicenter CA-XCOM Data Transport,
overview, 1-7
name resolution, 3-11
option on Version 2 window, 2-43
port, A-29
port value, GUI, 2-42
port, command line, 3-11
protocol stack, 1-7
protocol, command line, 3-11
tuning parameters, GUI, 2-84
TCP/IP Properties, GUI, 2-84
TCP_CMD, global parameter, A-41
tempdir API, 4-32
TEMPDIR, communications parameter, 3-17, A-41
TID information displayed, 2-69
toolbar pushbutton, main window, 2-8
TP_CMD, global parameter, A-41
TRA files, 2-90
Trace Properties, GUI, 2-88
TRACE_PATH, global parameter, A-41
tracing
from GUI, 2-57
using command line, 3-42
tracing facilities, GUI, 2-88
tracing parameter, XTRACE, 3-43
transfer_id parameter, 4-33
TRANSFER_ID parameter, A-42
TRANSFER_TYPE parameter, A-42
transfer_usr_data parameter, 4-33
TRANSFER_USR_DATA parameter, A-42
transferring files, from command prompt, 3-4
transfers
in progress, managing, 2-65
indirect, 2-54
information displayed in log, 2-62
list
fields, 2-19
symbols, 2-19
performing, 2-16
status, 2-65
details, 2-69
TRC files, 2-90
Truncate Records option, 2-31
truncation API, 4-33
TRUNCATION, data transfer parameter, 3-17, A-43
trusted API, 4-33
TRUSTED, security parameter, 3-53, A-43
TXPI_BUF_SIZE, global parameter, A-43
TXPI_RECEIVE_TIMEOUT, global parameter, A-44
TXPI_SEND_CHECK_FREQ, global parameter, A-44
TXPI_TERM_TIMEOUT, global parameter, A-44

Index11
U
Unicenter CA-XCOM Data Transport
benefits of LU 6.2 (APPC), 1-5
connectivity, 1-2
list of parameters, A-5
main window, 2-5
network levels, 1-3
starting on your PC, 2-3
TCP/IP overview, 1-7
unit API, 4-34
UNIT, mainframe file creation parameter, 3-30, A-45
UNIT_RF, retrieve file parameter, 3-24, A-45
unitct API, 4-34
UNITCT, tape parameter, 3-34, A-45
Universal Naming Convention, 2-1
user IDs, specifying for file access, 2-44
user logged on/off for scheduled transfers, 2-58
USER_DATA, A-45
user_data parameter, 4-34
userid API, 4-34
USERID, security parameter, 3-54, A-45
V
VAX, 5-7
Version 1 vs Version 2 protocols, 2-41
Version 2
option checkboxes, 2-31
parameters, A-5
window, 2-41
version API, 4-34
VERSION, data transfer parameter, 3-17, A-46
viewing transfer status, 2-65
viewing transfer status details, 2-69
volct API, 4-35
VOLCT, tape parameter, 3-34, A-46
volsq API, 4-35
VOLSQ, tape parameter, 3-34, A-46
volume API, 4-35
VOLUME, mainframe file creation parameter, 3-30,
A-46
VOLUME_RF, retrieve file parameter, 3-24, A-47
W
wildcard characters, 3-5
WRITE_EOF, global parameter, A-47
X
XBUFFSIZE, A-47
XCOM.CNF, 3-1, 3-2, 3-13
XCOM.GLB, 2-71, 3-2
XCOM.LOG, 6-2
XCOM.SES, GUI, 2-78
XCOM_CONFIG_SSL, A-47
XCOM_CONFIG_SSL, mainframe file creation
parameter, 3-30
XCOM_PASSWORD, A-47
XCOM_SHOW_CIPHER, mainframe file creation
parameter, 3-31, A-48
XCOM_USERID, A-48
XCOM62, 3-4
command line options, 3-6
examples, 3-8
syntax, 3-5
when to use, 3-4
XCOM62.EXE, 3-5
ERRORLEVEL return codes, 3-41
XcomAPI, 4-1, 4-3
xcomapi.h, 4-4
XCOMD Scheduler service, 2-3, 2-58
XCOMENCR.EXE, 3-54
xcomfullssl API, 4-35

Index12 User Guide
XcomQAPI, 4-1
XCOMTCP, 3-4
command line options, 3-6
examples, 3-12
syntax, 3-6
when to use, 3-4
XCOMTCP.EXE, 3-5
XENDCMD, A-48
xendcmd API, 4-36
XIDEST, A-49
store and forward parameter, 3-52
xidest API, 4-36
XLOGFILE, A-49
logging parameter, 3-44
xlogfile API, 4-36
XLPCMD, A-49
xlpcmd API, 4-36
XLUNAME, A-49
XMODE, A-50
xmode API, 4-37
XNODESPEC, A-50
XNOTIFYCMD, A-50
xnotifycmd API, 4-37
XPPCMD, A-50
xppcmd API, 4-37
XPRECMD, A-51
xprecmd API, 4-37
XQUE, 5-2
xtrace API, 4-38
XTRACE, testing and tracing parameter, 3-43, A-51
Z
z/OS
CICS interface, 5-5
store-and-forward, 5-5