Change of Location: Difference between revisions
PeterHicks (talk | contribs) Add Change of Location documentation |
PeterHicks (talk | contribs) mNo edit summary |
||
(5 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
The Change of Location | == Overview == | ||
When a train is calling a location other than the location in the schedule, a change of location message will be sent. | |||
== Data structure == | |||
<pre> | |||
{ | |||
"header": { | |||
"msg_type": "0008", | |||
"source_dev_id": "VNHY", | |||
"user_id": "#PEE0031", | |||
"original_data_source": "TOPS", | |||
"msg_queue_timestamp": "1511532209000", | |||
"source_system_id": "TRUST" | |||
}, | |||
"body": { | |||
"original_loc_timestamp": "1511528640000", | |||
"current_train_id": "", | |||
"train_file_address": "BDI", | |||
"train_service_code": "56461882", | |||
"dep_timestamp": "1511528640000", | |||
"loc_stanox": "36108", | |||
"train_id": "174M37CF24", | |||
"original_loc_stanox": "36169", | |||
"event_timestamp": "1511532180000" | |||
} | |||
} | |||
</pre> | |||
In the example above, the train scheduled to call at Stanox 36169 (Tuebrook Sdgs Gbrf) will now call at Stanox 36108 (Liverpool Biomass Tml Gbf). | |||
=== Header === | |||
{| class='wikitable' | |||
!Field | |||
!Description | |||
|- | |||
|msg_type | |||
|Set to '0008' for an change of location message | |||
|- | |||
|source_dev_id | |||
|[[LATA]] or [[CICS Session]] of the inputting terminal | |||
|- | |||
|user_id | |||
|[[NCI signon]] of the inputting user | |||
|- | |||
|original_data_source | |||
|Set to "TOPS" for a change of location message | |||
|- | |||
|msg_queue_timestamp | |||
| | |||
|- | |||
|source_system_id | |||
|Set to "TRUST" for a change of location message | |||
|} | |||
=== Body === | |||
{| class='wikitable' | |||
!Field | |||
!Description | |||
|- | |||
|train_id | |||
|The 10-character unique identity for this train at TRUST activation time | |||
|- | |||
|current_train_id | |||
| | |||
|- | |||
|dep_timestamp | |||
|The planned arrival/departure time at the location where the train will call | |||
|- | |||
|loc_stanox | |||
|The STANOX of the new calling point of the train | |||
|- | |||
|original_loc_stanox | |||
|The STANOX of the original location in the schedule | |||
|- | |||
|original_loc_timestamp | |||
|The planned arrival/departure time associated with the original location | |||
|- | |||
|train_service_code | |||
|Train service code as per schedule | |||
|- | |||
|train_file_address | |||
|The TOPS train file address, if applicable | |||
|- | |||
|event_timestamp | |||
|The time at which the Change of Location is entered into TRUST | |||
|} | |||
{{Navtable-DataFeeds}} | |||
[[Category:Train Movement Data]] |
Latest revision as of 16:53, 10 December 2018
Overview
When a train is calling a location other than the location in the schedule, a change of location message will be sent.
Data structure
{ "header": { "msg_type": "0008", "source_dev_id": "VNHY", "user_id": "#PEE0031", "original_data_source": "TOPS", "msg_queue_timestamp": "1511532209000", "source_system_id": "TRUST" }, "body": { "original_loc_timestamp": "1511528640000", "current_train_id": "", "train_file_address": "BDI", "train_service_code": "56461882", "dep_timestamp": "1511528640000", "loc_stanox": "36108", "train_id": "174M37CF24", "original_loc_stanox": "36169", "event_timestamp": "1511532180000" } }
In the example above, the train scheduled to call at Stanox 36169 (Tuebrook Sdgs Gbrf) will now call at Stanox 36108 (Liverpool Biomass Tml Gbf).
Header
Field | Description |
---|---|
msg_type | Set to '0008' for an change of location message |
source_dev_id | LATA or CICS Session of the inputting terminal |
user_id | NCI signon of the inputting user |
original_data_source | Set to "TOPS" for a change of location message |
msg_queue_timestamp | |
source_system_id | Set to "TRUST" for a change of location message |
Body
Field | Description |
---|---|
train_id | The 10-character unique identity for this train at TRUST activation time |
current_train_id | |
dep_timestamp | The planned arrival/departure time at the location where the train will call |
loc_stanox | The STANOX of the new calling point of the train |
original_loc_stanox | The STANOX of the original location in the schedule |
original_loc_timestamp | The planned arrival/departure time associated with the original location |
train_service_code | Train service code as per schedule |
train_file_address | The TOPS train file address, if applicable |
event_timestamp | The time at which the Change of Location is entered into TRUST |
Network Rail Open Data Feeds | |
---|---|
Data Feeds | About the Feeds • Account States • Durable Subscriptions • Example Code ( PHP / C# / Java / Ruby / Node.js) • Advanced Uses • FAQ • Release Notes |
RTPPM | RTPPM Feed |
Train Movements | Train Movements Feed • Train Activation • Train Cancellation • Train Movement • Train Reinstatement • Change of Origin • Change of Identity • Change of Location • TSPEED Field • Planned Cancellations • Cancellation Codes |
TD | TD Feed • C-Class Messages • S-Class Messages • Train Describers • TD Berths |
VSTP | VSTP Feed |
TSR | TSR Feed • Route Codes |
SCHEDULE | SCHEDULE Feed • TIPLOC Records • Schedule and Location Records • Association Records • CIF Codes • How Scheduling Works • Allowances |
Reference Data | Reference Data Feed • TOC Codes • CIF Codes • Delay Attribution Codes • Identifying Locations (STANOX, TIPLOC, NLC and 3-Alpha Codes) • STANOX Geographical Areas • Train Planning data (BPLAN) |