Script Designer

The Wintouch Emulation Script Designer is an easy to use tool for the Wintouch Administrator. Using this "Application Developer" the administrator can create, edit and enable emulation applications for the Wintouch user in specifically selected terminal emulation sessions. The design window is divided into three main panes, the Available Commands, Script (Source Code), and Command Properties (Parameters). Get to this screen from the AS/400 Applications window by double-clicking on a Script cell and then by clicking the button that appears at the far right of this cell.

Available Commands

This structure is an expandable tree with branch functions and related leaf commands. To expand the tree click on a folder icon.

• At: Moves the cursor to the specified row and column, if possible. If the cursor is "trapped" in a field for some reason, or the coordinates are off the screen, the statement is ignored.
• Erase: Erases the field the cursor is in, or the portion of the field to the right of the cursor, or all fields. If the cursor is not in a field, use the first field after the cursor position.
• Field Exit: Generates a Field Exit keystroke. This keystroke is valid only within a field, and clears to the end of the current field, then moves the cursor to the beginning of the next one.
• IF-Block: Semantics for "IF AT row col": Compares the literal with the screen buffer, starting at the specified position. Other If statement forms may be defined in the future.
• Paste: Paste count characters from the clipboard into the first available field(s), starting at the specified position. If count is zero or omitted, PASTE will not cross field boundaries unless NewLine characters are present, in which case they are responded to as if typed.
• Pause: Suspend execution of the script, remembering both the script and the current statement, and return control to the user until the resumeScript() method is called. Note:  This is not valid in an If Block!
• Return: Terminates execution of the script, optionally returning a value.
• Type: Generates the keystrokes to type the literal or variable. Note that this does not normally send anything to the host by itself (although it can, if it fills a field that has been flagged "Auto-Enter"). This is typical of block-mode terminal protocols, such as IBM 5250 and 3270.
• Wait:  Suspends execution of the script for the specified number of seconds.

AID Functions (attention identification codes)

A byte sequence that is generated when the operator presses certain function keys

• An AID Key: A function key which sends an AID (attention-ID) code to the host.
  • The function keys (F1-F24) provide a means of communication with the application program. Each key sends a particular signal to the program.
• Clear: This blanks the current screen except for the cursor, the separator line, and the operating status line.
• Enter: This transmits data you have typed to the application program. The System Available symbol must appear on the operating status line.
• Help: This function provides an explanation of the current error condition or help from the system.
• Home: This function moves the cursor to the first input position of the screen. The cursor moves to row one, column one of the screen if the screen is unformatted or has not input fields.
• Page Up/Down: This function is used to move data up or down on the display screen. Press PgUp to replace the screen data with the previous page data. Press PgDn to replace the screen data with the next page data.

Attn/SysRq Functions: The only other functions besides the AID functions that transmit data to the host.

• Use this function to select and start an alternate job.
• Notify the host system that the display station is ready to select a new program or activity.
• Request that the keyboard be unlocked so that you can enter data.

Clone Functions:.

Copy Functions: These functions copy from the screen to the clipboard, starting at the specified position. If the specified position is within a field, "COPY" skips characters that are not in fields, while "COPYALL" does not. If the specified position is not in a field, "COPY" behaves exactly like "COPYALL". "COPYBOX" copies all the characters within the rectangular area of the screen defined by the coordinates, much like the "rubber-band copy" function.

• Copy
• Copy All
• Copy Box

Read Functions: These functions copy from the screen into a variable, starting at the specified position. If the specified position is within a field, "READ" skips characters that are not in fields, while "READALL" does not. If the specified position is not in a field, "READ" behaves exactly like "READALL".

• Read
• Read All

Tab Functions: These functions move the cursor from one field to another. The cursor will be moved to the beginning of the first field beginning after its present position, the last field beginning before its present position, or the first field of the next line, respectively.

Adding Commands to a script

To add to a script, double-click on the command in the Available Commands pane. By doing this a Command Properties (Parameters) window will be displayed. Enter all necessary parameters.

Script Source Code

As commands are added from the available list, the Script Source Code pane displays a Tree structure of  those commands in their added sequence. 

Editing a command in a script

To edit a script command, double-click on the command in the Available Commands pane. By doing this a Command Properties (Parameters) window will be displayed. Edit all necessary parameters. 

Push Buttons

Edit: The Edit button opens the Command Properties (Parameters) window of a highlighted Script Source Code command.

Remove From Source: This button removes the highlighted Script Source Code command from the script.

Command Properties (Parameters)

This section of the Script Designer is a display only area. Highlight a script command in the Script Source Code pane to see its properties here. For example, the "At" command below has a Row value of 4 and a Column value of 30 which is displayed in the Command Properties area.

Push Buttons

OK: Select this button to save changes to the script and exit the window.

Cancel: Exits the window or dialog screen without saving any changes or additions made in the fields.

Help: This button displays online help in a new window.