ENCINA(8) — Maintenance
NAME
translateError - translates status codes from one form to another
SYNOPSIS
translateError [codes...]
ARGUMENTS
[codes...] Specifies the Encina or DCE status code to be translated. Multiple codes can be specified by separating them with a space.
DESCRIPTION
The translateError program is used to translate Encina and DCE status codes from one form to another. A status code can be represented in four different forms in Encina:
An Encina or a DCE status string, such as ENC-enc-1025 or DCE-rpc-0036
A decimal number, such as 1907401729
A hexadecimal number, such as 0x16c9a024
An Encina or DCE C constant, such as TRAN_NOT_READY or rpc_s_comm_failure
The output displays the associated Encina or DCE status string, the message string, and either the hexadecimal number or C constant, or both, depending on the status code specified on the command line. The NLSPATH and LANG environment variables must be set to the appropriate message catalog for the message string to be displayed in the output.
EXAMPLES
The following command displays the Encina status string, message string, and hexadecimal number associated with the C constant TRAN_ABORT_NO_SUITABLE_COORDINATOR:
% translateError TRAN_ABORT_NO_SUITABLE_COORDINATOR
ENC-tra-1135: All acceptable applications refused to
coordinate (0x7796846f)
The following command displays the Encina status string, message string, and C constant associated with the decimal number 2006353007:
% translateError 2006353007
ENC-tra-1135: All acceptable applications refused to
coordinate [TRAN_ABORT_NO_SUITABLE_COORDINATOR]
The following command displays the Encina status string, message string, C constant, and hexadecimal number associated with the Encina status string ENC-tra-1135:
% translateError ENC-tra-1135
ENC-tra-1135: All acceptable applications refused to
coordinate [TRAN_ABORT_NO_SUITABLE_COORDINATOR]
(0x7796846f)
The following command displays the Encina status string, message string, and C constant associated with the hexadecimal number 0x7796846f:
% translateError 0x7796846f
ENC-tra-1135: All acceptable applications refused to
coordinate [TRAN_ABORT_NO_SUITABLE_COORDINATOR]
— March 1997