home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / ZSYS / ZSYSARK / Z3HLP01.ARK / B.LBR / BG.HZP / BG.HLP
Text File  |  1990-03-23  |  12KB  |  494 lines
  1. ;
  2.      BackGrounder ii commands -- Enter letter/number from this menu 
  3.  
  4. F - features summary            H - HELP
  5. B - BG                    1 - CALC
  6. C - CUT,  PASTE             2 - SCREEN
  7. D - DIR,  FIND, ERA            3 - SPOOL, FORMS, PRINTR
  8. E - ECHO, FEED, CLS            4 - SHIFT
  9. G - GET,  GO,   JUMP,  SAVE
  10. J - JOT
  11. K - KEYS
  12. L - LIST, TYPE
  13. N - NDR,  OCP
  14. P - PEEK, POKE
  15. R - RESET, ^C
  16. S - SWAP, FLIP
  17. T - TIME, DATE
  18. W - WHL,  WHLQ, NOTE
  19.  
  20. :F :BGINFO.HLP
  21. :H
  22.      HELP - display/print indexed help file 
  23.  
  24. HELP <CR>
  25.  
  26.     Display this file (BG.HLP).
  27.  
  28. HELP [DU:]filename <CR>
  29.  
  30.     Display named help file.
  31.  
  32.  
  33. Use these controls:
  34.  
  35.     M        return to Menu
  36.     S        return to Start (top-level menu)
  37.     N,<CR>, <SPACE>    display Next screen
  38.     L        display Last screen
  39.     <CNTL-C>    exit from help
  40.     P        Print screen
  41.  
  42. :B
  43.      BG - review commands, remove BackGrounder ii 
  44.  
  45. BG <CR>
  46.  
  47.     Show active tasks and attached key-definitions.
  48.     If Quiet not set, list the available BackGrounder ii commands.
  49.  
  50. BG OFF <CR>
  51.  
  52.     Remove BackGrounder ii from memory and warm boot.
  53.  
  54. BG Q <CR>
  55.     Prompt Quietly, without listing commands.
  56.  
  57. BG V <CR>
  58.     Prompt Verbosely, listing commands.
  59.  
  60. BG Y <CR>
  61.     Yes, enable <SUSPEND> and <ALT> keys.
  62.  
  63. BG N <CR>
  64.     No, disable <SUSPEND> and <ALT> keys.
  65. :C
  66.      CUT and PASTE 
  67.     (requires a loaded screendriver)
  68.  
  69. CUT <CR>
  70.  
  71.     Copies rectangular region of screen to a buffer.
  72.  
  73.     Move the cursor to upper-left corner of region to be clipped.
  74.     Type 'X'.
  75.     Move the cursor to bottom-right corner of region.
  76.     Type 'X' or <CR>.
  77.  
  78. PASTE <CR>
  79.  
  80.     Returns last-clipped region to current program, at the
  81.     current cursor.
  82.  
  83.     A <CR>    is added to the end of each clipped row.
  84. :D
  85.      DIR  - file directory 
  86.  
  87. DIR <CR>
  88.     List all non-system files with sizes in current drive/user.
  89.  
  90. DIR Du:filespec <CR>
  91.  
  92.     List all matching non-system files with sizes in specified drive/user.
  93.  
  94. DIR /fas <CR>
  95.  
  96.     options are:    F - filesizes (reverses configured setting)
  97.             A - all = both Directory and System files.
  98.             S - System files only
  99.  
  100.  
  101. DIR Du:filespec /fas <CR>
  102.  
  103.     Specified files, with specified options
  104.  
  105.  
  106.      FIND - find files, ERA - erase 
  107.  
  108. FIND D:filespec <CR>
  109.  
  110.     Find all matching files on specified drive, in all user areas.
  111.  
  112. ERA filespec [v] <CR>
  113.  
  114.     Erase specified files. Verify first if V.
  115. :E
  116.      Echo - display input on console or printer 
  117.  
  118. ECHO string <CR>
  119.  
  120.     Display string (uppercase) on console
  121.  
  122. ECHO $string <CR>
  123.  
  124.     Display string (uppercase) on printer.
  125.  
  126. FEED <CR>
  127.  
  128.     Eject printer page (formfeed).
  129.  
  130. CLS <CR>
  131.     
  132.     Clear the screen and home the cursor.
  133. :G
  134.      GET, JUMP, GO, SAVE - load, run, save file 
  135.  
  136. GET addr [DU:]filename <CR>
  137.  
  138.     Load file at (hex) address.    (foreground only)
  139.  
  140. JUMP addr <CR>
  141.  
  142.     Run program starting at addr.     (foreground only)
  143.  
  144. GO <CR>
  145.  
  146.     Run program at normal start addr (100h).
  147.     GO will re-run the last program, provided
  148.        it is re-executable.        (foreground only)
  149.  
  150. SAVE nn[H] [DU:]filename [S] <CR>
  151.  
  152.     Save memory (starting at 100h) to file.
  153.     nn = decimal number of pages (100h each).
  154.     nnH = Hex number of pages
  155.     if 'S', nn = decimal number of Sectors (80h each).
  156. :J
  157.      JOT - take notes 
  158.     (requires a loaded screendriver)
  159.  
  160. JOT <CR>
  161.  
  162.     Clear screen for taking notes.
  163.  
  164.     Use <DEL> to delete a character, and other commands as listed.
  165.     <CNTL-P> will paste the last-clipped region at the cursor.
  166.  
  167.     To exit, type the <SUSPEND> character.
  168.  
  169.     The screen is appended to the JOTPAD file.
  170.  
  171. JOT [DU:]filename <CR>
  172.  
  173.     Same, but append to the filename specified.
  174. :K
  175.      KEYS - Define, load, save, view, attach key strings 
  176.  
  177. KEYS [Du:]filename <CR>
  178.  
  179.     Load definitions from filename.BG.
  180.  
  181. KEYS <CR>
  182.  
  183.     Select from the menu:
  184.       D - Define a key
  185.       P - Paste last-cut region to key
  186.       R - begin Recording keystrokes
  187.       V - View current definitions
  188.       K - view single Key
  189.       S - Save current definitions to file
  190.       L - Load (previously-saved) key definitions
  191.       A - Attach definitions to program for auto-loading
  192.  
  193.  
  194.         Defining a key.
  195.  
  196. To define a numeric keypad key, first press that key,
  197. then enter keystrokes and terminate with the <SUSPEND> key.
  198.  
  199. To define a main keyboard key, first press the <ALT> key, followed
  200. by the key to be defined, e.g. "\a".
  201.  
  202. To erase a character, type <DEL>, or control-X to start over.
  203.  
  204. To enter hex characters, first type the '#' key.
  205.  
  206. To enter a special character literally (Quote it), first type control-Q.
  207.  
  208. If there is no screendriver, define the "r" key to be a screen-redraw
  209. string appropriate to the running task.
  210.  
  211.  
  212.         Pasting to a key.
  213.         (requires a loaded screendriver)
  214.  
  215. The Paste option uses the last-cut region to define a key. A
  216. carriage-return (^M) is added to the end of each row.  Edit as desired,
  217. and terminate with <SUSPEND>.
  218.  
  219.         Viewing definitions.
  220.  
  221. Use the View option to inspect the currently defined keys. The display
  222. starts and ends with a colon ':' in order to indicate any spaces
  223. included in the definition.
  224.  
  225. To view a single defined key, use the K option.
  226.  
  227.         Keystroke Recording.
  228.  
  229. Use the Record option to begin recording each keystroke. 
  230.  
  231. Recording is terminated by typing the previously-defined <RECORD>
  232. key, or the <SUSPEND> key.  Up to 255 keystrokes may be recorded.
  233.  
  234.         Saving definitions.
  235.  
  236. Definitions may be saved for re-use when re-running a program. The Save
  237. option requests a short descriptive label and a filename. Usually, it's
  238. convenient to use the name of the current program. The filetype is
  239. automatically set to ".BG ".
  240.  
  241.  
  242.         Loading definitions.
  243.  
  244. Definitions may be (manually) loaded by selecting the Load option and
  245. entering the filename of the definitions to use.  The newly- loaded
  246. definitions replace any previously loaded or defined strings.
  247.  
  248. Definitions can be automatically loaded whenever a particular program is
  249. run.  To use this feature, Save the desired definitions to a suitable
  250. filename.  Then select the Attach option, give the name of the program,
  251. and the name of the definitions file.  The next time the program is run
  252. these definitions will automatically be installed.
  253.  
  254.            Global and user-task definitions
  255.  
  256. When BGii is first loaded, it contains a short list of global
  257. definitions, which you can inspect by typing KEYS and then V.  GLOBAL
  258. definitions are available everywhere -- in Foreground and Background
  259. CP/M and in either user task.  You can add new definitions, save them,
  260. load others, etc. by using the KEYS command at Foreground CP/M level.
  261.  
  262. USER-TASK definitions are reserved for an active user task. To define
  263. keys for a particular program, once it is running, type <SUSPEND>, KEYS
  264. and D.  These definitions are in effect only while this task is active,
  265. not in Background CP/M and not in another task.  They expire when the
  266. program is exited, so if you want to preserve them you should <SUSPEND>,
  267. use KEYS and the Save command.  To cause them to be automatically loaded
  268. with the next use of that program, use the Attach command also.
  269.  
  270. If you use the same key for a user-task definition and a global
  271. definition, the user-task definition takes precedence while the task is
  272. active.  The global definition remains in hiding and takes effect
  273. everywhere else.
  274. :L
  275.      LIST and TYPE -  print or display a file 
  276.  
  277. LIST [DU:]filename <CR>
  278.  
  279.     Print file on printer.  Expands tabs to 8 spaces.
  280.  
  281. TYPE [DU:]filename <CR>
  282.  
  283.     Display file.  The menu on the top line summarizes the keys:
  284.  
  285.     . = down 1 line        , = up 1 line
  286.     > = down 1 page        < = up 1 page
  287.     B = beginning        E = end of file
  288.     R = scroll right    L = scroll left
  289.     G       =  goto = enter string to search for
  290.     1...9   =  move that many pages in current direction
  291.  
  292.     Automatically unSQueezes a compressed file (forward only).
  293.  
  294. :N
  295.    NDR (Named DiRectory) and OCP (Overlay Command Processor) 
  296.  
  297. NDR [DU:]filename <CR>
  298.  
  299.     Load  filename.NDR  as the Named DiRectory.
  300.  
  301. OCP [DU:]filename <CR>
  302.  
  303.     Load  filename.OCP  as the Overlay Command Processor.
  304.  
  305. :P
  306.      PEEK and POKE - examine and change memory 
  307.  
  308. PEEK addr1 [addr2]<CR>
  309.  
  310.     Display memory in hex and ascii from addr1 to addr2.
  311.     If no addr2, display approx. 256 bytes.
  312.  
  313. PEEK<CR>
  314.  
  315.     Resume memory display from last address.
  316.  
  317. POKE addr byte1 byte2 ... <CR>
  318.  
  319.     Change memory at addr to (hex) byte1 ...
  320.  
  321. POKE addr $string <CR>
  322.  
  323.     Change memory at addr to (ascii) string.
  324. :R
  325.      RESET or CNTL-C - reset disk system 
  326.  
  327. RESET <CR> or <CNTL-C>
  328.     
  329.     Close modified files, reset disk system, and
  330.     log in drive A: and current drive.
  331.  
  332.     Use this command to change disks.  Be sure the running
  333.     program has completed writing any open files.
  334.  
  335. :S
  336.      SWAP and FLIP - switch to/view alternate task 
  337.  
  338. SWAP <CR>
  339.  
  340.     Switch to the alternate task.  If no alternate is active,
  341.     switch to alternate CP/M.
  342.     
  343. FLIP <CR>        
  344.     (requires a loaded screendriver)
  345.  
  346.     Display screen of the alternate task.
  347.     The next keypress restores the active screen.
  348.  
  349. :T
  350.      TIME and DATE - display time and date  (requires DateStamper)
  351.  
  352. TIME <CR>                TIME ALL <CR>
  353.  
  354.     Display current time.            Display time and date.
  355.  
  356. TIME ON <CR>
  357.  
  358.     Turn on time display for CP/M prompts.     Example:   10:24 A0>
  359.  
  360. TIME ON S <CR>
  361.  
  362.     Turn on time display with seconds for CP/M prompts:   10:24:03 A0>
  363.  
  364. TIME OFF <CR>
  365.  
  366.     Turn off time display in prompts.
  367.  
  368. DATE <CR>
  369.  
  370.     Display current date.
  371.  
  372. :W
  373.      WHL and WHLQ - wheel byte, NOTE - command comment 
  374.  
  375. WHL <CR>
  376.  
  377.     Turn off "wheel byte."  When the wheel byte is off,
  378.     only non-private programs can be run.
  379.  
  380. WHL password <CR>
  381.  
  382.     Turn on "wheel byte".
  383.  
  384. WHLQ <CR>
  385.     
  386.     Report "wheel byte" status - ON or OFF.
  387.  
  388. NOTE comment <CR>
  389.  
  390.     Treat following text up to ';' or <CR> as a comment for the command.
  391.  
  392. :1
  393.          CALC - decimal/hex calculator 
  394. CALC <CR>
  395.  
  396. Enter digits (with optional decimal point in decimal mode)
  397. Enter operator:
  398.     +     add
  399.     -    subtract
  400.     X or *    multiply
  401.     /    divide
  402.     M or %    modulus (remainder),  hex mode only
  403.     N    negate (change sign)
  404.     =    final result
  405. Enter:
  406.     SA, SB or SC     to Store Entry in register A, B, or C.
  407.     RA, RB or RC     to Recall register value to Entry register.
  408.     Q        to Quit.
  409.     H        toggle between Hex and Decimal modes.
  410.  
  411. The final result (Entry register) can be recalled with
  412. the calc <RESULT> key definition (initially <ALT> a).
  413.  
  414. Register values are preserved from the previous use of CALC.
  415. :2
  416.      SCREEN - dump screen to printer or file 
  417.     (requires a loaded screendriver)
  418.  
  419. SCREEN <CR>
  420.  
  421.     List the current (user-program) screen on the printer.
  422.     Command is disabled if spooling is active.
  423.  
  424. SCREEN [DU:]filename <CR>
  425.  
  426.     Append the current (user-program) screen to the specified file.
  427. :3
  428.          SPOOL, FORMS and PRINTR 
  429.  
  430. To load the Spooler, run SPOOLER.  To queue files for printing, run Q.
  431.  
  432. SPOOL <CR>
  433. SPOOL ON <CR>
  434.  
  435.     Activate Spooler and send current list device output
  436.     to SPOOL.$PL file on swap drive, user 0.
  437.  
  438. SPOOL [DU:]filename <CR>
  439.  
  440.     Send list output to named file.
  441.  
  442. SPOOL OFF <CR>
  443.  
  444.     Deactivate Spooler and optionally rename output file.
  445.     List output now goes to list device.
  446.  
  447.  
  448. FORMS <CR>
  449.  
  450.     Show current forms setting for each list device.
  451.     If a form is set, the Spooler will only print files with
  452.     that form setting.  No setting is displayed as "-".
  453.  
  454. FORMS <device> <form> <CR>
  455.  
  456.     Set the <device> to use <form>, reactivate Spooler.
  457.  
  458.        <device> =    C for CRT:
  459.             L for LPT: (parallel printer)
  460.             T for TTY: (serial printer)
  461.             U for UL1: (serial printer)
  462.  
  463.        <form>   = a single character (e.g. 'L' for letterhead)
  464.  
  465. FORMS <device> <CR>
  466.  
  467.     Clear form setting for <device> to allow printing
  468.     all types of files.  Reactivate Spooler.
  469.  
  470. PRINTR <CR>
  471.  
  472.     Show current printer device, reactivate Spooler.
  473.  
  474. PRINTR <device> <CR>
  475.  
  476.     Set printer device ("iobyte"), reactivate Spooler.
  477.  
  478.        <device> =    C for CRT:
  479.             L for LPT: (parallel printer)
  480.             T for TTY: (serial printer)
  481.             U for UL1: (serial printer)
  482.  
  483. :4
  484.          SHIFT - toggle numeric keypad 
  485.         (requires a loaded functionkey driver)
  486.  
  487. SHIFT ON <CR>
  488.     
  489.     Shift keypad to accept and use BackGrounder ii definitions.
  490.  
  491. SHIFT OFF <CR>
  492.  
  493.     Put keypad in numeric mode.
  494. , L       LBRI- M