home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / lansystk.zip / MPTSUTIL / README.UTL
Text File  |  1998-05-08  |  49KB  |  1,114 lines
  1. **********************************************************************
  2. README.UTL for Multi-Protocol Transport Services               10/13/95
  3.  
  4.                           Table Of Contents
  5.  
  6. SECTION 1: Applets
  7.          1.1 - NBJDSTAT
  8.          1.2 - DTF4
  9.          1.3 - MCL
  10.          1.4 - SNIFFLE
  11.          1.5 - NETPING
  12.          1.6 - LAPSDUMP
  13.          1.7 - MAPNAME
  14.          1.8 - CASSETUP
  15.          1.9 - OS2SNIFF
  16.          1.10 - NB64K
  17.          1.11 - NETTRACE
  18.          1.12 - XTRACE
  19.          1.13 - HOSTID
  20.  
  21. SECTION 2: Toolkit Files for Developers
  22.  
  23. SECTION 3: LAN CID Utility
  24.          3.1 - NEW CID RETURN CODES
  25.          3.2 - Warp Server LCU CID Installation from CD-ROM
  26.  
  27. ===============================================================================
  28. SECTION 1                       APPLETS
  29.  
  30.     The APPLET directory contains 13 MPTS utilities.  These applications
  31.     are supplied "as is" and IBM does not provide any support for these
  32.     programs.
  33.  
  34.  
  35. 1.1 - NBJDSTAT
  36.  
  37.     NBJDSTAT issues a NETBIOS STATUS command for either a local or remote
  38.     workstation and displays the NCB STATUS information to the screen.
  39.     NCB.STATUS information can be useful when you are doing system
  40.     configuration and application debug.  It includes such information as
  41.     the adapter's encoded address, the NetBIOS release number, and the local
  42.     name  table. For more information on the status command, see the
  43.     "IBM LAN Technical Reference" (SC30-3383-XX), Chapter 4.
  44.     NetBIOS must be loaded before this utility can produce meaningful results.
  45.  
  46.     NBJDSTAT is case sensitive and the command line options are:
  47.  
  48.  Usage:nbjdstat remote_name options
  49.  
  50.      remote_name:NETBIOS name to find(length: 16 characters [case sensitive])
  51.         If the name is less than 16 characters, blanks(0x20) are appended.
  52.         * specifies local name.
  53.      options:
  54.         /a  :specifies adapter to use (default:0) - valid:0,1,2,3
  55.         /h  :intrepet value as hex value and append to remote name
  56.              example: SERVER1 /h20
  57.              entire remote name may be specified as hex value
  58.              example: /h41555320202020202020202020202020
  59.         /m  :to make the name as IBM LS messager name
  60.         /n  :to append 0x00 to the name up to 16 characters
  61.         /q  :to make the name as IBM LS requester name
  62.         /v  :to make the name as IBM LS server name
  63.         /rxy:to make the name as IBM DB2/2 requester name
  64.              x can be: s(sql name); i(interrupt name)
  65.              y can be: 0(adapter 0); 1(adapter 1)
  66.         /sxy:to make the name as IBM DB2/2 server name
  67.              if x: is c(catcher name))
  68.              y can be: 0(adapter 0); 1(adapter 1)
  69.              if x: is b(callback name)
  70.              y can be: p(primary adapter); s(secondary adapter)
  71.  
  72.     An example of its use for the local workstation's NetBIOS Status is:
  73.                     nbjdstat *
  74.  
  75.     An example of its use for LS Server NetBIOS name SERVER1 and redirecting
  76.     the output to a file, is:
  77.                     nbjdstat SERVER1 /v > nbjdstat.out
  78.  
  79.  
  80. 1.2 - DTF4
  81.  
  82.     DTF4 formats LAN trace points from TRACEFMT output.  This information
  83.     can be useful when you are debugging LAN applications.  The following
  84.     statements must be in CONFIG.SYS before you can use the system trace
  85.     utility:
  86.  
  87.            TRACEBUF=63
  88.            TRACE=ON 164
  89.  
  90.     You can then use TRACEFMT to produce a file containing the trace
  91.     information.  After you have successfully saved the system trace
  92.     information into a file, you can use DTF4 to format the LAN trace data
  93.     into a readable format.  For more information on TRACEFMT, on OS/2 1.3
  94.     systems issue HELP TRACEFMT on the command line.  On OS/2 2.x systems,
  95.     enter TRACEFMT on the command line.  Then select HELP from the action
  96.     bar. NOTE !! when using OS/2 2.x TRACEFMT, you *MUST* save the output
  97.     as FORMATTED. (see TRACEFMT help for more information)
  98.  
  99.     An example of its use for the system trace information file
  100.     TRACEFMT.SAV would be to type the following at an OS/2 command prompt:
  101.  
  102.                   DTF4 tracefmt.sav > tracefmt.dtf /T
  103.  
  104.     The /T parameter provides the ASCII interruption of the transport frames.
  105.  
  106.  
  107. 1.3 - MCL
  108.  
  109.     MCL outputs the microcode level and adapter address of up to four
  110.     Token Ring adapters.  This utility provides a quick way to
  111.     determine the microcode level  as well as the universal and encoded
  112.     adapter addresses for IBM Token Ring adapters.  802.2 support (LANDD.OS2)
  113.     is required for this program.
  114.  
  115.  
  116. 1.4 - SNIFFLE
  117.  
  118.     SNIFFLE is a stand alone utility that is intended to aid in the
  119.     development of network information files (NIFs).  Invoked against
  120.     one or more NIFs, SNIFFLE ensures that the NIF sections, keywords, and
  121.     values are consistent both with the extended NIF format definition
  122.     and with each other.  For more information on the extended NIF format
  123.     definition, see the "IBM OS/2 NDIS Driver Implementation Package".
  124.     If an error is detected, SNIFFLE indicates the location of the error
  125.     and provides a description of the error condition.
  126.  
  127.     An example of its use for the IBMTOK.NIF would be to type the following
  128.     at an OS/2 command prompt.
  129.  
  130.                         SNIFFLE IBMTOK.NIF
  131.  
  132.  
  133. 1.5 - NETPING
  134.  
  135.  
  136.     NETPING is a NetBIOS utility that executes a NETBIOS NCB.FIND.NAME.
  137.     Command line options provide the capability of searching for various
  138.     application's NetBIOS names, such as LAN Server and DB2/2.
  139.     If the NetBIOS name is present on the LAN, the following information
  140.     will be displayed:
  141.  
  142.          - NetBIOS name type
  143.          - Node Address
  144.          - Routing Information (if name was not found on local segment)
  145.  
  146.     NETPING is case sensitive and the command line options are:
  147.  
  148.            /a  :specifies adapter to use (default:0)
  149.                 valid adapter: 0,1,2,3
  150.            /m  :to make the name as IBM LS messager name
  151.            /n  :to append 0x00 to the name up to 16 characters
  152.            /q  :to make the name as IBM LS requester name
  153.            /v  :to make the name as IBM LS server name
  154.            /rxy:to make the name as IBM DB2/2 requester name
  155.                 x can be: s(sql name); i(interrupt name)
  156.                 y can be: 0(adapter 0); 1(adapter 1)
  157.            /sxy:to make the name as IBM DB2/2 server name
  158.                 if x: is c(catcher name))
  159.                 y can be: 0(adapter 0); 1(adapter 1)
  160.                 if x: is b(callback name)
  161.                 y can be: p(primary adapter); s(secondary adapter)
  162.  
  163.     An example of its use for LS Server NetBIOS name SERVER1, searching on
  164.     adapter 1 is:   netping SERVER1 /a1 /v
  165.  
  166.  
  167. 1.6 - LAPSDUMP
  168.  
  169.  
  170.     LAPSDUMP is an utility that extracts memory segments from the LAN Adapter
  171.     and Protocol Support (LAPS) modules and formats/dumps that memory.
  172.     The command options for LAPSDUMP are:
  173.  
  174.          /fl     : format the LANDD (802.2) memory segments
  175.          /fn     : format the NETBEUI/NETBIOS memory segments
  176.          /fy     : format only the NETBIOS memory segment
  177.          /a      : specifies primary (0) or an alternate (1|2|3) adapter
  178.          /d      : in addition to formatting, dump the specified memory areas
  179.  
  180.     Formatting all segments is the default.
  181.  
  182.     An example of its use for formatting all segments on adapter 0 and
  183.     redirecting the output to a file (req1.dmp) is:
  184.  
  185.                        lapsdump > req1.dmp
  186.  
  187.  
  188. 1.7 - MAPNAME
  189.  
  190.  
  191.     MAPNAME is a utility which encodes NetBIOS names into the format used
  192.     by NetBIOS over TCP/IP (RFC-encoded name).  MAPNAME also decodes
  193.     the RFC-encoded name into a standard NetBIOS name.  The primary use
  194.     for this utility is to aid entry of NetBIOS names in the RFC-encoded
  195.     format into a TCP/IP domain name server.
  196.  
  197.     Command format: mapname input /fdblxx
  198.       input: a) filename.LST or filename.RFC
  199.              b) name(max. 16 char. for NB name, and 32 char. for RFC name)
  200.                 - name can be any char.+ \xDD in any order, surrounded by "[]".
  201.                 - D is hex digit(\xDD = one char.).
  202.           f: indicates the file I/O(default is name.)
  203.           d: indicates the I/O direction
  204.              a) r: NETBIOS -> RFC
  205.              b) n: RFC - > NETBIOS
  206.           b: pending blanks up to 16 char.(default is null char.).
  207.         lxx: indicates last char.(xx can be any hex value)
  208.  
  209.    NOTE: "b" and "lxx" options are not supported for file I/O conversion.
  210.  
  211.  
  212.     Examples:
  213.     mapname station1.lst /fr                 input: file station1.lst
  214.                                             output: file station1.rfc
  215.                                          direction: NETBIOS -> RFC
  216.  
  217.     mapname station1.rfc /fn                 input: file station1.rfc
  218.                                             output: file station1.net
  219.                                          direction: RFC -> NETBIOS
  220.  
  221.     mapname station1\x85name\x86 /r            input: name station1ànameå
  222.                                             output: name(RFC format)
  223.                                          direction: NETBIOS -> RFC
  224.  
  225.     mapname station1 /rbl20                    input: name station1 as SRV name
  226.                                             output: name(RFC format)
  227.                                          direction: NETBIOS -> RFC
  228.  
  229.  
  230. 1.8 CASSETUP -- code server setup utility
  231.  
  232.         Contents:
  233.  
  234.         1.8.1  An introduction to CASSETUP
  235.  
  236.         1.8.2  What to do first
  237.                1.8.2.1  Installing CASSETUP
  238.                1.8.2.2  Loading Srvifs/LAN CID Utility Support
  239.                1.8.2.3  Loading OS/2, MPTS and LS 4.0 images
  240.                1.8.2.4  Pruning the list of load-able applications
  241.  
  242.         1.8.3  Restrictions
  243.                1.8.3.1  General
  244.                1.8.3.2  Closing CASSETUP from the Windows List
  245.                1.8.3.3  CASPREP files and command files generated by CASSETUP.
  246.                1.8.3.4  Creating OS/2 2.1 boot diskettes on a workstation
  247.                         running OS/2 2.11
  248.                1.8.3.5  Long path names
  249.                1.8.3.6  Multiple instances of CASSETUP
  250.                1.8.3.7  Building Boot Diskettes on drive B:
  251.  
  252.  
  253. 1.8.1  An introduction to CASSETUP
  254.  
  255.         CASSETUP provides a single graphical interface for several
  256.         common tasks involved in installing CID enabled products over
  257.         the network.  It allows you to:
  258.  
  259.         - install Srvifs/LAN CID Utility Support which consists of:
  260.  
  261.           . The LAN CID Utility
  262.  
  263.           . Srvifs (a simple file server)
  264.  
  265.         - load application install images from diskettes or
  266.           CD ROM onto a Code Server,
  267.  
  268.         - build boot diskettes for use with LAN CID Utility, and
  269.  
  270.         - create CASPREP files which can be used to generate
  271.           LAN CID utility command files.
  272.  
  273.         A big advantage of this version of CASSETUP is that it can
  274.         handle many different applications.  To add an application to
  275.         the set that CASSETUP understands, you simply add an application
  276.         profile to the profiles directory.  See the online documentation
  277.         for information on application profiles.  Similarly, to build
  278.         new kinds of boot diskettes (with a different version of OS/2,
  279.         perhaps) you just create a diskette-build script, using the
  280.         provided scripts as a template.
  281.  
  282.  
  283. 1.8.2  What to do first
  284.  
  285.         To get started, do these steps:
  286.  
  287.         - Install CASSETUP (see section 2.1)
  288.         - After rebooting, review the online documentation by issuing
  289.           the command
  290.                         view cassetup.inf
  291.           from the directory where you installed CASSETUP.
  292.         - Invoke CASSETUP by double clicking on the desk-top icon.
  293.         - Install Srvifs/LAN CID Utility Support (see section 2.2)
  294.         - Load OS/2, MPTS, and LS 4.0 install images (see section 2.3)
  295.         - If you wish, prune the list of applications that can be loaded
  296.           (see section 2.4)
  297.         - Load application images as needed.
  298.  
  299. 1.8.2.1 Installing CASSETUP.
  300.  
  301.         CASSETUP is located on the MPTS diskette 3. The CASSETUP files
  302.         are packed in a file called CASSETUP.ZIP in the \APPLETS
  303.         directory on the MPTS diskette 3.
  304.  
  305.         Installing from MPTS diskette 3
  306.         -------------------------------
  307.  
  308.         To install CASSETUP from MPTS diskette 3, perform the following
  309.         steps:
  310.  
  311.         -- To unpack the CASSETUP files into the desired directory, insert
  312.            the MPTS diskette 3 into drive A: on the code server and
  313.            issue the following command:
  314.  
  315.               PKUNZIP2 A:\APPLETS\CASSETUP.ZIP <path>\CASSETUP
  316.  
  317.            Note:  If PKUNZIP2.EXE is not in a directory that is in the
  318.                   current path, you may copy the PKUNZIP2.EXE program from
  319.                   the root directory of MPTS diskette 1 into a directory
  320.                   that is in the current path.
  321.  
  322.         -- To initialize CASSETUP files and put the CASSETUP icon on
  323.            the desktop, issue the following command:
  324.  
  325.               <path>\CASSETUP\CASINST
  326.  
  327.  
  328.         Installing from a code server
  329.         -----------------------------
  330.  
  331.         The complete instructions on how to install CASSETUP from a code
  332.         server are located in the CASSETUP.INF file packed in the file
  333.         CASSETUP.ZIP in the \APPLETS directory on the MPTS diskette 3.
  334.         CASSETUP.INF would be located in the <path>\CASSETUP directory
  335.         on the code server if you followed the installation instructions
  336.         in Installing from MPTS diskette 3.
  337.  
  338.         After installation, shut down and reboot your system.
  339.  
  340. 1.8.2.2 Loading Srvifs and LAN CID Utility Support
  341.  
  342.         To load LAN CID Utility and Srvifs, do these things:
  343.  
  344.         - Display the Code Server Setup Container window by double clicking
  345.           on the Code Server Setup icon on your desktop.
  346.  
  347.         - Display the Code Servers Container window by double clicking
  348.           on the Code Servers icon in the Code Server Setup Container
  349.           window.
  350.  
  351.         - Select the "Selected" from the Code Servers Container window
  352.           menu bar, select "Srvifs/LAN CID Utility support", and then
  353.           select "Load...".  This will cause the Load Srvifs/LAN CID
  354.           Utility Support window to be displayed.
  355.  
  356.         - Select the OK pushbutton to start the load if the defaults are
  357.           acceptable.
  358.  
  359.         If the defaults that have been provided are not exactly what you
  360.         want then you can do the following:
  361.  
  362.         - You can accept the default Srvifs server target path or specify
  363.           one of your own.  The default is "x:\server", where x is the
  364.           drive where the Code Server Setup files were installed.  This
  365.           target path determines where the Srvifs server files will be
  366.           loaded.
  367.  
  368.         - You can accept the default source image path or specify one of
  369.           your own.  The default is "A:".  This can be any valid drive
  370.           and path, and must be accessible at this time.
  371.  
  372.         - The Srvifs Client/LAN CID utility target is a composite of
  373.           an alias and an optional path extension.  The aliases that
  374.           come with the Code Server Setup utility are:  READONLY and
  375.           READW (read/write).  Both of these are associated with the
  376.           drive where the Code Server Setup files were installed.  These
  377.           can be modified (delete and add) or you can create new
  378.           aliases.  READONLY is the default alias and the default path
  379.           extension is blank.
  380.  
  381.         The path to the Srvifs client/LAN CID utility cannot exceed 227
  382.         characters.  If you enter a combination of alias and path that
  383.         exceeds this amount you will receive a error message showing the
  384.         path and the number of characters over this limit.
  385.  
  386.         - Select the OK pushbutton to start the load.
  387.  
  388. 1.8.2.3 Loading OS/2, MPTS, and LS 4.0 images
  389.  
  390.         Obtain the install diskettes for OS/2 Version 2.1 or Version
  391.         2.11.  Also obtain either the LAN Server 4.0 install diskettes
  392.         or the LAN Server 4.0 Install CDROM.
  393.  
  394.         Start CASSETUP by double clicking the CASSETUP icon.
  395.  
  396.         Open the Code Servers object by double clicking on it.
  397.  
  398.         Open the Applications object by double clicking on it.
  399.  
  400.         Drag the icon representing your OS/2 version onto the code
  401.         server icon.  Follow the instructions on the screen to load the
  402.         images.
  403.  
  404.         Drag the icon representing MPTS for your media onto the code
  405.         server icon.  Follow the instructions on the screen to load the
  406.         images.
  407.  
  408.         Drag the icon representing LS 4.0 for your media and package
  409.         onto the code server icon.  Follow the instructions on the
  410.         screen to load the images.  Drag the icon representing LS 4.0
  411.         requester for your package onto the code server icon.  Select
  412.         the Register radio button and then select OK.
  413.  
  414.         Now you are ready to put more images on the code server, or to
  415.         generate CASPREP files, convert them to command files, or create
  416.         client boot diskettes.
  417.  
  418. 1.8.2.4 Pruning the list of load-able applications
  419.  
  420.         The Applications container shows each of the applications (and
  421.         variations of applications) for which images can be loaded on
  422.         the code server.  You may not be interested in all these
  423.         applications.  For example, if you have purchased the LAN Server
  424.         4.0 Advanced package on CDROM, you may not have a need to load
  425.         images for LAN Server 4.0 Entry on diskette.
  426.  
  427.         You can keep unneeded applications from appearing in the
  428.         container by moving the Application Profiles associated with the
  429.         applications to another directory.  The LAN Server-related
  430.         Application Profiles are:
  431.  
  432.              ls40a.pro         - LAN Server 4.0 Advanced Server on diskette
  433.              ls40cda.pro       - LAN Server 4.0 Advanced Server on CDROM
  434.              ls40areq.pro      - LAN Server 4.0 Advanced Requester
  435.              ls40e.pro         - LAN Server 4.0 Entry Server on diskette
  436.              ls40cde.pro       - LAN Server 4.0 Entry Server on CDROM
  437.              ls40ereq.pro      - LAN Server 4.0 Entry Requester
  438.  
  439.         If you will just be installing LS4.0 Advanced from the images
  440.         shipped on CDROM, issue the following commands to remove the
  441.         unneeded profiles.  Assume that CASSETUP is installed in
  442.         d:\cassetup.
  443.  
  444.              d:
  445.              CD cassetup
  446.              MD probkup
  447.              MOVE ls40a.pro probkup
  448.              MOVE ls40e.pro probkup
  449.              MOVE ls40cde.pro probkup
  450.              MOVE ls40ereq.pro probkup
  451.  
  452.         If you find later that you need to install one of these
  453.         application images, reverse the MOVE command to put the
  454.         application profile back in the main CASSETUP directory.
  455.  
  456.  
  457. 1.8.3  Restrictions
  458.  
  459. 1.8.3.1 General.
  460.  
  461.         CASSETUP is supplied as an applet.  Use it as-is.
  462.         No support is provided for CASSETUP.
  463.  
  464. 1.8.3.2 Closing CASSETUP from the Window List.
  465.  
  466.         If you close CASSETUP from the Workplace Shell Window List,
  467.         changes you have made to notebook settings may not be preserved.
  468.         Always close CASSETUP from the main dialog's system menu.
  469.  
  470. 1.8.3.3 CASPREP files and command files generated by CASSETUP.
  471.  
  472.         Always carefully examine the CASPREP files and command files
  473.         generated by CASSETUP.  They are designed to generate all the
  474.         information needed to install the selected applications, but
  475.         their content depends on the data in the application profiles.
  476.         Refer to the LAN CID utility documentation for more information
  477.         about CASPREP files and command files.
  478.  
  479. 1.8.3.4 Creating OS/2 2.1 boot diskettes on a workstation running OS/2 2.11.
  480.  
  481.         The program used to create OS/2 boot diskettes is sensitive to
  482.         the level of the operating system under which it is being run.
  483.         If the operating system on your workstation is OS/2 version
  484.         2.11, you will not be able to created boot diskettes for OS/2
  485.         version 2.1 or earlier.  The work-around for this is to do the
  486.         following steps from an OS/2 command line:
  487.  
  488.         - change to the directory that contains the OS/2 2.1
  489.           version of SYSINSTX.COM.  This is the DISK_0 subdirectory
  490.           of the install images.  For example
  491.  
  492.                 cd d:\CID\IMG\OS2V21\DISK_0
  493.  
  494.         - Create a backup copy of the OS/2 2.1 SYSINSTX.  For example
  495.  
  496.                 copy SYSINSTX.COM SYSINSTX.BKP
  497.  
  498.         - Replace the OS/2 2.1 SYSINSTX with the version for the
  499.           operating system running on your workstation.  (This requires
  500.           that you have the install diskettes for your current
  501.           version of OS/2, or that the current version also be loaded
  502.           on the code server.)
  503.  
  504.           If you have the install diskettes for your current version,
  505.           you might put the first diskette ("boot" diskette) in drive
  506.           a: and issue
  507.  
  508.                 copy A:\SYSINSTX.COM .
  509.  
  510.           If you have your current version's images loaded on the code
  511.           server, the command might be
  512.  
  513.                 copy d:\CID\IMG\OS2V211\DISK_0\SYSINSTX.COM .
  514.  
  515.         - Build the boot diskettes using CASSETUP
  516.  
  517.         - Restore the OS/2 2.1 SYSINSTX.COM by issuing commands similar to
  518.  
  519.                 cd d:\CID\IMG\OS2V21\DISK_0
  520.                 copy SYSINSTX.BKP SYSINSTX.COM
  521.  
  522. 1.8.3.5 Long path names
  523.  
  524.         In some cases, very long path names (greater than about 250
  525.         characters) may not be properly removed by CASSETUP.  If this
  526.         occurs, remove the paths manually.
  527.  
  528. 1.8.3.6 Multiple instances of CASSETUP
  529.  
  530.         Only one instance of CASSETUP.EXE should be running at any one
  531.         time.  Multiples can be started, but the modifications that
  532.         result from one or more of the instances of CASSETUP.EXE can be
  533.         lost.  The loss of these changes is not always predictable.
  534.  
  535. 1.8.3.7 Building Boot Diskettes on drive B:
  536.  
  537.         When you create boot diskettes on a boot drive other than A:,
  538.         manual steps are needed to make the diskettes able to boot from
  539.         drive A:.  Using a text editor such as E or EPM, edit the
  540.         config.sys on the second boot diskette.  Change all instances of
  541.         B:\ to A:\ and save the changes back to the diskette.
  542.  
  543.  
  544. 1.9 - OS2SNIFF
  545.  
  546.  
  547.         Network adapter detection (OS2SNIFF.EXE) is one of the new applets
  548.         of NTS/2. This applet will detect network adapters installed on the
  549.         user workstation.
  550.  
  551.         To execute OS2SNIFF.EXE, the files NCD.DLL and NCD.MSG must be in a
  552.         directory that is in the PATH/DPATH statement of the config.sys. From
  553.         an OS/2 command prompt execute OS2SNIFF.  The following information
  554.         will be displayed:
  555.  
  556.                            CARD TITLE:
  557.                            LS SUPPORTED:
  558.                            NIF FILENAME:
  559.                            I/O LENGTH:
  560.                            RAM LENGTH:
  561.                            BUS TYPE:
  562.                            SLOT:
  563.                            ID NUMBER:
  564.  
  565.         Network adapter detection has the ability to recognize different types
  566.         of adapters installed in micro-channel architecture (MCA), extended
  567.         industry standard architecture (EISA), and industry standard
  568.         architecture (ISA) bus computers.  Different methods are used to
  569.         detect network adapters on MCA, EISA, and ISA computers.
  570.  
  571.         Network adapters used in MCA bus computers are detected via their
  572.         programmable option select (POS) ID.  Each MCA network adapter has
  573.         a unique POS ID.  This POS ID corresponds to an adapter definition
  574.         file (ADF) shipped with each MCA adapter.  In detecting the network
  575.         adapters, each slot that contains an adapter in the computer is
  576.         interrogated for its POS ID.  The returned POS IDs from the
  577.         interrogation are cross checked with an internal table specifically
  578.         for MCA network adapters to determine if they are recognizable.
  579.         The network adapter detection function then passes the detected
  580.         adapters along with their specific information back to the
  581.         configuration/installation program.
  582.  
  583.         Network adapters used in EISA bus computers are detected via their
  584.         expansion board identifier (product ID).  Each EISA network adapter
  585.         has a unique product ID.  This product ID corresponds to a
  586.         configuration (CFG) file shipped with each EISA adapter.  Detecting
  587.         EISA network adapters is similar to detecting MCA network adapters.
  588.         Each slot containing an adapter is interrogated.  The returned product
  589.         IDs from the interrogation are cross checked with the internal table
  590.         specifically for EISA network adapters to determine if they are
  591.         recognizable.  There are some ISA network adapters that have a CFG
  592.         file so that the network adapter could be configured as an EISA
  593.         network adapter via the EISA configuration utility.  These network
  594.         adapters are also recognized using the EISA detection methodology.
  595.  
  596.         Network adapters used in ISA bus computers are detected via information
  597.         returned from the combination of the adapter input/output (I/O)
  598.         ports, the range of the read-only memory (ROM) address, and the range
  599.         of the random access memory (RAM) address.  Information such as I/O
  600.         port, range of ROM and RAM addresses are obtained from technical
  601.         specifications from the network adapter's manufacturer.  A specific
  602.         routine is written for each recognizable network adapter.  This
  603.         routine may manipulate the adapter's I/O ports and scan the ROM and
  604.         RAM address ranges to find the unique signature that is identify
  605.         with the card.
  606.  
  607.  
  608.  
  609. 1.10 - NB64K
  610.  
  611.        The NETBEUI environment space must fit within 64k.  NB64K will help
  612.        maximize the usage of these 65535 bytes.
  613.  
  614.        Various settings located in the PROTOCOL.INI file affect how much
  615.        memory NetBIOS allocates for NETBEUI.  Enter the desired values in
  616.        the Commands (NCBS), Names, Packets, Selectors, Datagram Packets,
  617.        and Loop Packets fields; then hit the calculate push button to
  618.        determine if this configuration is possible.  You will receive a
  619.        warning if the size exceeds 64k.
  620.  
  621.        This program will work with NETBEUI.OS2 drivers from earlier releases,
  622.        however, the overhead and size multipliers will be a close estimate.
  623.  
  624.        Once a suitable configuration is obtained, update the PROTOCOL.INI
  625.        file using the MPTS configuration utility.
  626.  
  627.        NB64K.HLP must be located in the DPATH statement of the config.sys.
  628.  
  629.  
  630. 1.11 - NETTRACE
  631.  
  632.        NETTRACE.EXE will set/reset the OS2TRACEMASK parameter for NetBEUI.
  633.        Running it from the command line with no options will give you the
  634.        current setting. The syntax is:
  635.  
  636.                             NETTRACE 0xFFFF
  637.  
  638.  
  639. 1.12 - XTRACE
  640.  
  641.        Extended Trace works by first turning on OS/2 Trace.  Then it checks
  642.        the 63K byte system trace buffer every so often, and if "full enough"
  643.        copies the new trace therein to a larger buffer of its own in memory.
  644.        Between checks of the system trace buffer, it puts itself to sleep,
  645.        giving up CPU.  Once the larger buffer (the Extended Trace Buffer)
  646.        becomes "full enough", its contents are dumped to a binary file on the
  647.        hard drive.  This file is treated as a circular buffer much like the
  648.        system trace buffer is, only can be much larger (many megabytes).
  649.        The Extended Trace program, once started, runs in the background,
  650.        detached from the session in which it was started.
  651.  
  652.        Once Extended Trace has been stopped, Extended Trace Format can be
  653.        invoked.  This program traverses the raw trace contained in the file
  654.        that was produced by Extended Trace and formats it.   If trace at any
  655.        point was lost for whatever reason, a message stating so is written
  656.        at that point in the formatted file.  The Extended Trace Format program
  657.        runs in the foreground, returning control when formatting is complete.
  658.  
  659.        NOTE:  Extended Trace Format looks for raw trace file produced by
  660.               Extended Trace in the current directory, so run Extended Trace
  661.               and Extended Trace Format in the same directory.
  662.  
  663.        In the current version, not only are the raw trace file and formatted
  664.        trace file produced, but 'flight recorder' files are produced.  One
  665.        other file is produced, which allows Extended Trace to communicate
  666.        with Extended Trace Format any parameters or information needing to
  667.        be shared between them.  This file must NOT be erased or modified
  668.        between the time Extended Trace and Extended Trace Format are run.
  669.  
  670.  
  671.        Here are the names of the files produced:
  672.  
  673.        XTRACE.RAW    -- raw trace stored here
  674.        XTRACE.FMT    -- formatted trace stored here
  675.        XTFLIGHT.DAT  -- flight recorder information for Extended Trace
  676.        XFFLIGHT.DAT  -- flight recorder information for Extended Trace Format
  677.        XTARGS.DAT    -- infomation shared between the two
  678.  
  679.        To install, follow these step:
  680.        1. Make sure that following files are in a directory in the PATH
  681.           statement:
  682.                       XTRACE.EXE
  683.                       XTFORMAT.EXE
  684.                       XTWAD.EXE
  685.        2. Move FINDSTDA.SYS to a directory you wish to leave it in.
  686.        3. Add the following lines to CONFIG.SYS:
  687.                       device=pathname\FINDSTDA.SYS
  688.                       tracebuf=63
  689.           where pathname is the path in which FINDSTDA.SYS resides.
  690.           NOTE: Extended Trace will NOT work if the trace buffer size is
  691.                 set to anything other than63K bytes.
  692.        4. Shutdown and reboot the system to activate the device driver and
  693.           make it possible to use Extended Trace and Extended Trace Format.
  694.  
  695.        Extended Trace has been implemented as an OS/2 executable, XTRACE.EXE,
  696.        to be called similarly to the executable TRACE.EXE that is shipped
  697.        with OS/2.  Arguments specific to Extended Trace must be specified
  698.        between the program name (XTRACE) and the "ON" keyword, while arguments
  699.        to be passed to OS/2 trace must be specified after the "ON" keyword.
  700.        To invoke Extended Trace, issue the program name, XTRACE, as one
  701.        would, in general, to run any OS/2 executable program, with arguments
  702.        appropriate for tracing whatever is desired or for turning Extend Trace
  703.        off.
  704.  
  705.        The format for turning Extended Trace ON is the following:
  706.  
  707.           XTRACE (Extended Trace options) ON (OS/2 trace options)
  708.  
  709.        Extend Trace options are specified wth a forward slash ("/") followed
  710.        immediately by the option name, a space, and the value desired for
  711.        that option.  When turning Extended Trace ON, any option that is
  712.        supported by regular OS/2 Trace is also supported and can be
  713.        specified exactly as for OS/2 Trace, immediately following the "ON"
  714.        keyword in the command.
  715.  
  716.        OPTION   DESCRIPTION                         MIN     MAX     DEFAULT
  717.        ---------------------------------------------------------------------
  718.        XS       eXtended trace buffer size (Kbytes)  63     1024      512
  719.        FL       Formatted trace file size Limit       1   102400     4096
  720.        ST       System trace buffer full Threshold    0%      90%      40%
  721.        XT       eXtended trace buffer full Threshold  0%      90%      70%
  722.        WC       Wait between Copies to extended
  723.                 trace buf, in milliseconds           100    10000     500
  724.        WB       Wrap Buffer if full, rather than
  725.                 stopping trace (YES/NO)              N/A      N/A     YES
  726.        KS       Keep Statistics, output when
  727.                 XTRACE turned off (YES/NO)           N/A      N/A     YES
  728.  
  729.        The following is an example:
  730.  
  731.                     XTRACE ON 164
  732.                     XTRACE /XS 400 /WC 1000 ON 164
  733.                     XTRACE /FL 8192 ON /P:002
  734.                     XTRACE OFF
  735.  
  736.        When turning Extended Trace OFF, no special options are supported; the
  737.        command
  738.                     XTRACE OFF
  739.  
  740.        will turn Extended Trace off completely (for ALL trace points).  Note
  741.        that this deviates from normal OS/2 TRACE, which supports not only
  742.        turning TRACE off fully, but also turning off only selected tracepoints
  743.        and options, while leaving others on.  If turning only selected
  744.        tracepoints is desired, this can be done directly by the user through
  745.        execution of the OS/2 Trace program, e.g.:
  746.  
  747.                     TRACE OFF 164
  748.  
  749.        To invoke Extended Trace Format, simply enter XTFORMAT on the command
  750.        line.  Extended Trace Format will then format the raw trace file in
  751.        the current directory, producing a text formatted trace file.  It
  752.        runs in the foreground and does not return until the formatting job
  753.        is done.
  754.  
  755.        NOTE:  The size of the formatted trace file may be less than that
  756.               specified with the /FL option, since XTRACE may not have
  757.               been run long enough to capture an amount of trace that,
  758.               when formattted, would file that large a file.
  759.  
  760.        NOTE:  Time taken to format the raw trace file is directly related to
  761.               the amount of raw trace there is to format.  It may take many
  762.               minutes to complete the formatting if many megabytes of formatted
  763.               output is to be produced.
  764.  
  765.        Below are examples of three trace records formatted by Extended Trace
  766.        Format as they would appear in the formatted output file.  This data
  767.        in the event specifier line for each record (except for the optional
  768.        timestamp) are displayed in hexadecimal.  Note that if there is no
  769.        timestamp, the TS field is left out altogether.  Also note that,
  770.        just as in the case of OS/2 TRACEFMT, data follows the event
  771.        specifier line, is broken up byte-to=byte, and also is displayed in
  772.        hexidecimal.  The sizes of the fields in the trace record header line
  773.        are constant throughout th formatting, i.e. each will always start
  774.        in column and have the same number of digits.
  775.  
  776.         EVENT #00029 : maj=08, min=003B, PID=0011, TS=131.44
  777.         03 B2 11 07 68 11 00 00 00 00 A0 01 00 00 23 FF
  778.         1D 00 00 2B 08
  779.  
  780.         EVENT #0002A : maj=01, min=0008, PID=0004
  781.         00 01 FF
  782.  
  783.         EVENT #0002B : maj=1E, min=0002, PID=0001, TS=009.21
  784.  
  785.        The formatting of trace records is plain in order to conserve space.
  786.        No interpreting or parsing of the data within the records is done,
  787.        unlike OS/2 TRACEFMT.  However, the expansion ratio from raw trace
  788.        file size to formatted trace file size is much lower with Extended
  789.        Trace Format than it is with OS/2 TRACEFMT.
  790.  
  791.        The internal formats of raw trace files produced by OS/2 TRACEFMT
  792.        (when the option to dump the raw trace to disk is selected) and by
  793.        the Extended Trace are not compatible.  This means that one cannot
  794.        use OS/2 TRACEFMT to format raw trace generated by Extended Trace,
  795.        nor can one use Extended Trace Format to format raw trace generated
  796.        by OS/2 TRACE.
  797.  
  798.  
  799. 1.13 - HOSTID
  800.  
  801.        HOSTID.EXE allows the user to change the Primary IP Address of the
  802.        system.
  803.  
  804.        Usage: hostid
  805.  
  806.        will display the current Primary IP Address.
  807.  
  808.        Usage: hostid a.b.c.d
  809.  
  810.        will set the Primary IP address of the system to a.b.c.d
  811.        where a.b.c.d is a valid IP address.
  812.  
  813.  
  814.  
  815. ===============================================================================
  816.  
  817. SECTION 2: TOOLKIT FILES FOR DEVELOPERS
  818.  
  819.  
  820.     The TOOLKIT directory contains files to aid in development of
  821.     NetBIOS and Socket applications.  \TOOLKIT\LAPSTK.ZIP
  822.     contains the files for LAPS development and is located on
  823.     MPTS Disk - 4.  \TOOLKIT\MPTNTK.ZIP contains the files for
  824.     Socket development and is also located on MPTS Disk - 4.
  825.  
  826.     To install LAPS Toolkit files from MPTS Disk - 4, perform the
  827.     following steps:
  828.  
  829.     -- To unpack the LAPS files into the desired directory, insert
  830.        the MPTS Disk - 4 into drive A: on the code server and type the
  831.        following command:
  832.  
  833.        PKUNZIP2 -d A:\TOOLKIT\LAPSTK.ZIP <e:\path>
  834.  
  835.     To install Socket Toolkit files from MPTS Disk - 4, follow these
  836.     steps:
  837.  
  838.     -- To unpack the Socket files into the desired directory, insert
  839.        MPTS Disk - 4 into drive A: on the code server and type the
  840.        following command:
  841.  
  842.        PKUNZIP2 -d A:\TOOLKIT\MPTNTK.ZIP <e:\path>
  843.  
  844.  
  845.     Example of putting the LAPS developer toolkit files onto drive C:
  846.  
  847.        PKUNZIP2 -d A:\TOOLKIT\LAPSTK.ZIP C:\
  848.  
  849.     Note:  If MPTS is not installed on the workstation on which you are
  850.            unpacking LAPS Toolkit, you must copy the PKUNZIP2.EXE program from
  851.            the root directory of MPTS Disk - 1 into a directory that is  in
  852.            the current path.
  853.  
  854.  
  855.  
  856. ===============================================================================
  857.  
  858. SECTION 3:  LAN CID UTILITY
  859.  
  860. __________________________
  861. 3.1 - NEW CID RETURN CODES
  862.  
  863.     The CID architecture has define a new range of CID return codes which
  864.     are now implimented by the LAN CID Utility (LCU).
  865.  
  866.     The defintions of the new CID return code ranges implimented in LCU are
  867.     as follows:
  868.  
  869.  FE 00 TO FE 3F
  870.  
  871.  EXPLANATION:  Successful Program Termination- Reboot and do not invoke again
  872.  
  873.            FE 01 TO FE 03  This range of Return Codes is reserved for
  874.                            CID-Enabled Applications that want the flexibility
  875.                            of specifying product specific Return Code defi-
  876.                            nitions. Products must of course then document the
  877.                            meaning of these Return Codes used from this range.
  878.                            The defined SDM action for this range is:
  879.                            Successful program termination-- Reboot and do not
  880.                            invoke again.
  881.  
  882.            FE 05 TO FE 07  Same as FE 01 to FE 03
  883.  
  884.            FE 09 TO FE 11  Same as FE 01 to FE 03
  885.  
  886.            FE 13 TO FE 3F  Same as FE 01 to FE 03
  887.  
  888.  ----------------------------------------------------------------------
  889.  
  890.  
  891.  FE 40 TO FE 7F
  892.  
  893.  EXPLANATION:  Successful Program Termination-No Reboot
  894.  
  895.            RETURN CODE     DESCRIPTION
  896.  
  897.            FE 40 TO FE 7F  This range of Return Codes is reserved for
  898.                            CID-Enabled Applications that want the flexibility
  899.                            of specifying product specific Return Code defi-
  900.                            nitions. Products must of course then document the
  901.                            meaning of these Return Codes used from this range.
  902.                            The defined SDM action for this range is:
  903.                            Successful program termination--No Reboot
  904.  
  905.  ----------------------------------------------------------------------
  906.  
  907.  
  908.  FE 80 TO FE FF
  909.  
  910.  EXPLANATION:  Unsuccessful Program Termination-No Reboot
  911.  
  912.            RETURN CODE     DESCRIPTION
  913.  
  914.            FE 80 TO FE FF  This range of Return Codes is reserved for
  915.                            CID-Enabled Applications that want the flexibility
  916.                            of specifying product specific Return Code defi-
  917.                            nitions. Products must of course then document the
  918.                            meaning of these Return Codes used from this range.
  919.                            The defined SDM action for this range is:
  920.                            Unsuccessful program termination--No Reboot
  921.  
  922.  
  923.  
  924. __________________________________________________
  925. 3.2 - Warp Server LCU CID Installation from CD-ROM
  926.  
  927.  
  928. LAN CID Utilities is included in OS/2 Warp Server to support lightly attended
  929. remote install scenarios of both client and server components to machines
  930. that do not have any software installed.  If you require assistance with
  931. setting up your CID Server, support is available through your local IBM
  932. Branch office.
  933.  
  934.   Setting Up Remote Install of Server Components using LAN CID Utilities
  935.  
  936. There are two major steps setting up a for remote installations using
  937. LAN CID Utilities: setting up the code server and creating the boot
  938. diskettes for the target machine.  The general procedures for performing
  939. these steps are described in the LAN CID Utility Guide.  A soft copy
  940. of this guide can be found on MPTS disk 5 in the README.UTL file.
  941. The README.UTL file can be found on the OS/2 Warp Server CD-ROM
  942. in directory \CID\SERVER\IBMLS\IBM500N5 subdirectory.
  943.  
  944. The OS/2 Warp Server CD-ROM includes install images that
  945. can be used directly from its CD-ROM and there are files
  946. included to assist setting up a code server to utilize this feature.
  947.  
  948.  
  949. OS/2 Warp Server includes a ZIP file that contains a set of default
  950. response files and a default LCU command file.  To un-zip these
  951. files, issue the following command.
  952.  
  953.         PKUNZIP2 -d x:\CID\SERVER\IBMLS\IBM500\LCU\WARPSRV.ZIP <target path>
  954.  
  955. where x is the drive letter of the CD-ROM drive that contains the
  956. OS/2 Warp Server CD-ROM.  The ZIP file is designed to place the
  957. response files and default LCU command file in the appropriate
  958. locations in the CID directory structure (as indicated below) and
  959. <target path> is the drive and path where the response files and default
  960. LCU command file will be placed.  In the example directory structure above,
  961. the <target path> is "D:\".  Warp Server's "Up and Running" describes both
  962. LCU and SYSVIEW/2 for CID installations.
  963.  
  964.  
  965.  
  966.        Setting Up an Code Server for the OS/2 Warp Server CD-ROM
  967.  
  968. The following steps are required for setting up a code server for
  969. the OS/2 Warp Server CD-ROM:
  970.  
  971.             - Install and configure the SRVIFS server.
  972.               Copy the \CID\SRVIFS directory of the Warp Server CD-ROM
  973.               onto the CID code server in the \SRVIFS directory.  The
  974.               \SRVIFS directory will be created when the WARPSRV.ZIP
  975.               file is unzipped using the -d option and the sample service.ini
  976.               for Warp Server will be placed in this directory
  977.               when unzipped using the -d option.
  978.             - Create the CID directory stucture on the CID code server for
  979.               response files, install logs, and the client install
  980.               REXX command.  The directories will also be created when
  981.               the WARPSRV.ZIP file is unzipped using the -d option.  The -d
  982.               will place the Warp Server default response files and default
  983.               client install command file will also be placed in the
  984.               appropriate locations in the CID directory structure.
  985.  
  986.  
  987. Refer to the "LCU Configuration Guide" for the procedure for installing
  988. the SRVIFS server.  The following statements should be used
  989. in the SRVIFS "SERVICE.INI" file on the code server.  The  "LCU Configuration
  990. Guide" should be consulted for changes necessary to address your unique
  991. environment.
  992. -----------------------------------------------------------------------------
  993. ;
  994. Adapter       = 0
  995. MaxClients    = 5
  996. MaxFiles      = 102
  997. Name          = CIDSERVER
  998. Groupname     = No
  999. ClientWorkers = 6
  1000. ;
  1001. Path          = d:\
  1002. perclient     = No
  1003. PermitWrite   = Yes
  1004. ;
  1005. alias= readonly,single,cdrom,e:\
  1006. alias= readwrite,single,writedsk,d:\cid
  1007. -----------------------------------------------------------------------------
  1008.  
  1009. In the example above, the CID directory structure is configured for drive "D:"
  1010. and the install images from the OS/2 Warp Server CD-ROM is configured for
  1011. drive "E:".  If your code server configuration is different, you will need
  1012. to change the appropriate statements to reflect your code server's configuration.
  1013. Drive "D:" appears twice, once in the "Path" statement and once in the
  1014. second alias statement.  Drive "E:" appears once in the first alias statement.
  1015.  
  1016. Also notice that the name of the code server has been set to "CIDSERVER".
  1017. If you have no other machines on the network using the NETBIOS name
  1018. "CIDSERVER", this name will work fine.  However, you should also feel
  1019. free to change this name to the name you would prefer.
  1020.  
  1021. Once SRVIFS is installed and configured on your code server, you must
  1022. activate SRVIFS with the following command:
  1023.  
  1024.         "SERVICE /INI=SERVICE"
  1025.  
  1026.  
  1027. The following directory structure should be setup as the source
  1028. of response files, installation log files, and client installation command
  1029. files on the code server:
  1030.  
  1031. D:\CID\CLIENT
  1032. D:\CID\RSP\WARPSRV
  1033. D:\CID\RSP\MPTS
  1034. D:\CID\RSP\LS
  1035. D:\CID\RSP\TCPAPPS
  1036. D:\CID\RSP\NWREQ
  1037. D:\CID\RSP\LDCS
  1038. D:\CID\RSP\SYSVIEW2
  1039. D:\CID\RSP\PSNS
  1040. D:\CID\RSP\PSF
  1041. D:\CID\LOGS\WARPSRV
  1042. D:\CID\LOGS\MPTS
  1043. D:\CID\LOGS\LS
  1044. D:\CID\LOGS\NSC
  1045. D:\CID\LOGS\TCPAPPS
  1046. D:\CID\LOGS\NWREQ
  1047. D:\CID\LOGS\LDCS
  1048. D:\CID\LOGS\SYSVIEW2
  1049. D:\CID\LOGS\PSNS
  1050. D:\CID\LOGS\PSF
  1051. D:\CID\LOGS\SRVIFS
  1052. D:\CID\LOGS\LCU
  1053.  
  1054.  
  1055. Your code server is now ready to perform a default installation of
  1056. all server components from OS/2 Warp Server.  However, you probably
  1057. do not want exactly a default install on any of your server machines.
  1058. At this point, you should modify the default response files to
  1059. match the configuration of the server component you want and
  1060. you should create LCU command files for each server you want
  1061. to install.  When you edit LCU command files, copy the default
  1062. command file to another file (the name of the file should equal the
  1063. name of the target machine to be installed and the extension should
  1064. be "CMD") and comment out the sections pertaining to the
  1065. server components not required.  Make sure that the variable "ldcs_install"
  1066. in the default command file points to the \CID\SERVER\LDCS subdirectory
  1067. that ends with a1 in order to correctly point to the LAN Distance source
  1068. directory.
  1069.  
  1070.                   Creating LCU Boot Diskettes
  1071.  
  1072. To create the LCU boot diskettes, execute the following commands
  1073. from the Warp Server CD-ROM:
  1074.  
  1075.     (S: Source Drive)
  1076.     (E: drive is the CD-ROM drive)
  1077.     (D: drive is the CID Server harddrive)
  1078.     (T: Target Drive)
  1079.  
  1080.  
  1081.     E:\CID\EXE\OS2\SEDISK.EXE
  1082.                                /S:E:\OS2IMAGE
  1083.                                /T:A:
  1084.  
  1085.     E:\CID\SERVER\MPTS\THINLAPS.EXE
  1086.                                      E:\CID\SERVER\MPTS
  1087.                                      A:
  1088.                                      nif_file_name (nif file name of the LAN
  1089.                                                      adapter in the target
  1090.                                                      machine)
  1091.  
  1092.     E:\CID\SRVIFS\THINIFS.EXE /D:X
  1093.                               /S:E:\CID\SRVIFS
  1094.                               /T:A:
  1095.                               /TU:A:
  1096.                               /SRV:\\CIDSERVER\CDROM
  1097.                               /REQ:* (* indicates that a random SRVIFS NETBIOS
  1098.                                        name will be used)
  1099.  
  1100.     E:\CID\SRVIFS\THINIFS.EXE /D:W
  1101.                               /S:E:\CID\SRVIFS
  1102.                               /T:A:
  1103.                               /TU:A:
  1104.                               /SRV:\\CIDSERVER\WRITEDSK /REQ:*
  1105.  
  1106.     E:\CID\LOCINSTU\CASINSTL.EXE /TU:A: /CMD:W:\CLIENT
  1107.                                  /PL:X:\CID\LOCINSTU;X:\CID\DLL\OS2
  1108.                                  /PA:X:\CID\LOCINSTU
  1109.                                  /REQ:*
  1110.                                  /D (indicates that the default LCU command
  1111.                                       file "DEFAULT.CMD will be used if the
  1112.                                       client LCU command file cannot be found)
  1113.  
  1114.