Runtime > Debug Runtime > The Kernel > Page Table Tran
Page Table Tran

This table shows a list of channels of communication between Citect SCADA components. A tran exists between exactly two separate components. A client tran initiates a connection, a server tran waits for a connection. Client and server in this context bears no relation to the type of component that owns the tran.

There are two modes for viewing the tran table: Standard and Verbose. The Standard mode shows information for every tran in a tabular format. It can be scrolled using the up/down arrow keys, the top row indicates the currently selected tran. Extended information for the selected tran can be viewed by toggling to Verbose mode by pressing the "v" key. Once in Verbose mode, the tran to display can be changed using the Page Up/Page Down keys.

In standard mode the tran table contains the following columns:

Field

Description

Name

The name and type of communication channel truncated to 20 characters:

  • Client
    Format: <cluster name><service name>
    Examples: Cluster1Alarm, Cluster1Report, Cluster1Trend
  • Server
    Format: <server name><cluster name>
    Examples: AlarmServer1Cluster1, ReportServer1Cluster1, TrendServer1Cluster1
  • Dedicated (Client and Server)
    Format: @@<cluster name><server name>
    Examples: @@Cluster1.AlarmServer1, @@Cluster1.ReportServer1, @@Cluster1.TrendServer1
  • Platform (Client and Server)
    Format: <server name><cluster name>
    Examples: AlarmServer1Cluster1, IOServerCluster1

Node

Either the node to which the tran is connected, or the status of the connection:

  • <call>
    The client tran is attempting to connect.
  • <listen>
    The server tran is waiting to be connected.
  • <disabled>
    The tran is currently disabled.
  • node name
    The tran has connected and is online. The value is the name of the node/computer to which the tran is connected. This could be the current computer or a different computer depending on the TCP/ IP configuration of the project.

Type

This is either:

  • Client - indicates a client tran. This tran actively attempts to connect to a server tran.
  • Server - indicates a server tran. This tran passively waits for a connection attempt from a client tran.
  • SerRnd - indicates a server-to-server redundant tran. This is the connection between the primary and standby servers when a project is configured for server redundancy.

Mode

This is either:

  • Local
    This tran connects two components which exist in the same process. For instance, when Citect SCADA is run in single process mode, every server component runs in the same process as the client. In this case, the connections between these components would be marked as Local.
  • OutPro (Out of Process)
    This tran either has an established connection or is attempting to establish a connection between two components via TCP/IP. The components exist in different processes. They may exist on the same computer or on different computers.
  • OutPrD (Out of Process Dedicated)
    A dedicated connection exists between the client and each server process on a single machine when Citect SCADA is run in multi-process mode. These trans use named pipe connections to verify that a communication path exists between every Citect SCADA component running on one computer regardless of the project's TCP/IP configuration. Dedicated connections do not exist between different computers.
  • Platfo (Platform Tran)
    This tran uses the Platform networking module as the transport layer between components. For version 7.0, it is only used to connect to the I/O Server.
    Note: There are client-side Alarm Server platform trans which will show up in the Tran Table. The server-side Alarm Server platform trans were not necessary or implemented for version 7.0 so these client-side trans will remain in a state of Connecting. They can be ignored.
  • Remote
    This server tran is waiting for a connection attempt via TCP/IP. Upon connection, this mode changes to OutPro.

Hnd

This value represents the handle number in the tran table of the record.

Cnt

This value indicates the number of times the tran has established a connection. Specifically it counts the number of times the tran receives the MSG_OPEN message. This value has no meaning for local trans for which it remains 0.

If the number is high, it can indicate that your network is dropping and then re-establishing connections. However, it could also mean that the server has been running for a long time and many clients have started and stopped, thereby closing and opening sessions.

Send

This value displays the number of messages that have been sent by the tran.

Rec

This value displays the number of messages that have been received by the tran.

Wait

This value represents the number of times the tran had to wait to get a buffer in order to send a message.

Stack

This value indicates the protocol number. Historically, this incorporated the NetBIOS LanA numbers with the TCP/IP protocol stacks. However, NetBIOS support was removed for version 7.0 while TCP/IP support was enhanced to include redundant Network Interface Cards (NIC).

The Stack value displays an index (1-based) which indicates on which redundant IP address the server tran is listening or connected. Its value is only used for out-of-process TCP/IP server trans; it has no meaning for every other tran.

Service

This column displays the type of the service used by the tran (regardless of the tran mode). The valid services are Alarm, IO, Report and Trend.

State

This is the current state of the tran. Valid states are Online, Offline, Connecting (client trans only), Disconnecting, Listening (server trans only) and Disabled.

Login

The user login name for remote Tran connection.

See Also

Published June 2018