Debugging a CICS or Batch Application › Synchronized Processing › Add a New Server Connection

Add a New Server Connection

If you have not already established a connection to the server that you want to use, you can add a server connection using the Eclipse UI. You must have the host and port details of the server to which you want to connect.

Follow these steps:

1. Select InterTest, Add New Server.

   The New Server Connection dialog opens.

2. Enter the details for the new server connection.

   The following field values are required to create a new server connection:

   Name

   Specifies the name of the server connection. You can use uppercase and lowercase alphanumeric characters, and embedded spaces when entering a value in this field.

   Note: For the purposes of this tutorial, specify the name "Basic Demo" in this field.

   Host

   Specifies the z/OS host name assigned by your installation. This is the host name used for TSO or CICS logon.

   Port

   Specifies the TCP/IP port number of the server. If there is a default port number displayed, verify it is correct. The port number is updated in the Preferences dialog.

   • For a CICS region—This field must be the port number configured in the CICS region.
   • For a Testing Tools server—This field must be the port number that is configured for the Testing Tools server running on z/OS UNIX System Services (USS).

   Use as Default Server

   Specifies that this server is selected when you access the Batch Link Queue or Schedule Table.

   CICS Region

   Defines a connection that is used when a CA InterTest for CICS for CICS debug session is initiated.

   Select this box to initiate a CICS debug session. This action displays the CICS Security Enabled check box. If you select this box, you can secure your connection by using a user ID and password.

   Clear the CICS Region check box to define a server connection.

   Default: Off

   (Optional) User ID

   Specifies the user ID for logging on to a z/OS system. Enter your user ID in this field.

   (Optional) Save Password

   Specifies whether you want to save the password. If you save the password, CA InterTest for CICS preloads the saved password into the Logon dialog whenever you are prompted to enter your user ID and password. If you do not save it, you are prompted for your password whenever you log on to CA InterTest for CICS. Until the password is deliberately reset or a logon fails, you are prompted for a user ID and password only when you first use a server. Check this box to save your password.

3. Click Finish.

   The new server is created and added to the list of servers in the Servers view. The Servers view shows the details of the new server.