APF

This service lists the current authorized program libraries and their volume serial numbers.

This service also:

selectively lists libraries by data set name, partial data set name, or volume serial number
adds a new entry to the APF list; authorizes link list data sets that were not authorized at IPL
deletes an entry from the APF list
changes the volume serial number for an entry in the APF list
provides ability to change the volume serial number for an entry in the APF list
provides ability to selectively modify the link list after adding or deleting an entry from the APF list
provides option to omit the volser on any command; unlike the SETPROG command and the CSVAPF macro, which require the specification of a volser, the APF service scans the catalog for the correct volser if one is not specified

Syntax

The parameters are defined as follows:

Parameter	Description
dsname	specifies the data set name of the authorized library
partialDsname	represents the first characters of a data set name For instance, if you type APF RXA15, the service lists every data set that has a prefix of RXA15.
volser	specifies the volume serial number If a volser is not specified, the cataloged volser for the data set is used. If SMS is specified as the volser, SMS will manage the data set. If ****** is specified as the volser, the system residence volume is used.
ADD	adds the specified data set on the specified volume to the APF list
DELETE	deletes the specified data set from the APF list
CHANGE	changes the volser on which the data set resides to the volume that follows If a volser is not specified, the cataloged volser for the data set name is used. If SMS is specified as the volser, SMS will manage the data set. If ****** is specified as the volser, the system residence volume is used.

Example 1

To list all entries in the APF list, type

APF

                                [1]       [2]
AMTA71I   APF LIST AT LOCATION 01B08000 HAS 201 ENTRIES
                   [3]                 [4]
AMTA72I   VOLUME OPNS00    DSN RES1.RES31.BBLINK

Legend:

hexadecimal address of the APF list in storage
APF list
volser of the authorized library, *SMS*, or ******
data set name of the authorized library

Note

The APF service repeats message AMTA72I for every entry in the APF list.

Example 2

To list all APF entries that start with RES1, type

APF RES1

AMTA77I THE FOLLOWING ENTRIES MATCHED THE REQUEST
AMTA72I VOLUME OPNS00 DSN RES1.RES31.BBLINK

Example 3

To list all APF entries for any data set on volser OPNS00, type

APF,,OPNS00

AMTA72I VOLUME OPNS00 DSN RES1.RES30.BBLINK

Note

The two commas indicate omission of the first parameter.

Example 4

To create a new entry in the APF list for RES1.RES30.BBLOAD, residing on OPNS01, type

APF RES1.RES30.BBLOAD,OPNS01,ADD

AMTA73I APF LIST NOW CONTAINS ENTRY FOR
AMTA72I VOLUME OPNS01 DSN RES1.RES30.BBLOAD

Example 5

To create a new entry in the APF list for a cataloged data set, type

APF RES1.RES30.BBLOAD,ADD

AMTA73I APF LIST NOW CONTAINS ENTRY FOR
AMTA72I VOLUME OPNS01 DSN RES1.RES30.BBLOAD

The APF service determines where RES1.RES30.BBLOAD is cataloged and creates a new APF list with the entered data set and the cataloged volser.

Example 6

To add a data set to the APF list and have the data set managed by SMS, type

APF RES1.USER.FILE,*SMS*,ADD

AMTA73I   APF LIST NOW CONTAINS ENTRY FOR
AMTA72I   VOLUME *SMS*     DSN RES1.USER.FILE
AMTA7MI   SMS MANAGED DATASET RES1.USER.FILE

Example 7

To remove an entry from the APF list, type

APF RES1.RES30.BBLOAD,OPNS01,DELETE

AMTA74I APF LIST ENTRY DELETED FOR
AMTA72I VOLUME OPNS01 DSN RES1.RES30.BBLOAD

Example 8

To change the volser of an existing APF entry, type

APF RES1.RES30.BBLOAD,OPNS01,CHANGE,PERF01

AMTA75I APF LIST ENTRY CHANGED. OLD VOLUME SER OPNS01 IS NOW
AMTA72I VOLUME PERF01 DSN RES1.RES31.BBLOAD