Validating the Installation

This document describes how to validate the installation.


Validation Requirements

Review the requirements in this section to validate the installation.

Adabas SQL Gateway Requirements

Verify that the Adabas SQL Gateway has been installed, configured, and verified at your site. Then complete the following steps:

  1. Create a CDD that contains:

    • One or more user definitions;

    • One or more table definitions.

  2. Copy the CDD to the machine on which the JDBC server is installed.

  3. Create a data set name for the CDD defined on the machine on which the JDBC server is installed.

  4. Start the JDBC server and ensure that it is accessible.

ConnecX Gateway Requirements

Complete the following steps for the following required modules.

  1. Verify that the ConnecX Multiclient Subsystem (CXGSERV) has been installed and that files CXGPARMS, NSERVP and LEOPTS have been configured.

  2. Verify that ConnecX Attachment Facility (CXGCICS) has been installed and that files CXGCIOPT, CXGIACF, and CXGCODE have been configured.

  3. Verify that the ConnecX Connect Manager (CXGCONM) has been installed and that the CXGCODE has been configured. Be sure to link-edit ACECALL, as described in Installing CXGCONM.

Enabling the ConnecX Multiclient Subsystem (CXGSERV)

Submit the CXGNSERV generated JCL job found in the dsnhlq.CXGSERV.CNTL data set. This will start the ConnecX Multiclient Subsystem.

Enabling the ConnecX Attachment Facility (CXGCICS)

Use the UQAD administration transaction to enable the ConnecX Attachment Facility.

Start of instruction setComplete the following steps:

  1. Run the UQAD START command to enable the ConnecX Attachment Facility. The following are sample results:

    +---------------------------------------------------------------------------+
    |   START                                                                   |
    |   STATUS: RESULTS                                                         |
    |    Program(CXGCIEX1)                                                      |
    |    Entry(CXGCIEX1)                                                        |
    |    ServiceTransaction(UQST/00000053)                                      |
    |    GlobalWorkArea(0007E5E0)                                               |
    |    CXGHost(my.cxghost.org)                                                |
    |    CXGPort(7937)                                                          |
    |    CXXHost(my.host1.org:7500!my.host2.org:7500]DISTRIBUTE)                |
    |    DSN(CXGCICS)                                                           |
    |    Options(APPLICATION=ONDEMAND)                                          |
    |    User(UQST)                                                             |
    |    MessageQueues(UQM1/CSSL)                                               |
    |    MessageDestination(TDQUEUE)                                            |
    |    StatisticsQueue(UQS1)                                                  |
    |    TaskStatistics(YES)                                                    |
    |    Trace(YES)                                                             |
    |    TraceException(YES)                                                    |
    |    TraceLevels(198/199)                                                   |
    |  + StartTime(2013-09-20 12:44:57.947)                                     |
    |   Service started successfully                                            |
    |                                                 SYSID=CI24 APPLID=CICSCI24|
    |   RESPONSE: NORMAL                         TIME: 12.44.57  DATE: 09.20.13 |
    | PF              3 END               7 SBH  8 SFH      10 SB 11 SF         |
    +---------------------------------------------------------------------------+ 
    
  2. Run the UQAD INQUIRE SERVER command to display active server information. The following are sample results:

    +---------------------------------------------------------------------------+
    |   I SERV                                                                  |
    |   STATUS: RESULTS                                                         |
    |    Program(CXGCIEX1)                                                      |
    |    Entry(CXGCIEX1)                                                        |
    |    ServiceTransaction(UQST/00000080)                                      |
    |    GlobalWorkArea(0007E5E0)                                               |
    |    CXGHost(my.cxghost.org)                                                |
    |    CXGPort(7937)                                                          |
    |    CXXHost(my.host1.org:7500!my.host2.org:7500]DISTRIBUTE)                |
    |    DSN(CXGCICS)                                                           |
    |    Options(APPLICATION=ONDEMAND)                                          |
    |    User(UQST)                                                             |
    |    MessageQueues(UQM1/CSSL)                                               |
    |    MessageDestination(TDQUEUE)                                            |
    |    StatisticsQueue(UQS1)                                                  |
    |    TaskStatistics(YES)                                                    |
    |    Trace(YES)                                                             |
    |    TraceException(YES)                                                    |
    |    TraceLevels(198/199)                                                   |
    |  + StartTime(2013-09-20 12:44:57.947)                                     |
    |   Display Service Information                                             |
    |                                                 SYSID=CI24 APPLID=CICSCI24|
    |   RESPONSE: NORMAL                         TIME: 12.57.10  DATE: 09.20.13 |
    | PF              3 END               7 SBH  8 SFH      10 SB 11 SF         |
    +---------------------------------------------------------------------------+
    
  3. Ensure that CXGCICS is connected to the CXGSERV by running the UQAD INQUIRE CONFIG CXG command. The following are sample results:

    +---------------------------------------------------------------------------+
    |   I CONFIG CXG                                                            |
    |   STATUS: RESULTS                                                         |
    |    ServiceState(ACTIVE)                                                   |
    |    Module(CXGCIOPT/26C51000)                                              |
    |    VersionDate(V11.5.03 3/20130919 12.13)                                 |
    |    CXGName(CXGCI24)                                                       |
    |    CXGHost(my.cxghost.org)                                                |
    |    CXGPort(7937)                                                          |
    |                                                                           |
    |                                                                           |
    |                                                                           |
    |                                                 SYSID=CI24 APPLID=CICSCI24|
    |   RESPONSE: NORMAL                         TIME: 12.53.13  DATE: 09.20.13 |
    | PF              3 END               7 SBH  8 SFH      10 SB 11 SF         |
    +---------------------------------------------------------------------------+
    
  4. Ensure that CXGCICS is connected to the JDBC server by running the UQAD INQUIRE CONFIG CXX command. The following are sample results:

    +---------------------------------------------------------------------------+
    |   I CONFIG CXX                                                            |
    |   STATUS: RESULTS                                                         |
    |    ServiceState(ACTIVE)                                                   |
    |    Module(CXGCIOPT/26C51000)                                              |
    |    VersionDate(V11.5.03 3/20130919 12.13)                                 |
    |    CXXName(CXXCI24)                                                       |
    |    CXXHost(my.host1.org:7500!my.host2.org:7500]DISTRIBUTE)                |
    |                                                                           |
    |                                                                           |
    |                                                                           |
    |                                                 SYSID=CI24 APPLID=CICSCI24|
    |   RESPONSE: NORMAL                         TIME: 12.53.31  DATE: 09.20.13 |
    | PF              3 END               7 SBH  8 SFH      10 SB 11 SF         |
    +---------------------------------------------------------------------------+
    

