in (input to *src) in <pathname> in <option string> <pathname>
IN provides a rapid means of inputting text or data from teletypewriter-like devices and paper-tape devices. There is no interaction with the terminal (it might just be paper tape!) and typing may proceed as rapidly as desired.
The most common use of IN is to append text to a file. This is done by typing
IN <pathname>
as a command. If the file does not exist, it will be created and initialized. IN will respond with a line feed as a prompt, after which data may be typed.
Unlike BUILD mode, IN does not respond to carriage returns or control-x or at-signs by sending line-feeds or "DEL" messages, and therefore typing may proceed as rapidly as desired. The end of a batch of input is signalled by typing a control-S (X-off, RDR-off, or DC3). IN then appends the accumulated text to the designated file and again responds with the LINE FEED. A control-S typed immediately after the prompt terminates the command.
The basic line formation and local editing rules used by IN are:
The general form of the IN command is
IN <option string> <pathname>
Both the option string and the pathname may be omitted.
When the file name is omitted on the command line, the current file (*SRC) is used. If the file name is present and contains one or more slashes(/), the indicated permanent file is used. If the file does not exist, one will be created if possible. If the <pathname> does not have any slashes and the file is in the AFT, that file is used. Otherwise, the file is created if possible.
To input paper tape, first invoke the IN command with the desired options. After the line feed is typed, place the tape in the reader and turn it on. The paper tape will be read until the tape runs out or a control-S is read. If the tape runs out, turn off the reader and type control-S.
Many terminals are not capable of sending all of the ASCII characters; furthermore IN uses some of the characters for editing purposes. Alternate character representations allow the input of any ASCII character. Acceptable alternates are listed below, using the ' as the escape character. Note that some of the characters below may not print correctly on all terminals.
STREAM DIRECTIVE AND ESCAPE CHARACTERS
'A @ (commercial at sign) '' ' (apostrophe) '( { (left brace) ') } (right brace) '! | (or bar) '< [ (left bracket) '> ] (right bracket) '- \ (back slash) '= ~ (tilde or not sign) '_ ` (grave accent) ' <tab> (escape blank) '; <carrage return> '" ^ (up arrow or cent sign) 'ddd ASCII character ddd (octal)
Copyright © 1996, Thinkage Ltd.