RCCTSTC
RCCTSTC tests the connection to the distributed system.
Syntax
RCCTSTC(host,port,distributedUserName)
Arguments
You can use the following arguments when you run the RCCTSTC function:
- The TCP/IP address or DNS name of the machine that contains the DevOps Code ClearCase® VOB. This address must be a valid TCP/IP address or DNS name.
- The TCP/IP port number used to contact the host specified by the host argument. Allowable values: 0-65535.
- The user ID on the distributed system on which you are running DevOps Code ClearCase and the server component of TSO Client.
Result
The following table lists the return and reason codes that result from running the RCCTSTC function; it also provides a description of the meaning of the codes.
Return code | Reason code | Description |
---|---|---|
0 | 601 | The connection succeeded. |
8 | 611 | Required argument missing. |
612 | Invalid argument value. | |
614 | Distributed command failure. | |
616 | Improper number of arguments. | |
12 | 698 | Internal error. |
699 | Internal error. |
Example
Test the connection to the distributed system on a computer running Windows® with an IP address of 9.48.114.54.
The server component of TSO Client is installed in C:\Program Files\IBM Rational\ClearCase\bin\ and is running with auth mode 0, using port 4000.
The following REXX™ commands could be used to invoke the RCCTSTC API function:
host = ‘9.48.114.54'
port = ‘4000'
disuser = ‘userone'
Parse Value RCCTSTC(host,port,disuser)
With rccret rccrsn rccmsg
Output
For a list of the output data sets
corresponding to the RCCLOG1 and RCCERR file names, see RCCUALOC.
Note: RCCOUT is not an output
file for this API function.
For a description of the log entries in RCCLOG1, see RCCULOG.
For an example listing of the log, see Example of a log entry.