TACL Reference Manual

Built-In Functions and Variables
HP NonStop TACL Reference Manual—429513-018
9-273
#OUT Built-In Variable
#OUT Built-In Variable
Use #OUT to set or obtain the name of the file currently being used by TACL as its
OUT file.
Result
#OUT returns the name of the current TACL OUT file.
Considerations
When you first log on to an interactive TACL, #OUT is initialized to the name of your
home terminal.
You cannot permanently change the primary TACL OUT file; that is the primary OUT
file always remains the same. You must push #OUT before you set it to a new OUT
file.
Setting #OUT to a disk file requires that TACL allocate one of its block buffers
internally. Because these blocks are large and must be allocated from the first 64K
bytes of the TACL address space, there are only four of them. (Other consumers of
these blocks buffers are #IN and #REQUESTER.)
When TACL has been started with its IN set to $RECEIVE, these guidelines apply:
•
You can set #OUT without first pushing it. This feature, in conjunction with an
equivalent one in #IN, allows you to run TACL as a server yet be able to take over
a terminal as though TACL had been run on the terminal in the usual way.
•
The value of #OUT is the default OUT file for processes started while #OUT is set
in this way.
•
You can revert to sending output as a REPLY to $RECEIVE by setting #OUT to a
null value.
•
To set or obtain the name of the current IN file, use the #IN built-in variable.
•
Lines read from the current IN are appropriately echoed to the current OUT. The
default OUT file to processes started by TACL is not affected by #OUT; the default
remains associated with the original TACL OUT file.
•
When communicating with a process, be careful to coordinate functions that
enable the communication (such as #IN or #OUT) with the counterpart
mechanisms in that process (such as IN or OUT referring to the TACL process
name). Deadlock conditions can result if TACL tries to open a process for
communication at the same time that process is trying to open TACL for
communication.
•
Use #PUSH #OUT (or PUSH #OUT) to save a copy of the current OUT file name.
#OUT