Notifying VLF of a change

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.