At the end of the installation process, you should verify that the installation was successful by performing the steps described in this section.
to verify basic operation of the transaction manager client
proxy:
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
client proxy has been installed, with client runtime control setting
ATM=ON.
Start (or restart) the TP system so that the Adabas Transaction Manager client proxy is loaded and initialized.
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 in the local system. If the transaction manager is not active in the local system, a message is displayed indicating that status. You can ignore the message at this time.
Press Enter, then make a note of the Terminal ID that is displayed on the main menu.
Select Local Sessions, then select Local Sessions from the next menu.
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 client proxy.
to verify communication with the transaction manager:
Start the transaction manager and re-enter the SYSATM application.
The transaction manager is identified automatically by the Adabas Transaction Manager client proxy when you enter SYSATM.
Select Transaction Manager Information, then Display Zap Information.
Displaying the list of applied fixes provided by this function verifies that communication with the transaction manager is functioning correctly, even if the list of fixes is empty.
Terminate your SYSATM session.
to verify two-phase commit operation:
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.
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.
Execute the DEMODTP program, supplying a non-zero value when prompted for a new personnel number.
When the message “About to commit” is displayed
start a new session in your TP system
log on to the Adabas Online System (AOS)
select Adabas Transaction Manager, then Transaction Manager Information, and then Active Transactions.
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, or for which the runtime
control TransactionModel has been set to DYNAMIC.
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.
Display additional details of the transaction by marking it on the screen and pressing Enter.
Verify that the Adabas Transaction Manager client proxy’s view of the transaction is correct by returning to the main menu and selecting Local Sessions, then Local Sessions once again.
Return to the session where your transaction is waiting to be completed and press Enter.
Use SYSATM to check that the transaction is no longer open.
The client session itself should still be listed under Local Sessions, but it should no longer appear in the Transaction Manager Information “Active Transactions” list.
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.
