Version 8.1.2

Local Sessions

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.


Local Sessions Menu

Start of instruction setTo display the Local Sessions menu

Top of page

Local Sessions

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:

  • DTP: a normal DTP-mode session

  • SER: a session that is operating in serial ET/BT mode

  • NTR: a session for which the TM proxy does not invoke transparent transaction processing

TC

The transaction coordinator that has control of the session’s global transactions. Possible values are:

  • A: the local ATM has control

  • C: the local client-side transaction coordinator has control

  • H: the host system transaction coordinator has control

Status

The session’s current status values together with a summary interpretation, as known by the TM proxy. Possible values are:

  • CLT SYNC: syncpoint requested by client-side transaction coordinator

  • FORCE BT: forced backout in progress

  • GT: global transaction status

  • IN BKOUT: an attempt to back out has not yet completed

  • IN CMIT: an attempt to commit has not yet completed

  • IN ET/BT: prepare/commit/backout in progress

  • TM DOWN: TM unavailable

  • TRN OPEN: transaction in progress

  • UNKNOWN: transaction status not known

  • XH ET: in extended hold (ET) status

  • XH BT: in extended hold (BT) status

Display Session Details

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:

  • ATM: the local ATM has control

  • CLIENT SIDE TC: the session’s client-side transaction coordinator has control

  • HOST TC: the host system transaction coordinator has control

Client Type

The internal type code for the client session, followed by a summary interpretation.

Possible values are:

  • DTP: a normal DTP-mode client

  • SER: a client session that is operating in serial ET/BT mode

  • NTR: a session for which the TM proxy does not invoke transparent transaction processing

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:

  • CLT SYNC: syncpoint requested by client-side transaction coordinator

  • FORCE BT: forced backout in progress

  • GT: global transaction status

  • IN BKOUT: an attempt to back out has not yet completed

  • IN CMIT: an attempt to commit has not yet completed

  • IN ET/BT: prepare/commit/backout in progress

  • TM DOWN: TM unavailable

  • TRN OPEN: transaction in progress

  • UNKNOWN: transaction status not known

  • XH ET: in extended hold (ET) status

  • XH BT: in extended hold (BT) status

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:

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.

List of Databases

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. If this field is blank, the setting of the database's DTP parameter is not currently known.
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:

  • ET: the client has no pending updates on this database

  • CHANGED: the client has uncommitted updates on this database

  • XH: the database is in extended hold status

  • BT RQD: backout must be performed on this database

Client TC Display

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.

Error Information

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.

Top of page

Zap 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.

Top of page