Ensure Connectivity from CICS

Use the sample transaction UQT0 to connect to the JDBC-Server and retrieve the current time and date information. The following are sample results:

+---------------------------------------------------------------------------------+ 
| -- UQT0/CXGCIT00 ************************************************** (Begin) ** |
| -- TEST: Validate the Product installation                                     |
| -- TEST: Request Date and Time information from the JDBC-Server                |
| -- PASS: Criteria: Maximal 1 row of data is returned and the                   |
| -- PASS: row contains the CURRENT Timestamp, Date and Time.                    |
| -- (001) 2013-09-20 12:55:23.545   2013-09-20   12:55:23                       |
| -- PASS: Test passed.                                                          |
| -- UQT0/CXGCIT00 ************************************************** (End) **** |
+--------------------------------------------------------------------------------+
 

Ensure Connectivity using CXGCONM

Tailor and run the sample job AJ01CONM to the JDBC-Server and retrieve the current time and date information. The following are sample results:

JESMSGLG

+CXGK090 (I) CONNECT Parameter:
 +CXGK090 (I) Server Name: servername
 +CXGK090 (I) User Name..: username
 +CXGK090 (O) CONNECT Parameter:
 +CXGK090 (O) Server Name: DD=mydsn;GATEWAY=my.jdbc.host;PORT=7500
 +CXGK090 (O) User Name..: myuserid

SYSOUT

-- CONM/CXGBAT00 ************************************** (Begin) **
 -- TEST: Validate the Product installation (BATCH)
 -- TEST: Request Date and Time information from the JDBC-Server
 -- PASS: Criteria: Maximal 1 row of data is returned and the
 -- PASS: row contains the CURRENT Timestamp, Date and Time.
 -- (001) 2013-09-20 12:44:57.947   2013-09-20   12:44:57                      
 -- PASS: Test passed.
 -- CONM/CXGBAT00 ************************************** (End) ****