CA Dynam for VSE User Guide

Using DYNACC
DYNACC communicates with calling programs using a communications area or
parameter list called DYNINFO. Significant enhancements were made to
DYNACC Version 1, as shipped with CA Dynam r5.3 and additional fields have
been added to DYNINFO. However, changes have been made in a way which
should be compatible with existing programs. Because both Version 1 and
Version 2 formats are supported by DYNACC, there is no mandatory
requirement to change to the new format.
Testing DYNACC Programs
DYNATEST is a new feature in DYNACC Version 2. The DYNATEST macro has
been provided as an easy way of learning about DYNACC, the differences
between Version 1 and Version 2, and for prototyping strategies for retrieving
Catalog information. DYNATEST will generate a program to exercise any
DYNACC function and will print a report detailing the results. Programs can be
generated to use either Version 1 or Version 2 parameter lists and will execute
on any supported operating system. You may use the generated programs as
a guide when developing your own programs.
DYNINFO Parameter List Generation
The DYNINFO parameter list used to control DYNACC is generated by copying
a definition in the appropriate language from the library in which CA Dynam is
installed. Assembler programs should invoke the DYNINFOA macro directly.
For more information, see DYNINFO Parameter List or perform a test assembly
invoking the DYNINFOA macro with no parameters for a description.
Detailed documentation on DYNINFO and DYNACC function and return codes
has been built into DYNINFOA and is printed when that macro is invoked with
INFO=YES (the default) as a parameter.
Using DYNACC
DYNACC is supplied as a relocatable object module suitable for linking with a
calling program. DYNACC resides in the library in which CA Dynam was
installed. DYNACC Version 2 is a root module which dynamically invokes a
separate service module depending on the version of the parameter list.
DYNACC is approximately 1K bytes in length. It has one entry point. DYNACC
uses CA Dynam system functions and so will only execute if CA Dynam is
installed and available.
Under CMS, provided CA Dynam can be located, DYNACC will activate the
System Adapter automatically, if necessary. Under VSE, the System Adapter
must already be active when DYNACC is first invoked.
10–2 User Guide