Using the trscopy command

This is the trscopy command for Microsoft Windows:

trscopy source_DirectConnect source_Service_Library destination_DirectConnect destination_Service_Library 

This is the trscopy command for UNIX:

trscopy.sh source_DirectConnect source_Service_Library destination_DirectConnect destination_Service_Library 
[-a] [-l] [-v]

Table 2-2 describes the parameters and options in the trscopy command.

Table 2-2: Description of trscopy parameters and options

Parameter

Description

source_DirectConnect

(Required) Name of the server that contains the source TRS files. It is located in the directory under the following name: For Windows:

  • C:\<install_dir>\DC-15_0\servers

  • For UNIX: /<install_dir>/DC-15_0/servers

source_TRS_Library

(Required) The name of the source TRS library associated with this server. It must exist under the source DirectConnect server name.

destination_DirectConnect

(Required) Name of the target DirectConnect server, located in the directory under C:\<install_dir>\DC-15_0\servers.

destination_TRS_Library

(Required) Name of the target TRS library. Follow these guidelines:

  • The executable associated with the server library name must not exist under the target DirectConnect server.

  • The file name must not exist anywhere under the following locales directory structure, based on platform: For Windows: C:\<install_dir>\DC-15_0\connectivity\locales For UNIX: /<install_dir>/DC-15_0/connectivity\locales

-a

(Optional and for UNIX only) Option that generates new service names for the new service library and adds these new services to the interfaces file.

-l

(Optional and for UNIX only) A “softlink” option. When possible, use softlinks instead of copying a file.

-v

(Optional and for UNIX only) Verbose option, which displays a description of each operation while it runs.

WARNING! If you used trscopy to create custom-named service libraries in /<install_dir>/DC-15_0/svclib, when you perform an upgrade, only the standard-named service libraries are upgraded. To correct this situation, do one of the following:

Example

This UNIX example shows the original image on the hard drive, followed by using trscopy, and the resulting image on the hard drive.

belford> cd /<install_dir>/DC-15_0belford> source ./DC_SYBASE.csh 
belford> cd /<install_dir>/DC-15_0/svclib 

belford> ls 
admin.so trs.sif trslu62.so trstcp.so

belford> cd /<install_dir>/DC-15_0/bin 

belford> cat $SYBASE/interfaces 
d3s1261e2bf 
master tcp ether belford 12612 
query tcp ether belford 12612 

belford> ./trscopy.sh srvname trstcp srvname
	trstcp02 -a -v /<install_dir>/DC-15_0/svclib/trstcp02.*: No such file or directory 
******************************************************To complete the service library copy process, change the service names in /install_dir>/DC-15_0/servers/srvname/cfg/trstcp02.cfg and add these new services to /<install_dir>/DC-15_0/connectivity/interfaces. ****************************************************** ./trscopy.sh completed successfully. ****************************************************** belford> cat /<install_dir>/DC-15_0/servers/srvname/cfg/trstcp02.cfg [Service Library] {Transaction Router Service Property} TraceProcessUserExits=no 
ProcessExitFile= 
ProcessExitEnabled=no 
UserExitFile=/<install_dir>/DC-15_0/servers/srvname/log/ngue.trstcp 
UserExit=no 
UseDBRPC=yes 
UpperCase=yes 
UpgradePassword=no 
TruncateLV=no 
TraceProtocol=none 
TraceTRS=none 
TDSTraceFile=/<install_dir>/DC-15_0/servers/srvname/log/ngtds.trstcp 
Send5701=no 
Security=no 
RPCInfoFile=/<install_dir>/DC-15_0/servers/srvname/cfg/ngrpc.trstcp 
RegionInfoFile=/<install_dir>/DC-15_0/servers/srvname/cfg/ngreg.trstcp ProtocolTraceFile=/<install_dir>/DC-15_0/servers/srvname/cfg/ngtcp.trstcp 
PEMDestType=CICS 
PEMDest= 
MaxConnections=25 
LogTRS=yes 
LogInfoFile=/<install_dir>/DC-15_0/servers/srvname/cfg/nggrp.trstcp 
DirectPrevent=no 
Description=Sybase Transaction Router Service Library 
DeactCon=yes 
ConQTimeout=60 
ConnInfoFile=/<install_dir>/DC-15_0/servers/srvname/cfg/ngcid.trstcp 
Accounting=no 
AccountFile=/<install_dir>/DC-15_0/servers/srvname/cfg/ngact.trstcp 
[tt12538ss] {Transaction Router Service Property} 
EnableAtStartup=yes belford> cd /home/<install_dir>/DC-15_0/svclib 
belford> ls
admin.so trs.sif trslu62.so trstcp.so trstcp02.50