Error Messages and Parameters in Route Optimiser Hidden Mode, Slides of Communication

Download Error Messages and Parameters in Route Optimiser Hidden Mode and more Slides Communication in PDF only on Docsity!

Route Optimiser Hidden

Mode v1. 6

• Route Optimiser Hidden Mode Page
• Revision Control
• Introduction - Conventions
• Running Import in hidden mode - Introduction
• Parameters - Example command - Extended error messages - Field numbers - Error types - Reasons for import to fail - Product fields - Error messages (only available in interactive mode) - Error numbers – Import file reading - Error numbers – Data processing - Error numbers – Quick Address - Error numbers – Dynamic import - Parameter driven features - Pre and Post import functions
• Running W32Auto - Introduction - Parameters - Recalculate routes and orders - Progress - Diagnostics mode - LogiXIE
• Black box matrix builder - Parameters - Status output format - Status values - Vehicle INI file format
  • [Vehicle] Page 2 Route Optimiser Hidden Mode
  • Speeds
• RDS – example usage of upload record types
• Introduction
• Order data
• Depot import
• Fleet availability
• Auto header
• Combined route and summary upload

Route Optimiser Hidden Mode Page 3

Revision Control

Revision Date By Details 1.0 05/10/15 Mohammad Arif Initial version – Content taken from Interface Suggestions v 1.1 29/02/15 Mohammad Arif Updated the definition for the /o2 flag for Import 1.2 29/07/16 Mohammad Arif Example command line structures for passing restrictions to Import and Morpheus added 1.3 04/10/18 Mohammad Arif Added xDima instructions for matrix building Added PTV Vehicle INI section 1.4 13/12/18 Mohammad Arif Add example command line structure for a local matrix through xDima 1.5 02/01/19 Andrew Gibbons Made various changes for more detail in the command line switches 1.6 19/07/19 Mohammad Arif Added extra error codes to ‘Dynamic Import’ table

Route Optimiser Hidden Mode Page 5

Running Import in hidden mode

Introduction

The standard Route Optimiser import program WLI32.EXE can be run in hidden mode. The file name must be specified within the PL.INI file within the work area. For details, please see the PLINI settings document. As with all DPS software, the usage of W32Auto is dependent on license keys. When working with Y cache map databases, the import engine can be configured to produce a local matrix. Morpheus.dll is needed in the LogiX32 folder which is not installed as default

Parameters

The following Parameters are available Parameter Usage /# Full path to DPS.INI /A Allows the request to run a post import program on exit. Spaces in the command line section of the Post import program should be replaced by a right curly bracket e.g. /ae:\carp\logix32\wlass32.exe,/h}/test,1,1. This is to prevent the program parsing the command line as part of the main program's command line. /B Full path for the errors file, overrides the settings in PL.INI /C Minimum confidence level. Used to overrule the default confidence level if being used as a validation tool. /D Map database to be used. This setting only applies when Import is given a full dataset to import, and is expected to process the data in a temporary work area i.e. /DGBE /E Extended error mode. works with /H to output the number of columns in error, and an error key to define the reason for rejection /F Full path to import file, overrides the settings in PL.INI Must be in hidden mode Do not use in conjunction /L /H Hidden mode When import has finished WLSRITOT.INI contains a value of ProgressPercent=100. WLSRITOT.INI will not be updated whilst there is a ICF.LOK in the work area. /J 0 (default) - Unknown 1 - containing Avoids/Bans records (.RJny) 4 - containing Barrier records (.RBar) 5 - containing Polygon restriction sections (.RPly) 6 - files list. These files will contain a list of restriction files and their corresponding types in the above format for the Morpheus system to systematically action. (.RLst) '/J' allows the user to pass a Matrix Restrictions file and its corresponding filetype (optional) on the Import engine command line. This is a RL5/6 Matrix Restriction file. If the filetype is not included then RL5/6 determines the file type from its extension. Otherwise it will be presumed the file is of whichever file type is passed. The file type is passed as the file type number followed by a right curly brace directly

