The ChangeLocaleRequest event is triggered when a language change occurs in the runtime system.

Namespace – ABSuite.AccessLayer.Connector.Core

Assembly – Unisys.ABSuite.AccessLayer.Connector.Core (in Unisys.ABSuite.AccessLayer.Connector.Core.dll)

Syntax

event EventHandler<ConnectionEventArgs> ChangeLocaleRequest

Using the IConnection Interface for the ChangeLocaleRequest Event

The following code is an example of using the ChangeLocaleRequest Event:

// Register for the Locale Change event, update the client language 
// to load up resources for the new language
this.Connection.ChangeLocaleRequest += (o, ee) =>
{
if (ee.Locale > 0)
       {
         this.Language = this.Languages.FirstOrDefault(l => l.Culture.LCID == ee.Locale);
       };
};

The ChangeSystemCompleted event is triggered when you have switched to another system (Switch to).

Namespace – ABSuite.AccessLayer.Connector.Core

Assembly – Unisys.ABSuite.AccessLayer.Connector.Core (in Unisys.ABSuite.AccessLayer.Connector.Core.dll)

Syntax

event EventHandler<ConnectionDownLoadCompleteEventArgs> 
ChangeSystemCompleted

The ChangeSystemRequest event is triggered when the runtime system performs a switch to another system.

Namespace – ABSuite.AccessLayer.Connector.Core

Assembly – Unisys.ABSuite.AccessLayer.Connector.Core (in Unisys.ABSuite.AccessLayer.Connector.Core.dll)

Syntax

event EventHandler<ConnectionChangeSystemRequestCancelEventArgs> 
ChangeSystemRequest

Using the IConnection Interface for the ChangeSystemRequest Event

The following code is an example of using the ChangeSystemRequest event:

// HandleChangeSystemRequest is the handler for processing the 
// ChangeSystemRequest event when the Host application does a switch 
// to another application.  
    public void HandleChangeSystemRequest(object sender, ConnectionChangeSystemRequestCancelEventArgs args)
    {
      // A switch to another application has occurred. Retrieve the 
      // new system name and log it. 
      // The client application must have a reference to the 
      // DataModels assembly for the system being switched. 
      // Otherwise it will not be able to process the 
      // transactions for the new application context. 
            
        string newSystem = args.Name;
        ApplicationLogger.LogInfo(() => string.Format("Host Application has switched to system: {0}", 
        newSystem));
}

The CloseRequest event is triggered when the runtime system closes the session with the client.

Namespace – ABSuite.AccessLayer.Connector.Core

Assembly – Unisys.ABSuite.AccessLayer.Connector.Core (in Unisys.ABSuite.AccessLayer.Connector.Core.dll)

Syntax

event EventHandler<ConnectionCloseRequestArgs> CloseRequest

Using the IConnection Interface for the CloseRequest Event

The following code is an example of using the CloseRequest event:

// HandleHostSessionClosed is the handler for processing the 
// CloseRequest event triggered when a BYE request is sent from the 
// Host application. It checks the ConnectionClosedRequestArgs 
// object for more information about the event.
     public void HandleHostSessionClosed(object sender, ConnectionClosedRequestArgs args)
     {
   // Log a message and clean up the session
        if (args.ForcedClosure)
            ApplicationLogger.LogInfo(() => string.Format("Host system has closed the session!"));
        else
            ApplicationLogger.LogInfo(() => string.Format("Session closed unexpectedly!"));

Session.Abandon();
     }     // Register for CloseRequest event. When the event is triggered, the 
           // specified method is called to handle the event.
     ABSConnection.CloseRequest += HandleHostSessionClosed;

The ConnectionProgressStatus event is triggered when the state of the connection progress changes.

Namespace – ABSuite.AccessLayer.Connector.Core

Assembly – Unisys.ABSuite.AccessLayer.Connector.Core (in Unisys.ABSuite.AccessLayer.Connector.Core.dll)

Syntax

event EventHandler<InformationEventArgs> ConnectionProgressStatus

Using the IConnection Interface for the ConnectionProgressStatus Event

The following code is an example of using the CloseRequest event:

// Register for the ConnectionProgressStatus event
ABSConnection.ConnectionProgressStatus += HandleConnectionProgress;

