Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
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