Page 6 Route Optimiser Hidden Mode before the file path. e.g. "1}". The filename will be written to the new MatrixRestrictionFile setting in the Matrix Build info of the [Import32] section of PL.INI /L Full path to a Filelist Do not use in conjunction /F After each run the file list will be removed /M Import mode, works with /H 0 = validate no import 1 = Import data for rows without errors, and report errors for rows in error 2 = Import and recalculate routes and orders All other values are recalculate routes and orders If not set use the hidden mode will always update /O 0 = (default) means that there are no options set. 1 = If Bit 0 is set (add 1) then this informs the engine that no depots are allowed to be imported regardless of any other permissions. 2 = If Bit 1 is set (add 2) then the engine removes any part of the path containing the characters '' or '/' up to and including the last instance of either character when the path value is checked on G records. /S Run auto at end of the import process /T Test mode, temporary work areas created in the /W directory are not deleted Only use for testing as the machine could run out of space, or the directory could run out of entries. /W Base path to create temporary work areas. Unless /T is specified the work area is created in a fresh folder, then deleted. Incompatible with /U Import will attempt to find an unused folder name based on the machines current date and time /X States that all the characters to the right are deemed to be the start directory and the program will attempt to change to this directory on start-up. All the characters to the left of /X become the rest of the command line. It is important therefore that the starting directory is the LAST parameter on the command line. /Z Importing in 'Black Box' mode we can override settings. We have added a 32 bit map for future proofing. This is similar to the /O option. If the /Z option is selected then columns for all 25 product types are recognised by default. If you need totals to be written to the WLSRITOT.INI, the following must be set. Within the [Import32] section of the PL.INI the following entry WritetotalsINI=yes WLSRITOT.INI is regenerated when the ICF.LOK file is deleted If you need errors from all files in a file list, set ClearErrors=no in the Import32 section of PL.INI

Example command

To import data into an existing profile, and using post import setting run auto C:\carp\logix32\wli32.exe /H /DGBE /S /X"c:\carp\workarea\test1" To import a file defined as a command line parameter, into a temporary profile, and using post import setting run auto

Page 8 Route Optimiser Hidden Mode Field Number Priority 45 Vehicle 46 Pair 47 Group 48 Shelf life 49 Sequence 50 Uninterrupted 51 Position 52 Book day 53 Work speed 54 Depot cap1 55 Depot cap2 56 Preferred depot 57 Total capacity 1 58 Total capacity 2 59 Category 60 Stock 61 Etc km 62 Etc hour 63 Supply cost 1 64 Supply cost 2 65 Error types Error Meaning I_IMPORT_ERR1 Invalid Type I_IMPORT_ERR2 Invalid Action I_IMPORT_ERR4 Ambiguous place name only I_IMPORT_ERR5 Post Zone only I_IMPORT_ERR6 Major City - known but vague only I_IMPORT_ERR7 Unsupported unique one-word place name only I_IMPORT_ERR8 Supported unique one-word place name only I_IMPORT_ERR9 Unique multi-word place name only I_IMPORT_ERR10 Reinforced unique place name only I_IMPORT_ERR11 Post sector only I_IMPORT_ERR12 Full British Postcode - Quick Address only I_IMPORT_ERR13 No location Given I_IMPORT_ERR14 Location not recognized I_IMPORT_ERR15 Outside Scan Boundaries I_IMPORT_ERR18 Did not match confidence level I_IMPORT_ERR19 Invalid Group number I_IMPORT_ERR20 Value out of range I_IMPORT_ERR21 Duplicate Call Point I_IMPORT_ERR22 Call Point not found I_IMPORT_ERR23 Missing Call Point Reference I_IMPORT_ERR24 Duplicate Order I_IMPORT_ERR25 Order Not Found I_IMPORT_ERR26 Missing Order Reference I_IMPORT_ERR27 Invalid Customer name I_IMPORT_ERR28 Missing Depot name I_IMPORT_ERR29 Duplicate Depot I_IMPORT_ERR30 Depot not found

