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.
Copyright © 2019 East Asian Observatory