Index of  //starlet.deltatel.ru/sys$common/syshlp/examples/cdsa/DUMMYEMMADDIN/*.*

\
****    DUMMYEMMADDIN_README.TXT    ****

This CDSA example is an Entity Module Manager, which extends
the functionality of CDSA by providing an additional category
of service. 

It's purpose is to demonstrate the mechanics of developing 
a CDSA EMM (which on OpenVMS is a shareable image).

It also provides the necessary CDSA code files that would be 
necessary to build an Entity Module Manager.

The installation procedure will verify that it is built 
correctly.  It will attach the module and execute
RegisterCDSAModule(), (the definition of INSTALL_ENTRY_NAME).

********************
**  Special Note  **
********************

Sys$common:[syshlp.examples.cdsa]readme.txt contains general
information that applies to all of the example programs that are signed.

The necessary files to build the example on OpenVMS are included,
with the exception of modselfkey.h.  This include file must be
generated from the certificate created for the addin module(s).

See the OpenVMS book "Open Source Security for OpenVMS, Volume 1: Common Data
Security Architecture", CDSA Programing Concepts, for complete instructions.
Special attention should be paid to the section on Signed Application Development.

A signed CDSA application will not execute until the proper credentials are
generated.

The DUMMYEMMADDIN example files are:

DUMMYEMMADDIN.C     DUMMYEMMADDINFNSPI.H     DUMMYEMMADDIN_BUILD.COM
DUMMYEMMADDINFNS.C  DUMMYEMMADDINFNS_ERR.H   DUMMYEMMADDIN_SIGN.COM
MAF_COLLECTN.C      MAF_ACL.H                DUMMYEMMADDIN_INSTALL.COM
MAF_DLLMAIN.C       MAF_API.H                DUMMYEMMADDIN.OPT
MAF_INTEG.C         MAF_CALLOUTS.H
MAF_MDS.C           MAF_COLLECTN.H
MAF_MISC.C          MAF_CONFIG.H
MODINSTALL.C        MAF_DBG.H
                    MAF_INCLUDE.H
                    MAF_INTEG.H
                    MAF_INTERFACE.H
                    MAF_LIST.H
                    MAF_MDS.H
                    MAF_MISC.H
                    MAF_UTIL.H
                    MAF_VALIDATE.H
                    MDS_UTIL.H
                    (MODSELFKEY.H not provided, user generated)

After performing the steps to generate the application credentials
and the include file, modselfkey.h, the DUMMYEMMADDIN example program 
can be built by copying the example files to a local build 
area, and executing the DUMMYEMMADDIN_BUILD command file, as follows:

     $ define/trans=conceal cdsa_tempdir :[.]
     $ set default cdsa_tempdir:[DUMMYEMMADDIN]
     $ copy SYS$SYSROOT:[SYSHLP.EXAMPLES.CDSA.DUMMYEMMADDIN]*.* []
     $ copy CDSA_SYSDIR:[SIGN]MODSELFKEY.H []
     $ @DUMMYEMMADDIN_BUILD

The resulting shareable image is DUMMYEMMADDIN_SHR.EXE. 

       **************
On the SIGNING SYSTEM run the command procedure to generate the manifest.
       **************

     $ @DUMMYEMMADDIN_SIGN

Finally back on the development system run the command procedure
to install the module.

    $ @DUMMYEMMADDIN_INSTALL

The addin module is now ready to be invoked by an application program.

  Name                                 Created         Size  Description

  DUMMYEMMADDIN.C            22-Mar-2010 18:31        5,221  C source
  DUMMYEMMADDIN.OPT           7-Aug-2002 11:16          606  VMS linker options
  DUMMYEMMADDINFNS.C         22-Mar-2010 18:31        1,746  C source
  DUMMYEMMADDINFNSPI.H       22-Mar-2010 18:31        1,301  C header
  DUMMYEMMADDINFNS_ERR.H     22-Mar-2010 18:31          758  C header
  DUMMYEMMADDIN_BUILD.COM     6-Jan-2003 15:25        1,774  DCL procedure
  DUMMYEMMADDIN_INSTALL.COM   9-Aug-2002 08:49          522  DCL procedure
  DUMMYEMMADDIN_SIGN.COM     30-Aug-2004 13:31        1,412  DCL procedure
  MAF_ACL.H                  22-Mar-2010 18:31        1,893  C header
  MAF_API.H                  22-Mar-2010 18:31      101,952  C header
  MAF_CALLOUTS.H             22-Mar-2010 18:31        6,657  C header
  MAF_COLLECTN.C             22-Mar-2010 18:31       27,283  C source
  MAF_COLLECTN.H             22-Mar-2010 18:31        7,027  C header
  MAF_CONFIG.H               15-Jul-2004 15:11        2,797  C header
  MAF_DBG.H                  22-Mar-2010 18:31          350  C header
  MAF_DLLMAIN.C              22-Mar-2010 18:31       84,581  C source
  MAF_INCLUDE.H              22-Mar-2010 18:31        2,553  C header
  MAF_INTEG.C                22-Mar-2010 18:31       32,721  C source
  MAF_INTEG.H                22-Mar-2010 18:31        1,890  C header
  MAF_INTERFACE.H            22-Mar-2010 18:31        7,661  C header
  MAF_LIST.H                 22-Mar-2010 18:31          678  C header
  MAF_MDS.C                  22-Mar-2010 18:31       22,824  C source
  MAF_MDS.H                  22-Mar-2010 18:31        2,150  C header
  MAF_MISC.C                 22-Mar-2010 18:31       12,355  C source
  MAF_MISC.H                 22-Mar-2010 18:31        2,676  C header
  MAF_UTIL.H                 22-Mar-2010 18:31        9,157  C header
  MAF_VALIDATE.H             22-Mar-2010 18:31        3,636  C header
  MDS_UTIL.H                 22-Mar-2010 18:31       24,092  C header
  MODINSTALL.C               22-Mar-2010 18:31        4,330  C source
  README.TXT                  6-Jan-2003 12:51        3,128  plain text