Route Optimiser Hidden Mode Page 9 Error Meaning I_IMPORT_ERR31 Invalid Vehicle bans value I_IMPORT_ERR32 Invalid Closed Days value I_IMPORT_ERR33 Invalid Time value I_IMPORT_ERR34 Overlapping Time Windows I_IMPORT_ERR35 Invalid Zone Value I_IMPORT_ERR36 Invalid Order Type I_IMPORT_ERR37 Invalid Imposed Book Time value I_IMPORT_ERR38 Invalid Imposed Work Time value I_IMPORT_ERR39 Invalid Imposed Depot Time value I_IMPORT_ERR40 Invalid Imposed Fix Time value I_IMPORT_ERR41 Invalid Imposed revenue value I_IMPORT_ERR42 Invalid Product Number I_IMPORT_ERR43 Invalid Product Quantity I_IMPORT_ERR44 Invalid Priority value I_IMPORT_ERR45 Priority must be in the range 1.. I_IMPORT_ERR46 Invalid Vehicle Group I_IMPORT_ERR47 Invalid Pair number I_IMPORT_ERR48 Invalid Shelf Life number I_IMPORT_ERR49 Invalid Sequence number I_IMPORT_ERR50 Invalid Interrupt Flag I_IMPORT_ERR51 Invalid Throughput capacity per day I_IMPORT_ERR52 Overlapping Depot capacities I_IMPORT_ERR53 Invalid Preferred Depot I_IMPORT_ERR54 Invalid Throughput capacity per planning period I_IMPORT_ERR55 Overlapping Depot Capacities I_IMPORT_ERR56 Invalid Depot Category I_IMPORT_ERR57 Invalid Depot Stock I_IMPORT_ERR58 Invalid Estimated Transport Cost Per Distance Unit I_IMPORT_ERR59 Invalid Estimated Transport Cost Per hour I_IMPORT_ERR60 Invalid Depot Supply cost I_IMPORT_ERR61 Outside Location Boundaries I_IMPORT_ERR62 Invalid Position I_IMPORT_ERR63 Invalid Book Day I_IMPORT_ERR64 Invalid Work Speed I_IMPORT_ERR65 No Errors detected I_IMPORT_ERR66 Product Quantities differ I_IMPORT_ERR67 No corresponding order found I_IMPORT_ERR68 Order is already linked to another I_IMPORT_ERR69 Order is allocated to a route I_IMPORT_ERR70 Order types correspond I_IMPORT_ERR71 Corresponding order has errors I_IMPORT_ERR72 The Maximum number of orders allowed has been reached I_IMPORT_ERR73 The Maximum number of depots allowed has been reached

Reasons for import to fail

Product fields

Route Optimiser Hidden Mode Page 11 Number Category Field

• 1 Gazetteer Cannot find GazetteS.ini
• 2 Gazetteer Invalid path to street level gazetteer
• 3 Gazetteer Cannot find GazetteS file
• 4 Gazetteer Cannot open GazetteS file
• 5 Gazetteer Cannot read GazetteS file
• 6 Gazetteer Invalid GazetteS file
• 9 Gazetteer Invalid database code
• 11 Gazetteer Cannot create street level locator form
• 12 Gazetteer Insufficient fields returned

Error numbers – Quick Address

Number Category Field

• 1000 QA Fatal
• 1001 QA Insufficient memory
• 1005 QA Cannot initialize
• 1006 QA Initialisation failure
• 1010 QA QA file open
• 1011 QA File File exists
• 1012 QA File File read error
• 1013 QA File File write error
• 1014 QA File File deletion error
• 1016 QA File File access error
• 1017 QA File Incorrect file version
• 1018 QA File File handle error
• 1019 QA File File creation error
• 1020 QA File File rename error
• 1021 QA File expired, QA database out of date
• 1022 QA File not demo version
• 1025 QA Read failure
• 1026 QA Write failure
• 1027 QA Incorrect drive specification
• 1028 QA Incorrect directory specification
• 1029 QA Directory creation error
• 1030 QA Invalid option
• 1031 QA Invalid INI file
• 1032 QA Invalid Log file
• 1033 QA Memory problem
• 1034 QA Invalid Hot key
• 1035 QA Hot key used
• 1036 QA Invalid resource
• 1037 QA Invalid data directory
• 1038 QA Invalid temporary directory
• 1040 QA Unknown error
• 1041 QA Duplicate
• 1042 QA Invalid action
• 1050 QA CC CC failure
• 1051 QA CC CC invalid code
• 1052 QA CC CC access failure
• 1053 QA CC CC missing dongle
• 1054 QA CC CC invalid units

