Table of contents
- 1. Document version history
- 2. Use cases of the path request process
- 2.1 Create dossier
- 2.1.1 Sent information
- 2.1.2 result
- 2.1.3 Notifications
- 2.2 Set acceptance indicator to green
- 2.2.1 Sent information
- 2.2.2 result
- 2.2.3 Notifications
- 2.1 Create dossier
1. Document version history
Version | Release date | Author | Highlights |
2 | 27.06.2022 | Nicolas Jasinski | Alignment between use cases description and sequence diagramImplementation of PRM to applicantsOIM structure update and alignment to Sector XSD schemaInclusion of the “Automatic downgrade of an acceptance indicator” use case |
3 | 23.09.2022 | Nicolas Jasinski | Overall remark: improved alignment with the existing implementation, the implementation across the different process types/use cases and the Sector Handbook”Reject dossier as Leading IM” – PTID and RPTID: development under analysis “Send offer” notifications: updated PTID and RPTID implementation”Accept the offer as Leading Applicant” notifications: updated PTID and RPTID implementation”Refuse offer as LA” notifications: updated PTID and RPTID implementation |
4 | 10.03.2023 | Nicolas Jasinski | Reject dossier as Leading IM: PTID implementation status (implemented)General Timetable update: description added for the handling of PaPsSubmit Path Request and Dossier release to Path Elaboration: description added for the handling of PaPsMessage sequence for the handling of PaPs |
2. Use cases for the path request process
TOR is always equal to “2” in the Path Request process.
2.1 Create dossier
The dossier is created by the Leading Applicant (LA). To do that, it shall send a Path Coordination Message with Train Information element to PCS with the following content, so that the system can build up an international dossier with the respective Applicant-IM pairs:
- Message header:
- Sender: company code of the leading applicant
- Recipient: 3178 (RNE)
- TOI: 30 – create dossier
- Planned Transport Identifiers: TR ID.
- Train Information
The dossier is created in PCS. If there is an issue with the message, PCS sends back an Error Message with the root cause..
Path Coordination Messages can contain Train Information and/or Path Information element. For dossier creation, PCS considers the information from the Train Information element. Based on that, PCS prepares the dossier with the following content:
- Territories: based on the RA – IM pairs in the Train Information.
- Sub-paths: based on the Planned Journey Location information in the Train Information element (each RA – IM pair must have at least two locations in the Train Information). PR IDs are generated for each sub-paths based on the PCS path IDs in the system
- Dossier ID: CR ID in TAF TSI
- Train ID
The LA receives a Receipt Confirmation Message with the following content:
- Message header:
- Sender: 3178 (RNE)
- Recipient: company code of the LA
- Related reference
The involved applicants shall be informed that a dossier was created and that it is now in Harmonization, they receive an Object Info Message with the following content:
- Message header:
- Sender: 3178 (RNE)
- Recipient: company code of any involved applicant
- Identifier: CR ID
- Train Information Extended:
- PlannedTransportIdentifiers (PTID): TR ID
- RelatedPlannedTransportIdentifiers (RPTID): all objects ID of the dossier
- PathInformationExtended (PIE):
- PTID: PR ID
- Path Information: for each PR listed in PTID
2.2 Set acceptance indicator to green
Applicable for both RAs and IMs for harmonisation and coordination purposes.
Any involved agency who would like to set the acceptance indicator to green shall send Path Coordination Message without Train Information and Path Information with the following content:
- Message header:
- Sender: company code of any involved agency
- Recipient: 3178 (RNE)
- TOI: according to the TOI mapping above. Applicants and IMs can use those TOIs to change their acceptance indicators to the proper colour in the different dossier statuses.
- Planned Transport Identifiers: TR ID, CR ID
If all the mandatory information is fulfilled in the dossier, the acceptance indicators belonging to the involved agency are changed to green. If not, then PCS will send an Error Message.
The agency that set the light receives a Receipt Confirmation Message.
The involved agencies (applicants or IMs depending on the phase) shall be informed about the phase promotion. They receive a Path Coordination Message without Train Information and Path Information and with the following content:
- Message header:
- Sender: 3178 (RNE)
- Recipient: company code of any involved agency
- TOI: according to the TOI mapping
- Planned Transport Identifiers: TR ID, CR ID, PR or PA ID
If the object (PR/PA) has not been prepared via a TAF TSI message, the object company code will be RNE’s and not the agency’s that created the object. To identify the responsible applicant/IM that updated the indicator for the mentioned PRID/PAID, please refer to the path information included in a PRM, PDM or OIM for the dossier and the responsible RU/IM will be indicated for the corresponding PR ID / PA ID.
2.3 Set acceptance indicator to red
Applicable for both RAs and IMs for harmonisation and coordination purposes.
Any involved agency who would like to set the acceptance indicator to red shall send Path Coordination Message without Train Information and Path Information with the following content:
- Message header:
- Sender: company code of the involved agency
- Recipient: 3178 (RNE)
- TOI: according to the TOI mapping above. Applicants and IMs can use those TOIs to change their acceptance indicators to the proper colour in the different dossier statuses.
- Planned Transport Identifiers: TR ID, CR ID
- Mandatory free text field on the message level: reason for the red light
It works the same as changing the light to green or yellow, the only difference is that the sender agency shall put a mandatory comment in the free text field of the message.
The involved agency set its acceptance indicators to red and the reason is saved in the comment area of the dossier.
The agency that set the light receives a Receipt Confirmation Message.
The involved agencies (applicants or IMs depending on the phase) shall be informed about the phase promotion. They receive a Path Coordination Message without Train Information and Path Information and with the following content:
- Message header:
- Sender: 3178 (RNE)
- Recipient: company code of any involved agency
- TOI: according to the TOI mapping
- Planned Transport Identifiers: TR ID, CR ID, PR or PA ID
If the object (PR/PA) has not been prepared via a TAF TSI message, the company code will be RNE’s. To identify the responsible applicant/IM that updated the indicator for the mentioned PR/PAID, please refer to the Path Information element included in a PRM, PDM or OIM.
2.4 Set acceptance indicator to yellow
Applicable for both RAs and IMs for harmonisation and coordination purposes.
Any involved agency who would like to set the acceptance indicator to green shall send Path Coordination Message without Train Information and Path Information with the following content:
- Message header:
- Sender: company code of any involved agency
- Recipient: 3178 (RNE)
- TOI: according to the TOI mapping above. Applicants and IMs can use those TOIs to change their acceptance indicators to the proper colour in the different dossier statuses.
- Planned Transport Identifiers: TR ID, CR ID
If all the mandatory information is fulfilled in the dossier, the acceptance indicators belonging to the involved agency are changed to green. If not, then PCS will send an Error Message.
The agency that set the light receives a Receipt Confirmation Message.
The involved agencies (applicants or IMs depending on the phase) shall be informed about the phase promotion. They receive a Path Coordination Message without Train Information and Path Information and with the following content:
- Message header:
- Sender: 3178 (RNE)
- Recipient: company code of any involved agency
- TOI: according to the TOI mapping
- Planned Transport Identifiers: TR ID, CR ID, PR or PA ID
If the object (PR/PA) has not been prepared via a TAF message, the object company code will be RNE’s and not the agency’s that created the object. To identify the responsible applicant/IM that updated the indicator for the mentioned PRID/PAID, please refer to the path information included in a PRM, PDM or OIM for the dossier and the responsible RU/IM will be indicated for the corresponding PRID/PAID (also available with the getDossier webservice).
2.5 General timetable update
Applicable for both RAs and IMs to make any kind of timetable update (e.g., departure time change or location deletion/add) in the PCS dossier. Please note that if an information (e.g., departure time change or location) already exists in the dossier and is not included in the PCoM, this information will be deleted from the dossier.
Any involved agency who would like to make an update on the timetable in a PCS dossier shall send a Path Coordination Message with Path Information and the following content:
- Message header:
- Sender: company code of the agency making the update
- Recipient: 3178 (RNE)
- TOI: depending on the dossier status and the agency type
- Planned Transport Identifiers: TR ID, CR ID, PR ID or PA ID (depending on the agency type)
- Path Information:
- PlannedJourneyLocation. In addition to the elements defined as mandatory by TAF TSI, the following elements are mandatory:
If everything went fine, the dossier was updated in PCS. If not, an Error Message is sent back with the root cause.
The updater receives a Receipt Confirmation Message.
Affected agencies receive an Object Info Message with the following content:
- Message header:
- Sender: 3178 (RNE)
- Recipient: company code of any affected agency
- Identifier: CR ID
- TOI: 01 harmonization in process, 08 coordination update or 13 preparation of final offer – in process (depending on the dossier status and the agency type)
- Train Information Extended:
- PlannedTransportIdentifiers (PTID): TR ID
- RelatedPlannedTransportIdentifiers (RPTID): all objects ID of the dossier
- PathInformationExtended (PIE):
- PTID: all modified PR or PA (depending on the phase)
- Path Information: for each PR or PA ID listed in PTID
- Every subpath gets its own PathInformationExtended element
2.6 Automatic downgrade of an acceptance indicator
Please refer to this guide for more details.
2.6.1 Sent information
The acceptance indicator of the affected agency is changed to yellow.
The affected agencies receive a Path Coordination Message with the following content:
- Message header:
- Sender: 3178 (RNE)
- Recipient: company code of any affected applicant or IM (depending on the phase)
- TOI: 01 harmonization in process, 08 coordination update or 13 preparation of final offer – in process (depending on the dossier status and the agency type)
- Planned Transport Identifiers: TR ID, CR ID, PR ID and or PA ID of the agency that made the change resulted in the downgrade.
2.7 Submit Path Request
The aim of this use case is to promote the dossier from Harmonization to Path Request as a leading Applicant. As PCS stores everything in the dossier, there is no need to send the PathRequest for every single sub-paths (PR). The leading Applicant simply promotes the whole dossier, also on behalf of the other involved Applicants. This promotion can also occur with an automatic promotion of PCS according to the PCS deadlines and specific conditions.
2.7.1 Sent information
The LA who would like to promote the dossier to Path Request shall send a Path Coordination Message without Train Information and Path Information and the following content:
- Message header:
- Sender: company code of the LA
- Recipient: 3178 (RNE)
- TOI: 04 – request ready (NPR, LPR, RP, Ad-hoc) or 19 – pre-accepted offer (Ad-hoc with pre-accepted offer)
- Planned Transport Identifiers: TR ID, CR ID
If all the mandatory information is fulfilled in the dossier and all the acceptance indicators of the Applicants are set to green, the dossier will be promoted. If not, then PCS will send an Error Message.
The LA receives a Receipt Confirmation Message
Involved applicants shall be informed about the phase promotion (under development). They receive a Path Coordination Message without Train Information and Path Information and with the following content:
- Message header:
- Sender: 3178 (RNE)
- Recipient: company code of any involved applicant
- TOI: 04 – request ready (NPR, LPR, RP, Ad-hoc) or 19 – pre-accepted offer (Ad-hoc)
- Planned Transport Identifiers: TR ID, CR ID
2.7.4.1 Scenario 1 (already described in the latest version of the Communication Guide): the Path Request is not part of a dossier containing at Pre-Arranged Paths published by Rail Freight Corridors
All involved agencies shall be informed about the path requests. They receive a Path Request Message with the following content:
- Message header:
- Sender: 3178 (RNE)
- Recipient: company code of any involved IM/applicant
- TOI: 04 – request ready (NPR, LPR, RP, Ad-hoc) or 19 – pre-accepted offer (Ad-hoc)
- Planned Transport Identifiers: TR ID, CR ID, PR ID
- Related Planned Transport Identifiers: PA ID (IM Timetable) corresponding to the PR ID (applicant timetable) from the Planned Transport Identifiers element and all other PR IDs belonging to the same territory.
- Train Information
- Path Information
2.7.4.2 Scenario 2: the Path Request is part of a dossier containing at least one Pre-Arranged Path published by a Rail Freight Corridor – Applicable schema version: Sector schema 3.1.0.1
2.7.4.3 Scenario 3: the Path Request is part of a dossier containing at least one Pre-Arranged Path published by a Rail Freight Corridor – Applicable schema version: PCS shared-schema
Scenario 2: the Path Request is part of a dossier containing at least one Pre-Arranged Path published by a Rail Freight Corridor – Applicable schema version: Sector schema 3.1.0.1
2.8 Information about the dossier in Pre-Booking phase
All involved agencies shall be informed about the path requests in Pre-Booking phase. They receive a Path Request Message with the following content:
- Message header:
- Sender: 3178 (RNE)
- Recipient: company code of any involved IM/applicant
- TOI: 04 – request ready (NPR, LPR, RP, Ad-hoc) or 19 – pre-accepted offer (Ad-hoc)
- Planned Transport Identifiers: TR ID, CR ID, PR ID
- Related Planned Transport Identifiers: PA ID (IM Timetable) corresponding to the PR ID (applicant timetable) from the Planned Transport Identifiers element and all other PR IDs belonging to the same territory.
- Train Information: element PreArrangedPath is included at Planned Journey Location if the location is part of a PaP
- Path Information: element PreArrangedPath is included at Planned Journey Location if the location is part of a PaP
Once the C-OSS has completed the Pre-Booking phase, the C-OSS either forwards the path requests to the IM and release the dossier to the Path Elaboration phase (if the requested PaP, an alternative PaP or a tailor-made solution is offered by the C-OSS) or rejects the dossier.
Scenario 3: the Path Request is part of a dossier containing at least one Pre-Arranged Path published by a Rail Freight Corridor – Applicable schema version: PCS shared-schema
2.9 Information about the dossier in Pre-Booking phase
All involved agencies shall be informed about the path requests in Pre-Booking phase. They receive a Path Coordination with the following content:
- Message header:
- Sender: 3178 (RNE)
- Recipient: company code of any involved IM/applicant
- TOI: 54 – Pre-booking in progress
- Planned Transport Identifiers: TR ID, CR ID, PR ID
- Related Planned Transport Identifiers: PA ID (IM Timetable) corresponding to the PR ID (applicant timetable) from the Planned Transport Identifiers element and all other PR IDs belonging to the same territory.
- Train Information: element PreArrangedPathPublishedbyRFCs is included at Planned Journey Location if the location is part of a PaP
- Path Information: element PreArrangedPathPublishedbyRFCs is included at Planned Journey Location if the location is part of a PaP
2.9 Dossier release to Path Elaboration
2.9.1 Scenario 1: the Path Request is not part of a dossier containing at Pre-Arranged Paths published by Rail Freight Corridors
Involved IMs shall be informed about the dossier promotion to Path Elaboration.
All involved IMs receive a Path Coordination Message with Train and Path information:
- Message header:
- Sender: 3178 (RNE)
- Recipient: company code of any involved IM
- TOI: 07 – Create offer
- Planned Transport Identifiers: TR ID, CR ID, PR ID
- Related Planned Transport Identifiers: PA ID (IM Timetable) corresponding to the PR ID (applicant timetable) from the Planned Transport Identifiers element and all other PR IDs belonging to the same territory.
- Train Information
- Path Information
2.9.2 Scenario 2: the Path Request is part of a dossier containing at least one Pre-Arranged Path published by a Rail Freight Corridor – Applicable schema version: Sector schema 3.1.0.1
All involved agencies shall be informed about the latest version of the path requests forwarded by the C-OSS to the IMs: they receive a Path Request Message with the following content:
- Message header:
- Sender: 3178 (RNE)
- Recipient: company code of any involved IM/applicant
- MS: 2
- TOI: 04 – request ready (NPR, LPR, RP, Ad-hoc) or 19 – pre-accepted offer (Ad-hoc)
- Planned Transport Identifiers: TR ID, CR ID, PR ID
- Related Planned Transport Identifiers: New PA ID (IM Timetable) corresponding to the PR ID (applicant timetable) from the Planned Transport Identifiers element and all other PR IDs belonging to the same territory.
- Train Information: element PreArrangedPath is included at Planned Journey Location if the location is part of a PaP
- Path Information: element PreArrangedPath is included at Planned Journey Location if the location is part of PaP
The Message Status 2 indicates to the IM that this Path Request Message replaces the Path Request Message containing the same PR ID and sent with Message Status 1 to the IM when the dossier transitioned from Harmonisation to Pre-Booking phase.
Involved IMs shall also be informed about the dossier promotion to Path Elaboration with a Path Coordination Message:
- Message header:
- Sender: 3178 (RNE)
- Recipient: company code of any involved IM
- TOI: 07 – Create offer
- Planned Transport Identifiers: TR ID, CR ID, PR ID
- Related Planned Transport Identifiers: PA ID (IM Timetable) corresponding to the PR ID (applicant timetable) from the Planned Transport Identifiers element and all other PR IDs belonging to the same territory.
- Train Information: element PreArrangedPath is included at Planned Journey Location if the location is part of a PaP
- Path Information: element PreArrangedPath is included at Planned Journey Location if the location is part of PaP
Note applicable to the above-mentioned Path Request Message and Path Coordination Message:
If the applicant has during the Pre-Booking phase accepted an alternative PaP offered by the C-OSS Manager or if the C-OSS has converted the PaP locations into tailor-made locations, the Train and Path Information elements will contain these changes. In this situation:
- The Train and Path information included in the first Path Request Message sent to the IM for the Submit Path Request use case are obsolete.
- Train Information and Path Information elements received in the messages are not aligned with the C-OSS timetable and not with the applicant timetable (however, the PR IDs from the applicant timetable are included in the identifiers elements). The acceptance of an alternative PaP by the applicant is formalised via PCS GUI, however the corresponding Path Request (the subpath in the applicant timetable) cannot be updated once it has been submitted.
Scenario 3: the Path Request is part of a dossier containing at least one Pre-Arranged Path published by a Rail Freight Corridor – Applicable schema version: PCS shared-schema
All involved agencies shall be informed about the latest version of the path requests forwarded by the C-OSS. They receive a Path Request Message with the following content:
- Message header:
- Sender: 3178 (RNE)
- Recipient: company code of any involved IM/applicant
- TOI: 04 – request ready (NPR, LPR, RP, Ad-hoc) or 19 – pre-accepted offer (Ad-hoc)
- Planned Transport Identifiers: TR ID, CR ID, PR ID
- Related Planned Transport Identifiers: New PA ID (IM Timetable) corresponding to the PR ID (applicant timetable) from the Planned Transport Identifiers element and all other PR IDs belonging to the same territory.
- Train Information: element PreArrangedPathPublishedbyRFCs is included at Planned Journey Location if the location is part of a PaP
- Path Information: element PreArrangedPathPublishedbyRFCs is included at Planned Journey Location if the location is part of a PaP
Involved IMs shall also be informed about the dossier promotion to Path Elaboration with a Path Coordination Message:
- Message header:
- Sender: 3178 (RNE)
- Recipient: company code of any involved IM
- TOI: 07 – Create offer
- Planned Transport Identifiers: TR ID, CR ID, PR ID
- Related Planned Transport Identifiers: PA ID (IM Timetable) corresponding to the PR ID (applicant timetable) from the Planned Transport Identifiers element and all other PR IDs belonging to the same territory.
- Train Information: element PreArrangedPathPublishedbyRFCs is included at Planned Journey Location if the location is part of a PaP
- Path Information: element PreArrangedPathPublishedbyRFCs is included at Planned Journey Location if the location is part of a PaP
Note applicable to the above-mentioned Path Request Message and Path Coordination Message:
If the applicant has during the Pre-Booking phase accepted an alternative PaP offered by the C-OSS Manager or if the C-OSS has converted the PaP locations into tailor-made locations, the Train and Path Information elements will contain these changes. In this situation:
- The Train and Path information included in the first Path Request Message sent to the IM for the Submit Path Request use case are obsolete
- Train Information and Path Information elements received in the messages are not aligned with the C-OSS timetable and not with the applicant timetable (however, the PR IDs from the applicant timetable are included in the identifiers elements). The acceptance of an alternative PaP by the applicant is formalised via PCS GUI, however the corresponding Path Request (the subpath in the applicant timetable) cannot be updated once it has been submitted.
Delete a sub-path from a dossier
Applicable for both RAs and IMs.
SENT INFORMATION
Any involved agency who would like to delete a sub-path from a dossier shall send a Path Coordination Message without Train Information and Path Infrmation and with the following content:
- Message header:
- Sender: company code of any involved applicant
- Recipient: 3178 (RNE)
- Planned Transport Identifiers: TR ID, CR ID, PR ID or PA ID (depending on the agency type)
- TOI: 32 – path canceled full
RESULT
The sub-path either with the PR ID from the Applicant timetable or with the PA ID from the IM timetable is successfully deleted.
NOTIFICATIONS
The updater receives a Receipt Confirmation Message.
As this update affects the whole dossier content, affected agencies receive an Object Info Message (under improvement: info about “deleted” path) without Train Information and Path Information from PCS with the following content:
- Message header:
- Sender: 3178 (RNE)
- Recipient: company code of any affected applicant or IM
- Identifier: CR ID
- TOI: 32 – path canceled full
- Train Information Extended:
- Identifiers
- PlannedTransportIdentifiers (PTID): TR ID
- RelatedPlannedTransportIdentifiers (RPTID): all objects ID of the dossier (note: therefore without the deleted object)
- TrainInformation
- PathInformationExtended (PIE):
- PTID: all PR or PA ID (depending on the phase) of all the subpaths (note: therefore without the deleted object)
- Path Information: for each PR or PA ID listed in PTID
- Every subpath gets its own PathInformationExtended element
- Identifiers
Send Offer
The aim of this use case is to show how the leading IM/AB can trigger the submission of offers (draft or final) at the PCS dossier level. The offer submission can also occur with an automatic submission of PCS according to the PCS deadlines and specific conditions.
SENT INFORMATION
The LIM who would like to trigger the submission of offers for a PCS dossier shall send a Path Coordination Message without Train Information and Path Information with the following content:
- Message header:
- Sender: company code of the LIM
- Recipient: 3178 (RNE)
- TOI: 09 – draft offer (for promotions from Path Elaboration during New Path Request, Late Path Request and Rolling Planning process types), 16 – final offer (for promotions from Post-processing during New Path Request, Late Path Request and Rolling Planning process types, from Path Elaboration during Ad-hoc Path Request process type)
- Planned Transport Identifiers: TR ID, CR ID
RESULT
If all the mandatory information is fulfilled in the dossier and all the acceptance indicators of the IMs/ABs are set to green, the dossier will be promoted. If not, then PCS will send an Error Message.
NOTIFICATIONS
The LIM receives a Receipt Confirmation Message.
Involved IMs shall be informed about the phase promotion. They receive a Path Coordination Message with the following content:
- Message header:
- Sender: 3178 (RNE)
- Recipient: company code of any involved IM
- TOI: 09 – draft offer, 16 – final offer
- Planned Transport Identifiers: TR ID, CR ID, PA ID
- Related Planned Transport Identifiers: all other PA IDs and PR IDs belonging to the same territory as the PA ID listed in Planned Transport Identifiers element
All involved agencies shall be informed about the offers. They receive a Path Details Message with the following content:
- Message header:
- Sender: 3178 (RNE)
- Recipient: company code of any involved agency
- TOI: 09 – draft offer, 16 – final offer
- Planned Transport Identifiers: TR ID, CR ID, PA ID
- Related Planned Transport Identifiers: all other PA IDs and PR IDs belonging to the same territory as the PA ID listed in Planned Transport Identifiers element
- Path Information
Reject dossier as Leading IM
The aim of this use case to show how a leading IM can reject a dossier (only possible Path Elaboration phase).
SENT INFORMATION
The LIM who would like to reject a dossier in PCS shall send a Path Coordination Message without Train Information and Path Information and with the following content:
- Message header:
- Sender: company code of the LIM
- Recipient: 3178 (RNE)
- TOI: 29 – withdrawal
- Planned Transport Identifiers: TR ID, CR ID
- Free text field on the message level: the reason for the rejection
RESULT
The dossier is rejected by the leading IM and it goes back to Harmonization status. Also, the reason for the rejection is saved to the comment area of the dossier.
NOTIFICATIONS
The LIM receives a receipt Confirmation Message.
All agencies shall be informed about the rejection. They receive a Path Coordination Message without Train Information and Path Information and with the following content:
- Message header:
- Sender: 3178 (RNE)
- Recipient: company code of any involved agency
- TOI: 29 – withdrawal
- Planned Transport Identifiers: TR ID, CR ID, PR ID
- Related Planned Transport Identifiers: PA IDs and PR IDs belonging to the same territory as the PR ID listed in Planned Transport Identifiers element (under analysis)
- Free text field on the message level: the reason for the rejection
Accept the offer as Leading Applicant
The aim of this use case to show, how a leading Applicant can accept the dossier and promote it to Active Timetable:
- New Path Request and Rolling Planning processes: the acceptance is only possible in the Final Offer phase (after the Post-processing phase)
- Late Path Request and Ad-hoc Path Request processes: the acceptance is possible in the Acceptance phase (next step following the PAth Elaboration)
SENT INFORMATION
The LA who would like to accept the dossier and move it to Active Timetable shall send a Path Coordination Message without Train Information and Path Information with the following content. This is valid for all process types.
- Message header:
- Sender: company code of the LA
- Recipient: 3178 (RNE)
- TOI: 17 – final offer – accepted
- Planned Transport Identifiers: TR ID, CR ID
RESULT
If all the mandatory information is fulfilled in the dossier and all the acceptance indicators of the applicants are set to green, the dossier will be promoted, and it arrives at the Active Timetable phase.
NOTIFICATIONS
The LA receives a Receipt Confirmation Message.
Involved IMs shall be informed about the acceptance; thus, PCS will send Path Confirmed Messages with the following content:
- Message header:
- Sender: 3178 (RNE)
- Recipient: company code of any involved IM
- TOI: 17 – final offer – accepted
- Planned Transport Identifiers: TR ID, CR ID, PA ID
- Related Planned Transport Identifiers: all other PA IDs and PR IDs belonging to the same territory as the PA ID listed as Planned Transport Identifiers element
Dossier transition to Active Timetable
As the dossier arrived at Active Timetable, it reached its final destination in the path request process. To keep all applicants up to date, PCS sends Path Details Messages with the booked paths to all involved agencies with the following content:
- Message header:
- Sender: 3178 (RNE)
- Recipient: company code of any involved agency
- TOI: 22 – booked
- Planned Transport Identifiers: TR ID, CR ID, PA ID
- Related Planned Transport Identifiers: all other PA IDs and PR IDs belonging to the same territory as the PA ID listed as Planned Transport Identifiers element
- Path Information
The same shall happen for Pre-accepted offer dossier: after the LIM sends the offer, the dossier transitions Active Timetable.
Refuse Offer as Leading Applicant
The aim of this use case is to show, how a leading Applicant can refuse an offer. Two options are available to them:
- Refusal without revision
- Refusal with required revision (available only for Ad-hoc path requests)
SENT INFORMATION
The LA who would like to refuse the offer shall send a Path Coordination Message to PCS without Train Information and Path Information with the following content:
- Message header:
- Sender: company code of the LA
- Recipient: 3178 (RNE)
- TOI: 25 – offer/final offer rejected (without revision) or 27 – offer/final offer rejected (revision required)
- Planned Transport Identifiers: TR ID, CR ID
RESULT
The result depends on the selected refusal option. If it’s done without revision, the dossier will go to the Closed phase, but if it’s with revision (available only for Ad-hoc path request), it will go back to Path Elaboration.
NOTIFICATIONS
Involved applicants shall be informed about the rejection. They receive a Path Coordination Message without Train Information and Path Information with the following content:
- Message header:
- Sender: 3178 (RNE)
- Recipient: company code of any involved applicant
- TOI: 25 – offer/final offer rejected (without revision) or 27 – offer/final offer rejected (revision required)
- PTID: TR ID, CR ID, PA ID
- RPITD: other PA IDs and PR IDs belonging to the same territory as the PA ID listed in Planned Transport Identifiers element
Involved IMs shall be informed about the rejection too. They receive a Path Details Refused Message with the following content:
- Message header:
- Sender: 3178 (RNE)
- Recipient: company code of any involved IM
- TOI: 25 – offer/final offer rejected (without revision) or 27 – offer/final offer rejected (revision required)
- PTID: TR ID, CR ID, PA ID
- RPITD: other PA IDs and PR IDs belonging to the same territory as the PA ID listed in Planned Transport Identifiers element
Make Observations (under development)
The aim of this use case to show how an Applicant can place an Observation in a dossier.
SENT INFORMATION
The involved applicant who would like to place an Observation shall send a Path Coordination Message without Train Information and Path Information with the following content. Please note that this use case is valid only for New Path Request and Rolling Planning process types because the Consultation phase is not part of the other process types.
- Message header:
- Sender: company code of the applicant making the observation
- Recipient: 3178 (RNE)
- TOI: 11 – observation – in process
- Planned Transport Identifiers: TR ID, CR ID, PA ID
- Free text field: the text of the Observation
RESULT
The Observation is saved in PCS in the comment area.
NOTIFICATIONS
The applicant that made the observation shall be informed that it was made successfully. He receives a Receipt Confirmation Message.
The IMs shall be informed that an Observation was made to one of the sub-paths. They receive a Path Coordination Message without Train Information and Path Information with the following content:
- Message header:
- Sender: 3178 (RNE)
- Recipient: company code of any involved agency
- TOI: 11 – observation – in process
- Planned Transport Identifiers: TR ID, CR ID, PA ID
- Free text field: the text of the Observation
Release Post-Processing
The aim of this use case is to show,how the leading Applicant can promote the dossier to Post-processing. This promotion can also occur with an automatic promotion of PCS according to the PCS deadlines and specific conditions.
SENT INFORMATION
The LA who would like to promote the dossier to Post-processing shall send a Path Coordination Message without Train Information and Path Information with the following content:
- Message header:
- Sender: company code of the LA
- Recipient: 3178 (RNE)
- TOI: 12 – observation – complete
- Planned Transport Identifiers: TR ID, CR ID
RESULT
The dossier is promoted to Post-processing.
NOTIFICATIONS
The LA receives a Receipt Confirmation Message.
All involved agencies shall be informed about the dossier promotion. They receive a Path Coordination Message without Train Information and Path Information with the following content:
- Message header:
- Sender: 3178 (RNE)
- Recipient: company code of any involved agency
- TOI: 12 – observation – complete
- Planned Transport Identifiers: TR ID, CR ID
Withdraw dossier
The aim of this use case to show,how a leading Applicant can withdraw a dossier (available only in Path Elaboration phase).
SENT INFORMATION
The LA who would like to withdraw a dossier in PCS shall send a Path Coordination Message without Train Information and Path Information with the following content:
- Message header:
- Sender: company code of the LA
- Recipient: 3178 (RNE)
- TOI: 29 – withdrawal
- Planned Transport Identifiers: TR ID, CR ID
- Free text field on the message level: the reason for the withdrawal
RESULT
The dossier is withdrawn by the leading Applicant and it goes back to Harmonization status. Also, the reason for the withdrawal is saved to the comment area of the dossier.
NOTIFICATIONS
The LA receives a Receipt Confirmation Message.
All agencies shall be informed about the withdrawal. They receive a Path Coordination Message without Train Information and Path Information with the following content:
- Message header:
- Sender: 3178 (RNE)
- Recipient: company code of any involved agencies
- TOI: 29 – withdrawal
- Planned Transport Identifiers: TR ID, CR ID, PR ID
- Free text field on the message level: reason for the rejection
Get dossier
Any involved agency of the dossier has a chance to download the dosser from PCS at any time. To do so, they only need to send an Object Info Message and PCS will send back the dossier also packed to an Object Info Message.
SENT INFORMATION
The involved agency who would like to download a dossier in PCS shall send an Object Info Message without Train and Path Information Extended element and with the following content:
- Message header:
- Sender: company code of the involved agency
- Recipient: 3178 (RNE)
- ObjectInfoType: R
- Identifier: CR ID
RESULT
As it is not an update in PCS, there is no result in the system, apart from the registered web-service request.
NOTIFICATIONS
The requesting agency receives an Object Info Message with the following content:
- Message header:
- Sender: 3178 (RNE)
- Recipient: company code of the involved Applicant
- ObjectInfoType: I
- Identifier: CR ID
- Train Information Extended:
- Identifiers
- PlannedTransportIdentifiers (PTID): TR ID
- RelatedPlannedTransportIdentifiers (RPTID): all objects ID of the dossier
- TrainInformation
- PathInformationExtended (PIE):
- PTID: all PR or PA ID (depending on the phase) of all the subpaths.
- Path Information: for each PR or PA ID listed in PTID
- Every subpath gets its own PathInformationExtended element
- Identifiers