EuroRunner Interfaces - ENOM

Introduction

EuroRunner interfaces with ENOM for outgoing notices and also incoming notices.

Set-Up

Both Transit Notices (to a network operator) and Contract notices (to any other counterparty) can be sent by ENOM.

Configuration

To set-up EuroRunner to allow sending of notices by ENOM; set the following properties for any of Network, Network Group, Contract or Contract Group:

ENOM Notice
  1. This option enables sending of notices.
    Note: The caption This Network can send Notices will be different on the Network Group, Contract and Contract Group notice properties.
  2. Choose the interface with which EuroRunner will interact: ENOM
  3. List of formats in which to send the notice, for ENOM this is always XML
  4. Provides an alternative easy to read view of the notice data.

Then set-up specific templates for the notices to be sent/viewed as using the properties for any of Flange, Point, Journey, Network, Network Group, Contract or Contract Group:

ENOM Templates
  1. Checking this allows daily notices to be sent.
  2. This allows the user to choose a specific template for the notice be transformed into when being sent.
  3. This allows the user to choose a specific template for the notice to be transformed into when being viewed by the user.

Note: Template selections will depend on object type, there may be custom templates available, you should know when you need to use these rather than the default templates.

If you also wish to send weekly notices, you should complete the weekly sections with the same settings.

Technical

When you send a notice within EuroRunner, EuroRunner converts the raw data from the database into XML. This XML is then transformed using XSL into ENOM XML; this is then saved as a file and put into the ENOM inbox folder for ENOM to pick up.

EuroRunner interfaces with ENOM for outgoing notices and also incoming notices. Notices coming from ENOM are placed in the EuroRunner inbox (see File Services).

The ENOM notice receivers run asynchronously under Notice Manager. To be identified as containing an ENOM notice an XML notice must have its main element called <message> for Edig@s v2 messages or <gmsl_enom> for Edig@s v3.

Once identified as being from ENOM Notice Manager identifies if the notice contains Allocations (TDD or TDR for Edig@s v2) or Confirmations (HCN, HDT, TDT, TWT, BRA, BDW, SDA, SWA, SA, BR, MOP, BRO, CB for Edig@s v2, NOMRES for Edig@s v3).

Allocations are processed by the EuroRunnerAR.AllocationReceiverQC component, in the EuroRunnerARQC COM+ Application.

Confirmations are processed by the EuroRunnerCR.ConfirmationReceiverQC component, in the EuroRunnerCRQC COM+ Application.

Configuration

For sending notices using ENOM, the ENOM inbox must be set-up, it is configurable during the installation of EuroRunner Server, and is stored in the registry (see the ENOM section of the Registry documentation), it can be any fixed, mapped or UNC drive i.e. \\server\share\folder.

Troubleshooting

EuroRunner is not picking up messages from ENOM.

When ENOM receives a message via FTP, it creates an XML file in a specified folder; this is generally EuroRunner’s inbox. If messages do not seem to be getting through to EuroRunner then there could be a number of possibilities:

ENOM XML Setup

ENOM needs to be configured to create XML files when it receives a message i.e. via FTP. To set-up ENOM to generate XML files, open up ENOM and go to Maintenance > System.

  1. Click the XML tab and tick the Generate XML tick box.
  2. Either type in the path name to the folder which you want the files to be generated in
  3. or click the small button to the right of the box and browse for the folder.

If you type in the path name instead of browsing for it, please ensure that the folder exists and that you have read & write permissions on the folder.

The folder location is defined in the registry (see the File Services section of the Registry documentation). EuroRunner looks in the inbox sub-folder of the location stored in the registry.

To check if the registry contains the correct folder location:

  1. In Windows, click the Start button, then click "Run" and type "regedit"
  2. In the left window pane, locate "HKEY_LOCAL_MACHINE" and expand it, now locate "SOFTWARE" and again expand it
  3. Locate the "GMSL" key and expand it
  4. Expand the "Services" key
  5. Now left click on the "FileService" key, you should see something similar to the following:
    ENOM Registry
  6. The string value "sourcedirs" data value in the right window pane should be pointing to the location that ENOM outputs its XML.
  7. To change the value, simply double click the string key 'sourcedirs'.

EuroRunner cannot send messages to ENOM/ENOM is not picking up outgoing EuroRunner messages, and there are no error messages from EuroRunner/ENOM