Page 12 Route Optimiser Hidden Mode Number Category Field

• 1055 QA CC CC no meter
• 1060 QA CC CC installation error
• 1061 QA CC CC expired
• 1062 QA CC CC date time error
• 1063 QA CC CC user limit
• 1064 QA CC CC activation error
• 1065 QA CC CC invalid drive specification
• 1070 QA Authorisation error
• 1080 QA Read error, nothing read
• 1090 QA Missing task

Error numbers – Dynamic import

Page 14 Route Optimiser Hidden Mode

Parameter driven features

Pre and Post import functions It is possible to define scripts / applications which are executed by import before and upon completion of import. These scripts are run when the Play button is pressed within import, not at the point that import itself is run.

Running W32Auto

Introduction

The W32Auto black box schedule engine, works in tandem with WLSRI import engine. When executing the W32AUTO engine the current path must be that of the work area to be scheduled. When scheduling is complete, W32Auto writes an AutoLog.fin file to the work area. W32Auto is not included as part of a Standard Route Optimiser installation As with all DPS software, the usage of W32Auto is dependent on license keys.

Parameters

The following Parameters are available Parameter Usage Path to the map database cfg file i.e. C:\Carp\DATA-GBE\datacfg.GBE Path to the matrix file i.e. C:\Carp\DATA-GBE\ROADMAPQ.GBE /H Hidden mode By default W32Auto runs in interactive mode /I Online mode, can be used in conjunction with /H. In online mode W32Auto outputs status information via progress files When running in hidden mode the two path parameters are mandatory When running in interactive mode the path parameters are specified as part of the WAUTODO.INI.

Recalculate routes and orders

It is often the case that a set workarea just needs recalculating, to assess any changes either to order sizes, or because “Actual” times have been set. This can be achieved with the following settings.

• As a “H” record 1}1}6}9}-1}-1}""}

Progress

W32Auto can return status information via the “Progress.gau” file, which is written to the work area. If the /I command line parameter is set, then status information will be written to the “Progress.gau” file at the next available point after a request is made. The calling application can make a request for status information by writing a “1” to the “Progress.nsr” file in the work area. W32Auto will write a 0 (zero) to the file when it has processed the request.

