home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Collection - Online Library - January 1996 / CKITOS2196.ISO / diskette / gg244090.dsk / unc.dsk / CHAPTER.09 / README.TXT < prev    next >
Text File  |  1993-10-28  |  4KB  |  87 lines
  1. This is an example for a client/server application using the CDS namespace
  2. and the security service of DCE. It is part of the IBM redbook
  3.  
  4.         DEVELOPING DCE APPLICATION FOR OS/2 AND AIX (GG24-4090)
  5.  
  6. It implements a simple distributed message queuing system. 
  7.  
  8. PREREQUISITES:
  9.  
  10.            RS/6000              !        PS/2
  11.         ---------------------------------------------
  12.            - AIX/6000 3.2       !        - OS/2 2.1
  13.            - DCE/6000 1.01      !        - CSET 1.0
  14.                                 !        - TOOLKIT 2.1
  15.                                 !        - DCE OS/2 
  16.  
  17. FILES:
  18.         README                  this file.
  19.         Makefile.aix            makefile for AIX
  20.         Makefile.os2            makefile for OS/2
  21.         mbox.idl                IDL interface description
  22.         mbox.acf                attribute configuration file
  23.         client.c                client part
  24.         server.c                server main module
  25.         manager.c               server manager module
  26.         security.c              server security checking module
  27.         common.h                common header file
  28.         os2.def                 linker definition file for OS/2
  29.  
  30.  
  31. COMPILING:
  32.         AIX:          make -f Makefile.aix
  33.         OS/2:         nmake -f Makefile.os2
  34.  
  35.  
  36. SETUP SERVER:
  37.         1) Login as root and authenticate as cell_admin.
  38.         2) Create a principal called MessageBox with rgy_edit.
  39.         3) Create an account for MessageBox valid for login and
  40.            group subsys/dce/cds-server. This group implies the
  41.            right to write to the CDS namespace.
  42.         4) Create a directory in the CDS name space with the
  43.            cdscp command:
  44.            cdscp add directory /.:/Servers
  45.         5) On the machine wich runs the server application 'mbox'
  46.            export the password for the account MessageBox to the
  47.            local default keytab file. Be sure the the password is 
  48.            the same as specified for the account.
  49.            # rgy_edit
  50.            Current site is: registry server at /.:/subsys/dce/sec/master
  51.            rgy_edit==> ktadd -p MessageBox
  52.            Enter password:xxxxxxx
  53.            Re-enter password to verify:xxxxxxx
  54.            rgy_edit==> exit
  55.            bye.
  56.         6) Authenticate as MessageBox and become root.
  57.         7) Run the server application:
  58.            # mbox
  59.            Wait for the message:
  60.            .......
  61.            Server /.:/Servers/MessageBox listening.
  62.  
  63. If you rerun the server you only have to perform step 6) and 7). If you
  64. choose to run the server on a different machine additinal you have to
  65. export the password to the local keytab file (step 5).
  66.  
  67.  
  68. CLIENT USAGE:
  69.  
  70.            AIX:        message [-c] [principal] [Message ...]
  71.            OS/2:       message [/c] [principal] [Message ...]
  72.  
  73. The client application 'message' provides the user interface for the simple
  74. message queuing system. Without any arguments it look for the oldest message
  75. for your principal. If there is a message waiting for you it prints the
  76. message and discards it.
  77. If you want to send a message just type principal name and the message in the
  78. commandline of the client.
  79.  
  80. Only a principal with control rights on the CDS name space entry
  81.                 /.:/Servers/MessageBox
  82. can use the option 'c' to create a new message box for the principal given
  83. on the commandline. If you are authenticated as the principal MessageBox,
  84. you will have the control right on the entry /.:/Servers/MessageBox because
  85. MessageBox is the owner of this entry. But you can change the ACLs on that
  86. entry to provide access to the create option for other principals.
  87.