home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 17 / CD_ASCQ_17_101194.iso / dos / fr / xtxtsnap / english / snapmem.doc < prev    next >
Text File  |  1994-09-18  |  4KB  |  101 lines
  1.                 SnapMem. User's manual.
  2.  
  3.     This resident program has been designed to take a "snapshot" of the
  4.     DOS memory (0 to 1 Mo) between the starting and ending addresses that
  5.     you can choose.
  6.     The activation hotkey can be set when launching.
  7.     The output can be the screen, a file or both.
  8.  
  9.     Syntax: SnapMem [/K=Msk...[-Msk][-Key]] [/B=Beginning] [/E=End]
  10.                      [/O=Output1[-Output2]] [/N=[Path]File name]
  11.                      [/A] [/H] [/U]
  12.  
  13.     The program does not make case distinction when reading the parameters
  14.     on the command line.
  15.  
  16.     WARNING : Parameters must be separated by a space.
  17.  
  18.     - Msk, Mask keys : RSH (right shift), LSH (left shift), CTL, ALT,
  19.       SYS ("System" key, on AT keyboard only), BRK ("Break" key), NUM
  20.       ("Numlock"), CPS ("Capslock"), INS ("Insertion").
  21.       You can activate any combination of keys.
  22.  
  23.     - Key : ASCII character, A to Z, digits 0 to 9 (on the numeric keypad
  24.       only) or function keys (F1 to F9).
  25.  
  26.       WARNING, this program has been designed for QWERTY keyboards. If you
  27.       have an AZERTY (French for instance) keyboard, some letters will be
  28.       misplaced (Alt-Q will be activated by Alt-A for instance).
  29.       There are two solutions :
  30.  
  31.           - Avoid letters which are not at the same place on both keyboards.
  32.           - Define Keyb, Fr and then switch on the keyboards type in typing
  33.             Ctl-Alt-F1 (American) or Ctl-Alt-F2 (French).
  34.  
  35.     - Beginning and End, numbers between 0 and 1048575 ($0 and $FFFFF).
  36.       Both notation (decimal and hexa) are correct.
  37.       These numbers are rounded modulo 256.
  38.  
  39.     - Output BF : Binary file, TF : Text file, SC : Screen. You can't
  40.       set both binary and text file at the same time. The output screen
  41.       will be displayed only if you are running in text mode. The width of
  42.       data display on the screen and the length of text file lines are set
  43.       to 64 characters.
  44.  
  45.     - Path + File name : defines the name of the memory dump file. This
  46.       parameter is used only if the option /O=BF or /O=TF is activated.
  47.  
  48.     - ASCII characters between $07 (Bell) and $13 (end of line) and the
  49.       $1A character (end of text file) are discarded when the output
  50.       is a text file (these characters are replaced by blank spaces).
  51.  
  52.       WARNING : If you wish to print the output file, don't forget to remove
  53.       the printer control characters (ASCII 0 to 31 + ASCII 127). In order
  54.       to do it, you can use the XTXT program that must be in the disk.
  55.  
  56.     - If the parameter /A is used, hexa addresses are displayed in front of
  57.       the data extracted from the memory.
  58.  
  59.     - The /H parameter displays a help screen which recalls SnapMem's
  60.       commands. In this case, the program is not launched.
  61.  
  62.     - The /U parameter removes SnapMem.
  63.  
  64.       Example : SnapMem /K=Ctrl-Alt-Y /B=65536 /E=$FFFC0 /O=TF-SC /A
  65.                         /N=C:\TEMP\MEMORY.TXT
  66.  
  67.  
  68.       Default settings : /K = Ctl-Alt-S
  69.                          /B = $00000  /E = $FFFFF
  70.                          /O = TF
  71.                          /N = Memory.Snp
  72.                          /A is not active.
  73.  
  74.       When activating the resident program, you can see the program's
  75.       progress with a bar-graph displayed on the screen. SnapMem saves and
  76.       restores the current screen when the text mode is active. If a
  77.       graphic mode is active, this feature is inhibited so that you cannot
  78.       see the dump's running even when the parameter /O=SC is on.  In that
  79.       case, you temporarily loose the control of your program until the
  80.       memory dump ends.
  81.  
  82.       WARNING : If you write on a faulty disk, the error which occurs
  83.       (you know : "Abort, Retry, Ignore") desactivates SnapMem. In this case, 
  84.       it is NECESSARY to reboot the PC (this problem will be solved one of 
  85.       these days, advices on how to deal with TSR's I/O errors are welcome).
  86.  
  87.  
  88.  
  89.                         ANNEX. Revision history.
  90.  
  91.  
  92.        Version 1.01.  September 1994.
  93.  
  94.            - The bug which occured when writing the dump file on a
  95.              protected disk has been fixed. Fatal bug when no disk (or
  96.              not formated one) was present in the drive has been fixed too.
  97.  
  98.            - Reduction of resident's memory size (58 K -> 30 Ko).
  99.  
  100.        Version 1.00. April 1994.
  101.