CA Dynam for VSE User Guide

DYNINFO Parameter List
For GV calls, tape volumes which match the characters before the leading
space are returned. On the call after the last matching volser has been
returned, DYNRTCOD 24 is set. DYNRTCOD 6 is set for volumes with no active
files (scratches). A key of at least one nonblank character must be supplied,
otherwise DYNRTCOD 32 (SYNTAX ERROR) and DYNERCOD 16 (VOLSER
GENERIC KEY ALL SPACES) is set.
For DD calls, it is used to request that the version of the tape data set which
resides on a specific volume is returned. If the volume does not contain an
active version of the data set, DYNRTCOD 8 is set. May not be specified in
conjunction with DYNRQVER, DYNRQGEN or DYNRQGDG.
DYNRQVSQ
Optional for DD calls. Otherwise must be spaces. It may be specified in
conjunction with version selectors (DYNRQVER, DYNRQGEN, DYNRQGDG, or
DYNRQVOL).
It is used to specify the starting volume sequence number for a multivolume
tape file (relative to 1) or the relative extent sequence number for multiextent
disk files (relative to 1). DYNRQVSQ is useful where DYNINFO is not
large enough to hold all volumes or extents for a data set version. If a SD, GD,
DD, or NG call results in DYNRTCOD being set to 28, set up a DD call for the
data set with DYNRQVSQ set to one greater than the number of volumes
retrieved so far. The DYNVBREC array is filled with as many volumes as exist
and will fit, starting at this volume sequence number.
DYGNVOL always contains the number of tape or disk entries actually returned
for a specific call. DYGVOLS contains the total number of volumes or extents
that exist for a data set version. DYNNVBRS indicates the number of tape
volumes which will fit in DYNINFO. More than this number of disk entries will
fit, as disk entries are smaller. If more exist than will fit, as many as will fit are
returned, DYNRTCOD is set to 28, and DYNRTLEN is set to indicate the length
that would have been required to accommodate all that exist, starting at the
volume sequence number specified in DYNRQVSQ. (DYNRQVSQ is only valid
for DD calls.)
DYNRQFSQ
DYNRQDVC
Optional for DV calls. Otherwise must be spaces. It is used to indicate which
file on a multifile tape volume is to be returned, relative to 1. If this file
sequence does not exist, DYNRTCOD is set to 8. If this field is not set, the first
active file version on the tape volume is returned.
Optional for SD, GD, DD, and NG calls. Otherwise must be spaces. It is used to
select the device class of data sets and generations to be retrieved from the
Catalog. Selection values are as follows:
(blank)
T
all data sets and generations
TAPE and FI data sets and tape generations
10–14 User Guide