next up previous
Next: Linking
Up: RETRIEVING HELP TEXT
Previous: Terminal Handling

Error Codes

The HLP_CREH routine and all internal subprograms return status information through an integer argument using the following codes:

HLP_HELP returns a function value of +1 rather than 0 to indicate success, for compatibility with the VMS HELP system. HLP_HELP may also return certain of the error values from the above list.

Most of these error conditions can only occur as a result of bugs in the HLP software. The most common one to arise during normal use is "HELP library error on OPEN" -- for example where an incorrect library name has been supplied.

A status value J returned by the HLP routines may be translated into a message string MES by means of the HLP_ERRMES routine:

CALL hlp_ERRMES(J,MES)

The length of the MES string should be at least 50 characters.



next up previous
Next: Linking
Up: RETRIEVING HELP TEXT
Previous: Terminal Handling



HLP --- Interactive Help System
Starlink User Note 124
P. T. Wallace
13th June 1995
E-mail:ptw@star.rl.ac.uk