---+ Using the APPX/TMUNIX Scripting Feature Appx now uses the following environment variables to control the Appx scripting feature: <blockquote style="margin-right: 0px;" dir="ltr"> APPX_TST_DIR<br /> APPX_SCRIPT_IN<br /> APPX_SCRIPT_OUT </blockquote> <p dir="ltr">The scripting feature recognizes scripts of the following form:</p> <p dir="ltr">(This script will enter application design, traverse to input process definition, muck around a little, then exit.)</p> <p dir="ltr">! <br /> ! APPX MENU <br /> #USER 2<br /> ! APPLICATION DESIGN<br /> TST10<br /> #RETURN<br /> #USER 2<br /> ! PROCESS MANAGEMENT<br /> #USER 3<br /> ! PROCESS (INPUT)<br /> #CURSOR DOWN<br /> #CURSOR DOWN<br /> #CURSOR RIGHT<br /> #CURSOR RIGHT<br /> #DELETE PREV CHARACTER<br /> #DELETE PREV CHARACTER<br /> # RETURN<br /> ! FRAME (INPUT)<br /> #END<br /> ! PROCESS (INPUT)<br /> #END<br /><br />Blank lines and lines beginning with an exclamation point (!) are treated as comments (and ignored). Lines beginning with a pound sign (#) are considered to be the names of Appx options. Any other lines are considered literal text which is provided to Appx as if the user had entered the characters at the keyboard.</p> <p dir="ltr">You can substitute environment variables into a script using "#$name" where "name" is the name of an environment variable. You can use this as a way to automate repetitive tasks such as data file management. For example, given the following script:</p> <p dir="ltr">! Filename: restruct.apx<br />!<br />! Restructure a database/application<br />! set $ap to the name of the application<br />! set $db to the name of the database<br />!<br />#USER 4<br />#$db<br />#$ap<br />#RETURN<br />#USER 4<br />#END<br />#END<br />#END</p> <p dir="ltr">You could restructure a database/application with the following Unix command line:</p> <blockquote style="margin-right: 0px;" dir="ltr"> <p dir="ltr">$ APPX_SCRIPT_IN=restruct.apx ap=TAR db=MDB appx</p> </blockquote> <p dir="ltr">Of course the easiest way to build this script would be to record the keystrokes and then edit in the environment variables for the text you want to replace.</p> <p dir="ltr">NOTE: Because comments start with a "!" and options start with a "#", you will NOT be able to record/playback any strings which start with either of those characters. If the playback facility finds an option line which is doesn't understand (such as #NONSENSE), it will play back a #CANCEL instead. If you must record a string that begins with a "#" or a "!", begin the string with a junk character and then go back<br />and delete the character.</p> <h5 dir="ltr">APPX_SCRIPT_OUT</h5> <p dir="ltr">If the APPX_SCRIPT_OUT environment variable is defined, Appx will use the file named by that variable to record keymap independent keystrokes. As each option is entered by the user, Appx records the option name in the output script file. Non-option keystrokes are echoed to the script file. Appx will also record the current process name so that script files are (reasonably well) documented and more easily maintained.</p> <h5 dir="ltr">APPX_SCRIPT_IN</h5> <p dir="ltr">If the APPX_SCRIPT_IN environment variable is defined, Appx will use the file named by that environment variable as the source of input. Appx options and literal text will be read from the input script file. If the input script file becomes exhausted, Appx will<br />begin reading from stdin.</p> <h5 dir="ltr">APPX_TST_DIR</h5> <p dir="ltr">If the APPX_TST_DIR environment variable is defined, Appx will record screen dumps into files in that directory. Appx will create two subdirectories called:</p> <p dir="ltr">$APPX_TST_DIR/expect</p> <p dir="ltr">$APPX_TST_DIR/actual</p> <p dir="ltr">If Appx is recording a script (because the APPX_SCRIPT_OUT environment variable is set), Appx will record screen dumps into the $APPX_TST_DIR/expect directory, otherwise, Appx will record screen dumps into the $APPX_TST_DIR/actual directory. The screen dumps are editable ascii files whose names are of the form screen001, screen002, etc.. Appx will record screen dumps each time an interceptable Appx<br />option is recorded (or played back).</p> <p dir="ltr">Also, if APPX_TST_DIR is defined, the normal time/date display is suppressed so that screen dumps will not be time sensitive.</p> <p dir="ltr">The APPX_SCRIPT_IN, APPX_SCRIPT_OUT, and APPX_TST_DIR environment variable can be used in any combination.</p> <p dir="ltr"> </p> | APPX Script In | APPX Script Out | APPX TST DIR | | | SET | | | Playback, no screen dumps | | | SET | | Record, no screen dumps | | | | SET | Input comes from keyboard,dump screens | | SET | SET | | Playback & record (annotates script w/proc names) | | SET | | SET | Playback & dump screens (Regression test) | | | SET | SET | Record and dump screens (record a test) | | SET | SET | SET | Playback, record, dumps screens (why bother?) | <pre dir="ltr"><br /></pre> <p dir="ltr">The most useful combinations are the "record a test" and the "regression test" cases. A regression test is built by record the script and screen dumps (into $APPX_TST_DIR/expect) to establish the baseline screens.</p> <p dir="ltr">A regression scenario is tested by playing back the script, capturing the screen dumps (into $APPX_TST_DIR/actual), then "diff"ing the expect and actual directories. The 'diff' command can take two directories as arguments in which case it compares each file in the two directories, therefore the command "diff expect actual" can be used to verify a run of a regression test.</p> <p dir="ltr"> </p> ---++ Comments: _Read what other users have said about this page or add your own comments._ --- <br />%COMMENT%
This topic: Main
>
WebHome
>
DeveloperTips
>
KeystrokeRecordingPlayback
>
APPXTMUNIXScripting
Topic revision: r2 - 2012-03-01 - ChrisBrower
Copyright © 2008-2024 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki?
Send feedback