The system automatically informs VLF of all PDS updates made through
IBM-supplied code. Thus, for PDS classes, your application does not
need to notify VLF about PDS updates unless your installation uses
its own private method of updating partitioned data sets.
If you need to notify VLF that an object, or some set of objects,
in VLF storage is no longer valid, issue the COFNOTIF macro. You
normally use COFNOTIF to inform VLF of changes to the permanent data
kept on auxiliary storage devices, to ensure that the VLF objects
reflect the current level of the permanent data on DASD.
To issue COFNOTIF, you must specify:
- The major name or a list of major names. The structure of the
major name for PDS classes consists of the following elements:
- 6-character volume serial number (padded with blanks if necessary)
- PDS name (44-characters maximum), padded with blanks to equal
the MAJLEN value.
For example, where the volume serial number is VOL123 and
the data set name is MYPDS, specify VOL123MYPDS, padded with blanks
as required.
- The type of change you are reporting. A change to a minor name
affects only the minor name within the major name specified on the
MAJOR parameter.
VLF views a minor name with one or more alias
names as separate objects. Thus, to change a minor name, you must
issue COFNOTIF for the minor name and for each alias name.
Specify the type of change with the FUNC parameter, as follows:
- FUNC=DELMAJOR — specifies that one or more major names have
been deleted. VLF deletes all objects with those major names.
- FUNC=DELMINOR — specifies that one or more minor names have
been deleted. VLF deletes any object with a matching minor name.
With FUNC=DELMINOR, you must specify MINLIST to identify the minor
name(s). When MAJOR is specified and the class is a non-PDS class,
only matching minor names within that major name are deleted. Otherwise,
all objects matching the minor name(s) in all PDS classes are deleted.
- FUNC=ADDMINOR — specifies that one or more minor names have
been added to a major name. With FUNC=ADDMINOR, you must specify MINLIST
to identify the minor name(s).
- FUNC=UPDMINOR — specifies that one or more objects corresponding
to existing minor names have been changed. With FUNC=UPDMINOR, you
must specify MINLIST to identify the minor name(s).
- FUNC=PURGEVOL — specifies that a physical storage device
has been logically disconnected from the system, or that all of the
information on the device has been deleted or replaced. With FUNC=PURGEVOL,
you must specify VOLUME to identify the volume serial number of the
volume.
For non-PDS classes, you must specify CLASS to restrict the changes
to a single class. If you omit CLASS or use CLASS to specify the name
of a PDS class, VLF assumes that the change affects all PDS classes.