Route Optimiser Hidden Mode Page 15 The data is written to the “Progress.gau” file in the following as a record of with the following format.  typedef struct  {  int lSize; // size of structure  int lVers[4]; /* The version number of the Auto DLL  0 = Major version  1 = Minor version  2 = Release  3 = Build  /  int lSR; / communication flag caller->auto  1 = tell auto to pass progress info  2 = tell auto to stop gracefully  3 = stop quickly  Auto always resets this field to 0.  */  int lErr; //  int lStat; //  int lNJnys; //  int lNTrps; //  int lNights; //  int lShift; //  int lDist; // Kms or tenth Kms?  int lNDel; //  double dDQ1; //  double dDQ2; //  double dDQ3; //  int lNCol; //  double dCQ1; //  double dCQ2; //  double dCQ3; //  int lUtil1; //  int lUtil2; //  int lUtil3; //  double dBars[5]; // the five progress bars ( 0-100)  // [0]= read orders  // [1]= matrix build  // [2]= tried  // [3]= Allocated  // [4]= optimised  } The data is written 4 byte aligned, therefore an int is a 4-byte integer, and a double is 8 bytes.

Diagnostics mode

By default, W32Auto displays a simple text based status screen when running in interactive mode When running in interactive mode, W32Auto can be controlled by the WAUTODO.INI file located in your Logix32 directory. An example file follows.  [AUTOTEST]  user =  datacfg =C:\CARP\DATA-gbx\DATACFG.gbx  lingo =C:\CARP\LOGIX32\ENGLISH.INI  roadmapq =C:\CARP\DATA-gbx\ROADMAPQ.gbx  logix =C:\CARP\LOGIX.INI  workarea =C:\Workarea\Test

LogiXIE

Route Optimiser Hidden Mode Page 17

Black box matrix builder

As part of the Route Optimiser suite of programs (depending on license) DPS provide the facility to build Y-cache matrix files via the Black box matrix builder Morpheus2BB.EXE. Morpheus2BB.EXE is not included as part of a Standard Route Optimiser installation As with all DPS software, the usage of Morpheus2BB is dependent on license keys. Morpheus2BB works based on an existing work area. Therefore, all required depots, orders or call points must be loaded into the work area.

Parameters

The following Parameters are available Parameter Usage /a Add to existing mode. Keeps existing matrix values and adds any new times and distances. Cannot be used in conjunction with /r /b<n,w,s,e> Boundary rectangle in decimal degrees latitude longitude i.e. <n,w,s,e>=North,West,South,East Any points outside of the boundary rectangle are ignored format North,West,South,East If for example a rogue order is imported outside of the normal territory, the total processing time can increase dramatically this setting helps to filter out these orders as they are not considered for use as a matrix point. /d Include depots. If omitted depots are ignored /e Load matrix points from fil(E) Can be either: *.dbf - with lat, long fields, *.jny - with lat/long or DPS Y Coordinated, or a matrix file with the correct map file extension /f (F)requency of status information output, in seconds. The output format is defined later NOTE: Requires threads, so not to be used with /N Default = - 1 (no action) /g (G)eopath. This can either be the code for the map database i.e. UKA, or the full path the GEOY file (including the extension). NOTE: Has no effect if /P is used to set the profile path, as the map will be retrieved from the profile settings /h (H)idden mode, no screen messages /i Delete any (I)naccessible/(I)nvalid nodes If is greater than zero, then only delete nodes if less than % of nodes are inaccessible If equals zero, then no points will be deleted If equals - 1, then all inaccessible points will be deleted Default = - 1 (no action) /j Load (J)ourney data and/or restrictions. Loads bans/avoid- points/poly-restrictions from (J)ourney file, PLY restriction file, or existing matrix file Can be either *.jny - with lat/long or DPS Y Coordinates, .ply/.plym

• poly-restriction file, or a matrix file with the correct map file extension.

Page 18 Route Optimiser Hidden Mode It is possible to pass a road-bans/avoids file with any file extension by prefixing the filepath with a type number followed by '}'. It is also possible to load multiple road bans files using either an '.LST' file extension containing a list of files with file type prefrix (see above). Alternately, any file extension can be used if the file type prefix of FT_LstFile (6). FT_UnKnown = 0 FT_Journey = 1 FT_dbf = 2 FT_matrix = 3 FT_Barrier = 4 FT_PlyRst = 5 FT_LstFile = 6 File containing a list of file paths Example: 5}D:\CARP\Workarea\Project\Profile\restrictions.xyz This will force RL6 to load the 'restrictions.xyz' file using the '.PLY' parsing routine. /k (K)eep/maintain existing bans/avoid points/poly-restrictions from existing matrix file Integer value representing a bitmap Range: 0 to 31 BIT 0 = Maintain Existing Speeds BIT 1 = Maintain Existing Bans BIT 2 = Maintain Existing Avoids BIT 3 = Maintain Existing Barriers BIT 4 = Maintain Existing Points Example: /K25 = Bitmap(11001) = Maintain Existing Speeds, Barriers and Points Default = - 1 (no action) /L (L)anguage Three character language code /m Matrix file output location Set the destination file path for the new matrix file. Default location is current directory (usually profile directory) with the file name LMSMatQ.xxx, where xxx is the map database code. File name must be provided. /n (N)o threads mode NOTE: Threads are required for regular progress output The progress file be initialised, but will not be written until after the matrix build is complete /o Output status file full path /p Path to the profile to be used as the data source /q (Q)uiet mode (No debug/log) NOTE: No effect at present!!! /r Rebuild matrix. It keeps all the points in the existing matrix and recalculates all time and distances /s Shutdown time after termination in seconds. To allow a graceful exit what is the maximum amount of time that the program can continue after the max run time is exceeded. /t Tasks loading flag. If not set (or all other values) load both tasks and call points 0 = No Callpoints and No Orders 1 = Tasks only 2 = Callpoints only 3 = Callpoints or Orders /u (U)ser session number