basic.tclread Statement/BASIC Program

basic.tclread

Command basic.tclread Statement/BASIC Program
Applicable release versions: AP
Category BASIC Program (486)
Description loads the TCL command used to activate the program into a variable.

The program must be the program called from TCL. "TCLread" will not work when called from a subroutine or from "enter" or "TCL" statements. This statement allows parameters to be passed from TCL to a program directly without processing. Individual parameters can be extracted using the "field" function.
Syntax tclread variable
Options
Example
"tclread" is used to extract the file name and item-id from the 
"tcl" command line.  The name of the program is "show".  
Here is a sample TCL command using the "show" program:

show bp testprog

program show
tclread sentence
filename=field(sentence,' ',2)
itenname=field(sentence,' ',3)
Purpose
Related basic.statements
basic.procread
basic.field
basic.procwrite
basic.error()
ue.0003
basic.sentence