Version 7.5.1

Verifying the Installation

At the end of the installation process, you should verify that the installation was successful by performing the steps described in this section.


Verify Basic Operation of the Adabas Transaction Manager Proxy

Start of instruction setto verify basic operation of the Adabas Transaction Manager proxy:

  1. If it is currently executing, stop the TP system where you will use Adabas Transaction Manager Online Services.

    This must be a TP system in which the Adabas Transaction Manager proxy has been installed, with job parameter setting ATM=ON.

  2. Start (or restart) the TP system so that the Adabas Transaction Manager proxy is loaded and initialized.

  3. Log on to the Adabas Online System (AOS). Select Adabas Transaction Manager to invoke the Online Services application SYSATM.

    SYSATM automatically searches for an active transaction manager daemon in the local system. If the Adabas Transaction Manager daemon is not active in the local system, a message is displayed indicating that status. You can ignore the message at this time.

  4. Press Enter, then make a note of the Terminal ID that is displayed on the main menu.

  5. Select Local User Information, then Local Users.

    One of the listed items should be recognizable either as the Terminal ID you noted in step 4 or the User ID of your current session, depending on your TP environment. This verifies the basic operation of the Adabas Transaction Manager proxy.

Top of page

Verify Communication with the Transaction Manager Daemon

Start of instruction setto verify communication with the Transaction Manager daemon:

  1. Start the transaction manager daemon and re-enter the SYSATM application.

    The Adabas Transaction Manager daemon is identified automatically by the Adabas Transaction Manager proxy when you enter SYSATM.

  2. Select Transaction Manager Daemon Information, then Display Zap Information.

    Displaying the list of applied fixes provided by this function verifies that communication with the Adabas Transaction Manager daemon is functioning correctly, even if the list of fixes is empty.

  3. Terminate your SYSATM session.

Top of page

Verify Two-Phase Commit Operation

Start of instruction setto verify two-phase commit operation:

  1. Start two databases with the parameter setting ADARUN DTP=RM: one database containing a standard Employees file and the other database containing a standard Vehicles file.

  2. In library SYSMTvrs (where vrs is the version, revision, and system maintenance level of Adabas Transaction Manager), modify the test program DEMODTP so that it correctly refers to the Employees and Vehicles files.

  3. Execute the DEMODTP program, supplying a non-zero value when prompted for a new personnel number.

  4. When the message “About to commit” is displayed

    The display of your pending transaction should indicate that two databases are involved in it.

    Note:
    This test is not valid in a CICS/RMI environment in which Natural executes in pseudo-conversational mode. In this mode, the INPUT statement that displays the message “About to commit” causes CICS to take a syncpoint at end-of-task and commit the pending Adabas updates. To verify correct operation in a CICS/RMI environment, this test should be done in a Natural session that was started with PSEUDO=OFF.

    Note:
    This test is not valid in an IMS/TM environment in which RRMS acts as the superior transaction coordinator. In such an environment, the ADARUN TMSYNCMGR parameter should take the value NONE for the purposes of this test.

  5. Display additional details of the transaction by marking it on the screen and pressing Enter.

  6. Verify that the Adabas Transaction Manager proxy’s view of the transaction is correct by returning to the main menu and selecting Local User Information, then Local Users.

  7. Return to the session where your transaction is waiting to be completed and press Enter.

  8. Use SYSATM to check that the transaction is no longer open.

    The user session itself should still be listed under both the Local Users option of Local User Information and the Global User Queue option of Transaction Manager Daemon Information.

  9. Execute the program DEMODTP again to ensure that the personnel number was changed consistently in the Employees and Vehicles files.

    You can now be assured of global transaction integrity in client environments and databases where the software is installed.

Top of page