z/OS V1R6.0 DFSMS Access Method Services for Catalogs

DEFINE NONVSAMYou can code DEVICETYPES(0000) if the VOLUMES parameter specifies anindirect volume serial (’******’), or an extended indirect volume serial (a systemsymbol). A value of DEVICETYPES(0000) will cause the actual device type tobe determined from the current system residence volume (or its logicalextension) at the time the catalog entry is retrieved. DEVICETYPES(0000) isonly valid with an indirect volume serial specification in the VOLUMESparameter.In addition to the above, if you are using the symbolic form of volume serials,the volume must be mounted and online at the time the catalog entry isretrieved from the catalog. If it is not, the catalog request will be terminatedwith a return and reason code.Exception: DEVICETYPES is not applicable for an OAM non-VSAM entry andis ignored if specified.Abbreviation: DEVTVOLUMES(volser[ volser...])specifies the volumes to contain the non-VSAM data set. VOLUMES isrequired when you define a non-OAM non-VSAM data set.There are two special forms of the VOLUMES parameter that can be provided,and they are referred to as the indirect volume serial forms. They result in thesystem dynamically resolving the volume serial to the system residence (or itslogical extension) serial number when the catalog entry is retrieved. It is notresolved when the DEFINE NONVSAM is processed. This allows you to laterchange the volume serial number(s) of the system residence volume (or itslogical extensions) without having to recatalog the non-VSAM data sets onthose volumes.The two special forms are:1. VOLUMES(******)2. VOLUMES(&xxxxx), where &xxxxx is a symbol contained in theSYS1.PARMLIB IEASYMXX member that was specified at IPL time. Thesymbol name is intended to represent the volume that is a logical extensionof the system residence volume. The symbol name must be specified as asingle, simple (not substringed) symbol of no more than six charactersincluding the leading ampersand. If a symbol is intended to represent asix-character volume serial number, the symbol must be six characters longand the ending period must be omitted. As an example:VOLUMES(&SYSR2)If &SYSR2 has been defined at IPL by an entry in the IEASYMxx member,the value of that symbol will be used when this catalog entry is retrievedfrom the catalog. If the symbol is not defined, the value returned for thevolume serial will be &SYSR2.IBM recommends the use of the symbol &SYSR2 for the first logicalextension to the system reference volume, &SYSR3 for the second, and soon.Exception: VOLUMES is not applicable for an OAM non-VSAM entry and isignored if specified.If you code VOLUMES(******), then the system dynamically resolves this to thesystem residence volume serial number whenever the catalog entry is used. Itis not resolved when the DEFINE NONVSAM is processed. This allows you toChapter 16. DEFINE NONVSAM 183