IBMlogo
IBM eNetwork Communications Server for Windows NT
Host Publisher Feature, Version 6.01
[Next|Previous|Contents]

Host Publisher Hints and Tips

Errors

Host Access has some built-in features to correct errors in your host sessions.

When Host Access has recognized a screen, it looks for error strings on that screen. You define these on the Errors panel by:

  1. Selecting a screen
  2. Add...ing a new error
  3. Specifying some confirmation text, either by marking the text on the terminal window or manually entering it in the Confirmation Text field if the error is difficult to recreate.

Each error is assigned an error number, a short name, and a long name. These are used by Host Publisher in reporting and logging the errors.

Each error is categorized as fatal or recoverable. A recoverable error is one that allows returning to normal processing of the screen, while a fatal one does not.

Each error can have a macro associated with it.

The macro for a recoverable error should return the state to a point where screen processing can continue.

The macro for a fatal error should try to change the state to what is expected at the end of the data loop macro, so that the disconnect macro can play correctly.

Unfortunately, a limitation in the current release of Host Access prevents playing recoverable error macros during processing of a screen macro. It is not possible to recover from an error that occurs during processing of a screen macro. Use fatal errors instead of recoverable errors, unless the error cannot occur during a screen macro.

Restrictions

Host Access only looks for errors on screens it recognizes. It only recognizes screens during data loop and screen macros. You cannot invoke error handling this way during connect or disconnect macros.

You cannot invoke any special error handling if any macro command fails; for example, if a WaitForScreen in your data loop macro times out. When a macro command fails, Host Access stops processing the integration object and places an error message in the Web page it is producing.


[Next|Previous|Contents]
IBM eNetwork Communications Server for Windows NT
Host Publisher Feature, Version 6.01