Compaq AA-Q88CE-TE Network Router User Manual


 
CALL RTR_ERROR_TEXT
CALL RTR_ERROR_TEXT
The CALL RTR_ERROR_TEXT command causes a command server to execute
the
rtr_error_text( )
routine and to display the returned error text.
Format
CALL RTR_ERROR_TEXT
Command Qualifiers Defaults
/OUTPUT[=file-spec] /OUTPUT=stdout
/STATUS=status-code /none
Description
The CALL RTR_ERROR_TEXT command causes a command server to call the
rtr_error_text( )
routine using the value supplied on the command line.
The
rtr_error_text( )
routine itself is described in Application Programmer’s
Reference Manual.
The prototype of
rtr_error_text( )
is:
char *rtr_error_text (
rtr_status_t sts
);
Table 6–5 shows the correspondence between values you supply on the command
line and the C language parameter values produced and used for the call.
Table 6–5 Parameters for rtr_error_text
C Parameter Name Parameter Value Command Line Specification
sts 42 42 (parameter)
Qualifiers
/OUTPUT[=file-spec]
/OUTPUT=stdout (D)
Specifies that the resulting information is written to the file
file-spec
.If
/OUTPUT
or
file-spec
is omitted then the standard or default output is used.
/STATUS=status-code
No default
Specifies the
sts
parameter in the
rtr_request_info( )
call.
Examples
This command shows the text associated with error number 4849722.
RTR> CALL RTR_ERROR_TEXT /STATUS=4849722
error text normal successful completion
6–12 RTR Command Line Interface