CA Dynam for VSE User Guide

General Reporting−DYNPRINT
The DYNREAD Interface
DYNREAD is the user module supplied with DYNPRINT. It is used by all
programs operating under DYNPRINT control to access data from the CA
Dynam Catalog, disk VTOCs and to obtain access to CA Dynam System
Adapter services. In order to create your own custom or as-needed reports,
you need to understand how to use it.
DYNREAD operates as a single interface between the CA Earl program and the
various service providers. The CA Earl program, CA Earl runtime routines and
DYNREAD communicate with each other through two data areas. These are the
first two parameters passed by CA Earl to a file module. They are the function
parameter list, also referred to by CA Earl as the record area, and the
communications area. The first eight bytes of the function parameter list
contain the function code and indicate the service required.
On entry, DYNREAD analyzes the function code and invokes the service
provider in the appropriate manner, passing the function parameter list
according to the conventions supported by the service provider.
Upon return, DYNREAD analyzes the function return code and sets indicators in
the form required by CA Earl to indicate whether the operation succeeded.
These indicators and other return information maintained by DYNREAD are all
contained in the CA Earl/DYNREAD communications area. While it isn't
required for CA Earl to analyze or process the CA Earl/DYNREAD
communications area, a CA Earl-language definition of this area is supplied
with DYNPRINT and is called EARLCOMM.
The version of CA Earl supplied with CA Dynam does not support the use of
any user modules other than DYNREAD. Nor does this version of CA Earl allow
access to, or creation of, any data files other than through DYNREAD. If you
have the fully functional version of CA Earl, then these restrictions do not
apply to you. In all other respects the functioning of the CA Earl version
supplied with DYNPRINT is identical to that of the fully functional version.
DYNREAD is invoked as a standard CA Earl file module in the following
manner:
filename: FILE DYNREAD 300 RECORD = plist-size
..
..
GET filename
When CA Earl is invoked under the control of DYNPRINT, and DYNREAD is
invoked by the CA Earl program with a function code equal to spaces,
DYNREAD checks to see whether a request has been generated by DYNPRINT
from report control statements. If so, DYNREAD copies the DYNPRINT request
into the function parameter list area and uses it for processing as if it had
been passed from the CA Earl program.
9–14 User Guide