int PCMSValidateRouteHOS(Trip trip)


Trip trip – Handle to a trip.


Determines if a trip is HOS compliant. If the trip is not HOS compliant, an HOS report will be generated. This report will provide details about where along the route off-duty stops are required in order to satisfy HOS rules.

Note: If Hub routing is enabled, this function will generate an error message. It is NOT recommended to generate a Hub route when HOS management is enabled. Performance of this API will vary based on the length and complexity of the route. 

Return Values 

Zero (0) indicates that the route is HOS compliant. A negative one (-1) indicates that an error has occurred.


Greater than zero indicates that the route is not HOS compliant. The number provided is the number of off duty stops that need to be added to the route to make it HOS compliant.


Sample Code 

 if( PCMSValidateRouteHOS(trip) < 0)
if (PCMSGetHOSRouteReport(trip, buffer, BUFLEN) != 0)
//report not changed, loop
 if(!strcmp(buffer, prevReport))
 strcpy(prevReport, buffer);
 PrintLogString("\nPCMSGetHOSRouteReport()----\n %s", buffer);

Supported Since: PC*MILER Connect 29

Category: Hours of Service