CDSA$OUTPUT_ERROR.EXE

The CDSA implementation on OpenVMS supplies a special program that can be used to translate numeric CDSA error codes to text messages. This program resides in the SYS$SYSTEM directory and is called CDSA$OUTPUT_ERROR.EXE. It uses the routines described in this section to convert a numeric error code to its associated text label and error string. A foreign command, cdsa_error, has been defined in SYS$MANAGER:CDSA$SYMBOLS.COM to invoke this program. For details about using cdsa_error and its options, see Chapter 4 “CDSA Utility Programs”.

Note that this utility is defined as cdsa_error by CDSA$SYMBOLS.COM. The cdsa_error utility converts a CDSA numeric error code into its corresponding text strings. The text is output to SYS$OUTPUT.

SYNOPSIS

cdsa_error base_flag error_code

OPTIONS

base_flag		The mathematical base in which the error code is represented: -d   Specifies that the numeric value of error_code is decimal (base 10). -o   Specifies that the numeric value of error_code is octal (base 8). -h   Specifies that the numeric value of error_code is hexadecimal (base 16). If you specify something other than these options, you will get an error message that lists the correct options. (See Example 2.)
error_code		The error code stated in the numerical base specified by the base-flag parameter.

EXAMPLES

1. $ cdsa_error -h 3135 Error: CSSMERR_DL_STALE_UNIQUE_RECORD The record returned has been changed by someone and is stale

2. $ cdsa_error -? dka300:[sys0.syscommon.][sysexe]cdsa$output_error.exe;1: illegal option -- ? cdsa$output_error -d|o|h <Error Code> options: -d : Error code is a decimal number -o : Error code is an octal number -h : Error code is a hexadecimal number