Use SF

Purpose:  The USE SF command, without the LOG option, sets up a specified System File (SF) use in place of terminal input, as if the lines in the file were typed at the terminal.  The USE SF LOG command designates a LOG file to record a copy of terminal input and output.

Syntax

USE SF name

USE NO SF

USE SF name /AS/ LOG [ONLY] [APPEND]

USE NO SF LOG

USE SF name

declares a SF to be used as the terminal input source.  If the file name extension is .CMD, it need not be specified.  Any other extension must be specified.

USE NO SF

terminates input from the currently declared SF and all nested SF’s.

USE SF name /AS/ LOG

specifies that all terminal input and output (except edit characters) is to be written on the designated SF.

ONLY

suppresses terminal display while terminal output is written on the LOG file.  If ONLY is not specified, terminal output is both written on the LOG file and displayed at the terminal.

APPEND

specifies that any text previously contained in the LOG file is to be retained.  The new text written into the file will be attached to the end of the old text.

USE NO SF LOG

terminates output to the currently declared LOG file.  A SF that is functioning as a LOG file cannot be read until it is first closed with the USE NO SF LOG command.

EXAMPLE

The USE SF command is issued on a SF named BOOKLIST, the text of which is shown first with the LIST command:

*LIST SF BOOKLIST<CR>
00020  USE DS BOOKS_DBM2
00030  EXTRACT
*USE SF BOOKLIST<CR>
FL4948  Conversational Spanish 1227 21.59 00 10 50.10
FL5345  Speak It In Russian 1944 19.99 .00 10 45.75

The following command declares a log file to record subsequent terminal interaction.

*USE SF WORK1.LOG AS LOG<CR>

NOTES:  USE SF editing command