Starting the TSO Client server from a command window

You can start the TSO Client server from a command window.

1. Log in to Windows using a login ID with Administrator privileges.
   You must remain logged in as long as the server component of TSO Client is running. Ensure that the ClearCase\bin directory, for example, C:\Program Files\IBM\RationalSDLC\ClearCase\bin, is in the system PATH environment.
2. Edit the rccTSOServer.bat script, shown below.
   The default location of rccTSOServer.bat is: C:\Program Files\IBM Rational\ClearCase\bin.

   set cp=copy
   set cat=ccperl rccCat.pl
   set cleartool=cleartool
   set clearmake=clearmake
   set TSO_SERVER_PORT_NUMBER=portnumber
   set RCC_MAX_PROC=number
   # set c:\workarea as working directory for rccTSOServer.exe
   cd /D C:\workarea
   rccTSOServer.exe -p %TSO_SERVER_PORT_NUMBER% -a 0

   You can set the following options in this script. All other statements should remain as shown in the example.

   set TSO_SERVER_PORT_NUMBER=portnumber

   Set portnumber to the port where the server component of TSO Client is configured.

   set RCC_MAX_PROC=number

   Set number to the maximum number of child processes allowed. This environment variable ensures that the number of simultaneous client requests cannot exceed the capacity of the server. If this environment variable is not set, the default maximum process number is set to 30, that is, the rccTSOServer will support a maximum of 30 concurrent active child processes by default. The current maximum child process number cannot exceed 64. If the number is set to more than 64, the maximum supported number, 64, is used by rccTSOServer.

   cd /D C:\workarea

   Specify a working directory. Setting a working directory for the TSO Client server helps preserve user data. The TSO Client server creates a subdirectory in its working directory for each user to cache each user's data. If it were running from the IBM® Rational® ClearCase® default installed directory, C: \Program Files\IBM Rational\ClearCase\bin, then cached data would be lost when upgrading to a new version of Rational ClearCase.

   -a 0 | 2

   Specify 0 for no user authentication or 2 to use secure password protection. See Using secure password protection with TSO Client for more information.

   -ro 1 | 0

   Specify 1 to support roaming profiles. Specify 0 to support local profiles only. The default is 0. For more information about setting up roaming profiles, see Configuring rccTSOServer on Windows for user authentication.

   -w number

   If -w is specified, the maximum child process number is set by -w and rccTSOServer ignores the environment variable RCC_MAX_PROC. The current maximum child process number cannot exceed 64. If the -w parameter is more than 64, the maximum supported number, 64, is used by rccTSOServer.

3. Run the rccTSOServer.bat script.