Caché ObjectScript Reference - InterSystems Documentation

$ZUTIL(96,4)• $ZUTIL(96,5) Sets $DEVICE• $ZUTIL(96,9) Returns the Calling Routine Name• $ZUTIL(96,10) Returns the Calling Routine Namespace• $ZUTIL(96,14) Returns the Current Device Type$ZUTIL(96,4)Sets $TEST to reflect I/O redirection.$ZUTIL(96,4,n)$ZU(96,4,n)ParameternThe boolean value used to set the $TEST special variable upon return from I/Oredirection code.0 = Clears $TEST (sets to 0) on return from the redirected READ.1 = Sets $TEST (sets to 1) on return from the redirected READ.DescriptionYou can specify how to handle the $TEST special variable on return from I/O redirectionby issuing this function. By default, the value of $TEST is preserved (stored and restored)across a call to extrinsic code, such as I/O redirection code. However, you may wish to returnthe setting of $TEST from I/O redirection code. For example, if application code invokes aREAD command with I/O redirection, and the READ times out, this timeout sets $TEST inyour application. To preserve this setting of $TEST upon returning from I/O redirection code,you must invoke $ZUTIL(96,4,n) within the I/O redirection code.For further information on I/O redirection, refer to $ZUTIL(82,12).Note:$ZUTIL(96,4,n) can only be invoked from extrinsic code. It cannot be called directlyfrom the Caché Terminal. Attempting to do so results in a error.See Also• READ commandCaché ObjectScript Reference 695