[an error occurred while processing this directive]

HP OpenVMS Systems Documentation

Content starts here
HP Open Source Security for OpenVMS Volume 1: Common Data Security Architecture > Chapter 4 CDSA Utility Programs

CDSA$OUTPUT_ERROR.EXE

 » Table of Contents

 » Glossary

 » Index

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