Previous Topic: Run the Engine in Console ModeNext Topic: The List of Available Options (O)


Enable Direct Communications

You can communicate directly with a service that is already active. This communication allows you to get running updates of the service status, without interfering with the service activities. Communication with the service is done through Telnet.

This section explains how to enable direct communication.

Follow these steps:
  1. Define a base communication port for the engine with the following DML:
    INSERT INTO T_SYSTEM_CONFIGURATIONS
      (SYS_CONFIG_ID,
       SYS_CONFIG_NAME,
       SYS_CONFIG_VALUE,
       SYS_CONFIG_PARENT)
    VALUES
      (SEQ_SLA_SYS_CONFIG.NEXTVAL,
       'pslcommunicationport',
       3000,
       71)
    

    Note: Only do this procedure once.

    The number 3000, indicated in the above DML, is the base communication port. In other words, instance 0 uses this port. All other instances use this number, plus their instance ID, as their port. For example, instance 11 is assigned, using this example, port 3011. Obviously, the base port must be chosen so that all instances of the engine are assigned ports that are free. When a port is already taken, communication is disabled for the relevant instance. If the service is already up, running this script updates the database, but the service only searches for an update every 2 minutes. Therefore, it sometimes takes that long before the communication module is active.

  2. Open a command window and type the following command:
    Telnet <server name> <port id>
    

    The server name is the actual name of the computer, the IP of the computer, or localhost. This naming convention is true if you are initiating communications from the application server upon which the engine runs.

    For example, Telnet localhost 3011.

    When communication is initiated, the calculation status screen is displayed and a timeout delay of 10 seconds is activated. For example, every 10 seconds, the last requested page is retrieved again. The default page is the calculation status page and it is displayed until the user selects another page.

When you first connect, you receive the Telnet screen.

Pressing the relevant number on the keyboard displays the appropriate page:

The first line shows the instance of the PslWriter to which you are connected.

The following table details the letter or number and its explanation. A more detailed explanation of each letter/number follows.

Available Options:

Letter/Number

Explanation

O

List of available options

Q

(Quit) Terminates communications

1

Calculation status screen

2

Calculation Sequence

3

Agent calculation tracking

9

Fragmentation state of the process memory