Test Connection

The Test onsite/offsite connection button is available only when valid programming is entered for the entire connection (both onsite and offsite) and all other fields as well. Clicking one of the buttons further validates the connection programming by attempting to connect to the 5000 CP system. See Adding/Editing Connections for information about connecting or editing a system.

When you click to test a connection, the System Administration & Diagnostics application checks if the connection is in use and considers whether the test can be allowed and which warning message, if any, is needed.

The following table shows the test processing and warning messages that may appear in the warning message box. The possible situations are listed in order of precedence, highest to lowest. If more than one situation applies, the message box prompt and operation for the situation listed highest in the table is used.

a. Because DB Programming may be in the middle of processing a restore or other update, the System Administration & Diagnostics application does not blindly force it to terminate. Verify that DB Programming is not busy, and the end the session.

b. The list of applications that may be using the connection may include one or more of the following: AWS Web page, SSH connection, Diagnostics Monitor. System Administration & Diagnostics checks for these applications at least as reliably as DB Programming did in versions 3.0 through 3.2. If applications other than those listed are using the connection, they may not be detected. Also if the AWS Web page is open for any 5000 CP, because the IP address is not internally visible to System Administration & Diagnostics, it is listed as an application possibly using the connection.

To perform a connection test:

The Information bar appearing in the Test Connection window is almost identical to that appearing in the main System Administration & Diagnostics window. The only difference is in the buttons at the far right in the bar. On this window, the buttons appear below the bar, rather than in the bar. Otherwise, appearance and operation are the same.

If the connection succeeds, the following window appears. At this point, diagnostics are not active. Also note that a warning condition may exist, in which case the bar will be yellow and the text will explain the warning.

Do one of the following:

To save the connection
Select Save connection, and then click Save connection. When saving the connection, the System Administration & Diagnostics application automatically closes the Add/Edit System Connection Window. The Save connection check box does not appear if no changes were made to the connection.

If you clicked the red X or pressed Escape to close the Test Connection Window without saving the connection, the following prompt appears.

Do one of the following:
1. To disconnect and save the connection, click Disconnect and save connection.
2. To return to the connection test, click Return to test.
3. To disconnect the connection and cancel the test, click Disconnect and cancel test.
To save and active the connection

Select Activate connection, and then click Save and activate connection. When activating the connection, System Administration & Diagnostics checks to see if that can be allowed at this time, or if any warnings are needed. If no warnings are needed or if you confirm that you want to activate the connection, the tested connection is activated and if available and so indicated by the Connection options in the Options menu (see Programming System-Wide Options), system monitoring will begin and DB Programming will be launched. The Activate connection check box is not available whenever Save connection appears and is not selected.
To exit without changing

Click Close. The tested connection is disconnected and the Add/Edit System Connection Window remains open. Any changes made are intact but not yet saved. You must click Save connection to save the changes, or click Cancel to cancel the changes.

If the test fails for any reason, the Information bar in the Test Connection window displays the failure and no check boxes will be offered. Whenever there is a warning or failure displayed, you can click to see the expansion area of the Information bar.

Connection Type	Connection in Use By:	Message Box Text (Title: Test Connection)	Operation Result:
Modem or Remote Configuration	DB Programminga	<connection name> is in use by DB Programming. Before you disconnect and test the <connection name> connection, you must terminate the DB Programming session. (Test anyway / Cancel)	The connection is closed. Monitoring stops. DB Programming and any other applications are left running, but their links go down. The test begins.
Modem or Remote Configuration	Another application	<connection name> is a [modem/remote configuration] connection, which may be in use by the following: <list>b Are you sure you want to disconnect and test the <connection name> connection? (Test / Cancel)	The connection is closed. Monitoring stops. Other applications are left running, but their links go down. The test begins.
Any	System Administration & Diagnostics (for example, currently connected)	<connection name> is currently connected. Are you sure you want to disconnect and test the <connection name> connection? (Test / Cancel)	The connection is closed. Monitoring stops. The test begins.
Any	None	None	The test begins.

Test Onsite/Offsite Connections

To perform a connection test: