home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / dsstlkt5.zip / dssos2tk / readme.doc < prev   
Text File  |  1998-05-08  |  7KB  |  159 lines
  1. This file contains toolkit-related sections from the 
  2. readme.doc and readme.dce files for Version 4.0 of  
  3. IBM Directory and Security Server (DSS) for OS/2 Warp.
  4. Minor modifications were made for directory paths in 
  5. the installation instructions since the CD path is different.
  6.  -- IBM DC 4-15-97 --
  7.  
  8. ************************************************************************
  9.  
  10.         IBM Directory and Security Server (DSS) for OS/2 Warp
  11.  
  12.          (c) Copyright by IBM Corp. and by others 1980, 1996
  13.  
  14.                       All rights reserved.
  15.  
  16.                 IBM is a registered trademark of
  17.               International Business Machines Corp.
  18.  
  19. ************************************************************************
  20. 4.0                   APPLICATION PROGRAM DEVELOPMENT
  21. *************************************************************************
  22.  
  23. _________________________
  24. 4.1  TOOLKIT INSTALLATION
  25.  
  26. Instructions for installing the DSS/DCE application development toolkit
  27. are as follows:
  28.  
  29.   1) Insert the CD-ROM.
  30.  
  31.   2) At the OS/2 command prompt, change to the CD-ROM drive and change
  32.      the product directory indicated in the product description.
  33.  
  34.   3) Type INSTALL and press ENTER.
  35.  
  36. The DSS toolkit install program presents a menu to guide the installation.
  37.  
  38. ______________________________________
  39. 4.2 TOOLKIT DOCUMENTATION INSTALLATION
  40.  
  41. When installing the DSS toolkit online documentation, the DSS install
  42. program does not add the books to the DSS folder in the Information folder.
  43. The procedure for creating folder objects is:
  44.  
  45.   1) Open the OS/2 Desktop Information folder.
  46.  
  47.   2) Open the DSS folder.
  48.  
  49.   3) From the OS/2 Templates folder, drag the "Program" template folder to the
  50.      DSS folder.
  51.  
  52.   4) Open the settings for the folder and make the following changes:
  53.  
  54.      Program
  55.        Path and file name = VIEWHELP.EXE
  56.        Parameters = <d>:\<path>\<filename>.inf
  57.                   where: <d> is the drive letter where DSS is installed
  58.                          <path> is "opt\dcelocal\books" for DCE documentation
  59.                                 and "ibmlan\books" for DSS documentation
  60.                          <filename> is the name of the online documentation
  61.                                     file as follows:
  62.  
  63.                             For DCE:
  64.                               dcecore  - DCE OS/2 Warp Appl. Dev. Guide
  65.                               dceapref - DCE OS/2 Warp Appl. Dev. Ref.
  66.                               dceapint - DCE OS/2 Warp Appl. Dev. Gd.-Intro
  67.                               dcedirsv - DCE OS/2 Warp Appl. Dev. Gd.-Dir Srv
  68.  
  69.                             For DSS:
  70.                               dsspgr   - DSS Prog. Guide and Ref.
  71.      General
  72.        Title = "title name"  (for example, DCE OS/2 Warp Appl. Dev. Guide)
  73.  
  74. The DSS Toolkit books are viewable from the CD-ROM by issuing the
  75. "view <filename>" command in the \TOOLKIT\PUBS directory.
  76.  
  77. ____________________________________________________
  78. 4.3  NetDCDBInit API NOT SUPPORTED BY DSS DC SERVERS
  79.  
  80. The DSS Programming Guide and Reference contains an error. In the User Category,
  81. the NetUserDCDBInit API is not supported by DSS DC servers.
  82.  
  83.  
  84. _________________________
  85. 4.4  ACCESS32 SAMPLE CODE
  86.  
  87. The DSS toolkit does not support the ACCESS32 sample program. Installing the
  88. DSS toolkit over the LS 4.0 or Warp Server toolkit results in the ACCESS32.C
  89. and ACCESS32.EXE files being present. These files are not functional on DSS.
  90.  
  91. _________________________________
  92. 4.5  MOCL INTERFACE NOT AVAILABLE
  93.  
  94. The Model Object Class Library (MOCL) interfaces referenced in some of the DSS
  95. publications are not available in the first release of DSS.
  96.  
  97. ____________________________________________________
  98. 4.6  DCE TOOLKIT MUST BE INSTALLED ON HPFS PARTITION
  99.  
  100. The DCE Toolkit and DCE Examples need to be installed on a HPFS partition.
  101. The Toolkit install process ends with errors if an attempt is made to
  102. install these components on a FAT partition.
  103.  
  104.  
  105. FROM README.DCE:
  106. -----------------
  107.  
  108. Application Development Environment
  109. ===================================
  110. The DCE Toolkit contains the DCE include files, the DCE program
  111. development tools and  DCE Examples. The DCE Toolkit can be 
  112. installed via the DSS Toolkit Install Program. 
  113.  
  114. The DCE Toolkit and DCE Examples can only be installed on a
  115. HPFS partition. The installation program will fail when trying
  116. to install the DCE Toolkit and DCE Examples on a FAT partition.
  117.  
  118. THE DCE Application Development books can be viewed from the
  119. DSS CD_ROM by typing  "view file_name" while in the
  120. \PUBS directory.
  121.  
  122. The following DCE Examples are provided:
  123.     1) acl manager        --->  opt\dcelocal\examples\acl_mgr
  124.     2) bank               --->  opt\dcelocal\examples\bank
  125.     3) context_app        --->  opt\dcelocal\examples\demo\context_app
  126.     4) data_test_app      --->  opt\dcelocal\examples\demo\data_test_app
  127.     5) sample             --->  opt\dcelocal\examples\demo\generic_app
  128.     6) ems                --->  opt\dcelocal\examples\ems
  129.     7) binop              --->  opt\dcelocal\examples\pubs\binop
  130.     8) dts sample         --->  opt\dcelocal\examples\pubs\dtssamp
  131.     9) greet (4)          --->  opt\dcelocal\examples\pubs\greet
  132.    10) prime              --->  opt\dcelocal\examples\pubs\prime
  133.    11) string-tree        --->  opt\dcelocal\examples\pubs\strtree
  134.    12) password strength  --->  opt\dcelocal\examples\pwdstren
  135.    13) hello_svc          --->  opt\dcelocal\examples\svc\hello_svc
  136.    14) timop_svc          --->  opt\dcelocal\examples\svc\timop_svc
  137.    15) timop              --->  opt\dcelocal\examples\timop
  138.    16) type manager       --->  opt\dcelocal\examples\type_mgr
  139.    17) xds/xom            --->  opt\dcelocal\examples\xdsxom
  140.  
  141. The DCE Examples were tested with the IBM C Set/2 Version
  142. 2.01 Compiler, the IBM VisualAge C++ Compiler, the Borland C++ 2.0
  143. Compiler and the Watcom C/C++ for OS/2 10.5 compiler. The
  144. examples were also tested with the IBM Warp 3.0 Toolkit.
  145.  
  146. Please pay *close* attention to the compiler and linker flags used
  147. in the examples that are shipped with this product. These are the
  148. same compiler and linker flags that you should use for your
  149. application development. One of the compiler flags that MUST be
  150. specified is -Su4. You may encounter various problems with RPC
  151. runtime and security APIs if you do not specify this compiler
  152. option in your Makefile.
  153.  
  154. For more information on the DCE Examples, please see the main
  155. DCE Examples Readme located in opt\dcelocal\examples.
  156.  
  157.  
  158.  
  159.