The Local Sessions option provides information from the ATM client proxy component in the Adabas link module that your ATM Online Services session is currently using. For example, if your session is executing in a CICS region, information is provided about client sessions in that CICS system which are using the same Adabas link module and the ATM client proxy.
If your ATM Online Services session is running in a job which has been
defined with the System Coordinator parameter Managed by
daemon, you will be able to monitor client sessions in all jobs
that are managed by the same System Coordinator daemon. Refer to the Adabas
System Coordinator documentation for further
information.
To display the Local Sessions menu
Select service 3 from the Online Services main menu.
The following menu will appear:
07:57:12 ***** A D A B A S TRANSACTION MANAGER 8.1.2 ***** 2006-04-19
- Local Sessions - T13000M1
Job Name: DAEFCI18
Code Service
---- -----------------------
1 Local Sessions
2 Zap Information
. Exit
---- -----------------------
Code ..: _
Command ==>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Menu
|
| From this menu, you can | Code | Command |
|---|---|---|
| list local sessions | 1 | 3.1 |
| display zap information | 2 | 3.2 |
This function produces a list of all client sessions using the TM proxy that your session is using
08:02:02 ***** A D A B A S TRANSACTION MANAGER 8.1.2 ***** 2006-04-19
- Local Sessions - T13100M1
Job Name: DAEFCI18
<------Terminal ID------> <-------Client ID-------> T
C Char Hex Char Hex Typ C Status
_ TCII E3C3C9C900000000 TM?q ? E3D41B9800000007 DTP A 802000 GT
_ TCR9 E3C3D9F900000000 0000000000000000 NTR 804000 GT
_ TCR9 E3C3D9F900000000 TM?q ? E3D41B9800000013 DTP A 002000 TRN OPEN
_ TC45 E3C3F4F500000000 0000000000000000 NTR 804000 GT
_ TC45 E3C3F4F500000000 TM?q ? E3D41B9800000001 DTP A 802000 GT
_ TC92 E3C3F9F200000000 0000000000000000 NTR 804000 GT
_ TC92 E3C3F9F200000000 TM?q ? E3D41B9800000008 DTP A 802000 GT
Command ==>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Refr Top Net Menu
|
The following information is provided:
| Field | Description |
|---|---|
| C | Enter a non-blank character and press Enter to obtain more detailed information about a particular session. |
| Terminal ID | The environment-dependent identifier of the client session in character and hexadecimal format. For example, the identifier for a CICS session is usually the session’s CICS terminal ID. Use PF11 to toggle between Terminal ID and Net Name. |
| Net Name | A second environment-dependent identifier for the client session. For example, the identifier for a CICS session is usually the session’s VTAM LUname. Use PF11 to toggle between Terminal ID and Net Name. |
| Client ID | The Client ID for each client session, in character and hexadecimal format. |
| Typ |
The client session type. Possible values are:
|
| TC |
The transaction coordinator that has control of the session’s global transactions. Possible values are:
|
| Status |
The session’s current status values together with a summary interpretation, as known by the TM proxy. Possible values are:
|
If you mark a particular session in the C column and press Enter, a screen similar to the following will be displayed:
08:07:32 ***** A D A B A S TRANSACTION MANAGER 8.1.2 ***** 2006-04-19
- Session Details - T13110M1
Job Name: DAEFCI18 Co-ordinator: ATM Client Type: 00 - DTP
Terminal ID: TCR9 E3C3D9F900000000 Net Name: DAEETCR9 C4C1C5C5E3C3D9F9
Client ID: TM?q ? E3D41B9800000005 Status: 0020002002F0 TRN OPEN
CommID: 000FA10E 20860000 BEAD4038 F1705B42 00000001 C3C9C3E2 E3C3D9F9
XID: C1C4C101 00000050 00000002 5033000F A10E2086 0000BEAD 4038F170 5B420000
0001C3C9 C3E2E3C3 D9F9D7C4 E3C5E2E3 4040C4C1 C5C6C3C9 F1F8BEAD 405F290D
7C020000 00000000 00000000 00000000 00000000 00000000 00000000 C2D80000
00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000
Adabas calls: 123 Transactions: 1 UAB: 1BC14FE8 GTQE: 1B63EA80
Last Function Call: 23 - STRT TRN Transaction model: DYNAMIC
DBNo. L/R DTP ETID Status | Pending Response Codes
135 L N PDTEST 8067 ET | Resp. Subcode
20532 L Y 0265 CHANGED |
|
|
|
|
Command ==>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Exit Refr Top ErrI Menu
|
The following information is provided:
| Field | Description |
|---|---|
| Jobname | The name of the job under which this Online Services session is running. |
| Coordinator |
The transaction coordinator that has control of the session’s transactions. Possible values are:
|
| Client Type |
The internal type code for the client session, followed by a summary interpretation. Possible values are:
|
| Terminal ID | Environment-specific identifier of the client session in character and hexadecimal format. |
| Net-Name | Environment-specific identifier of the client session. |
| Client ID | The Client ID in character and hexadecimal format. |
| Status |
The session’s status code in hexadecimal followed by a summary interpretation in character format. Possible values are:
|
| CommID | The session’s 28-byte Adabas Communication ID. |
| XID | The Transaction ID of the current transaction. This field contains binary zeros if the session has no transaction is progress. |
| Adabas Calls | The number of Adabas calls issued by the session. |
| Transactions | The number of transactions executed by the session. |
| UAB | This field contains internal information which might be useful to Software AG’s support staff in problem resolution. |
| GTQE | This field contains internal information which might be useful to Software AG’s support staff in problem resolution. |
| Last Function Call | The type of the most recent internal call sent by the TM proxy to the transaction manager for the session. Included for diagnostic purposes. |
| Transaction Model | The transaction model that is currently in use for the session. |
The remainder of the screen displays:
a list of databases with which the client is in session; and
a list of up to five pairs of pending Adabas response codes and subcodes in reverse chronological order.
If the list of databases is too long to fit on the display, “More” appears at the foot of the screen. Use PF7 to return to the top of the list and PF8 to scroll down the list.
| Field | Description |
|---|---|
| DBNo. | Database ID. |
| L/R | Indicates whether the database is local to or remote from the client; that is, whether or not the database is executing in the same operating system instance. |
| DTP | Indicates whether distributed transaction
processing is enabled for the database; that is, whether it is running with the
runtime parameter ADARUN DTP=RM.
|
| ETID | If the database session has an ETID, it is shown here; otherwise the field is blank. |
| Status |
A summary of the current status of the database with respect to the current client session. Possible summary values are:
|
If the session has an open transaction under the control of the local environment’s client-side transaction coordinator (CLIENT SIDE TC), PF9 at the foot of the screen is labeled “TC’. Pressing PF9 invokes the Client TC Display window showing the identifier used by the client-side transaction coordinator for the transaction.
Press PF10 to display the contents of the feedback block returned by the local ATM when the TM proxy last sent a command to it on behalf of the session.
The format of the resulting pop-up window is the same as described in section Display Error Information.
This function can be used to determine the zaps that have been applied to the ATM kernel module that is executing in the Adabas link module that your session is currently using.
This function is invoked by selecting option 2, Display Zap Information, on the Local Sessions menu.
The resulting screen output has the same format as that described for displaying zaps for an ATM manager.
Use PF9 to produce a similar display that shows which zaps have been applied to the Adabas System Coordinator kernel (CORKRN) that is being used by your current session.
