next up previous
Next: DAT_FIND - Find named component
Up: ROUTINE DESCRIPTIONS
Previous: DAT_ERASE - Erase component

   
DAT_ERMSG - Translate a status value into an error message

Description:
This routine translates an error status value into an associated error message. It first attempts to translate the value supplied as a DAT__ error code. If this fails, it then attempts to translate it as a system status code for the host operating system. If this also fails, then the returned string is a message indicating that the status value could not be translated.

Invocation:
CALL DAT_ERMSG( STATUS, LENGTH, MSG )

Arguments:
STATUS = INTEGER (Given)
The error status value to be translated.
LENGTH = INTEGER (Returned)
Number of significant characters in the returned error message (i.e. excluding trailing blanks). This value will not exceed the length of the character variable supplied for the MSG argument.
MSG = CHARACTER * ( * ) (Returned)
The error message.

Notes:
  • If the variable supplied for the MSG argument is not long enough to accommodate the error message, then the message will be truncated and the returned value of LENGTH will reflect the truncated length.
  • No returned error message will contain more significant characters than the value of the EMS__SZMSG symbolic constant. This constant is defined in the include file EMS_PAR.



next up previous
Next: DAT_FIND - Find named component
Up: ROUTINE DESCRIPTIONS
Previous: DAT_ERASE - Erase component

HDS Hierarchical Data System
Starlink User Note 92
R.F. Warren-Smith & M.D. Lawden
23rd February 1999
E-mail:rfws@star.rl.ac.uk

Copyright (C) 1999 Central Laboratory of the Research Councils