home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 16 / 16.iso / t / t480 / 1.ddi / EXE / NEWSTUFF.DOC < prev   
Encoding:
Text File  |  1991-04-01  |  8.2 KB  |  225 lines
  1.         LATE BREAKING INFORMATION ABOUT INSTALIT/MEDIABUILDER
  2.                  INSTALIT 2.09G+ - MediaBuilder 2.10+
  3.  
  4.  
  5.                            OUR FAX NUMBER
  6.  
  7. By fax, you can reach us at (205)881-7787.  See the Developer's Guide for
  8. details of our BBS.
  9.  
  10.                NEW MEDIABUILDER PVD [INSTALLER] WRINKLE
  11.  
  12. If you're running MediaBuilder version 2.1 or higher, you can include the
  13. following line inside PVDs in order to specify that a specific installer
  14. executable is the one which should be placed on the distribution media and
  15. renamed...that is...something other than INSTALIT as the source name.
  16.  
  17.   [Installer] installer_name as target_name
  18.  
  19.                  PROBLEMS WITH "INSERT DISKETTE FOR"
  20.  
  21. If you use BernoulliAsFixed and RequireFixed, you may find some extraneous
  22. requests for media insertion.  The only current solution is to not use
  23. BernoulliAsFixed.  You can also query whether any Bernoulli drives are
  24. present and use the new DefineDrive instruction described below.
  25.  
  26.                      NEW ASPECTS FOR FULLPATHTO
  27.  
  28. FullPathTo works with both string and directory variables.  For example:
  29.  
  30.   [DirX] := FullPathTo file_name_with_no_path {PathOnly}
  31.   [StringX] := FullPathTo file_name_with_no_path {PathOnly}
  32.  
  33. Since INSTALIT normally looks first in the current directory and the current
  34. directory is not always known, the PathOnly keyword causes INSTALIT to search
  35. the path only, including the current directory only if it is on the path.
  36.  
  37. FullPathTo now gives the full path even when Novell returns something like
  38. Z:.\XYZ.
  39.  
  40.                        A NOTE ABOUT ZERO-BYTE FILES
  41.  
  42. It's sometimes advantageous to include files with zero size in your
  43. distribution builds.  INSTALIT and MediaBuilder can handle those situations
  44. just fine.  You should adhere to one rule, however.  Don't make those zero
  45. byte files the last ones in your PVD;  that almost certainly prevents them
  46. from being the last ones on any given distribution diskette.
  47.  
  48.                               ERRATA
  49.  
  50. Page 51 of the version 2.0 Developer's Guide erroneously lists full paths
  51. in the "FURTHER EXAMPLES" section.  As correctly stated above on that page,
  52. no paths are allowed.
  53.  
  54. Page 202 incorrectly states that BINMOD searches from the end by default.
  55. BINMOD searches from the beginning by default.
  56.  
  57.                       NEW THERMOMETER ACTION
  58.  
  59. In order to prevent excessive flashing on the screen, the extraction
  60. progress indicator for single files is now inactive when the file size
  61. is less than 10K bytes.
  62.  
  63. The thermometer now has a new display mode.  Try this out:
  64.  
  65.    GetQuedFiles ShowJustOne
  66.  
  67.                           CHANGE TO BINMOD
  68.  
  69. BINMOD.EXE has been changed to allow you to specify up to 50 rather than
  70. 25 bytes for the ID string.  **YOU** must assure that the DOS command line
  71. length limit isn't exceeded, however.
  72.  
  73. BINMOD now allows you to search for a limited length.  To do so, use
  74. "-L" followed by the customary hex or decimal representation of the search
  75. length in bytes.
  76.  
  77.                    USING DOSVERSION AND EMSVERSION
  78.  
  79. Since DOSVersion and EMSVersion both return real numbers, the usual
  80. assignment to [NumberX] variables isn't feasible.  These two functions
  81. both work fine with If statements, however, allowing you the decision
  82. making power you need to control your scripts.
  83.  
  84. NEW INSTRUCTIONS
  85.  
  86.   ForceError   ;; Force unrecoverable error and thus show
  87.                ;; the info set by SetSupportInformation
  88.                ;; Useful in test mode.
  89.   If CompletionStatus = Finished|Unfinished|DontCare
  90.      ;; see SetCompletionStatusTo
  91.   If MediaIsFormatted <drive>
  92.   If MediaIsWriteProtected <drive>
  93.   If MediaIsEmpty <drive>
  94.   If DirectoryIsEmpty directory_name  ;; directory contains no subdirs or files
  95.       ;; NOTE (FileExists C:\DIR\*.* returns false if subdirs but no files)
  96.  
  97.   DeleteDirectory directory_name  ;; only mode is "quietly"
  98.     ;; Make sure directory is empty before calling to assure that no
  99.     ;; files present spur a "do you wanna" request.
  100.     ;; If any subdirs are present, error will occur.
  101.     ;; No wildcards allowed.
  102.  
  103.   UnQueFiles
  104.     list_of_files
  105.   EndUnqueFiles
  106.  
  107.   UnQueFileGroup group_number ;; unqueues any file which belongs to the group
  108.  
  109.   UnQueAllFiles
  110.  
  111.   SetAllowExit On|Off   ;; disable <ctrl+x> (and during extraction, exit keys)
  112.  
  113.   SetReadOnlyInquiry On|Off   ;; disable automatic inquiry about readonly file
  114.                               ;; replacement
  115.  
  116.   SetClearScreenOnExit On|Off    ;; optionally clear screen on return to DOS
  117.  
  118.   SetExitMessageTo one_line_message  ;;message displays after return to DOS
  119.  
  120. NEW DEFINEDRIVE INSTRUCTION
  121.  
  122. For those networks such as DEC PCSA which return erroneous information about
  123. the local/remote and fixed/removeable status of network drives, the new
  124. DefineDrive instruction can assist in handling the situation.  Basically,
  125. if the Network function returns true and NovellLoaded returns false and
  126. your custom dialog box finds out that the network is a PCSA, you can use
  127. the DefineDrive instruction and a little more logic to correctly note the
  128. true status of the drive.  The fixed/removeable issue is important when it
  129. causes INSTALIT to ask for insertion of a new media into a fixed drive.
  130.  
  131. Here's the DefineDrive syntax:
  132.  
  133.   DefineDrive drive_letter {LOCAL|REMOTE} {FIXED|REMOVEABLE|ABSENT}
  134.  
  135.           For example:
  136.  
  137.             DefineDrive J local removeable
  138.             DefineDrive InstallationDrive Remote
  139.             DefineDrive D absent
  140.  
  141.  
  142. NEW MATH PROCEDURES
  143.  
  144. You can now do addition/subtraction in the following way:
  145.  
  146.     [NumberX] := - [NumberY] + 200000 - 2,365 + [NumberZ]
  147.     [NumberX] := [NumberY] + 200000 - 2,365 + [NumberZ]
  148.  
  149. Note that operators must be preceded and followed by space characters.
  150.  
  151.  
  152. NEW ADDRESSOF FUNCTION
  153.  
  154.   [StringX] := AddressOf [StringY]
  155.  
  156. This instruction can be useful to pass the memory address segment:offset
  157. of a string variable to a child process.  The strings are stored with a
  158. length byte followed by the characters of the string.
  159.  
  160. After this function executes, [StringX] will contain a string of the form
  161.  
  162.    HHHH:HHHH
  163.  
  164. where H is a hexidecimal digit.  Zeros are left padded as necessary.
  165.  
  166.  
  167. NEW CURRENTDIRECTORY FUNCTION
  168.  
  169. INSTALIT doesn't make use of the concept of the current directory, instead
  170. referring to all files as full paths.  Note that this statement doesn't mean
  171. that you can't specify relative paths in your PVD and script.
  172.  
  173. The ChangeDirectoryTo instruction allows you to set the directory prior to
  174. running a self-extracting file, for example.
  175.  
  176. Under certain circumstances it's also desirable to be able to access the
  177. name of the current directory...perhaps that set by a child process which
  178. ran.  The new CurrentDirectory function fills this need.  The syntax is as
  179. follows:
  180.  
  181.    [DirX] := CurrentDirectory
  182.  
  183. The function returns a full path.
  184.  
  185. NEW PROCEDURES USEFUL FOR FLOPPY INSTALLATIONS
  186.  
  187. INSTALIT/P (the Pascal version) now supports installation to and from the
  188. same floppy drive.  The following new instructions and new optional
  189. instruction line switches are useful for floppy installations.  Some of
  190. them may also have some application for dynamic mapping of large products onto
  191. multiple fixed drives.
  192.  
  193.   DefineMedia
  194.     list_of_media
  195.   EndDefineMedia
  196.  
  197.      for example:  DefineMedia
  198.                      Program Disk 1   ;; Media number 1
  199.                      Program Disk 2   ;; Media number 2
  200.                      Utilities Disk   ;; Media number 3
  201.                        .
  202.                        .
  203.                    EndDefineMedia
  204.  
  205.   QueFiles OntoMedia media_number
  206.     file_list
  207.   EndQueFiles
  208.  
  209.   QueFileGroup group_number OntoMedia media_number
  210.  
  211.   QueAllFiles OnToMedia media_number
  212.  
  213.   [NumberX] := SizeOfQueForMedia media_number
  214.   [NumberX] := MediaCount  ;; number defined via DefineMedia
  215.   [NumberX] := SizeOfGroup
  216.  
  217.   GetQuedFiles ForMedia media_number
  218.     ;; default is get for all media...autopilot mode...automatic
  219.     ;; destination media insertion requests
  220.  
  221.   GetQuedFiles NoInsertionPrompt  ;; don't ask for insertion of destination
  222.                                   ;; media for first destination media
  223.  
  224.   GetQuedFiles RequireEmpty       ;; Require that each floppy be empty
  225.                                   ;; on first insertion