CA-GSS Statements and Commands › GSS Extended Functions › IO Functions › Number, String, and Variable Functions › System Information Functions › REDIRECT()

REDIRECT()

This function sends TRACE or SAY output to a stack instead of to the ISERVE log. The recorded information can be retrieved later using standard stack-manipulating functions and commands.

Syntax

stack = REDIRECT({TRACE|SAY},[stack])

Parameters

TRACE

Redirect TRACE output.

SAY

Redirect SAY output.

stack

Stack number to receive the redirected output. To terminate redirection of the TRACE or SAY output, code this argument as OFF.

Default: The current value is returned but not changed.

Return Codes

101 - 102

ARG n MISSING OR INVALID

Example

x = redirect('trace',5)      /* Trace output is written on
                                 stack 5 */
 x = redirect('say','off')    /* Redirection of SAY output is
                                 terminated.*/