home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 17 / CD_ASCQ_17_101194.iso / vrac / abatvw2.zip / ABATVIEW.DOC < prev    next >
Text File  |  1994-05-14  |  54KB  |  1,128 lines

  1.               *********************************
  2.               *         A BATCH VIEW          *
  3.               *                               *
  4.               *  Menus, Messages, Utilities,  *
  5.               *              and              *
  6.               *  Information for Batch Files  *
  7.               *  Ver 2.0           3/30/1994  *
  8.               *         Copyright 1993        *
  9.               *       by Robin R. Latham      *
  10.               *********************************
  11.          FOR IBM or COMPATIBLE PC's, USING DOS 3.0 or HIGHER
  12.     GRAPHICS: 80 Column Color, or Monochrome Text Modes Supported.
  13.           _______
  14.      ____|__     |               (R)
  15.       --|       |    |-------------------        Robin R. Latham
  16.     |   ____|__  |  Association of         2607 Betty Lane #167
  17.     |  |       |_|  Shareware              Arlington, TX. 76006
  18.     |__|   o   |    Professionals            (817) 649 - 5273
  19.       -----|   |   |---------------------    Compuserve ID# 72614,602
  20.        |___|___|    MEMBER
  21.  
  22.  
  23.  
  24.             >>>  TABLE OF CONTENTS <<<
  25.                             PAGE
  26.  
  27.         INSTALLATION, PACKING LIST................... 1
  28.  
  29.         INTRODUCTION................................. 2
  30.  
  31.         GENERAL USE.................................. 3
  32.  
  33.         ABATMENU..................................... 4
  34.  
  35.         ABATMENU OPTIONS............................. 5
  36.  
  37.         ABATMENU FUNCTION KEYS....................... 6
  38.  
  39.         AMSG......................................... 7
  40.  
  41.         AMSG OPTIONS................................. 8
  42.  
  43.         AECHO ....................................... 9
  44.  
  45.         AECHO OPTIONS .............................. 10
  46.  
  47.         AMSCROLL ................................... 11
  48.  
  49.         AMSCROLL OPTIONS............................ 11
  50.  
  51.         ABATINFO ................................... 12
  52.  
  53.         ABATINFO OPTIONS ........................... 13
  54.  
  55.         ABATJOB .................................... 14
  56.  
  57.         ABATJOB OPTIONS ............................ 15
  58.  
  59.         ACLS........................................ 16
  60.  
  61.         APAGE....................................... 17
  62.  
  63.         TEXT FILES.................................. 18
  64.  
  65.         COLOR ATTRIBUTES............................ 19
  66.  
  67.         BATCH FILES................................. 20
  68.  
  69.         TECHNICAL................................... 21
  70.  
  71.         DISCLAIMER.................................. 23
  72.  
  73.         REGISTRATION................................ 23, 24
  74.  
  75.  
  76.  
  77.             -  INSTALLATION  -                     PAGE 1
  78.  
  79.   You can use AINSTALL.BAT to copy all the files from the distribution disk.
  80. Ainstall.bat is menu driven and will copy files to disk drives A, B, C, or D.
  81. You will have the option to copy the files to a ROOT directory or a directory
  82. named ABATVIEW. Installing the files in a sub-directory will prevent any
  83. overwrites to existing files with the same name. There are two utility batch
  84. files named AVIEWDOC.BAT and APRNTDOC.BAT that will provide immediate viewing
  85. or printing of the associated documentation.
  86.  
  87.              * Quick Start *
  88.   You can start learning how to use all the programs in the utility set by
  89. running the ALEARNME.BAT tutorial program.
  90.  
  91.  
  92.             -  PACKING LIST  -
  93.  
  94.   Please make a quick check to see if you recieved all of the following
  95. files. Some of the supporting programs require other files in order to
  96. function properly. If you have purchased an incomplete or malfunctioning
  97. copy of this software from a distributor and cannot resolve the problem
  98. locally, please call or write me with the distributors name and address
  99. and I will send you a free replacement disk.
  100.  
  101. * PROGRAMS *
  102.  
  103. ABATMENU.EXE - Generates pop up menus.
  104. AMSG.EXE - Generates pop up messages.
  105. ACLS.EXE - Selectable Clearing of the video screen.
  106. AECHO.EXE - Provides a more versatile alternative to DOS Echo.
  107. AMSCROLL.EXE - Generates moving screen messages.
  108. ABATINFO.EXE - Provides a variety of information to your batch files.
  109. ABATJOB.EXE - Provides a variety of screen drawing and control functions
  110.           as well as an environment variable loop counter.
  111. APAGE.EXE - Displays ASCII text files.
  112.  
  113. * BATCH FILES *
  114.  
  115. AINSTALL.BAT - Installation batch file.
  116. AVIEWDOC.BAT - Provides documentation viewing.
  117. APRNTDOC.BAT - Provides documentation printing.
  118. ALEARNME.BAT - Utility set tutorial.
  119. AEXMPLES.BAT - Example menus and messages.
  120. ATXTFILE.BAT - How to use ascii text files with Abatmenu and Amsg.
  121.  
  122. * DOCUMENTS *
  123.  
  124. ABATVIEW.DOC - A Batch View software manual.
  125. ASCIICDS.DOC - Table of Ascii codes.
  126. ASITELIC.DOC - Example site license.
  127. AREGISTR.FRM - A Batch View Registration form.
  128. VENDOR.DOC - for Shareware Distributors.
  129.  
  130. * SUPPORT FILES *
  131.  
  132. ABATVIEW.ZIP - An archive file
  133. INSTL.TXT - Message text for the Installation batch file.
  134.  
  135.  
  136.             INTRODUCTION                       PAGE 2
  137.  
  138.    A BATCH VIEW is a utility set designed to allow you to create personal
  139. or custom Graphical User Interfaces for your batch files. It will also add
  140. a great deal of extra functional power to available DOS Batch file commands
  141. by providing you with many information and system utilities. Because the
  142. programs in the utility set operate in text modes, the portability of the
  143. batch files you create is not severely limited to operation on specific
  144. hardware. Text modes are still quite capable of providing a very professional
  145. and crisp appearance as well as some impressive and interesting effects. The
  146. utility set programs will allow you to create batch files that have the look
  147. and feel of custom written software. Eight programs are included in the set,
  148. each of which is targeted at a specific concept in batch file enhancements.
  149.  
  150. THE UTILITY PROGRAMS
  151.  
  152. ABATMENU.EXE - Creates custom pop up menus for batch files, allowing
  153.            complete configuration of the video screen. Menus are
  154.            automatically centered on the display screen, and have
  155.            3-D shadowing. Passes the errorlevel code of the menu
  156.            item selected back to the calling program or batch file.
  157.            Up to 48 menu items per menu. Mouse Supported.
  158.  
  159. AMSG.EXE - Creates custom pop up messages or prompts for batch files,
  160.        and provides the same degree of video control as abatmenu.
  161.        Displays system information, and allows user input into
  162.        a specific Environment variable.
  163.  
  164. ACLS.EXE - Provides a variety of interesting ways to clear text from
  165.        the video screen, and the ability to change or set the default
  166.        background and text color.
  167.  
  168. AECHO.EXE - A replacement for the DOS ECHO and MORE commands. Provides
  169.         control over coloring and placement of text. Allows display
  170.         of Ascii text graphics. Color display of text files.
  171.  
  172. AMSCROLL.EXE - Allows you to create and display text messages that roll
  173.            across the screen horizontally, vertically, or around the
  174.            perimeter. Great for framing eye catching screens.
  175.  
  176. ABATINFO.EXE - Provides a variety of information about system configuration
  177.            files, and directories, by passing error level codes, and
  178.            setting Environmental variables. Batch files can determine
  179.            the proper course of action based on this information.
  180.  
  181. ABATJOB.EXE - Contains screen drawing and coloring tools to provide a
  182.           final degree of coverage for personal or custom displays.
  183.           Provides a loop counter in the Environment.
  184.  
  185. APAGE.EXE - An ascii text file reader. Primarilly provided for viewing the
  186.         documentation of this utility set. May be used to view any text
  187.         file. Provides fully functional scrolling and page keys, and a
  188.         selection of the screen color for the displayed text.
  189.  
  190.    Typing the name of any of these programs at the DOS command line except,
  191. Aecho.exe will bring up a quick help screen. Use the /h option with Aecho to
  192. see it's help screen. All the programs use option switches to control their
  193. output. Options are entered on the command line after the program name, with
  194. multiple program options separated by spaces. Program options are described
  195. throughout this manual and on the quick help screens.
  196.  
  197.  
  198.              -  GENERAL USE  -                     PAGE 3
  199.  
  200.    As stated on the preceeding page the utility set programs are controlled
  201. by using option switches, and taking supplied information from the command
  202. line. Options are specified in a format that is very similiar to the Dos
  203. operating system. I'm assumming that you're familiar with this convention
  204. since you're interested in using this utility set and therefore have probably
  205. written Dos batch files and used Dos to a fair extent. If you haven't, check
  206. out your Dos Manual in conjunction with this document to get the general
  207. idea of what's being discussed here.
  208.  
  209.    Any information that a program in the set needs, is passed on the command
  210. line in the same manner as the option switches. Common input formats are used
  211. in order to reduce the time to learn how to use all the programs in the set.
  212. Although unique sequences of input occur in certain situations, common themes
  213. and formats are frequent enough to allow you to get a good feel for input
  214. requirements and usually successfully guess how to supply information to a
  215. program if you are unsure about a particular option's requirements.
  216.  
  217.    Here are some of the general rules of thumb regarding inputs. Quite a few
  218. of the programs have been designed to operate so that the input order of
  219. certain pieces of information is arbitrarily decided by you. Most of the
  220. programs generate video screen functions in one way or another. The programs
  221. provided WILL operate in monochrome or color text modes. If color is
  222. available, you'll probably want to take advantage of it by selecting color
  223. attributes to enter when using screen drawing programs. ACLS, AECHO, ABATJOB,
  224. and AMSCROLL allow you to enter options and attributes without regard to
  225. order as long as they are the first arguments entered on the command line.
  226. Attributes are distinguished by entering a '+' sign in front of them, this
  227. being true for all the programs, while options use a '/' sign for recognition.
  228.  
  229.    The '+' sign is also used to designate an ascii code when entering such a
  230. code into an argument field that takes characters or strings. This is useful
  231. for displaying characters that cannot be entered with the keyboard. AECHO has
  232. a special option field to allow you to enter codes without the '+' sign, but
  233. as a general rule you may use this sign to enter attributes and ascii codes.
  234.  
  235.    Several programs take character string arguments. When entering these
  236. from the Dos command line use quotation marks whenever words or symbols are
  237. to be considered a single argument by the program. When using text files the
  238. programs distinguish seperate arguments by assuming they appear on seperate
  239. lines. Once again, AECHO is the exception allowing you to place options and
  240. text on one line in a file. This is because AECHO was designed to mimic the
  241. Dos ECHO command.
  242.  
  243.    Programs that write to the video display sometimes require a location in
  244. order to perform that function. Locations are entered in a numeric format
  245. with the row(0-24) first, and the column(0-79) second. Some of the programs
  246. require more information in the form of a direction switch, these are alpha
  247. characters such as L for left, H for horizontal, or V for vertical. The
  248. direction switches are usually accompanied by a numeric length value. Both
  249. of these pieces of information are only necessary when performing operations
  250. on sections of the video display that encompass more than one screen location.
  251. Box drawing, filling, or blanking functions need two pairs of coordinates, an
  252. upper row and column, and a lower row and column.
  253.  
  254.  
  255.                 ABATMENU                       PAGE 4
  256.  
  257.    ABATMENU generates pop up menus for batch files. The program may be
  258. controlled from any calling batch file, such as the AUTOEXEC.BAT to allow
  259. menu selectable boot configurations, for TSR's, DOS Environment variables,
  260. prompt selection, time and date entry, selectable program execution, or
  261. anything else a batch file can handle. Batch file branching is determined by
  262. the ERRORLEVEL returned. Several useful DOS utilities may be invoked from
  263. within the created menu by pressing the Function Keys. A Screen blanker
  264. has been incorporated within the program with a 5 minute timeout.
  265.  
  266.    Abatmenu allows a full range of selectable options to determine the menu
  267. colors, title, selections, hi-light bar, and background texturing or
  268. character string, when generating your own batch file menus. Options may be
  269. passed directly to ABATMENU on the DOS command line, or stored in an ASCII
  270. text file when dealing with large selection lists.
  271.  
  272.    Abatmenu handles up to 48 menu items. You may hi-lite and select menu
  273. items by using the arrow and enter keys or a mouse cursor and any button. The
  274. program will automatically display 16 menu selections at a time with options
  275. to page through all the selections.
  276.  
  277.    Abatmenu returns an ERRORLEVEL code to the calling batch file corresponding
  278. to the item selected. The errorlevel is then processed by the batch file to
  279. perform the desired function. Abatmenu returns a ZERO(0) if the ESCAPE key is
  280. pressed to allow exit without action, or any other desired procedure specified
  281. in the calling batch file.
  282.  
  283.    If you wish to learn by doing, or are becoming impatient at this point, a
  284. tutorial program called ALEARNME.BAT has been provided along with several
  285. other batch file examples for demonstration and learning purposes.
  286. Alternately, simply typing "abatmenu" at the DOS prompt provides a brief on
  287. screen explanation of program operation.
  288.  
  289.  
  290.  
  291.  
  292.             ABATMENU OPTIONS                    PAGE 5
  293.  
  294.    Abatmenu program options are entered using standard DOS command line
  295. parameter passing. You may also use text files to store program arguments and
  296. selections. Enclosing a parameter with quotation marks allows it to be passed
  297. as a single option, regardless of the spaces between characters. This is
  298. useful if you wish to have multiple word titles, selections and background
  299. character strings for your menu display.
  300.  
  301.    Typing.... ABATMENU 176 "Boot Menu" Selection1 Selection2 Exit
  302. at the command line will generate a Blue and Cyan pop up menu with the title
  303. "Boot Menu", three menu selections, and the first selection hi-lighted. The
  304. number 176 is an ASCII code that will fill the background screen with texture.
  305. You may enter any printable Ascii code for a variety of texturing, or
  306. wallpaper menu backdrops. You may also enter text strings or words in this
  307. field. Remember to enclose text strings in quotation marks when entering
  308. arguments on the command line. Included is a separate file called
  309. ASCIICDS.DOC which contains a listing of Ascii codes for you to reference
  310. and experiment with. Several ascii codes control printer operation, so
  311. printing the file will generate undesirable results and is not recommended.
  312. You may however view this file on your monitor using the AVIEWDOC.BAT file.
  313.  
  314.    To produce other color menus, you will need to provide abatmenu with four
  315. color attributes. Entering a + (plus sign) immediately in front of the
  316. attributes designates a color menu. Color value codes are listed on page 8,
  317. with examples of how to construct attributes. BLUE and CYAN are DEFAULT
  318. colors.
  319.  
  320. Typing.... ABATMENU +31 0 116 115 176 "Boot Menu" Selection1 Selection2 Exit
  321. at the command line produces a blue menu bordered with white, black selection
  322. text, a white hi-light bar with red text, and a white screen filled with cyan
  323. texturing.
  324.  
  325.           - ABATMENU PROGRAM OPTION LISTING -
  326.  
  327. * For Monochrome or Default Color Displays
  328.  
  329. ABATMENU Screen-Ascii Title Selections..........
  330.  
  331. * For Specific Color Displays
  332.  
  333. ABATMENU +Window Menutxt Bar Screen Scrn-Ascii Title Selections...
  334.  
  335.     A + (plus sign) requests generation of a color menu.
  336. WINDOW = Color attribute of menu.      MENUTXT = Color of selection text.
  337. BAR = Color attribute of hi-light.     SCREEN = Color attribute for screen.
  338. TITLE = menu title.                    SELECTIONS = menu selections.
  339.    SCRN-ASCII = Ascii code for background screen texturing or wallpaper.
  340.  
  341.  
  342.  
  343.             ABATMENU FUNCTION KEYS              PAGE 6
  344.  
  345.    Abatmenu allows you to execute several common operating system utilities
  346. via Function keys. This is useful if you use the program as a primary shell
  347. to run your standard executables. Use the Function Keys if you wish to return
  348. to the current menu after the desired utility is executed.
  349.  
  350.  
  351.             - FUNCTION KEY LIST -
  352.  
  353. F1 Key - Displays Function Hot Key list on screen.
  354.  
  355. F2 Key - Set the System Time and Date.
  356.  
  357. F3 Key - Display Current Directory Tree.
  358.  
  359. F4 Key - Format Floppies on Drives A or B. (Default Settings)
  360.  
  361. F5 Key - Run Microsoft Diagnostic Program. (Dos Versions 6.x)
  362.  
  363. F6 Key - Run DOS Chkdsk or Scandisk. (Dos Version Dependent)
  364.  
  365. F7 Key - Run Microsoft Anti-Virus Scan on Current Disk. (Dos Versions 6.x)
  366.  
  367. F8 Key - Run DOS Help Program. (Dos Versions 5.0 and Above)
  368.  
  369. F9 Key - Run DOS Disk Defragment Program. (Dos Versions 6.x)
  370.  
  371. F10 Key - Run DOS Edit Program. (Dos Versions 5.0 and Above)
  372.  
  373.  
  374.  
  375.  
  376.                 AMSG                       PAGE 7
  377.  
  378.    AMSG allows you to create custom user prompts, and contains several
  379. command line switches that provide program generated system information
  380. such as the time and date, DOS version and environment variable settings,
  381. available disk drives and current working directory. You may also display
  382. user query prompts that only accept (y/n) key responses, and return a
  383. designating errorlevel code. AMSG also allows you to get user input for
  384. your batch files. Users may enter up to 64 characters that will be
  385. assigned to an environment variable "INPUT=". They may also enter a
  386. an integer ranging between(0-255) to be returned as an error level code.
  387.  
  388.    AMSG operates in a similar fashion to ABATMENU, allowing you to determine
  389. the color and background texturing of your display prompt. AMSG frames your
  390. message in a bordered pop up window, and waits for a keypress before clearing
  391. the video screen and exiting. You may also use text files to store multiple
  392. program options and message text.
  393.  
  394.    Message text is automatically centered within the display window, and
  395. a "Press Any Key to Continue" prompt is added to instruct users. All option
  396. displays are separated from your message by blank lines within the window.
  397. You may use ONLY ONE display option at a time when generating a window, but
  398. you may include up to 20 lines of message text. Again, message text is
  399. centered in the window by the program, and an appropriate user prompt is
  400. added to your message. If the program cannot produce a window that fits on
  401. the video screen it will generate an error message.
  402.  
  403.    Binary prompts may be produced by using the /ask option. This option adds
  404. a "(y/n)" prompt to the bottom of your message window, turning your text into
  405. a simple question. Program exit may only be accomplished by pressing the 'y'
  406. or 'n' keys in either upper or lower case. Amsg returns a 1 for yes, and a
  407. 0 for no. The resulting errorlevel code can then be interpreted by the
  408. calling batch file. If the /ask switch is not used Amsg always returns a 0.
  409.  
  410.    It's a good idea to experiment with various program options on the command
  411. line before including them in your batch files. In this way you can determine
  412. the most aesthetically pleasing color combinations with minimal modification.
  413. This is especially true for long or complex batch files.
  414.  
  415.  
  416.             AMSG OPTIONS                       PAGE 8
  417.  
  418.    Amsg will produce color or monochrome message windows. Program options are
  419. passed in the formats listed below.
  420.  
  421. AMSG PROGRAM OPTION LISTING
  422.  
  423. * For Monochrome  -  Type > AMSG Screen-Ascii [Switch] Message..........
  424.  
  425. * For Default Color  - Type > AMSG [Switch] Message........
  426.  
  427. * For Color Displays -
  428.     Type > AMSG +Window Wndtxt Screen Scrn-Ascii [Switch] Message...
  429.  
  430.  
  431.     A + (plus sign) requests generation of a color screen.
  432. WINDOW = Color attribute of window.     WNDTXT = Color of message text.
  433.         SCREEN = Color attribute for screen.
  434. SCRN-ASCII = Ascii code for background screen texturing or wallpaper.
  435.   [SWITCH] = One of Four optional information display switches.
  436.         MESSAGE = Your prompt or message text.
  437.  
  438.  
  439.             - *  SWITCHES  * -
  440.  
  441. /td - Displays the time and date settings of your computer.
  442. /dsk - Displays letters of logical disk drives and the current
  443.             working directory.
  444. /mem - Displays your System Memory information.
  445. /eqp - Displays Hardware and attached Peripheral information.
  446. /env - Displays system environmental variables and current DOS Version.
  447. /ask - Displays your message as a question and only accepts (y/n) responses.
  448. /task - Timed (5 minute) question. Defaults to YES.
  449. /npt - Displays an input box and allows input of up to 64 characters.
  450.        Characters are stored in a string assigned to Environment
  451.        variable "INPUT=".
  452. /erl - Displays an input box which allows entry of an integer(0-255).
  453.        Returns that integer as an error level code.
  454.  
  455.    Typing AMSG alone on the command line will display a brief description of
  456. its use, similar to the listing above. An on screen listing of color
  457. attributes may be seen by entering AMSG /c or AMSG color. Color attribute use
  458. and construction is also documented on page 19. The use of text files is
  459. covered on page 18 of the manual.
  460.  
  461.    Switches are optional, and the inclusion of a switch with your message
  462. text combines all the information into the display window. Only one switch
  463. may be used for each message window.
  464.  
  465.  
  466.                AECHO                           PAGE 9
  467.  
  468.    Aecho is designed to be a more flexible replacement for the DOS echo
  469. command. Aecho will allow you to designate to some extent where to place
  470. the text, what color to display it with, and allow you to display all
  471. printable ascii codes. In addition, it provides the same capabilities
  472. as the DOS more command, so that you can echo text files rather than
  473. enter each line of text seperately. You are provided with the same level
  474. of control with each line of text in a file as you would be if you entered
  475. them seperately on the command line.
  476.  
  477.    The default position for display text is to left justify it on the display
  478. screen. The /m option automatically centers your text, the /r right justifies,
  479. and the /p[column #] allows you to specify the start position.
  480.  
  481.    A text file can be used by first entering any overriding attributes or
  482. positioning option switches. Then enter the /t option followed by a full
  483. path name if necessary, name of the file, and file extension. If options
  484. are entered when using a text file, they become default values when
  485. displaying text. Options may be embedded in a text file and will be used
  486. when displaying the text they preceed. If there are no options preceeding
  487. the line of text read from a file, the options entered on the command
  488. line will be used for color and positioning of text. The default value for
  489. attributes is taken from screen location 0,0. The default value for
  490. positioning is to center text on the display screen.
  491.  
  492. * Important Note *
  493.    Aecho requires an option switch to see its help screen. Although this
  494. is inconsistent with other programs in the set, it was done so that Aecho
  495. could display a blank line like its DOS counterpart. As a side note, if
  496. you wish to display a blank color line, enter the appropriate attribute
  497. on the command line.
  498.  
  499.  
  500.             -  AECHO OPTIONS  -                      PAGE 10
  501.  
  502.    The positioning of attributes and option switches is unimportant. In most
  503. cases you would be entering an attribute and option switch preceeding your
  504. text. You may elect to embed certain options or enter them after the text.
  505.  
  506.    When using a text file you may want to enter an attribute, positioning
  507. option, and the /t option followed by a filename. In this instance the /t
  508. option must be entered last and then followed by a file name. Options on
  509. the command line with a text file designate default options for each line
  510. of text in the file.
  511.  
  512. (+Attribute) - Display text in color specified.
  513. /t - Open and display a text file one page at a time. Similiar to DOS More.
  514. /* - Display text with a spinning cursor.
  515. /m - Automatically center display text.
  516. /r - Right Justify display text.
  517. /pz - Automatic pause, with message at bottom of screen until key press.
  518. /p[column #] - Display text at column indicated. (0-79)
  519. @#:# - @ symbol denotes an ascii code (0-255). # symbol number of ascii code.
  520.        :# colon seperates, second # is number of times to print ascii code.
  521. /c - Displays Color Attribute Chart.
  522. /h /? - Displays help screen.
  523.  
  524.  
  525.               AMSCROLL                            PAGE 11
  526.  
  527.    Amscroll is a program that produces text messages that roll across the
  528. screen in a variety of directions and configurations. The effect is one
  529. comparable to a theatre marquee or moving billboard sign. The designated
  530. message is displayed until a key is pressed. Some very unique and interesting
  531. batch file displays may be constructed using this program.
  532.  
  533.     ****** The Basic Format to use Amscroll ******
  534. Default - Type: AMSCROLL (Option and/or Attribute) "Text Message"
  535.                 OR
  536. Type: AMSCROLL (Option and/or +Attribute) Speed Direction "Text Message"
  537.  
  538.    The placement of the option and attribute on the command line is
  539. discretionary, as long as they are entered first you may enter them without
  540. regard to order. Although you must enter an option to tell the program how
  541. to display your text, the attribute argument may be omitted since a default
  542. value is obtained from the display screen.
  543.  
  544. Options - listed below.
  545. +Attribute - Constructed from Attribute table. (Default value from screen)
  546. Speed - A numeric value (0-30), with 0 being slowest, 30 being fastest.
  547. Direction - A letter (L/R/A). Left, Right, or Alternating.
  548.         The Letter may be upper or lower case.
  549. Text message - Whatever text you type in. Must be enclosed in quotation marks
  550.            if spaces are to be included.
  551.  
  552.              - AMSCROLL OPTIONS -
  553.  
  554. /row - You specify the row number (0-24)
  555. /col - You specify the column number (0-79)
  556. /tb - Row numbers 0, and 24, the top and bottom rows are used.
  557. /lr - Column numbers 0, 79, the left and right columns are used.
  558. /roll - Message scrolls vertically while text moves horizontally.
  559. /peri - Screen is encased with moving text message.
  560. /pauz - A preset pause message is displayed on row 24.
  561. /c - a table of color attributes is displayed.
  562.  
  563.  
  564.               ABATINFO                             PAGE 12
  565.  
  566.    Abatinfo, if you haven't guessed already, was designed to provide
  567. information to batch files. I've tried to combine many useful functions
  568. into one program to give you a broad range of available information for your
  569. batch files. This particular program goes beyond the visual and user
  570. interface focus of the utility set to give your batch files some extra power.
  571. The Batch file commands that Dos provides can be combined with this
  572. information to extend the abilities of your batch files.
  573.  
  574.    Most of the information returned by Abatinfo is in the form of an
  575. error level code. Since the error level code is limited in the amount of
  576. information it can convey, it uses the system environment to store requested
  577. information. The environment variable names are "INFO=" and "DIR=". The
  578. "DIR=" variable is used to store the current path, while "INFO=" is used
  579. to store other information such as file sizes, and free disk bytes.
  580.  
  581.    You can use the variety of information returned by Abatinfo to set up
  582. date or time activated batch activities, and enhance system configuration
  583. sensing and file copying capabilities. The majority of the option switches
  584. do not require input. Returned information is in a true/false state when
  585. doing simple checking with a 1 for true and a 0 for false. Return values
  586. that can be fitted within the numeric range limits of error level coding
  587. are returned in that manner with as little value decoding as possible. The
  588. Dos version and video display type are the only two values that had to be
  589. returned in coded form as an error level.
  590.  
  591.    When entering input for files or directories you may enter a drive and
  592. complete path. Wildcards may be used with file arguments such as myfile.*,
  593. my*ile.txt, etc... Remember to enclose string arguments in quotation marks
  594. if necessarry. Input arguments are listed on the next page in the actual
  595. order taken by the program.
  596.  
  597.  
  598.             - ABATINFO OPTIONS -                    PAGE 13
  599.  
  600. /day - Returns the day of the month as as an error level(0-31).
  601. /wkd - Returns the day of the week as an errorlevel code(0-6). Sunday = 0.
  602. /mo - Returns current month(1-12) as an error level.
  603. /min - Returns current minute(0-59) as an error level.
  604. /hr - Returns current hour(0-24) as an error level.
  605. /yr - Returns current year(0-99) as an error level. Century not included.
  606. /drx - Does logical drive exist ? Enter an argument drive (Alpha A-Z) or
  607.        (Numeric 1-26). Returns a 1 if drive exists, a 0 if not.
  608. /drv - Returns current drive as an error level(1-26).
  609. /dos - Returns Dos version as an errorlevel. Major version x 10.
  610.        Minor version as a single digit. Dos 5.0 = 50, Dos 3.3 = 33.
  611. /dsp - Return monitor display type. 0 = NONE, 3 = EGA or Multi-scan
  612.        4 = Color Display, 5 = Monochrome, 7 = VGA Mono, 8 = VGA Color.
  613. /col - Returns number of logical video display columns in current mode
  614.        as an error level. 80, 100, 132 etc..
  615. /row - Returns number of logical video display rows in current mode
  616.        as an error level, 25, 43, 50 etc..
  617. /cpsl - Returns error level 1 if caps lock is on, 0 if not.
  618. /scrl - Returns error level 1 if scroll lock is on, 0 if not.
  619. /nmbl - Returns error level 1 if number lock is on, 0 if not.
  620. /rod - Returns error level 1 if mouse present, 0 if not.
  621. /ver - Returns error level 1 if verify on, 0 if not.
  622. /brk - Returns error level 1 if break on, 0 if not.
  623. /ddx - Does directory exist ? Returns error level 1, if specified directory
  624.        exists, a 0 if not. Directory may contain a Drive and complete path.
  625. /dfx - Does file exist ? Returns error level 1, if specified file exists, a
  626.        0 if not. File argument may contain a Drive, path, and wildcards.
  627. /rtd - Are you currently in the root directory on the default drive ?
  628.        Returns a 1 if true, or a zero if not.
  629. /tfa - File argument archive attribute bit check.
  630.        Returns a 1 if file archived, a 0 if not.
  631.        Argument may contain a drive, path, and wildcards.
  632. /tfr - Same as /tfa but checks for read only attribute.
  633. /idv - Is argument the disk volume ID. Drive may be included in argument.
  634.        Returns 1 if true, or 0 if not.
  635. /pth - Save the current path in the environment under Variable "DIR=".
  636. /fdb - Saves disk free bytes in environment variable "INFO=".
  637.        Argument is a disk drive. (Alpha A-Z) (Numeric 1-26).
  638. /fsiz - Get argument file size and save in environment variable "INFO=".
  639.     Argument may contain a drive, path, and wildcards.
  640. /npth - Check argument string for existence in environment path variable.
  641.     Argument may be a partial or full path string. Returns 1 if found.
  642. /nenv - Same as /npth but checks all environment variables.
  643. /esiz - Returns number of 16 byte paragraphs assigned for environment use.
  644.     A 512 byte environment would return 32, 1024 returns 64.
  645. /fdc - File date comparison. Takes two file arguments. Arguments may contain
  646.        a drive, path, and wildcards. Returns the number of the file that is
  647.        older according to the order they were entered. Returns 3 if both
  648.        files are the same age. Returns a 0 if cannot find file or error.
  649. /room - Is there room to copy a file to a disk. Takes a drive and a file
  650.     argument. Returns a 1 if room to copy, a 0 if not.
  651. /fenv - Number of available environment space in in 16 byte paragraphs.
  652.  
  653.  
  654.               ABATJOB                              PAGE 14
  655.  
  656.    Abatjob is a versatile utility program that will allow you to control
  657. many of the text mode capabilities your PC offers, as well as providing
  658. some rudimentary drawing and character placement tools. Several other
  659. miscellaneous functions are included to enhance your batch file power.
  660. These functions include control over cursor display, shape, and positioning,
  661. a print screen function, and the ability to set up and use a loop counter
  662. in the environment.
  663.  
  664.    Abatjob contains over twenty option switches, and the task of providing
  665. maximum flexibility with a minimum of user input was somewhat daunting.
  666. Consistent argument formats were used wherever possible and default values
  667. and toggle switching are used to decrease complexity. Many of the options
  668. affect the entire screen or otherwise do not require arguments, while others
  669. will function with an absolute minimum of input.
  670.  
  671.    The basic input requirements for screen manipulation or drawing functions
  672. that work on specified parts of the screen is a location in the form of a row
  673. and column. Rows are specified using numbers 0-24, while columns use numbers
  674. 0-79. Screen attributes are optional with a default value being taken from
  675. screen location 0,0 if one is not specified.
  676.  
  677.    Options listed on the next page are categorized by input parameters in
  678. order to simplify the argument formats. How the program operates depends to
  679. a great extent on the type of information it's passed. There are a lot of
  680. optional information stipulations that will allow you to use one option in
  681. a variety of ways. Default values are provided wherever there is a
  682. discretionary argument.
  683.  
  684.  
  685.              -  ABATJOB OPTIONS  -                      PAGE 15
  686.  
  687. Arguments in parenthesis denote discretionary inclusion for specific results.
  688. (+Attribute) - If an attribute other than the default at screen location 0,0.
  689. (V/H Direction) - A Vertical(row) or Horizontal(column) direction.
  690. (length) - Used in combination with direction to specify screen locations.
  691. (Border Type) - Type of lines encompassing a box.
  692. A (+) in front of a character argument denotes an Ascii code.
  693.  
  694. * Options without arguments or input parameters. *
  695.  
  696. /blink - A toggle switch for blinking all text on the screen.
  697. /brgt - A toggle switch for text intensity on the screen.
  698. /bbrt - A toggle switch for background screen color intensity.
  699. /nvrt - A toggle switch for inverting screen color.
  700. /prtsc - Print what's on the screen.
  701. /cntr - Set a loop counter in the environment to a value.(Default Value Zero)
  702. /inc - Increment the loop counter in the environment.
  703. /dec - Decrement the loop counter in the environment.
  704. /dcntr - Delete the loop counter from the environment.
  705. /crsr - Toggle cursor on and off.
  706.  
  707. * Options using argument or input parameter format *
  708.   (+Attribute) (V/H Direction) Row Column (Length)
  709.  
  710. /sblink - A toggle switch for blinking selected text on the screen.
  711. /sbrgt - A toggle switch for selected text intensity.
  712. /sbbrt - A toggle switch for selected background screen color intensity.
  713. /snvrt - A toggle switch for selectively inverting screen color.
  714. /scolr - Change selected screen color without erasing text.
  715. /schr - Fill specified portion of the screen with a character.
  716. /line - Draw a horizontal or vertical line at location specified.
  717.  
  718. * Options with special argument or input parameter formats. *
  719.  
  720. /sbox - Draw a shadowed box at location specified.
  721. - (+Attribute)(SS,DS,SD,DD Border Type) Top Row,Top Col,Bottom Row,Bottom Col
  722. /chbx - Fill a rectangular portion of the screen with a character.
  723. - (+Attribute) Character,Top Row,Top Col,Bottom Row,Bottom Col
  724. /vstr - Fill the screen with a character string.
  725. - (+Attribute) Word or string enclosed with parenthisis.
  726. /cntr - Set a loop counter in the environment to a value.
  727. - A value from 0 - 255
  728. /mvcur - Move the cursor to row and column.
  729. - Row( 0 - 24), Column(0 - 79)
  730. /cursz - Change cursor shape or size.
  731. - Start Scanline, End Scanline ( 0-13 )
  732. /colr - Change screen color without erasing text.
  733. +Attribute
  734.  
  735.  
  736.                 ACLS                               PAGE 16
  737.  
  738.    Acls is a video screen clearing utility that that may be used to add a
  739. dimension of visual entertainment to your batch files, or as an enhancement
  740. to your computer operating system. Acls is functionally similar to the DOS
  741. CLS command, but provides an alternate set of differing methods to clear the
  742. video display. Because of this, you must remember to include an option that
  743. specifies the desired method when using Acls, or you will be presented with a
  744. help screen. The use of Acls is not required when generating menus and
  745. message windows, it was simply added to the utility set to provide uniqueness
  746. and variety to your batch files.
  747.  
  748.    As stated above, you may view a descriptive list of program options by
  749. typing ACLS alone on the command line. You may also use Acls to set the
  750. default screen colors of your video display. These will remain active until
  751. another program resets them or you call Acls again with a different option.
  752. Typing ACLS /c or ACLS color displays an on screen listing of usable color
  753. attributes. You may enter a screen attribute by preceeding it with the plus
  754. symbol and inputing it before or after an option. If a new attribute is not
  755. specified, a default value from screen location 0,0 will be used.
  756.  
  757.    The following list describes the ACLS option switches. Most of the
  758. effects generated by these switches are hard to describe with words, so if
  759. the descriptions are hard to visualize, please try experimenting with them.
  760.  
  761. ACLS PROGRAM OPTIONS
  762.  
  763. /hz - moves every other line of text off the screen in the opposite
  764.       direction in a horizontal fashion.
  765. /vt - moves every other column of text off the screen in the opposite
  766.       direction in a vertical fashion.
  767. /wl - wipes screen clear from the left.
  768. /wr - wipes screen clear from the right.
  769. /in - text disappears by being scrolled into the middle of the screen.
  770. /out - text disappears by being scrolled towards bottom and top of screen.
  771. /splt - Splits screen in half and scrolls off. Sound Effects.
  772. /diag - Diagonal scroll down. Sound Effects.
  773. /tnl - Draw a tunnel and clear the screen. Sound Effects.
  774. /wbs - Invert screen color and add patterns. Sound Effects.
  775. /blko - Blocks out portions of the screen in sequence. Sound Effects.
  776. /prt(4 corners) - Clear part of the screen you specify. Sound Effects.
  777. /cls - a conventional screen clear in graphics or text modes.
  778. /c - Shows a table of color attributes.
  779.  
  780.  
  781.  
  782.                APAGE                                PAGE 17
  783.  
  784.    Apage allows you to view ascii text files. You can control viewing with
  785. the up and down arrow keys, page up and page down keys, spacebar, home, and
  786. end keys. The arrow keys and spacebar allow you to scroll through the text
  787. one line at a time, while the page keys provide viewing in chunks of 22 lines
  788. per page. Apage offers two less common key functions with the home and end
  789. keys. Home will bring you back to the beginning of the file. End allows you
  790. to read the entire file at a speed comparable to Mr. Data on Star Trek. You
  791. can view files in the color of your choice by entering an attribute preceeded
  792. by a '+' symbol as the first argument on the command line.
  793.  
  794.    Many of the program functions are performed with sound effects. If you
  795. don't want to listen to the effects while your viewing the file, the
  796. CONTROL+S keys will toggle the sound on and off.
  797.  
  798.    Apage will handle files up to 2 Megabytes in size. You may open and view
  799. larger files but the program will only display the first 2 Megs of text.
  800. Hopefully, this is not to much of a handicap unless you keep and read
  801. extremely large text files. If you have files exceeding a Megabyte in length
  802. you may wish to turn the sound effects off if you intend to go to the end
  803. of the file with the end key function. The sound effects generate a tone
  804. starting at 230 hertz and increments that tone by 3 hertz per line of text.
  805. This can bring the tone up to a very high frequency when reading in files
  806. of this magnitude. The high frequency tone will not hurt your ears or the
  807. PC speaker but can become annoying if you have to listened to it for several
  808. moments.
  809.  
  810. * To Use Apage *
  811. Type: Apage (+Attribute) "(Drive:\Path)\ Filename with extension"
  812.  
  813.  
  814.  
  815.              TEXT FILES                             PAGE 18
  816.  
  817.    Abatmenu, Amsg, and Aecho allow you to store program options in straight
  818. Ascii text files. You can produce Ascii text files with many popular word
  819. processors that have file export functions. Check your documentation to see
  820. if your word processor has this capability. Most versions of DOS come with
  821. Ascii text file processing programs. Starting with DOS 5.0 a program called
  822. Edit was provided for this purpose. Earlier versions of DOS come with a
  823. program called Edlin that provides crude, but effective text file generation.
  824.    To use a text file containing your program options, you will need to create
  825. the file and then pass the complete name of your file to abatmenu or amsg on
  826. the command line. Abatmenu and Amsg take text file arguments the same way,
  827. and options for both may be stored in the same file by using labels.
  828.  
  829. Typing.... ABATMENU Myfile.txt
  830.  
  831. tells abatmenu to search for a file called Myfile.txt in the current directory
  832. to obtain its command line options. Abatmenu is not case sensitive about the
  833. file name, but it does need the complete file name including the extension.
  834.    To create a text file that abatmenu can use you need to enter each command
  835. line option on a separate line of the file, and in the correct order. Abatmenu
  836. uses the ascii code that signals a new line to separate the options. New line
  837. codes and carriage returns are automatically generated by your word processor
  838. when you press the Enter or Return key.
  839.  
  840. Myfile.txt would be formatted as follows....
  841.  
  842. 176
  843. Boot Menu
  844. Selection1
  845. Selection2
  846. Exit
  847.  
  848.    You can store multiple option sets in a text file by using labels.
  849. A label in a text file consists of any alphanumeric word, phrase, or set of
  850. characters you wish to use, as long as it is immediately preceded by the
  851. @ character, and placed on a separate line of the text file. The @ character
  852. is created by pressing the <shift> + 2 keys simultaneously. Labels are used
  853. to mark the set of options you wish the program to use. You mark an option
  854. set by placing the label on the line preceding it. You need not worry about
  855. marking the end of the set, since the next label or end of the file performs
  856. that function. To use the label, you must type the label name after the file
  857. name that contains it, and enclose both in quotation marks.
  858.  
  859. Typing..... ABATMENU "Myfile.txt @Mylabel"
  860. calls the option set marked @Mylabel.
  861. 7                              |
  862. 9                              |
  863. 176                            |
  864. Boot Menu                      |
  865. Selection1                     |
  866. Selection2                     |
  867. Exit                           |
  868. @Mylabel --------------------- |
  869. 10                             |
  870. 20                             |
  871. 176                            |
  872. Mylabel Boot Menu              |
  873. Selection1                     |
  874. Selection2                     |
  875. Exit ------------------------- |
  876.  
  877.  
  878.  
  879.             COLOR ATTRIBUTES                        PAGE 19
  880.  
  881. The color combinations are made by adding the decimal values of the foreground
  882. and background colors. For instance to get a Cyan background and a white
  883. foreground you would add 48 + 15 = 63. To get a White hi-lite bar with Red
  884. Text you would add 112 + 4 = 116. You do not need to specify background colors
  885. for window text, the program automatically uses the background color selected
  886. for the window.
  887.  
  888.  
  889.             Color Attributes
  890.             ****************
  891.  
  892.  
  893.    Foreground Colors:
  894.  
  895.    Black            0               Gray                  8
  896.    Blue             1               Light Blue            9
  897.    Green            2               Light Green           10
  898.    Cyan             3               Light Cyan            11
  899.    Red              4               Light Red             12
  900.    Magenta          5               Light Magenta         13
  901.    Brown            6               Yellow                14
  902.    Light Gray       7               White                 15
  903.  
  904.  
  905.    Background Colors:           Examples:
  906.  
  907.    Black            0           Blue Background and Yellow Foreground
  908.    Blue             16
  909.    Green            32                    16 + 14 = 30
  910.    Cyan             48
  911.    Red              64          Green Background and White Foreground
  912.    Magenta          80
  913.    Brown            96                    32 + 15 = 47
  914.    White            112
  915.  
  916.  
  917.  
  918.  
  919.               BATCH FILES                      PAGE 20
  920.  
  921.  
  922.    DOS provides batch files so that you can store the commands to perform
  923. specific tasks in a file, rather than repeatedly entering them on the command
  924. line. A DOS batch file name must have a .BAT extension, and be different from
  925. any of DOS's internal command names.
  926.    A Batch file must be an Ascii text file, with each batch file command
  927. placed on a separate line. To run a batch file, simply type its name at the
  928. DOS prompt, and press the enter key.
  929.    Batch files allow you to perform simple computer programming using DOS
  930. commands. If you know how to use DOS, you already have most of the knowledge
  931. required to write effective batch files. To set up batch files for ABATMENU,
  932. you will need to understand the basic concepts of labels, and errorlevel code
  933. testing. ABATMENU returns an errorlevel code to the calling batch file.
  934. Pressing the ESC key while ABATMENU is running will return a ZERO. Selecting
  935. item one at the top of the menu and pressing the ENTER key returns a ONE, the
  936. next item a TWO, and so on. Batch files allow you to set up labels
  937. corresponding to the returned errorlevel code, in order to perform the tasks
  938. you select from the menu.
  939.    DOS provides 0 - 255 ERRORLEVEL codes. You must check for these in
  940. descending order since DOS tests for errorlevels using a greater than or
  941. equal to comparison.
  942.  
  943.      ******** EXAMPLE ********
  944.  
  945. REM menubat.bat         * name of batch file *
  946. TOP:                    * a batch file label *
  947.  
  948. ABATMENU 6 31 +16 7 116 117 15 "* MENU *"  item1 item2 item3
  949.  
  950. IF ERRORLEVEL 3  GOTO THREE (item3 label)
  951. IF ERRORLEVEL 2  GOTO TWO   (item2 label)
  952. IF ERRORLEVEL 1  GOTO ONE   (item1 label)
  953. IF ERRORLEVEL 0  GOTO END   (ESC label)
  954.  
  955. GOTO TOP       * Reruns ABATMENU *
  956.  
  957. ONE:           * item1 label *
  958. LH FASTOPEN C: * loads fastopen for the C drive into high memory *
  959. LH DOSKEY      * loads doskey (A TSR) into high memory *
  960. GOTO END       * Exit batch file *
  961.  
  962. TWO:           * item2 label *
  963. DATE           * input date for system *
  964. TIME           * input time for system *
  965. PAUSE          * pause until user presses a key *
  966. ACLS /hz       * Call Clear Screen utility program *
  967. GOTO TOP
  968.  
  969. THREE:         * item3 label *
  970. CD WP51        * change directories *
  971. WP             * run wordperfect 5.1 *
  972. END:           * end of batch file or ESCAPE label *
  973.  
  974.  
  975.                TECHNICAL                             PAGE 21
  976.  
  977. ABATMENU
  978. Maximum Selection Size - 30 characters each.
  979. Maximum Number of Selections - 48 total. 16 per screen.
  980. Maximum Number of Text File Labels - Unlimited if you can remember them,
  981.                     and spare the disk space.
  982. AMSG
  983. Maximum Character Length of one line of message text - 70 characters.
  984. Maximum Number of Text Lines for message window - 20 lines.
  985. Maximum Number of Text File Labels - Unlimited if you can remember them,
  986.                     and spare the disk space.
  987.  
  988. ABATINFO
  989. Abatinfo will return a 0 if a dos error is encountered such as a disk drive
  990. door being open. The program does no bomb but since it uses DOS to to obtain
  991. information, it also depends on dos for error checking.
  992.  
  993. NOTES
  994. Text Modes - All programs that use screen functions use text modes 3 or 7. If
  995.          possible the programs will reset to a text mode if your not
  996.          already in one.
  997.  
  998. DOS limits the number of characters you can enter on the command line. If you
  999. are encountering truncated menus or other problems, you should try using text
  1000. files to store your option sets.
  1001.  
  1002. You may not use the same text file to store program options for Abatmenu
  1003. and Amsg. Each program reads the text files and labels in a slightly
  1004. different manner. Be Careful!
  1005.  
  1006.  
  1007.             DISCLAIMER                         PAGE 22
  1008.  
  1009. Because of the various hardware and software environments into which
  1010. these programs may be put, no warranty of fitness for a particular purpose
  1011. is offered.
  1012.  
  1013. WARRANTY DISCLAIMER:
  1014.  
  1015. THIS SOFTWARE, MANUAL, AND SUPPORTING FILE ARE SOLD "AS IS" AND WITHOUT
  1016. WARRANTIES. ROBIN R. LATHAM DISCLAIMS ALL WARRANTIES RELATED TO THIS
  1017. SOFTWARE, WHETHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY
  1018. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE,
  1019. AND ALL SUCH WARRANTIES ARE EXPRESSLY AND SPECIFICALLY DISCLAIMED. NEITHER
  1020. ROBIN R. LATHAM, NOR ANYONE ELSE WHO HAS BEEN INVOLVED IN THE CREATION,
  1021. PRODUCTION, OR DELIVERY OF THIS SOFTWARE SHALL BE LIABLE FOR ANY INDIRECT,
  1022. CONSEQUENTIAL OR INCIDENTAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO
  1023. USE SUCH SOFTWARE EVEN IF ROBIN R. LATHAM HAS BEEN ADVISED OF THE POSSIBILITY
  1024. OF SUCH DAMAGES OR CLAIMS. IN NO EVENT SHALL ROBIN R. LATHAM'S LIABILITY FOR
  1025. ANY DAMAGES EVER EXCEED THE PRICE PAID FOR THE LICENSE TO USE THE SOFTWARE,
  1026. REGARDLESS OF THE FORM OF THE CLAIM. THE PERSON USING THE SOFTWARE BEARS ALL
  1027. RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE.
  1028.      Some states do not allow the exclusion of the limit of liability for
  1029. inconsequential or incidental damages, so the above limitation may not apply
  1030. to you.
  1031.      This agreement shall be governed by the laws of the Sate of Texas and
  1032. shall inure to the benefit of Robin R. Latham, and any successors,
  1033. administrators, heirs, and assigns. Any action or proceeding brought by
  1034. either party against the other arising out of or related to this agreement
  1035. shall be brought only in a STATE or FEDERAL COURT of competent jurisdiction
  1036. located in Tarrant County, Texas. The parties hereby consent to in personam
  1037. jurisdiction of said courts.
  1038.  
  1039.  
  1040.             REGISTRATION                       PAGE 23
  1041.  
  1042. TERMS OF USE:
  1043.  
  1044.      Upon registration, this software and the disks on which it is contained
  1045. is licensed to you, for your own use. This is copyrighted software. You are
  1046. not obtaining title to this software or any copyrights. You may not
  1047. sublicense, rent, lease, modify, translate, convert to another programming
  1048. language, decompile, or disassemble the software for any purpose.
  1049.      You may make as many copies of this software as you need for back-up
  1050. purposes, or SHAREWARE distribution. You may use this software on more than
  1051. one computer, provided there is no chance it will be used simultaneously on
  1052. more than one computer. If you need to use the software on more than one
  1053. computer simultaneously, please contact me for information about site
  1054. licenses. Use of any utility program contained within this set on a network
  1055. requires a site license.
  1056.  
  1057. SHAREWARE DISTRIBUTION:
  1058.  
  1059.      Permission is hereby granted for clubs, disk vendors, user groups, or
  1060. individuals to distribute A BATCH VIEW on a SHAREWARE basis, providing that
  1061. the entire A BATCH VIEW package with accompanying documentation files is
  1062. included in the distribution, and a relevant statement is made concerning the
  1063. required registration of shareware beyond the price of the distribution disk.
  1064.  
  1065.      If you like, or find these programs useful, please feel free to
  1066. distribute copies to friends and acquaintances, or upload a copy to your
  1067. favorite bulletin boards. Please make sure that you include all the files
  1068. that come with the A Batch View Utility Set in any copies that you distribute.
  1069. Your support of the shareware concept, products, and distribution process is
  1070. greatly appreciated.
  1071.  
  1072.      A compressed version of this utility set may be downloaded from the
  1073. compuserve IBMSYS Forum, Library 1 under the file name ABTVEW.ZIP. You will
  1074. need a copy of PKUNZIP version 2.0 to decompress the file. A shareware copy
  1075. of PKUNZIP is located in the same Forum under the name PK204G.EXE.
  1076. I can also be reached by compuserve Email with ID # 72614,602.
  1077.  
  1078.  
  1079.                                   PAGE 24
  1080.    You may register this Utility set through the compuserve shareware
  1081.    database. Type GO SWREG at any Compuserve Prompt. Search using the
  1082.               word ABTVWE, or my name.
  1083.    *******************************************************************
  1084.    *                      REGISTRATION FORM                          *
  1085.    *                A BATCH VIEW UTILITY SET Ver 2.0                 *
  1086.    *     Copyright 1994 by Robin R. Latham  All Rights Reserved.     *
  1087.    *******************************************************************
  1088.  
  1089. Name:            ____________________________________________
  1090.  
  1091. Address:         ____________________________________________
  1092.  
  1093. City, State:     ____________________________________________
  1094.  
  1095. Zip Code:        ____________________________________________
  1096.  
  1097.  
  1098. The cost to register one copy of A BATCH VIEW is $15.00. Registration entitles
  1099. you to an abundance of good Karma, a clear conscience, and continued legal use
  1100. of all the A BATCH VIEW utility programs. In addition to the above, I provide
  1101. free copies of any future program upgrades or versions(IF desired), and phone
  1102. or mail support. Site licenses are available for a flat fee of $45 (U.S.)
  1103. Please make checks or money orders payable to Robin R. Latham, and send to
  1104. the address listed at the bottom of the page.
  1105.  
  1106.         Thanks for supporting Shareware products !
  1107.  
  1108.     Send me New Program Upgrades or Versions []
  1109.  
  1110.     Registration $15 []     Site License $45 []
  1111.  
  1112.     Individual Program Registration $5 [] X Number________
  1113.  
  1114.     Disks $1 [] X Number________         5.25 []    3.5 []
  1115.  
  1116.     Texas Residents Please Add 7.5% Sales Tax: ___________
  1117.  
  1118.                 Total Enclosed: ______________
  1119.        _______
  1120.       ____|__     |               (R)
  1121.    --|       |    |-------------------        Robin R. Latham
  1122.      |   ____|__  |  Association of         2607 Betty Lane #167
  1123.      |  |       |_|  Shareware              Arlington, TX. 76006
  1124.      |__|   o   |    Professionals            (817) 649 - 5273
  1125.    -----|   |   |---------------------    Compuserve ID# 72614,602
  1126.     |___|___|    MEMBER
  1127.  
  1128.