Update carrier department - Code: UPD. CARR DEPARTMENT
General
This page describes the UPD. CARR DEPARTMENT function of the TMS Irreg Resolution Functions function set. Use it in a step on an irregularity to apply the department that was proposed for the linked carriers (handling units), for example after the planning changed.
The function works on the carriers that are linked to the irregularity as a cause. For each carrier, it only acts when a new department was proposed that differs from the one on the original section. The function does one of the following:
- Update the original order or section. This only happens when a new department was proposed for all carriers of the section and UPD. IF ALL UPDATED is enabled. UPD. SECTION/ORDER sets which document is updated: 0 for the order, 1 for the section, or 2 for both.
- Create a new order. In all other cases, the function creates a new order as a copy of the original order, without the goods, and with the new department. It adds the carriers to this new order. If a copy with the same department already exists for the original order, the function reuses it.
The new order and its carriers are added to the irregularity as results. After the function runs, the proposal is marked as processed.
Update the original document
When the function updates the original order or section:
- Use UPD. STATUS to set a status on the updated document. You can't use it when you update both the order and the section.
- Use CLEAR PLAN VALUES to clear 2 for the plan department and 3 for the plan box. Combine values with &, for example 2&3.
- Use RESET LOAD TIMES and RESET UNLOAD TIMES to clear the loading or unloading times of the updated order or section. When the function creates a new order, it doesn't copy those times from the original order.
Change the status of the original carrier and order
When the function creates a new order, you can set a status on the original carrier with CARR CXL STATUS. When all carriers of the original section have this status, the original section gets the status from ORD CXL STATUS. Leave the status parameters empty to keep the current statuses.
Parameters
The following parameters are applicable on this function.
| Name | Value | Description |
|---|---|---|
| UPD. IF ALL UPDATED | Yes or no. | Update the original document instead of creating a new order when all carriers have a new department. |
| UPD. SECTION/ORDER | 0, 1, or 2. | The document to update: 0 for the order, 1 for the section, or 2 for both. |
| UPD. STATUS | A status code. | Optional. The status to set on the updated document. Not possible when you update both. |
| CLEAR PLAN VALUES | Text. | Optional. The other plan values to clear: 2 for the plan department and 3 for the plan box. Combine values with &. |
| RESET LOAD TIMES / RESET UNLOAD TIMES | Yes or no. | Optional. Clear the loading or unloading times. |
| CARR CXL STATUS | A status code. | Optional. The new status of the original carrier. |
| CARR CXL REAS.CODE / CARR CXL REAS.DESCR | Reason code / free text. | Optional. The reason stored with the carrier status change. |
| ORD CXL STATUS | A status code. | Optional. The new status of the original section when all its carriers have the carrier status. |
| ORD CXL REAS.CODE / ORD CXL REAS.DESCR | Reason code / free text. | Optional. The reason stored with the order status change. |
| IRR. RESOLVED STATUS | A status code. | Fill this in. The new status of the irregularity. The function stops with an error when no status is available. |