Gas Contract Nominations file โ Import from XML file
- Last UpdatedApr 24, 2025
- 2 minute read
By default, the Gas Contract Nominations application can read data from XML files placed in the %DNADataRoot%\RealTime\Temp\CustomApps\nom folder.
Unlike text-based gas contract nomination files, XML-based files do not have a required file-naming format other than that they must use the extension .xml.
The contents of each file, however, must take the following format:
|
Field |
Description and Constraints |
|---|---|
|
<SCADA_SCHED4> |
A wrapper delimiting the XML record. |
|
<T> |
The type of record. Enter N for nomination. |
|
<F> |
The creation or modification date/time in the following format: <YYYY-MM-DD HH:MM:SS> |
|
<M> |
Descriptive field for the station. |
|
<N> |
The Station Logical Name: the receipt or delivery meter station associated with the nomination. |
|
<R> |
The receipt/delivery flag. For a receipt nomination, enter R. For a delivery nomination, enter D. |
|
<C> |
The nomination cycle indicator. Valid values are as follows:
|
|
<S> |
The scheduled time for the nomination. Usually, this will be the top-of-gas day, but may be the start time of another nomination cycle. The format is as follows: <YYYY-MM-DD HH:MM:SS> |
|
<D> |
The amount of the nomination in volume units (MMCF). |
|
<E> |
The amount of the nomination in energy units (DTH). |
Important: The system considers leading or trailing spaces in text fields as part of the field value.
NAESB Nomination Cycles
|
Cycle |
Data Type |
Effective Time for Gas to Flow |
|---|---|---|
|
Timely (ONT) |
4:30 PM Central |
9:00 AM Central (next day) |
|
Evening (EVE) |
8:30 PM Central |
9:00 AM Central (next day) |
|
Intra-Day 1 (ID1) |
12:30 PM Central |
2:00 PM Central |
|
Intra-Day 2 (ID2) |
5:00 PM Central |
6:00 PM Central |
|
Intra-Day 3 (ID3) |
9:30 PM Central |
10:00 PM Central |
Example
<LIST>
<SCADA_SCHED4>
<T>N</T>
<F>2016-08-02 11:00:00</F>
<M>mGCN01</M>
<N>1</N>
<R>R</R>
<C>ID2</C>
<S>2016-08-02 11:00:00</S>
<D>150608</D>
<E>150608</E>
</SCADA_SCHED4>
</LIST>
Note: The file can have multiple <SCADA_SCHED4> entries.
Notes - File Handling
-
If both the filename and content are valid, the application processes, and then silently deletes, the file.
-
If the filename is invalid, the application renames the file <filename>.orig.
-
If the filename is valid, the application processes the file line by line.
-
If the application does not encounter an unexpected error, but does locate some invalid records, it silently deletes the file and appends the invalid lines to <filename>.err.
-
If the application encounters an unexpected error -- such as a corrupt file -- it renames the file to <filename>.orig.
-