List-it

Last edited: December 15, 2003 08:14 AM

List-it is a command line driven utility that will list specified file on screen. It will allow scrolling by touch.

SYNTAX:

    LIST-IT

        {/init} {/v1=##} {/v2=##} {/v=##} {/f=} {/h=’text’} {/ESC}
        {/listclockedemps} {/showempjobs} {/listemps}
        {/plu} {/price(x)} {/eval=x} {/group}
        {/listbuk} {/makecheck}
        {/listcusnum} {/listcusalpha}
        {/ini=’filename.ini’}
        {/?}

OTHER FEATURES:

    Mouse Pointer will show if Environment variable ‘ShowMouse’ is set to Yes.

    Scrolling will slow if Environment variable ‘SlowScroll’ is set to a value.

   

    /Init on command line will initilize the video.

    /LISTCLOCKEDEMPS – Will list clocked in employees and their department.

    /LISTEMPS – Will list all employees in the employee database.

    /SHOWEMPJOBS – Will list all valid job codes for a specified employee. Employee is specified by passing Number 3 variable in Variable.TXT, the job code selected by user will be returned in the variable specified by the /V or /V1 switches. This feature was designed to use in conjunction with the “Timeclock using Vars” instruction.

    /PLU will list defined PLUs with optional prices. The list will come from PLU.LST or PRODUCT.DAT depending on the options selected.

    /PRICE 1-4 will define the price level to use in conjuction with /PLU

    /EVAL= when used in conjunction with /PLU, will mask the list to PLUs with specified evaluator on.

    /GROUP will list defined groups and their numbers

    /F={File name} will list the specified file. The default file to list is Z:Check.TXT

    /V1=## will return a value in specified variable number in Z:VARIABLE.TXT. When used in conjuction with /GROUP,/PLU, /LISTCLOCKEDEMPS and /LISTEMPS will return of number of the Group or PLU selected in specified variable number. When used in conjunction with /F= or default will return the value of the row selected.

    /V=## will function just like /V1 for backward compatibility.

    /V2=## will return the entire line of the chosen row in specified variable number. Must use one of the Memo variables to get it all.

    /H={text} will use up to 30 chars of {text} as a header for list-it. {text} must be enclosed within ‘ marks eg. -> ‘PLU Listing’ list-it will automatically chop and center the {text} to length of 30.

    /ESC will draw an Escape button in conjunction with the Ok button. When this button is touched, List-It will not return any values in Z:Variable.TXT

    /LISTBUK= to show a specified bucket file. Will only list the first 40 columns of each available 200 column row in a bucket file. Do not specify path, only file name without extension.

    /MAKECHECK to create Z:CHECK.TXT after listing whatever it was you were listing on the screen.

    /LISTCUSNUM will list up to 4000 customers numerically using their account numbers. Will return selected customer account in the Cus:Account variable.

    /LISTCUSALPHA will list up to 4000 customers alphabetically. Will return selected customer account in the Cus:Account variable.

    /INI=’filename.ini’ will allow all settings to be defined in an ini file instead of on the command line. See the included Sample.INI file for an example of it’s usage.

    /? will display help info

Revisions

01/05/96 Version 1.11

  1. Updated the help info.

01/15/96 Version 1.12

  1. Added /LISTCLOCKEDEMPS command line switch. Can be used instead of the login screen. Example: picking an employee to assign to a drawer, etc.

01/31/96 Version 1.13

  1. Fixed the bug causing the /V1= switch to fail when used in conjunction with /LISTCLOCKEDEMPS switch.

02/20/96 Version 1.14

  1. Added /LISTEMPS command line switch. Will list all employees in employee database.

04/16/96 Version 1.15

  1. Added ability to speed search any list displayed by List-It. Speed search line will not be displayed, but user can type and List-It will search.
  2. Updated Help Screen.

06/28/96 Version 1.16

  1. Added /ESC command line switch. This will cause List-It to display an Escape button along with the Ok button. When touched, List-It will not return any values in Z:VARIABLE.TXT.
  2. Upped the limit of Item () when reading a specified file from 500 to 4000.

05/07/96 Beta Version 2!00

  1. Compiled a beta version for compatability with TOUCHNET version 5.xx Updated the loading of the following files to accomodate file format changes in TOUCHNET version 5.xx: Product.DAT Employee.DAT Depts.DAT (JobCode.DAT) Customer database files
  2. Updated the way PLUs are read from the journal files. FROM: Case 1 to 999 TO: Case -1999 to 999
  3. INCR %MaxPLUs from 999 to 1999

06/28/96 Beta Version 2!01

  1. Incorporated changes made in version 1.16.

07/08/96 Version 2.02

  1. Incorporated thin Shadow Box to use instead of ShadowBoxUI which uses thick shadow.

07/15/96 Version 2.03

  1. Fixed bug related to version checking.

01/30/97 Version 5.04

  1. Changed time stamp method to match the hour to the version of TouchPRO it is compatible with.
  2. Added command line switch /EVAL= to be used in conjunction with the /PLU switch. Will mask the list to PLUs with the specified evaluator on.
  3. Compiled with new SHARE code and ERRORs code.
  4. Removed command line switch /BUILD, will always load product.dat

03/10/97 Version 6.00

  1. Changed loading of Employee.DAT and JobCode.DAT

04/24/97 Version 6.01

  1. Added command line switch /SHOWEMPJOBS. This switch will list all valid job codes for a specified employee. Employee is specified by passing Number 3 variable in Variable.TXT, the job code selected by user will be returned in the variable specified by the /V or /V1 switches. This feature was designed to use in conjunction with the “Timeclock using Vars” instruction.

07/07/97 Version 6.02

  1. Will always initialize mouse now instead of only when /INIT was specified in the command line switch. This was done to fully support Elo-Graphics touch monitors.

09/19/97 Version 6.03

  1. Added command line switch /SHOWBUK= to show a specified bucket file. Will only list the first 40 columns of each available 200 column row in a bucket file.
  2. Added command line switch /MAKECHECK to create Z:CHECK.TXT after listing whatever it was you were listing on the screen.

10/27/97 Version 6.04

  1. Added command line switches to view up to 4000 customers. Can see list either alphabetically (/listcusalpha) or numerically (/listcusnum).

04/01/98 Version 6.05

  1. Fixed bug in /listcusNum and /listcusAlpha. Wasn’t returning selected account number selected. Now it does, it returns selected customer account in the touchPRO variable Cus:Account. You do not have to
      specify a variable with /v, /v1, /v2 command line switches.
  2. Fixed a bug in /listbuk. Wasn’t returning any values. Now will return bucket row number selected (not row of list) in specified variable.
  3. Enhanced /listbuk. Was including blank lines, now it doesn’t.

04/17/98 Version 6.06

  1. Fixed bug in /listbuk. Was returning invalid bucket row numbers.
  2. Updated help info.

2/25/2000 Version 6.10

  1. Added the /INI=filename.ini commandline option. Most options can now be defined in an .INI style file (Sample.INI included) to allow for more complex settings without a polluted commandline. All new features will be added in the INI file and not on the command line. Backwards support for existing command line switches remains.
  2. Added a new .INI setting called ‘ColumnHeader’ which can be used to create a non-scrolling column header row. Because leading spaces on .INI file settings are ignored, a tilde (~) may be used to represent spaces (see sample.ini for example).
  3. Added 2 new .INI settings called ‘EscText’ And ‘OkText’ To allow the button text to be changed to suit the needs of the developer.
  4. Added a new .INI setting called ‘Wide’ which will make the list 76 chars wide (full screen) if set to YES.
  5. Now using the same Touch Library code as TouchPRO, causing the buttons to highlight and touch correctly. Dragging your finger while touching the list will no longer bump into OK or CANCEL buttons
  6. Modified the colors and tracking of the buttons to look more like current software versions.