Logs and troubleshooting

Last updated 10 November 2026

Logs

Each run writes its log into a folder named logs inside the folder it read. There are three files a day, info-<date>.log, warning-<date>.log and error-<date>.log; the last ten of each are kept.

The log names each file read, the bank it was matched to and the reader used, and counts what was read, skipped and written. A code Position Mapper can't translate, or a value it can't read, is logged as a warning rather than guessed. Read the warnings after each run. When a file or a position is missing from the result, the warning and error logs name the file and the reason.

When something goes wrong

What you see	What to do
Map and Load Positions is greyed out	Your licence doesn't include Position Mapper. See Activating your licence.
A message about the workbook	See The checks before each run.
Clicking the button seems to do nothing	The Bank Adaptor window couldn't start: on 32-bit Windows, or when antivirus software blocks it. Position Mapper needs 64-bit Windows. Otherwise run the Repair Tool (see If GIAnalyzer doesn't load).
"The application is not licensed to run. Please contact support."	Your licence doesn't include Position Mapper, or has expired.
"No running Excel instance found or Excel is unavailable."	The workbook was closed, or Excel restarted, while the window was open. Open the mapper workbook, keep it open, and run again.
"Missing required arguments. Operation cancelled."	The Bank Adaptor window was started some other way. Start it from the GIAnalyzer tab.
After Start, nothing changed in the workbook	Check that Excel was the output format, and that you closed the window: the workbook is updated when it closes. Then look in the error log.
All the positions of one bank are gone	The last run didn't include that bank's files. Each run replaces the sheets: see What a new run does.
A position is missing	Look in the warning and error logs. Check that the file is of a type Position Mapper reads: see Preparing the files.
CSV or JSON files hold the same deal twice	The same files are in the folder twice, often as a file and in an unpacked zip folder next to it. CSV and JSON don't merge them; the Excel output does.
The base CPI is empty on IND_P	The CPI data sheet doesn't have the month that trade needs. See Inflation legs and the CPI data sheet.

Contacting us

Email us with the warning and error logs of the run, and, if you can, a copy of the file that caused the problem with the client's details removed.