Safeguard Reference Manual (G06.29+, H06.08+, J06.03+)

SAFECOM Session-Control Commands
Safeguard Reference Manual — 520618-030
4 - 21
OBEY Command
OUT listfile
redirects SAFECOM output to listfile for all the commands in command-file.
For listfile, specify any file name.
If listfile does not exist, SAFECOM creates an EDIT-format file and then
writes all output text to that file. If listfile exists, SAFECOM opens the file and
appends the output text.
command-file
is the name of a file containing SAFECOM commands (usually an EDIT-format
file). The name can be any file name.
Considerations
•
Nesting command files
Command files can be nested, with one OBEY command file within another.
Command files can be nested to a depth of four. For example, from the SAFECOM
prompt, you could enter the command OBEY FILE1. FILE1 could contain the
command OBEY FILE2, FILE2 could contain the command OBEY FILE3, and
FILE3 could contain the command OBEY FILE4.
•
Command-file error handling
When SAFECOM encounters a syntax error or an invalid object type while
executing a command file, it aborts processing the command file and calls ABEND.
If it encounters other errors, it processes the commands till the end of file and then
calls ABEND.
As a result, TACL returns -6 as the MESSAGECODE and a non-zero value as the
COMPLETIONCODE.
•
Stopping the execution of a command file
Press the BREAK key to stop the execution of a command file. SAFECOM stop
s
processing commands and closes the command file.
•
Using FC after executing a command file
When you enter the FC command af
ter executing a command file, the FC
command displays the OBEY command rather than the last command executed in
the command file.
Note. ABEND (in case of any error in OBEY file) is supported only on systems running H06.28
and later H-series RVUs and J06.17 and later J-series RVUs.