CA Dynam for VSE User Guide

DYNINFO Parameter List
If the OE call is used to set the EARL flat file option, no more than one volume
or extent will be returned at a time by DYNACC. If the file version is spread
over more than one volume or extent, DYNRTCOD will be set to 28 regardless
of the amount of space reserved for DYNINFO. In this case DYGNVOLS will
never be greater than one.
DYNREQST
DYNRQDSN
Contains all input variables to DYNACC. If an optional field is to be omitted, it
must be cleared to spaces before calling DYNACC. Selection fields which
contain other values, for example, binary zeros, will be evaluated by DYNACC
as selection fields.
Required for DD and GD calls. Otherwise, it must be spaces.
For GD calls, all data sets which match all characters before the leading space
will be returned. On DD calls, if an exactly matching DSN is not found,
DYNRTCOD 12 is set. On GD calls, on the call after all matching data sets have
been returned (if any) DYNRTCOD 20 is set. For GD calls, DYNRQDSN must
contain at least one nonblank character, else DYNRTCOD 32 (SYNTAX ERROR)
and DYNERCOD 8 (GENERIC KEY ALL SPACES) is set.
DYNRQPSW
DYNRQVER
DYNRQGEN
DYNRQGDG
DYNRQVOL
For password-protected data sets, if no password is supplied, for any call
except a DD, DYNRTCOD 16 is set and only the DSN is returned. On a DD call
for a password-protected data set, if no password is supplied or doesn't
match, DYNRTCOD 40 is set and the call is terminated.
Optional for DD calls. Otherwise must be spaces. It is the disk or tape data set
version number, relative to the most current version (version one) to be
retrieved. Test ($TEST job), scratch and invalid versions (such as, open not
closed) are ignored. If not found, DYNRTCOD 8 is set. May not be specified in
conjunction with DYNRQGEN, DYNRQGDG, or DYNRQVOL. If DYNRQVER,
DYNRQGEN, DYNRQGDG, and DYNRQVOL are all spaces, the most current
version (version one) is returned.
Optional for DD calls. Otherwise must be spaces. It is the CA Dynam/D disk
data set generation number to match against in the catalog. If not found,
DYNRTCOD 8 is set. May not be specified in conjunction with DYNRQVER,
DYNRQGDG or DYNRQVOL.
Optional for DD calls. Otherwise must be spaces. It is the OS or MVS
Generation Data Group identifier to match against in the Catalog. If not found,
DYNRTCOD 8 is set. May not be specified in conjunction with DYNRQVER,
DYNRQGEN, or DYNRQVOL.
Required for DV and GV calls. Optional for DD calls. Otherwise must be spaces.
For DV calls, it is used to specify the exact volser to retrieve. If not found,
DYNRTCOD is set to 8. If the volser contains no active files (is a scratch),
complete volume information (but no data set or version information except
for the most recently active data set name) is returned, and DYNRTCOD is set
to 6.
Chapter 10: Accessing the Catalog 10–13