Compaq AA-Q88CE-TE Call Rtrerrortext, Parameters for rtrerrortext, STATUS=status-code No default

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-specis 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–12RTR Command Line Interface