This page contains the complete description of all commands that can be used on script files.
An logical sequence of these commands will be referred as an "Script".

General Command Syntax:

{command} "parameter1,[parameter2, parameter3...,parametern]",

where {command} is any of listed commands on column 1 of below table. These commands may be used in english or portuguese as stated by "|" symbol, and "parameter1,...,parametern" are specific to the command that they refer, as described on column 2 of same table.

Script Commands Description:

COMMAND	PARAMETER(S)	DESCRIPTION
TERMINAL	Terminal Type Ex.: "IBM-3278-5-E"	Terminal Type to be used in this session
TITLE | TITULO	"title name" Ex.: "TSO SIDE-A"	Text string that will be shown on window caption and will substitute the session name. If it is omitted, the session name will be shown on window caption.
PORT | PORTA	"Telnet Port" Ex.: "2023"	Telnet Port Number of the server specified on CONNECT command, to where will be connected this session. Optionally, this port can be specified on CONNECT command. If Telnet Port number is not specified, it will be assumed default Telnet port (23). See more informations on CONNECT command below.
CONNECT | CONECTAR	"IP Address:Port" or "name1.name2:Port" or "TEC3270=name" or "TEC3270=*"	Connect to this IP Address and port (optional, it will assume port 23, if it is omitted). Instead of IP Address, an Internet name (aaa.bbb.ccc) may be supplied, or an previously defined session name may be used. It also can be used an asterisk ('*'), in place of session name, to indicate current session name.
GOTO | IRPARA	"LABEL name" Ex.: "CONNECT1"	Go to executing next command after LABEL command, whose name is supplied. An LABEL command, with this name, must be defined in any place ahead.
MOVECURSOR	"R:C" Ex: "10:72"	Move cursor to line and column specified by the parameter (using indicated format). Observe maximum line and column numbers, accordingly to terminal type specified.
TYPE|DIGITE	"text" Ex.: "This is an text string"	Type text from actual cursor position.
PASSWORD | SENHA	"message" Ex.: "Type your secret code"	Open an input dialog, using supplied message, for typing an text that will be automatically inserted on screen from actual cursor position. Each typed character will be shown as an asterisk ('*') on the dialog field used to type the text. Should be used to get passwords, for example.
KEY | TECLE	PF1,PF2,..,PF24, ENTER,CLEAR,TAB, PA1,PA2,PA3 Ex.: KEY "enter" KEY "pf1"	Simulates function key pressing. Key names that can be used are listed on column beside.
LABEL | PARAGRAFO	"LABEL name" Ex.: "CONNECT"	Names this position as having the name supplied. Any name can be used, command names included, because in this context they are simply names.
LOOKFOR | ESPERARPOR	"text" Ex.: "Tela001"	Text to be searched on screens that will be received in following. Next command only will be executed after text has been found. Take care on using this command, because if the searched text is never received, the next command will never be executed.
LOOKLIST | ESPERARLISTA	"string1[label1] string2[label2]" Ex.: "MVS-F[LABEL_MVSF] MVS-J[LABEL_MVSJ]"	Wait for occurrence of one of two text strings and go to correspondent label (the name supplied in the brackets), when one has been found. Script processing will be started again, from this point.
PROMPT | DIALOGO	"message" Ex.: "Type your user id"	Open an input dialog, using supplied message, for typing an text that will be automatically inserted on screen, from actual cursor position.
MESSAGE | MENSAGEM	"message" Ex.: "Expired password"	Open an popup message, having the supplied message, and options buttons OK, that permits script processing to be continued, and CANCEL, that stops script processing.
EXIT | SAIR.	----	This command stops script processing, ignoring other commands placed after it.
* (ASTERISK)	----	Script file comments, it is ignored.

Notes:

(1) Command Sequence:

All commands related to the begin of session connection must be placed before the commands that only can be used after session is connected, that is, they must be placed before the "CONNECT" command;
Commands not related to existence of an session connected, as they are independent from it, may be placed on any point of script file.

Commands related to session connecting:
TERMINAL, TITLE, CONNECT, PORT

Commands related to session connected:
TYPE, PASSWORD, KEY, LOOKFOR,
LOOKLIST,PROMPT, MOVECURSOR "R:C"

Session Independent commands:
GOTO "label", LABEL, EXIT

(2) "Script" file sample:

Click here to see an script file sample, using above commands.

Click on any place of script file sample page to return to this page.