\
****    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 <userdisk>:[<local_build_area>.]
     $ 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.