// HandleConnectionProgress is the handler for processing the 
// ConnectionProgressStatus event that is triggered when the state 
// of the Connection processing changes.  
        public void HandleConnectionProgress(object sender, InformationEventArgs args)
        {
          // Check the connection information and log a message
          InformationEventArgs.InformationType iType = (InformationEventArgs.InformationType)args.Information;

          if (iType == InformationEventArgs.InformationType.Connected)
              ApplicationLogger.LogInfo(() => string.Format("Client connected successfully 
              to the Host system!"));
           
          if (iType == InformationEventArgs.InformationType.Connecting)
              ApplicationLogger.LogInfo(() => string.Format("Client is connecting to the Host system."));

          if (iType == InformationEventArgs.InformationType.ConnectionFailed)
              ApplicationLogger.LogInfo(() => string.Format("Client could not connect to the Host system!"));
     If (args.Info != null)
              ApplicationLogger.LogInfo(() => string.Format("Connection progress information: {0}",args.Info));
      
        }

The DownLoadComplete event is triggered when the required assemblies for the client session have been downloaded successfully.

Namespace – ABSuite.AccessLayer.Connector.Core

Assembly – Unisys.ABSuite.AccessLayer.Connector.Core (in Unisys.ABSuite.AccessLayer.Connector.Core.dll)

Syntax

event EventHandler<ConnectionDownLoadCompleteEventArgs> 
DownLoadComplete

Using the IConnection Interface for the DownLoadComplete Event

The following code is an example of using the DownLoadComplete event:

// Register for the DownLoadComplete event
ABSConnection.DownLoadComplete += HandleDownloadComplete;

// HandleDownloadComplete is the handler for processing the 
// DownLoadComplete event 
// when the required assemblies have been downloaded from the 
// specified Assembly Location 
    public void HandleDownloadComplete(object sender, ConnectionDownLoadCompleteEventArgs args)
    {
        // Log the path to the downloaded files
        string DownloadFilePath = args.Path;
        ApplicationLogger.LogInfo(() => string.Format("Assemblies have been downloaded to: {0}",
        DownloadFilePath));

    }

The DuplicateLoginRequest event is triggered when the runtime system detects that the user requesting a session has already logged into the system.

Namespace – ABSuite.AccessLayer.Connector.Core

Assembly – Unisys.ABSuite.AccessLayer.Connector.Core (in Unisys.ABSuite.AccessLayer.Connector.Core.dll)

Syntax

event EventHandler<CancelEventArgs> DuplicateLoginRequest

Using the IConnection Interface for the DuplicateLoginRequest Event

The following code is an example of using the DuplicateLoginRequest event:

// Register for the DuplicateLoginRequest event
 ABSConnection.DuplicateLoginRequest += HandleDuplicateLogin;

// HandleDuplicateLogin is the handler for processing the 
// DuplicateLoginRequest event when a new session tries to connect 
// to the host system using Login credentials that are already being 
// used by an existing session. 
        public void HandleDuplicateLogin(object sender, CancelEventArgs args)
        {
            // Cancel the event and Log a message 
            args.Cancel = true;
            ApplicationLogger.LogInfo(() => string.Format("A duplicate Login condition has been encountered!"));

        }

The IsBusyChanged event is triggered when a change occurs in the busy state of the connection.

Namespace – ABSuite.AccessLayer.Connector.Core

Assembly – Unisys.ABSuite.AccessLayer.Connector.Core (in Unisys.ABSuite.AccessLayer.Connector.Core.dll)

Syntax

event EventHandler IsBusyChanged

Using the IConnection Interface for the IsBusyChanged Event

The following code is an example of using the IsBusyChanged event:

// Register for the event
ABSConnection.IsBusyChanged += HandleIsBusyChanged;

// HandleIsbusyChanged is the handler for processing the 
// IsBusyChanged event when a change occurs in the Busy state 
// of the connection. 
    public void HandleIsBusyChanged ()
    {
    // Retrieve the current Busy state of the connection and log it.
        if (ABSConnection.IsBusy)
            ApplicationLogger.LogInfo(() => string.Format("Connection is currently busy 
            processing a request!"));

    }

The ProcessTransactionErrors event is triggered when the runtime system returns error messages to a client session.

Namespace – ABSuite.AccessLayer.Connector.Core

Assembly – Unisys.ABSuite.AccessLayer.Connector.Core (in Unisys.ABSuite.AccessLayer.Connector.Core.dll)

Syntax

event EventHandler<TransactionErrorsArgs> ProcessTransactionErrors

Using the IConnection Interface for the ProcessTransactionErrors Event

The following code is an example of using the ProcessTransactionErrors event:

// Register for the ProcessTransactionErrors event   
ABSConnection.ProcessTransactionErrors += HandleTransactionErrors; 

// HandleTransactionErrors is the handler for processing the error 
// messages received from the host as a result of the transaction 
// request.  
        public void HandleTransactionErrors(object sender, TransactionErrorsArgs args)
        {
            // Retrieve the event details and log the information
            ApplicationLogger.LogInfo(() => string.Format("Transaction request resulted in 
            errors from the host application"));

            // Check the HasErrors property
            if (args.HasErrors)
            {
                ApplicationLogger.LogInfo(() => string.Format("TransactionErrors ShowDialog is true!"));
// Call the ProcessErrors method to process the errors from the host 
// system 
                ProcessErrors(args.Errors);

            }

            // Call the ProcessErros method to process the errors 
            // from the host system 
            ProcessErrors(args.Errors);
}

The SetCursorRequest event is triggered when the runtime system sets the focus on a field in the current DataModel.

Namespace – ABSuite.AccessLayer.Connector.Core

Assembly – Unisys.ABSuite.AccessLayer.Connector.Core (in Unisys.ABSuite.AccessLayer.Connector.Core.dll)

Syntax

event EventHandler<ConnectionEventArgs> SetCursorRequest

Using the IConnection Interface for the SetCursorRequest Event

The following code is an example of using the SetCursorRequest event:

// Register for the SetCursorRequest event 
 ABSConnection.SetCursorRequest += HandleCursorRequest;

// HandleCursorRequest is the handler for processing the 
// SetCursorRequest event when the Host application sets the cursor 
// to a specific field in the DataModel.  
     public void HandleCursorRequest(object sender, ConnectionEventArgs args)
     {
      // Retrieve the cursor information 
      string cursorField = args.FocusField;   // Field name to set the focus
         int cursorCopy = args.ColumnIndex;   // Copy row number if it is a Copy.From ispec

         ApplicationLogger.LogInfo(() => string.Format("Cursor Field is set to: {0}. ColumnIndex is {1}",
         cursorField, cursorCopy));

}

The ShowTeachRequest event is triggered when the runtime system requests the view to display a teach class.

Namespace – ABSuite.AccessLayer.Connector.Core

Assembly – Unisys.ABSuite.AccessLayer.Connector.Core (in Unisys.ABSuite.AccessLayer.Connector.Core.dll)

Syntax

event EventHandler<ShowClassRecallScreenEventArgs> 
ShowTeachRequest

Using the IConnection Interface for the ShowTeachRequest Event

The following code is an example of using the ShowTeachRequest event:

// Register for the event  
ABSConnection.ShowTeachRequest += HandleTeachRequest;

// HandleTeachRequest is the handler for processing the 
// ShowTeachRequest event when the Host application sets the cursor 
// to a specific field in the DataModel.  
    public void HandleTeachRequest(object sender, ShowClassRecallScreenEventArgs args)
    {
        // Retrieve the Teach screen information  
        string teachScreen = args.Name;   // Name of the Teach 
        string ownerIspec = args.Owner;  // Ispec or class that owns 
      // the Teach screen

        ApplicationLogger.LogInfo(() => string.Format("Display Teach screen: {0}  for ispec {1}", 
        teachScreen, ownerIspec));

    }

The StatusChanged event is triggered when the status information is updated by the runtime system.

Namespace – ABSuite.AccessLayer.Connector.Core

Assembly – Unisys.ABSuite.AccessLayer.Connector.Core (in Unisys.ABSuite.AccessLayer.Connector.Core.dll)

Syntax

event EventHandler StatusChanged

Using the IConnection Interface for the StatusChanged Event

The following code is an example of using the StatusChanged event:

// Register for the StatusChanged event
ABSConnection.StatusChanged += HandleStatusChanged;

// HandleStatusChanged is the handler for processing the 
// StatusChanged event when the status information sent by the Host 
// application changes.  
   public void HandleStatusChanged(object sender, EventArgs args)
   {
    // The status information has changed. Check the Status property 
       string statusInfo = ABSConnection.Status;
       ApplicationLogger.LogInfo(() => string.Format("Current Status info: {0}", statusInfo));

   }

The TransmissionObjectChanged event is triggered when the response from the runtime system requires a different DataModel to be used, instead of the current DataModel.

Namespace – ABSuite.AccessLayer.Connector.Core

Assembly – Unisys.ABSuite.AccessLayer.Connector.Core (in Unisys.ABSuite.AccessLayer.Connector.Core.dll)

Syntax

event EventHandler<ConnectionEventArgs> 
TransmissionObjectChanged

Using the IConnection Interface for the TransmissionObjectChanged Event

The following code is an example of using the TransmissionObjectChanged event:

// HandleTransmissionObjectChanged is the handler for processing the 
// TransmissionObjectChanged event when the Host application context 
// changes to a different ispec.  
   public void HandleTransmissionObjecChanged(object sender, ConnectionEventArgs args)
   {
    // The status information has changed. Check the Status property 
       string newIspecName = args.TransObject.ObjectClassName; 
       ApplicationLogger.LogInfo(() => string.Format("Context has been changed to ispec: {0}", newIspecName));

   }