int PCMSSetStopOptions(Trip trip, int stopIndex, bool onDuty, int stopDuration, int stopType)


Trip trip – Handle to a trip.

int stopIndex – Index of the stop.

bool onDuty – Sets the On Duty status of this stop. True = on duty, False = off duty.

int stopDuration – Time in minutes that the driver will remain at this stop.

int stopType – Identifier for which kind of stop is being made.  Should be an integer value of 0 to 4, with the following representations: 0 = None; 1 = Pickup; 2 = Drop off; 3 = Rest stop; 4 = Fuel stop.


Sets advanced stop information for a specific stop in a trip. 

Return Values 

Returns zero (0) upon success. A negative one (-1) indicates an error has occurred.

Sample Code

//insert the rest stop right before the destination
PCMSDeleteStop(trip, PCMSNumStops(trip) - 1);
if (PCMSAddStop(trip, restStop) != 1)

//set the rest stop as off duty with the stop duration
PCMSSetStopOptions(trip, PCMSNumStops(trip) - 1, false, (int)stopDuration, 0);
PCMSAddStop(trip, destination);
                               if (strlen(buffer))
PrintLogString("\nCan not parse HOS report: \n %s", buffer);

Supported Since: PC*MILER Connect 29

Category: Trip Options