itc - InteleTerm Pro script compiler
itc [ name ]
Itc is a script compiler that generates scripts for use with it, the InteleTerm Pro terminal program.
Without arguments, itc asks for the name of a script to compile. You can also the script name in the command line by including its name only (not the full path) as an argument to itc. Leave off the .src extension as itc adds it for you. Example:
This compiles the “bix.src” script, writing the compiled output to “bix”. You can also use the [C]ompile command from the [S]cript menu within it.
It scripts can be created with your text editor. From the [S]cript menu in it, choose [N]ew to create a new script, or [E]dit to edit an existing one. Again, leave off the “.src” extension when referencing your script.
The format of a script file follows these rules:
Each instruction is on a line by itself
Labels are declared on lines by themselves and a colon (:) follows the label name.
When labels are referenced, the colon is not used.
Indenting is optional, but aids in keeping your script readable.
Quoted text arguments can have control characters
imbedded in them by entering a caret (^) followed
by the letter (upper or lowercase) of the corresponding
control character. For example, to put a carriage
return at the end of a PRINT instruction, you would use:
Quoted text arguments can include characters like quotes, carets, and backslash by prefixing them with the backslash (\).
Text arguments containing spaces must be put between quotation marks, otherwise the program will only recognize the first word in a series of words.
A space character must separate a command from its argument(s).
Comments can be placed on lines by themselves following any of these comment characters: pound (#), semi-colon (;), apostrophe (’), asterisk (*).
The script language consists of these commands:
Causes script execution to begin executing instructions at label. When a return instruction is encountered, program flow resumes with the next instruction following the do command.
Temporarily pauses script execution and puts you into terminal mode. When you exit terminal mode, script execution continues.
Diverts script execution to a certain label. Unlike do, a return will not return to the instruction after the goto.
Clears the screen and puts the cursor in the upper left corner.
Displays text on the screen, but is not sent to the modem. Add “^M” at the end of the text to issue a carriage return.
speed will set the bits per second rate for use with it. Values for bps are 300, 1200, 2400, 9600, 19200, 38400, and 57600.
Sets up local or remote echo modes for terminal mode. Arguments for mode are on and off. Echo on is half duplex (local echo). Echo off is full duplex (remote echo).
Dials a phone number.
Attempts to connect with a host computer after dialing. Use the IF statement after executing connect to determine if connection was successfully established.
Causes script execution to return to the line following the corresponding do instruction.
Halts script execution until “text” has been received. This is used for handshaking on incoming data. Use the if instruction to determine if pattern was found.
IF is used to test the most recent function performed by the script, such as attempting to connect with a host computer, sending or receiving a file, or handshaking on incoming text. Example conditions for use with IF are:
if found goto ... if ok goto ... if connect goto ... if good goto ... if failed goto ... if bad goto ... if true goto ... if success goto ... if false goto ... if no goto ... if yes goto ...
Place not or no in front of a condition to negate it, such as “if not found goto label”. The words “then” and “goto” are optional. If the condition is true, the script branches to the label referenced at the very end of the if instruction.
Works like print, except sends text to the modem and not to the screen. If you need to send a carriage return, use “^M” (caret followed by the letter M).
Disconnects the modem with the host, and hangs up the phone.
Send the text in file, line by line. Output is paused after each line for delay seconds if included. The next line is not sent until char is received if the optional char argument is included. Example:
sendfile bletch.txt 2 :
This sends the file “bletch.txt” line by line, with an interline delay of 2, and waits for a colon from the host before each line is sent.
Sends a modem break tone.
Causes script execution to pause for the seconds specified, then execution resumes.
Executes the system command line in command. This can be used to
run any program on the system, such as external protocols, or a C-Shell
that invokes a shell script. Examples:
exec "csh cd /profile/mail; rm tempfile" exec "sz filename" exec "csh source batch.script"
Commands with spaces must be enclosed in quotation marks.
When the command is complete, control returns to it and the script continues. “If” statements can be used to test the success of the exec command.
Lets you run a different script file from within a script.
Causes a script to stop running. If you’re online, you’re taken right to terminal mode.
Causes the script to stop running and forces it to quit.
Specifies whether any output which is shown inside the terminal mode window will be sent to the printer or not. Values for mode are on and off. Printer on sends output to the printer, while printer off does not.
Initializes terminal emulation for the named terminal template file.
Labels that begin with the name “fkey”, followed by a digit from 0 to 9 (e.g., fkey5:, fkey8:, etc.), denote entry points in loaded scripts when the Command key and a digit are pressed in terminal mode. Issuing a function key is like choosing the Goto command from the Scripts menu in it and selecting a label. As soon as the script ends, control returns to terminal mode. This makes it possible to create ten key-triggered functions in each script.