OASIS Command Referencedump |
dump - dump blocks of binary data to the terminal
dump [<starting block>] [<number of blocks>]
The dump command is used to access the contents of the log memory. Important Note: There is no way to interrupt the dump command; the dump can take a very long time depending upon the amount of data in the can and the terminal connection speed. You may wish to set the UserIF serial setup parameter to use a higher baud rate (19200 to 115200) before dumping a large amount of data.
The optional parameter <starting block> specifies which (typically 16K) block of memory at which to begin the dump. The optional parameter <number of blocks> specifies the number of memory blocks to dump. If no parameters are given, the entire log memory is dumped. If only the starting block is given, dump will dump all blocks after the starting block. dump will automatically access the hard drive if one is installed and if the requested blocks are located there.
The data returned will be UUENCODED binary data is the OASIS parameter ASCII is FALSE, and ASCII if TRUE. The value of the ASCII parameter may be set using the parm command.
The logs command may be used in conjunction with dump to obtain information about the log blocks.
If the symbol YMODEM is defined, the data is dumped using the YModem protocol. The user is prompted to initiate a YModem file receipt (e.g., using Hyperterm, click file>receive and select a directory and the YModem protocol). The file will be dumped to the selected directory; its name will be <file name>.<file number>, where filename will be specified in the YMODEM_FILENAME symbol defined in custom.h, and file number is set to the current value of ymodemFileNum (defined in ymodem.c). The file number is automatically incremented by OASIS each time a dump is performed; it may be changed using the parm command.
Dump blocks 16 to 20 inclusive:
dump 16 5
Dump all blocks from 12 on:
dump 12
Dump all blocks:
dump