Drive until the controlled train makes contact with a consist ahead. The controlled stops immediately after contact with the rear of the consist. Prior to this command in the driver schedule, use can be made of a command such as 'Drive Via Trackmark' to bring the controlled train to a point with a clear switched path to the rear of the consist.
By default, the command execution sets the coupling mask of the lead coupler in the train's heading (logical direction of travel), so the train is prevented from coupling to the consist ahead. Alternatively, the user may elect to not set the couplling mask, in which case the train will couple to the consist ahead.
Use <kuid:368725:60017> 'Set lead coupler mask of train' to reset the mask once the set mask is no longer required.
Thanks to atilabarut for his 'CoupleAhead' command which has been used as a template for the development of this command.