Vehicle Contents (Movement Order)

A Vehicle Contents movement order is defined by a set of delimited values that determines changes to be made to a set of vehicles. Changes include loading/unloading passengers, loading/unloading freight, changing vehicle destinations, and changing freight contents.

The type number for this order is 18.

For each vehicle that is to be changed, 5 values need to be defined. For 2 vehicles, 10 values are required, etc. The format for each vehicle is as follows:

index;loaded;loadtype;mass;destination

index

The vehicle index, where the first vehicle is index 0, the second is index 1, etc.

Example:

      loco, car1, car2, car3, .... car9

index: 0 1 2 3 9

      loco1, loco2, loco3, car1, car2, car3 

index: 0 1 2 3 4 5

During simulation, if there is any mismatch in indices (example: 10 values, only 9 cars) the simulation will not execute the order. When inn Developer mode, a warning message is generated when order execution fails due to an index mismatch.

loaded

empty: 0 loaded: 1

Any other value generates a warning in Developer mode, and loaded is set to 0 (empty)

loadtype

Integer as defined in table 'TrainLoads'.

example: 0 equals "empty" (not defined in table, is a special value) 1 equals Iron Ore (defined in table) 2 equals Grain (defined in table)

If load type is mismatched with load class of car type (example: Iron Ore in tank car) then the simulation generates an error. If load type is not found (or is not a number) sim generates an error when sim starts.

mass

Integer value in metric tonnes.

If empty: 0.

If a value is larger than the max value for that type of car is entered, the simulation automatically clips to max value. If not a valid integer, an error is generated. If a valid integer, but is negative, a warning is generated, and the value is interpreted as zero.

destination

Text of desired vehicle destination. In Developer mode, a text length longer than 30 characters generates a warning.