Index of  //675502.arinterhk.tech/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.

NameRevisedSizeDescription
[TXT]DUMMYEMMADDIN.C23-Mar-2010 08:305,221C source
[TXT]DUMMYEMMADDIN.OPT 7-Aug-2002 11:16606VMS linker options
[TXT]DUMMYEMMADDINFNS.C23-Mar-2010 08:301,746C source
[TXT]DUMMYEMMADDINFNSPI.H23-Mar-2010 08:301,301C header
[TXT]DUMMYEMMADDINFNS_ERR.H23-Mar-2010 08:30758C header
[TXT]DUMMYEMMADDIN_BUILD.COM 6-Jan-2003 15:251,774DCL procedure
[TXT]DUMMYEMMADDIN_INSTALL.COM 9-Aug-2002 08:49522DCL procedure
[TXT]DUMMYEMMADDIN_SIGN.COM30-Aug-2004 13:311,412DCL procedure
[TXT]MAF_ACL.H23-Mar-2010 08:301,893C header
[TXT]MAF_API.H23-Mar-2010 08:30101,952C header
[TXT]MAF_CALLOUTS.H23-Mar-2010 08:306,657C header
[TXT]MAF_COLLECTN.C23-Mar-2010 08:3027,283C source
[TXT]MAF_COLLECTN.H23-Mar-2010 08:307,027C header
[TXT]MAF_CONFIG.H16-Jul-2004 09:092,797C header
[TXT]MAF_DBG.H23-Mar-2010 08:30350C header
[TXT]MAF_DLLMAIN.C23-Mar-2010 08:3084,581C source
[TXT]MAF_INCLUDE.H23-Mar-2010 08:302,553C header
[TXT]MAF_INTEG.C23-Mar-2010 08:3032,721C source
[TXT]MAF_INTEG.H23-Mar-2010 08:301,890C header
[TXT]MAF_INTERFACE.H23-Mar-2010 08:307,661C header
[TXT]MAF_LIST.H23-Mar-2010 08:30678C header
[TXT]MAF_MDS.C23-Mar-2010 08:3022,824C source
[TXT]MAF_MDS.H23-Mar-2010 08:302,150C header
[TXT]MAF_MISC.C23-Mar-2010 08:3012,355C source
[TXT]MAF_MISC.H23-Mar-2010 08:302,676C header
[TXT]MAF_UTIL.H23-Mar-2010 08:309,157C header
[TXT]MAF_VALIDATE.H23-Mar-2010 08:303,636C header
[TXT]MDS_UTIL.H23-Mar-2010 08:3024,092C header
[TXT]MODINSTALL.C23-Mar-2010 08:304,330C source
[TXT]README.TXT 6-Jan-2003 12:513,128plain text