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: 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