Initialising Bank Wizard

Before you can use Bank Wizard to perform validation, it must be initialised and any conditions handled. You should report any conditions that occur during initialisation to a user who can react appropriately depending on the severity:

Fatal conditions during initialisation indicate that Bank Wizard will not function. These must be reported to a user who can react to the problem immediately. If error conditions occur at the same time, they will give you more information about the problem.
Error conditions indicate that there is a problem with a country, for example, if a country licence has expired or if the country's DTFs cannot be found or read. Whether your application can continue depends on your application and your business rules
Warning conditions indicate that Bank Wizard is functioning normally but there is something that you need to be aware of that does not require immediate action, for example, the licence for a country will expire within 30 days.
Information conditions are not generated during initialisation.

You can report these conditions as screen messages, system logs or email them to the user. You must also decide whether you want your application to operate without Bank Wizard or without a country, for example, if the licence for Spain has expired.

This example shows the simplest sequence of calls you can use.

/* Initialise a return code to show the status of the initialisation */

ret = OK

/* Create the handle used to return any conditions caused by the initialisation process */

BWICreateHandle(h)

/* Check that the handle is valid */

if (BWIValidHandle(h) != 0) {

/* If not valid, log the error and send a suitable return code */

logBWCondition(h,"Initialise")

return NO_BANK_WIZARD

/* Run the initialisation process */

BWIInit(h)

/* Log the initialisation and any conditions */

logBWCondition(h,"Initialise")

/* Check for any fatal conditions */

if (BWINext (h,BWI_N_FATAL)) {

/* Set a return code if Bank Wizard is unavailable */

ret = NO_BANK_WIZARD

}

/* Free the handle */

BWIFree(h)

This is when you cache the DTFs using a new handle, if required.

You must cache each country individually

/* Finish */

return ret