error_$c_get_text(3)

NAME

error_$c_get_text − return subsystem, module, and error texts for a status code

SYNOPSIS

C Syntax

void error_$c_get_text(

status_$t status,
char ∗subsys,
long subsysmax,
char ∗module,
long modulemax,
char ∗error,
long errormax)

Pascal Syntax

procedure error_$c_get_text(

in status: status_$t;
out subsys: univ char;
in subsysmax: integer32;
out module: univ char;
in modulemax: integer32;
out error: univ char;
in errormax: integer32);

Remarks

To view this manual entry via the man(1) command, use the function name shown above without the “$” character.

DESCRIPTION

The error_$c_get_text call returns predefined text strings that describe the subsystem, the module, and the error represented by a status code. The strings are null terminated.

status A status code in status_$t format.

subsys A character string. The subsystem represented by the status code.

subsysmax
The maximum number of bytes to be returned in subsys.

module
A character string. The module represented by the status code.

modulemax
The maximum number of bytes to be returned in module.

error A character string. The error represented by the status code.

errormax
The maximum number of bytes to be returned in error.

EXAMPLE

The following statement returns text strings for the subsystem, module, and error represented by the status code st:

error_$c_get_text (st, subsys, MAX, module, MAX, error, MAX);

Museum