home *** CD-ROM | disk | FTP | other *** search
/ Mega CD-ROM 1 / megacd_rom_1.zip / megacd_rom_1 / MENU / KYSS37.ZIP / KYSQKREF.ASC < prev    next >
Text File  |  1991-02-19  |  7KB  |  156 lines
  1.                          KYSS! QUICK REFERENCE GUIDE
  2.  
  3. MENU COMMANDS
  4.  
  5. ADM:ON/OFF          Enable/Disable Extended File/Dir management privileges
  6. BEL:                Ring bell to gain operator's attention.
  7. DES:text            Describe activity in Job Tracking Log (32 char max.).
  8. DOS:                Exit KYSS! to DOS command mode. Also use w/PWD:
  9. DIR:d:\path         Change logged directory to d:\path before executing job 
  10.                     or changing to a menu.
  11. EDT:filespec        Edit specified file (filespec = d:\path\filename.ext).
  12.                     You may use * & ? wildcards in EDT: filespec.
  13. HDG:text          * Display a menu heading.
  14. HLP:filespec n      Context-Sensitive help (n = item number in leftmost col).
  15. INP:prompt          Operator Entry Request (creates variables $1 to $9)
  16. JOB:filespec        Request job number for entry in job tracking log file.
  17.                     filespec is an optional filename of the file containing 
  18.                     valid job #s & descriptions.
  19. LOG:filespec        Record this process in Job Tracking Log
  20. LST:filespec txt    View a text file.  txt is optional, and if given display 
  21.                     begins at line containing txt.
  22. MNU:filespec        Call a submenu
  23. MSG:text            Display a message for the operator
  24. ORD:              * Display menu entries in order (default = alphabetized).
  25. POS:n,n           * Position menu in display area at Row n, Col n.
  26. PRN:filespec        Print specified file
  27. PWD:filespec        Require a password (filespec - password file).
  28. REM:text            REMark is not processed by KYSS!
  29. VER:d:filespec msg  Require disk containing filespec (msg prompt optional). 
  30. XIT:                Exit before process execution; non-resident mode.
  31.  
  32. NOTE: * commands must begin in leftmost screen position before any menu
  33. selection items are entered.  All others must be placed under menu headings
  34. and preceded by a leading space or tab.  Exception is PWD: which may also
  35. be used before any menu selection items to password-protect entire menu.
  36.  
  37. EXAMPLE MENU
  38.  
  39.      | <-- leftmost screen position
  40.      HDG:MAIN MENU
  41.      POS:3,25
  42.      ORD:
  43.      Delete Files (First menu selection)
  44.           HLP:MAINMENU.HLP 1
  45.           REM:Restrict this process to authorized persons
  46.           PWD:ACTGDEPT.PWD
  47.           MSG:Files you specify will be GONE FOREVER!!!
  48.           INP:Enter file specification as d:\path\filespec.  You &
  49.               can use DOS (? and *) wildcards.
  50.           DES:Files deleted by operator
  51.           LOG:C:\ACTIVITY.LOG
  52.           DEL $1
  53.      Wordprocessing Program
  54.           REM:Go non-resident to make all memory available
  55.           XIT:
  56.           WP
  57.           REM:If program allows change of current drive/dir, use &
  58.               KYSS variables $@ and $# to force return to currently &
  59.               logged drive and directory.  Notice ! command separator.
  60.           $@:!CD\$#
  61.      Edit This Menu
  62.           REM:This is a convenience for menu development.  It can be &
  63.               removed or PWD: protected when menu is complete.
  64.           MSG:You will have to exit from this menu, then call it again &
  65.               for these changes to appear.
  66.           EDT:MAINMENU.MNU
  67.      Call a Submenu
  68.           MNU:MENU2.MNU
  69.  
  70. KYSS! IMPLICIT VARIABLES
  71.  
  72.      $1 to $9  Created with the KYSS! INP: command.  Each time INP: is
  73.                used within a single menu entry, a $n variable is created
  74.                to contain the characters entered by the operator.  As
  75.                many as 9 operator entries may be requested.
  76.                Example:  INP:Source drive as d: (A-C)
  77.                          INP:Target drive as d: (A-C)
  78.                          IF $1==$2 GOTO Error
  79.                          COPY $1*.* $2
  80.                          GOTO End
  81.                          :Error
  82.                          ECHO Source and target drive cannot be the same
  83.                          PAUSE
  84.                          :End
  85.      $@        Retains 1-character representation of current drive
  86.      $#        Retains current path.  Ex:  CD\$#
  87.  
  88. KYSS.BAT COMMAND LINE SWITCHES
  89.  
  90. KYSS! is ALWAYS called from the KYSS.BAT file as:
  91.  
  92.      @ECHO OFF
  93.      CLS
  94.      KYSS3 [optional switches]
  95.  
  96. Multiple switches may be used.  Separate each option with a space.
  97. Switches may be lower case letters as shown or upper case.
  98.  
  99.      -a        Allow full access to file/directory mgt. facilities.
  100.      -eext     Set menu filename extension.  Default is .MNU Ex: -eMEN
  101.      -f        Inhibits specific KYSS! faclilities.
  102.                Follow -f with the list of facilities to TURN OFF
  103.                    e - Editor
  104.                    f - Files (Disk Jockey)
  105.                    p - Password editor
  106.                    o - Options editor
  107.                    r - Report generator
  108.                KYSS3 -frof turns off reports, options and file manager.
  109.      -h        Hush! Disable bell that preceeds operator entry requests.
  110.      -lprn     List device. Default is PRN:  Example: llpt2
  111.      -ppath    Set default menu file directory.  Ex: -pC:\KYSS3
  112.      -tpath    Set path for temporary files.  Ex: -tE:\
  113.      -n        Force KYSS! to go non-resident on all menu items.
  114.      -o        Turn off default CLS and ECHO OFF commands.
  115.      -q        Allow exit to DOS from main menu via <Esc> key.
  116.      -r        Disable display of "PRV - Previous" menu selection.
  117.      -s        Enable swap to XMS/EMS memory or file during process execution.
  118.                Swap to file using environment variable KYSWAP=d:\path.
  119.      -ufilename Filename containig user names for USR: validation. Create
  120.                using KYPASSWD.
  121.  
  122. KYSS! ENVIRONMENT VARIABLES
  123.  
  124. Establish using SET command in AUTOEXEC.BAT file.
  125.  
  126.      TPATH=d:\path       Establishes path for temporary files to be
  127.                          written.  KYSS.BAT may also be in this directory.
  128.                          This directory should be unique for each user
  129.                          in a LAN environment.
  130.  
  131.      KYS$DRV=d:          Set "home" drive for KYSS! operations.
  132.      KYS$DIR=\path\      Set "home" directory for KYSS! operations.
  133.  
  134.      KYS$PATH=d:\path    Replaces KYS$DRV and KYS$DIR in Release V3.7+
  135.  
  136.      KYSAVE=d:\path      Storage area for KYSS! working files such as
  137.                          directory tree, user .CFG files, notepad, etc.
  138.                          LAN users should be granted all rights to this
  139.                          directory.
  140.  
  141.                          Default is root directory of current drive.
  142.                          
  143. DOS ENVIRONMENT
  144.  
  145.      PATH=d:\path        Set DOS search path to directory containing
  146.                          KYSS! III.   Ex: PATH=C:\KYSS3
  147. CONFIG.SYS FILE
  148.  
  149.      FILES=10            Minimum setting in CONFIG.SYS file. 20 is typical.
  150.  
  151.      SHELL=C:\COMMAND.COM /e324 /p  
  152.  
  153.                          See DOS SHELL command in CONFIG.SYS to create
  154.                          an environment size sufficient for KYSS! to
  155.                          use 60 bytes of available environment space.
  156.