The requirements for the caller are:

None.

None.

Before issuing the COFNOTIF macro, the caller does not have to place any information into any register unless using it in register notation for a particular parameter, or using it as a base register.

Some callers depend on register contents remaining the same before and after issuing a service. If the system changes the contents of registers on which the caller depends, the caller must save them before issuing the service, and restore them after the system returns control.

None.

The standard form of the COFNOTIF macro is written as follows:

The parameters of the standard form are explained as follows:

FUNC=DELMAJOR

FUNC=DELMINOR

FUNC=ADDMINOR

FUNC=UPDMINOR

FUNC=PURGEVOL

Is a required parameter that indicates the nature of the change that you are reporting. The meaning of each value is as follows:

• FUNC=DELMAJOR specifies that one or more major names have been deleted.
• FUNC=DELMINOR specifies that one or more minor names have been deleted from a major name.
• FUNC=ADDMINOR specifies that one or more minor names have been added to a major name.
• FUNC=UPDMINOR specifies that the objects corresponding to one or more existing minor names have been changed.
• 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.

,MAJLIST=majlist

Identifies the list of major names with which the change is associated. When you specify FUNC=DELMAJOR, you must specify MAJLIST to identify the major name(s) VLF is to delete. If the list contains more than one major name, you must also specify MAJNUM. Each major name in the list must be the same length. If the major name length is not 64, you must also specify MAJLEN.

Use the following structure to specify the major name for a PDS class:

• 6-character volume serial name (padded with blanks if necessary)
• PDS name (a maximum of 44 characters), padded with blanks to equal 64 or the MAJLEN value.

For example, assume that you want to delete the major name MYPDS that resides on volume VOL123. Specify VOL123MYPDS, padded with blanks as required.

,MAJNUM=majnum

An optional halfword parameter that contains the number of major names in the major name list. The default is 1.

,MAJLEN=majlen

An optional halfword parameter that contains the length of each input major name. The default is 64.

Note: VLF uses the length you specify to scan the major name list. The length of the significant part of the name (the part VLF uses to search its storage for objects with that major name) depends on the value specified for the major name on the COFDEFIN macro that defined the class. If the COFDEFIN length is greater than the COFNOTIF length, VLF pads the name on the right with blanks.

,MAJOR=major

Identifies the major name associated with the change to one or more minor names. When you specify FUNC=DELMINOR, FUNC=ADDMINOR, or FUNC=DELMINOR, you must specify MAJOR. If the length is not 64, you must also specify MAJLEN.

Use the following structure to specify the major name for a PDS class:

• 6-character volume serial name (padded with blanks if necessary)
• PDS name (a maximum of 44 characters), padded with blanks to equal 64 or the MAJLEN value.

For example, assume that you want to delete the major name MYPDS that resides on volume VOL123. Specify VOL123MYPDS, padded with blanks as required.

,MINLIST=minlist

Identifies the list of minor names with which the change is associated. When you specify FUNC=DELMINOR, FUNC=ADDMINOR, or FUNC=UPDMINOR, you must specify MINLIST. If the list contains more than one minor name, you must also specify MINNUM. If the length is not 64, then you must also specify MINLEN. Each name in the list must be the same length.

,MINNUM=minnum

An optional halfword parameter that contains the number of minor names in the minor name list. The default is 1.

,MINLEN=minlen

An optional halfword parameter that contains the length of each name in the input minor name list. The default is 64.

Note: VLF uses the length you specify to scan the minor name list. The length of the significant part of the name (the part VLF uses to search its storage for objects with that minor name) depends on the value specified for the minor name on the COFDEFIN macro that defined the class. If the COFDEFIN length is greater than the COFNOTIF length, VLF pads the name on the right with blanks.

,VOLUME=volume

Specifies the volume serial number of a resource that was logically removed from the system. Specifying VOLUME causes VLF to purge any objects related to the resource identified.

Specify VOLUME only for objects with major names that correspond to PDS names and only when you also specify FUNC=PURGEVOL.

,CLASS=class

Specifies a 7-byte field that identifies the name of the class associated with the change. CLASS is an optional parameter. Specify CLASS only for a non-PDS class. If you omit CLASS or specify a PDS class, VLF assumes that the change being reported applies to all PDS classes.

,RETCODE=retcod

Specifies the location where the system is to store the return code. The return code is also in general purpose register (GPR) 15. If you specify a storage location, it must be on a fullword boundary.

,RSNCODE=rsncod

Specifies the location where the system is to store the reason code. The reason code is also in GPR 0. If you specify a storage location, it must be on a fullword boundary.

None.

When the COFNOTIF macro returns control to your program, GPR 15 (and retcod, if you coded RETCODE) contains one of the following hexadecimal return codes. GPR 0 (and rsncod, if you coded RSNCODE) contains one of the following hexadecimal reason codes.