Compaq AA-Q88CE-TE - Manual (Page 88)

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