Technical information

DSN Parameter
User Reference
Connectivity Systems, Inc.—Copyright © 2006
Use Pursuant to Company Instructions
6-27
.Gnnnn[Vnnn] Specifies a disk version by generation number.
Insert the generation number after the G, but before
the V, if a generation number exists. The Vnnn
portion of the parameter is ignored by BIM-EPIC
and can be omitted. The Vnnn portion is included
for MVS compatibility only. In practice, as in MVS,
this form is not usually used. Use - or + forms
instead.
(0)
(-n)
(+n)
Specifies a version-by-version number.
 (0) Zero indicates the current version.
 (-) Minus indicates a previous version for input.
 (+) Plus indicates a new version for output.
!
WARNING:
For generation datasets used as input, if a dataset
name does not contain a version, all existing
versions of the dataset will be concatenated and
read!
For MVS compatibility, a 0 (zero) specifies the
current version instead of 1, as in the DSN Catalog.
That means when you enter a version number
containing a minus sign, the version number should
be one less than the DSN Catalog version number.
For example, if the DSN Catalog version number is
3, specify DSN=dataset-name(-2).
Note: You do not need to specify (+n) for output
datasets. Specifying the dataset name is sufficient to
create a new version. However, if the DDGEN
configuration parameter is set to YES, specifying
(+n) with DISP=(x,CATLG) causes disk datasets to
be cataloged as generation datasets. If DDGEN is
set to NO and you do not specify LABEL=RETPD
or LABEL=EXPDT, the dataset is cataloged as a
non-generation dataset.
area Specifies which ISAM dataset area is being defined.
 INDEX indicates the cylinder index component.
 PRIME indicates the prime data area.
 OVFLOW indicates the overflow area.
Subparameter Definition