The Command Line Interface › Command Examples for Metatransfers and Inquire on Status

Command Examples for Metatransfers and Inquire on Status

This is a sample script file for performing a metatransfer and an inquire, and producing a CA Easytrieve report:

xcomtcp -c5 -f c:\temp\xcomcnf\asm2.cnf stcip=xcomwinca.ca.com
stcport=48316 inq_file=/tmp/xcom.inq.file
xcomtcp -c6 stcip=xcomwinca.ca.com stcport=48316
inq_file=/tmp/xcom.inq.file inq_wait=000005
hist_file=/tmp/xcomhist
echo Process returned $?
$XCOM_HOME/ezt/xcomehrp hist_file=/tmp/xcomhist.histf

Note: The –c5 metatransfer parameters LUSERID and LPASSWORD are not shown in the example above but are required and can be specified in the configuration file.

Suppose this script file is called xmeta.script and is located in /xcomcnf.

To execute this batch file

1. Submit the following command to change to the directory where xcomtcp is located:

   cd /opt/CA/XCOM/bin
   

   Note: This step is not required if the CA XCOM Data Transport directory is in the system path.

2. Submit the following command to run the script file:

   /xcomcnf/meta.script
   

How to Send a Ping Request

Use the Ping command at the command prompt to send a request from the Local System to the Remote System to determine whether the system is available to XCOM.

Information about the remote CA XCOM Data Transport Server is returned as a result of this command.

Example:

XCOMTCP -ping REMOTE_SYSTEM=?? {PORT=??} {SECURE_SOCKET=YES|NO} {TRNENCRL_CIPHER=xx}

The Ping request parameters:

TRNENCRL_CIPHER

Parameters

This section describes the parameters of Ping request.

REMOTE_SYSTEM

The name of the remote system that receives the Ping request.

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 system's IP address, host name, or domain name.

Range: 1 to 64 characters

Default: None

PORT

The number of the TCP/IP port on the remote CA XCOM Data Transport server. Used for TCP/IP transfers only.

Range: 1 to 65535

Default: 8044

SECURE_SOCKET

Specifies whether to use an OpenSSL socket or non-OpenSSL socket for transfers.

YES

Performs a secure transfer. The transfer uses an OpenSSL socket and connects to an SSL listener on the remote partner.

NO

Performs a non-secure transfer. The transfer uses a non-OpenSSL socket.

Default: NO

TRNENCRL_CIPHER

TRNENCRL_CIPHER specifies the requested list of ciphers which are used to encrypt the password fields for locally initiated transfers.

The cipher list consists of one or more ciphers from the table that colons separate. The characters (!) or (-) can precede each cipher in the cipher list.

If (!), is used then the ciphers are permanently deleted from the list. The ciphers that are deleted can never reappear in the list even if they are explicitly stated.

If (-), is used then the ciphers are deleted from the list, but some or all of the ciphers are added again using later options.

Default: COMPAT

Examples:

To request all ciphers except for any of the DES ciphers, use the following command:

TRNENCRL_CIPHER=ALL:!DES

To request only a 3DES or AES cipher, use the following command:

TRNENCRL_CIPHER=3DES:AES

To disable the cipher negotiation or remain backward compatible with the earlier releases of CA XCOM Data Transport, use the following command:

TRNENCRL_CIPHER=COMPAT

Command Example of Ping Request

xcomtcp -ping REMOTE_SYSTEM=XX PORT=XX TRNENCRL_CIPHER=ALL
XCOMN0882I PING INFO FOR <SYSTEMNAME>
XCOMN0882I RELEASE=r11.6 SP00 GEN LEVEL <LEVEL> SYSTEM NAME=<SYSNAME> SYSTEM ID=<SYSID>