Skip to main content

PCMSSetStopOptions

Syntax

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

Parameters

  • 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.

Description

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)
    break;

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

Supported Since: PC*MILER Connect 29 Category: Trip Options

Last updated July 19, 2025.