As EuroRunner simply creates an XML file in a folder to send messages to ENOM, there is not actually a lot that can fail with this part of the process with regards to ENOM or EuroRunner.

If EuroRunner cannot create the file in the specified location then the most likely causes would be:

The ENOM inbox is defined in the registry (see the ENOM section of the Registry documentation). This value is the path to the folder where EuroRunner will create the XML notice.

To check if the registry contains the correct folder location:

  1. In Windows, click the Start button, then click "Run" and type "regedit"
  2. In the left window pane, locate "HKEY_LOCAL_MACHINE" and expand it, now locate "SOFTWARE" and again expand it
  3. Locate the "GMSL" key and expand it.
  4. Now left click on the EuroRunner key, you should see something similar to the following:
    ENOM Registry
  5. The string value "edig@sin" data value in the right window pane should be pointing to ENOM's inbox.
  6. To change the value, simply double click the string key 'edig@sin' and enter the new path.

Ensure that this path actually exists; the simplest method is to copy this path then open up Windows explorer and paste it into address bar.

If you are certain the folder actually exists then the problem maybe that the folder is not actually accessible via EuroRunner.

This can sometimes be the issue when the target folder is located on a mapped or UNC network drive. If the drive has not been mapped correctly or the user is not authenticated.

If the folder exists and is accessible but EuroRunner still cannot create the XML file, the problem could be with actual file permissions on the folder.

Ensure that the target folder’s file permissions are set correctly and that the user that EuroRunner is running as (EuroRunnerUser by default unless changed during install) has read & write permissions to the folder.

Messages are getting to ENOM but are not being sent by ENOM

When ENOM receives a message it does a variety of things depending upon what is configured in the settings.

ENOM sends messages it receives from EuroRunner via FTP, there are several places in ENOM that require configuration for the FTP settings. If the FTP settings have not been set up, ENOM will not be able to send the messages.

This screen is the general FTP allow/disallow setting. Tick the Use FTP checkbox to allow ENOM to FTP.

If you require a proxy server to FTP in your network then you can enter a proxy server on this screen also. (Most networks permit FTP'ing therefore do not require a proxy server)

This screen defines exactly which FTP server is contacted and sent messages to.

ENOM FTP Setup

Each recipient in the Name dropdown list requires:

  1. FTP user id
  2. FTP password
  3. FTP path
  4. FTP IP address
  5. Once the FTP details have been entered the Use FTP box must also be checked.

Once all the settings have been entered click Save.

To configure ENOM to send messages as soon as it receives them from EuroRunner go to the Maintenance > System screen, on the General tab and tick the box called Send Messages Immediately.

When this box is ticked, ENOM will attempt to send the message via FTP to the correct counterparty as soon as it receives a new message.

When ENOM is performing a send/receive, it creates a log to show the process, to view this log, double click on the 4th pane in the status bar of ENOM:

ENOM Status Bar

This will display a screen listing the last process that occurred and informing you of any errors that may have occurred.

Note: If no FTP settings have been configured and a send/receive occurs, the process log will still say Getting FTP Lock...Got FTP Lock. This does not mean that ENOM has connected to an FTP server, the FTP lock is simply a database entry which is set when ENOM performs a send/receive.

Message leaving EuroRunner are causing a decode failure in ENOM

When ENOM receives a message that it has problems decoding from XML into its own format, ENOM produces a decode failure. ENOM will display a message box informing you of the file which had the decode problem.

ENOM will create a new file under the ENOM inbox called XMLFiles.log, this file contains a list of all decode problems that ENOM has encountered.

Under the inbox a new folder will be created call XML_Failed, this folder contains the message that failed along with another file with the same name as the failed message with a .LOG suffix. This file contains detailed information about the decode failure i.e:

19 Jul 06 11:54 ENOMSVR [GMSL] : MessageNOMINT01.Unit 'KWH' invalid.

In the example above ENOM has received a message which has an unknown unit, this would be rectified by adding a new unit to ENOM to match the unknown unit then the failed message could be moved into ENOM's inbox, or the message could be resent from EuroRunner.

Registry Keys

See the ENOM section of the Registry documentation.

GMSL Logo About Us | Contact Us | Fluxys SA | © 2006 Gas Management Services Limited