Table of Contents

SYM - Manager Instance

Module SYM

Description

A record in this table represents one running manager instance.

Managers are identified by their manager instance name (i.e. the name of the controlling inifile which is typically identical to the name of the transaction if only one instance of a manager transaction is used).

SYM records are created and updated only by a watchdog process (under normal circumstances the controlling watchdog process identified by SYNINR, if this process fails any other watchdog process might correct the status (i.e. set STA to 'C'anceled).

REQSTA is interpreted by the controlling watchdog only (and the watchdog might then trigger the manager to terminate).

A manager might terminate itself if it finds its SYM record set to 'C'anceled, 'B'locked, or 'D'own.


Datafields

Name Description Data Type Len Dec. View lines View type Inst. Visible Codetable
INR Internal Unique ID of Manager Instance Text 8 1 Edit Yes Public
APPSRV Application Server Text 32 1 Edit Yes Public
STA Termination Status of Session Text 1 1 Edit Yes Public Embedded
MGR Manager Instance Name Text 8 1 Edit Yes Public
VALDATTIM Valid until Datetime 15 0 Unknown Yes Public
LSTDATTIM Timestamp of last update of this record Datetime 15 0 Unknown Yes Public
SYNINR INR of Controlling Watchdog Session Text 8 1 Edit Yes Public
REQSTA Requested Status of Manager Instance Text 1 1 Edit Yes Public Embedded
REQEVTINR Internal Unique ID of Event for request Text 8 1 Edit Yes Public
SSNINR INR of Session Text 8 1 Edit Yes Public

Indices

Name Fields Properties
SYM_APPSRV STA
SYM_INR INR Unique

/


Lock

INR

Datafield Description and Properties


Datafield INR Internal Unique ID

Description

Unique internal ID of a record within the table. The INR is a text field, which is created by retrieving the next valid entry from the counter SSN. The field INR is used to maintain links from other tables into this table.

Helpinformation

Unique internal ID of a record within the table. The INR is a text field, which is created by retrieving the next valid entry from the counter of this table. The field INR is used to enable links from other tables to this table.

For contractdata the INR also links the two tables xxD and xxT as associated entries hold the same INR.


Datafield APPSRV Application Server

Description

The name of the server executing the watchdog process.

Helpinformation

The name of the server executing the watchdog process.


Datafield STA Termination Status of Session

Description

The status of the SYM record reflects the logical status of this manager instance.

'S'tarting:Manager started by Watchdog but not successful start has not been verified yet

'R'unning: In normal operation

'D'own: Manager terminated (due to scheduled or gracefull shutdown)

'C'anceled: Manager Instance marked as terminated by other process as SYM record was not updated in time.

'B'locked: Manager is down but must not be restarted (i.e. if a watchdog process finds a SYM record with STA 'B'locked it will not try to restart manager)

Helpinformation

The status of the SYM record reflects the logical status of this manager instance.

'S'tarting:Manager started by Watchdog but the successful start has not been verified yet

'R'unning: In normal operation

'D'own: Manager terminated (due to scheduled or gracefull shutdown)

'C'anceled: Manager Instance marked as terminated by other process as SYM record was not updated in time.

'B'locked: Manager is down but must not be restarted (i.e. if a watchdog process finds a SYM record with STA 'B'locked it will not try to restart manager)

Codetable
Code Text
S Starting
R Running
D Down
C Canceled
B Blocked

Datafield MGR Manager Instance Name

Description

Name of the Manager Instance

This is the name of the controlling inifile which is typically identical to the name of the transaction if only one instance of a maanger transaction is used

Helpinformation

Name of the Manager Instance

This is the name of the controlling inifile which is typically identical to the name of the transaction if only one instance of a manager transaction is used


Datafield VALDATTIM Valid until

Description

After this timestamp this entry is assumed to be stale as the expected update did not take place.

So after this timestamp the watchdog responsible for updating this entry is assumed to benolonger active.

Helpinformation

After this timestamp this entry is assumed to be stale as the expected update did not take place.

So after this timestamp the watchdog responsible for updating this entry is assumed to be no longer active.


Datafield LSTDATTIM Timestamp of last update of this record

Description

Date and time when the transaction identified in LSTFRM was started.

Helpinformation

Date and time when the transaction identified in LSTFRM was started.


Datafield SYNINR INR of Controlling Watchdog Session

Description

Unique internal ID of a controlling watchdog session.

Helpinformation

Unique internal ID of a controlling watchdog session.


Datafield REQSTA Requested Status of Manager Instance

Description

Requested status of manager instance as per codetable.

Helpinformation

Requested status of manager instance as per codetable.

Codetable
Code Text
-
D Down

Datafield REQEVTINR Internal Unique ID of Event for request

Description

Whenever REQSTA is set (by anopther process) a corresponding event describing the triggering process and reason will be written.

Helpinformation

Whenever REQSTA is set (by another process) a corresponding event describing the triggering process and reason will be written.


Datafield SSNINR INR of Session

Description

This field identifies the session entry in the table SSN, responsible for issuing this event.

Helpinformation

This field identifies the session entry in the table SSN, responsible for issuing this event.