home *** CD-ROM | disk | FTP | other *** search
/ Shareware 1 2 the Maxx / sw_1.zip / sw_1 / DISK_UTL / WIZ251.ZIP / CALL_WIZ.ZIP / CALL_WIZ.DOC < prev    next >
Text File  |  1991-09-18  |  2KB  |  62 lines
  1.  
  2.                 CALL_WIZ.DOC
  3.                 ------------
  4.                by Ray Van Tassle
  5.                1020 Fox Run Lane
  6.              Algonquin, Ill, 60102
  7.                 (708)-658-4941
  8.                    September, 1991
  9.  
  10.     WIZ can be used by another program to do file finding. This
  11.     could be particularly useful for a disk viewer, such as
  12.     XTREE, QFILER, and others.
  13.  
  14.     In this mode, instead of typing out the filenames, WIZ will
  15.     copy the strings to a memory buffer specified by (and in) the
  16.     calling program.  In this mode, WIZ won't type out anything
  17.     (except error messages), so it will be invisible to the user.
  18.  
  19.     WIZ may be called either directly (via the DOS EXEC function),
  20.     or by spawning via COMMAND.COM.  An example program showing
  21.     how to call WIZ is included in this distribution.
  22.  
  23.  
  24.     The calling program gives WIZ it's PSP (program segment
  25.     prefix) with the "-z" switch.  WIZ makes some checks to verify
  26.     that this is a valid PSP.  Then it looks in the memory block
  27.     for the signature of the inter-task-communication (ITC) block. 
  28.     The ITC must be in the first 64KB of the program (following the 
  29.     PSP).
  30.  
  31.     The calling program can make the ITC as large as it wants.
  32.     It specifies the size as the 1st word of the ITC.  Upon return
  33.     from WIZ, the 1st word has the number of strings that WIZ
  34.     put into the ITC.  The next byte contains a character to tell
  35.     the caller if WIZ was able to store all the strings that it 
  36.     wanted to in the ITC. (Period (.) is so, plus (+) if not--plus 
  37.     meaning "there was more, but I couldn't fit it all".)
  38.  
  39.  
  40.     Starting with the 4th byte, WIZ puts the strings as ASCIZ--the 
  41.     same way that environment strings are stored.  The last string 
  42.     is terminated with two NULL characters.
  43.  
  44.     All the other switches to WIZ still work, and perform their 
  45.     usual function.  You probably would not want to give either the 
  46.     "-g" option, or "-cdel*".  To get just the filenames (including 
  47.     disk and path), you would need to give "-p".
  48.  
  49.     ========================================
  50.  
  51.     Permission is hereby granted for anybody to include a call to 
  52.     WIZ from another program, and to distribute WIZ along with 
  53.     their program, provided that the complete WIZ distribution 
  54.     package is included (executables, example source code, and 
  55.     documentation).
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.