              I       .       M       .       S       .
 
   I N D U S T R I A L   M I C R O C O M P U T E R   S Y S T E M S
 
   
 
 
P. O. B. 6305, HAIFA, 31 062, ISRAEL.
TEL: ++972-4-8110877
FAX: ++972-4-8110875
 

 
  DLOAD UTILITY                                                  September '95
                                                    
(Revised June '07)
 
  GENERAL DESCRIPTION
  

  DLOAD (Down LOAD calibration) utility's operation is similar to the
  function "restore file" of the calibration utility (LCIC). The advantage
  of DLOAD is that it doesn't require manual interaction, thus available
  during automated process, where human involvement is unacceptable.
  The utility, however, reports its course to the caller, enabling him to
  flow accordingly. The "caller" may be either a batch file or a program,
  as demonstrated by the examples supplied.

  The package includes the following files:
  1. DLOAD.TXT - This document file.
  2. DLOAD.EXE - The DLOAD utility.
  3. DL.BAT -    A batch file example invoking DLOAD.
  4. EX01.C -    A C program  example invoking DLOAD.


  USAGE
  
 
  DLOAD  <i>  <name>
  <i>    card number - 1, 2, etc.
  <name> required calibration name (case insensitive)

  Upon successful operation, DLOAD returns the card to the same mode as it
  was before. Specifically, If the card was initialized, DLOAD turns it
  again to that mode after completing the "restore" operation. The mode
  "preservation" enables to invoke DLOAD by USER'S PROGRAM, or DOS command
  line, advancing with user's application. The files EX01.C and DL.BAT
  illustrate how to invoke DLOAD by user's program and by a batch file,
  respectively.

  RETURN CODE
  
 
  By its completion, DLOAD reports its course to the caller, enabling him to
  flow accordingly. The report is supplied by a "return code", which is passed:
  * Through the "ERRORLEVEL" when the caller is a batch file.
  * Through routine's return value when the caller is a program (in EX01.C
    example program it's the value returned by "spawnl").
  There are three categories of return codes:
  * Successful operation.
  * Non critical error - DLOAD failed to carry out the specified request,
    but no worsening in card's state.
  * Critical error - DLOAD failed to turn the card into a normal state.
    User should hardware reset the PC and run LCIC.
  Refer to the following "return codes list".

 RETURN CODES LIST
 
 
 CODE NAME (1)    CODE VALUE  (2)       CODE DESCRIPTION

NO_ERRORS              0         NO errors (success).
ERR_ARGUMENT           1         Illegal number of arguments.
ERR_SEGMENT            2         Missing or illegal SEGn file.
ERR_CARD_UNCALIBRATED  4       C Uncalibrated card.
ERR_SOFT_VERSION       5         Incorrect card version. The utility
                                 supports LCIC card versions 10, 11 & 12.
ERR_IN_LIST_FILE       6         LISTn.SET file read error.
ERR_NO_CALIBRATION     7         Specified calibration not found.
ERR_COMMUNICATION      8       C Card communication failure.
ERR_CARD_RESPONSE      9       C No response from the card upon
                                 exiting calibration transfer.
ERR_READ_PARAMS       10       C No response from the card upon
                                 reading calibration parameters.
ERR_WRITE_SETUP       11         LISTn.SET file write error.
ERR_INIT_FAILED       12       C Initialization failed -
                                 Hardware error or incorrect card address.
ERR_FINISH_FAILED     13       C Can't finish the card.
ERR_MEMORY_ALLOC      14       C DOS memory allocation error.
ERR_MAGAZINE_FILE     15       C MAGn.SET: magazine file error.
 
 
NOTES

 
1. The CODE NAME is the same symbol used in the "define" satatements of EX01.C.
2. "C" in this column specify a Critical error (refer to "Return Code" section).
