home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / network / lad2 / lad2st11.txt < prev   
Text File  |  1993-04-30  |  11KB  |  259 lines
  1. LAD/2 TO START 1.1 BRIDGE APPLET (LAD2ST11.CMD VERSION 1.1)
  2. -----------------------------------------------------------
  3.  
  4. INTRODUCTION
  5. ------------
  6.  
  7.      The LAD2ST11.CMD applet converts clients defined in a LAD/2
  8. workgroup into IBM LAN NetView Start 1.1 migration files.  (A single
  9. client from a workgroup can also be specified.)  These files can be
  10. dragged from an OS/2 directory folder and dropped on a Start topology
  11. container to have LAD/2 clients represented in Start.  This applet
  12. does not modify any of the LAD/2 data files.
  13.  
  14.      After using LAD/2, you can then use Start to modify your product
  15. parameters; tune your configuration parameters for LAN Server,
  16. Database Manager, and Communications Manager; and generate the
  17. response files, LCU command files, and/or NetView DM/2 change files to
  18. update the products on your workstation.
  19.  
  20.      LAD2ST11 has the following parameters:
  21.  
  22.           Parameters:
  23.              /LADPATH=source pathname of the LAD/2 main directory
  24.              /CUSTNAME=customer name
  25.              /WGNAME=workgroup name
  26.              /USERNAME=user name (or client name)
  27.                 (optional - if not specified, all the users in the
  28.                 workgroup are migrated)
  29.              /OFILE=fully qualified override file name
  30.                 (optional - if not specified, no node, LAN adapter, or
  31.                 LAN Server parameters will be overridden)
  32.              /MIGPATH=target pathname of an existing directory for the
  33.                 generated Start migration files
  34.                 (optional - defaults to the current directory)
  35.  
  36.      The following example generates Start 1.1 migration files for all
  37. the clients in the sales workgroup for the market customer.  LAD2ST11
  38. will expect the LAD/2 EXTD.TBL, LAPS.TBL, LS30.TBL, AND RECEIVER.TBL
  39. data files to be stored in the y:\lad2\market\sales\ directory, and it
  40. will expect the LAD/2 WORKGRP.TBL data file to be stored in the
  41. y:\lad2\ladcode\ directory.  (LAD/2 always stores the WORKGRP.TBL in
  42. the LADCODE subdirectory.)  The generated migration file will be
  43. stored in the current directory, overwriting any old versions of the
  44. files.
  45.  
  46.    lad2st11 /ladpath=y:\lad2\ /customer=market /wgname=sales
  47.  
  48.      The applet migrates many of LAD/2's configuration parameters.
  49. Both DFT and non-DFT sessions are included in the migration file, as
  50. well as information on LAN Server, local node names, LAN adapters,
  51. etc.  Information that had to be defaulted, modified, or extrapolated
  52. during the bridging process will be logged.
  53.  
  54. OVERRIDE FILE
  55. -------------
  56.  
  57.      Users can specify an override file that replaces values in the
  58. generated migration files, whether to override a default value or a
  59. migrated value drawn from the LAD/2 data tables.  The override file
  60. applies to all the migration files generated during a single
  61. invocation.  You can limit the override file to a single client if you
  62. include the /USERNAME= parameter in your LAD2ST11 invocation.  Users
  63. can specify the same or a different override file each time the applet
  64. is run.
  65.  
  66.      The override file allows users to specify the following:
  67.  
  68.    * For Node information *
  69. DBType           /* req, svr, local, or stop */
  70. LANType          /* req, svr, dom, or stop */
  71. EMType           /* dft, lan or dft lan */
  72. DEFLOCALCP       /* 1-8 SNA characters */
  73. CPALIAS          /* 1-8 SNA characters */
  74. BootDrive        /* 1=A, 2=B, 3=C, etc. */
  75. DBInstalled      /* 1=A, 2=B, 3=C, etc. */
  76. CMInstalled      /* 1=A, 2=B, 3=C, etc. */
  77. LANInstalled     /* 1=A, 2=B, 3=C, etc. */
  78. MachineType      /* 4 alphanumeric chars */
  79. MachineNum       /* 3 alphanumeric chars */
  80. MfgPlant         /* 2 alphanumeric chars */
  81. SerialNum        /* 7 alphanumeric chars */
  82. WKSTComment      /* 1-60 characters */
  83. NodeID           /* 5 hex characters */
  84.  
  85.    * For LAN Adapter information *
  86. AdapterType      /* token ring i, token ring ii, token ring /a,
  87.                  token ring 16/4, token ring 16/4 /a, tr-unknown,
  88.                  bus master token ring, ibm ethernet /a,
  89.                  3comethermc, ungermann-bass niups2, or
  90.                  wd ethercard plus /a */
  91. AdapterSpeed     /* 4 or 16 (for token ring connections) */
  92. LocalAdminAdd    /* 12 hex characters */
  93. EMDestAdd        /* 12 hex characters */
  94. EMRUsize         /* 4 digit number */
  95. CSMLANID         /* 1-8 SNA characters */
  96. EthernetType     /* 802.3 or DIX */
  97.  
  98.    * For LAN Server/Requester information *
  99. DomainName       /* 1 - 8 characters from the LAN Character Set */
  100. COMPUTERNAME     /* 1 - 8 characters from the LAN Character Set */
  101. FileAccessMode   /* 1 - 12  (if < 3, random; = 3, mixed; > 3
  102.                  sequential) */
  103.  
  104.      The override file format is of the form:
  105.  
  106. keyword1        value1
  107. ...
  108. keywordN        valueN
  109.  
  110.      There must be at least one white space between the keyword and
  111. value.  The keyword is not case sensitive, however, the value is.  If 
  112. duplicate keywords are specified, the value of the last specified 
  113. keyword will be used.  The LAD2ST11 applet will not check to see if 
  114. the specified values are in the valid range for the parameter or match 
  115. the correct format.  Start will check the values when the file is 
  116. migrated into a topology.  
  117.  
  118.      For example, if the following override file was specified with:
  119.  
  120. WKSTCOMMENT    My comment.
  121. EMRUsize       1000
  122. FileAccessMode
  123.  
  124.      The following values would be changed and logged in the generated
  125. migration files:
  126.  
  127. Overriding WKSTComment old value ' ' with new value 'My Comment.'.
  128. Overriding EMRUsize old value '1920' with new value '1000'.
  129. Overriding FileAccessMode old value '3' with new value ' '.
  130.  
  131.      Since the override values apply to all the generated migration
  132. files produced by an invocation of the applet, double check to insure
  133. that the following keywords should be applied to all the clients in
  134. your workgroup:  DEFLOCALCP, CPALIAS, NodeID, LocalAdminAdd,
  135. EMDestAdd, CSMLANID, DomainName, and COMPUTERNAME.  Certain values,
  136. such as COMPUTERNAME, should be unique to each workstation.
  137.  
  138. OCUNODE
  139. -------
  140.  
  141.      An alternate means of generating Start migration files is to run
  142. OCUNODE on each of the client machines on which LAD/2 has installed
  143. products.  OCUNODE.EXE is the Start discovery program that derives
  144. information about the workstation and places it into the created
  145. migration file.  An advantage of using the OCUNODE program is that it
  146. will retrieve additional information that LAD2ST11 cannot, such as the
  147. machine type and workstation comment, however, with LAD2ST11, you can
  148. create your migration files from a single workstation using the
  149. information stored in the LAD/2 data tables.
  150.  
  151. LAD/2 -> START MAPPINGS
  152. -----------------------
  153.  
  154.      The following lists the section parameters in the Start migration
  155. file, their defaults, and how they were derived from the LAD/2 tables.
  156. It is not recommended that you directly change the Start 1.1 migration
  157. file.  For more information on the migration process, please consult
  158. the IBM LAN NetView Start 1.1 User's Guide.  LAPS configuration data, 
  159. OS/2 Service Pack, and application information are not migrated to 
  160. Start.
  161.  
  162. *NODE*
  163. <always present in the migration file>
  164. EMAdapterNum      (default - 3)
  165. DBType            Database Manager functionality (default - stop)
  166.                   (Note:  If requester/server, value is server.)
  167. LANType           LAN Server/Requester functionality (default - stop)
  168.                   (Note:  All servers are bridged as entry servers. 
  169.                   Backup domain controllers are bridged as 
  170.                   servers too.)
  171. EMType            Communications Manager functionality 
  172.                   (default - stop)
  173. GWType            (default - <blank>)
  174. EMDFTSess         #dft terminal and printer sessions (default - 0)
  175. EMNDFTSess        #non-dft terminal and printer sessions (default - 0)
  176. DEFLOCALCP        local node name (default - nodename)
  177. CPALIAS           local node alias (default - nodename)
  178. OSversion         (default - os/2 2.0)
  179. BootDrive         OS/2 install drive (default - 3)
  180. DBInstalled       Database Manager install drive (default - 0)
  181. CMInstalled       Communications Manager install drive (default - 0)
  182. LANInstalled      LAN Server/Requester install drive (default - 0)
  183. MachineType       (default - 0000)
  184. MachineNum        (default - 000)
  185. MfgPlant          (default - 00)
  186. SerialNum         (default - 0000000)
  187. StartDFTSess1     dft session 1 name if autostart (default - <blank>)
  188. StartDFTSess2     dft session 2 name if autostart (default - <blank>)
  189. StartDFTSess3     dft session 3 name if autostart (default - <blank>)
  190. StartDFTSess4     dft session 4 name if autostart (default - <blank>)
  191. StartDFTSess5     dft session 5 name if autostart (default - <blank>)
  192. StartNDFTSess1    non-dft session 5 name if autostart (default -
  193.                   <blank>)
  194. StartNDFTSess2    non-dft session 5 name if autostart (default -
  195.                   <blank>)
  196. StartNDFTSess3    non-dft session 5 name if autostart (default -
  197.                   <blank>)
  198. StartNDFTSess4    non-dft session 5 name if autostart (default -
  199.                   <blank>)
  200. StartNDFTSess5    non-dft session 5 name if autostart (default -
  201.                   <blank>)
  202. WKSTComment       (default - <blank>)
  203. NodeID            local node ID (default - <blank>)
  204.  
  205. *EMDFTPARMS*
  206. <one for each non-DFT session if Communications Manager is installed
  207. and if DFT adapter is type 3>
  208. SessionNum        session number
  209. SessionType       session type (1 - terminal, 2 - printer)
  210. SessShortID       session short ID
  211. PresSpace         session presentation space (1 - 5)
  212. PresSpaceRow      (default - <blank>)
  213. PresSpaceCol      (default - <blank>)
  214. SessionName       session name
  215.  
  216. *EMNONDFTPARMS*
  217. <one for each non-DFT session if Communications Manager is installed>
  218. SessionNum        session number
  219. SessionType       session type (1 - terminal, 2 - printer)
  220.                   (default - 1)
  221. SessShortID       session short ID
  222. PresSpace         session presentation space size (1 - 5)
  223.                   (default - 2)
  224. PresSpaceRow      (default - <blank>)
  225. PresSpaceCol      (default - <blank>)
  226. LUName            session name
  227. LULocalAdd        session NAU
  228. ForAdapter        (default - 0)
  229. AdapType          (default - LAN)
  230.  
  231. *ADAPTER*
  232. <included for DFT type 3 adapter>
  233. AdapterNum        (default - 3)
  234. AdapterType       (default - dft 3270)
  235.  
  236. *ADAPTER*
  237. <included for LAPS adapter>
  238. AdapterNum        (default - 0)
  239. AdapterType       adapter type
  240. AdapterSpeed      (default - 4)
  241.                   (Note: Only present for token ring with speeds)
  242. LocalAdminAdd     locally administered address
  243.                   (default and UAA - 000000000000)
  244.                   (prefixed with an I if an ethernet address or
  245.                   T if a token ring address)
  246. EMDestAdd         adapter destination address
  247. EMRUsize          (default - 1920)
  248. CSMLANID          network ID (default - CASMID)
  249. EthernetType      802.3 or DIX (default - 802.3)
  250.                   (Note: Only present if ethernet adapter)
  251.  
  252. *LANSRPARMS*
  253. <included for LAN Server>
  254. AdapterNum        (default - 0)
  255. DomainName        domain name
  256. COMPUTERNAME      machine name
  257. FileAccessMode    (default - 3)
  258.  
  259.