Authorize the FDR Programs

Add the FDR library to authorized list

The FDR load library must be defined to z/OS as an APF authorized library. For ABR users, the installation steps in the following sections will not work until the library is authorized. If it is not already defined as authorized, you (or your z/OS system programmer) must do so by:

  • Updating the PROGxx member of SYS1.PARMLIB and activating the updated list with the z/OS console command: SET PROG=xx
  • If your authorized program list is in dynamic format, you can temporarily authorize the FDR load library with the z/OS console command: SETPROG APF,ADD,DSNAME=fdr.load.library,VOL=volser
  • You may also have another means of temporarily authorizing the FDR load library for installation and testing.

Remember that temporary authorization will vanish after the next IPL unless the appropriate PARMLIB member is updated.

TSO foreground authorization

Some of the foreground options available through the FDR ISPF dialogs require that some FDR programs be listed in the TSO Authorized Program Table in order to be executed with APF (Authorized Program Facility) authorization.

Functions that need TSO authorization

The functions that require APF authorization when performed in the foreground are VOLUME STATUS Report (panel A.I.5), FDREPORT (panel A.1.6), RESTORE (panel A.2), ARCHIVE and Superscratch (panel A.3), BACKUP (panel A.4), and COMPAKTOR MAP or SIMULATE (panel A.C). All of these functions can also be performed in the background, or (except COMPAKTOR) via the remote queue; if you specify the ABRGLOBL variable FOREGRND(NO), these functions will not be available in the foreground, and you will not have to provide APF authorization, for programs FDRABR and FDRCPK.

ARCHIVE or BACKUP via the Remote Queue (A.3, A.4, and A.5) requires APF authorization for program FDRABRUT if the ABRGLOBL variable DISKUPDT is specified or defaulted as “YES”, but not if it is specified as “NO”.

Additionally, the Search, Report, and Services SRS Dialog (A.S) requires APF authorization for program FDRSRSA.

TSO authorized program table

Add the FDR program names (FDRABR, FDRABRP, FDRABRUT, FDRCPK, FDREPORT, FDRMONA, FDROPVMA, FDRQUERY, and FDRSRSA) to the AUTHCMD, AUTHPGM, and AUTHTSF NAMES lists in an IKJTSOxx member. Consult the IBM Initialization and Tuning Reference for the proper syntax.

TSO PARMLIB command

The TSO PARMLIB command lists the IKJTSOxx member current in use as well as its contents. It can also syntax check a new IKJTSOxx member and activate a new member.

PARMLIB

displays the IKJTSOxx member currently in use and all of as its contents

PARMLIB LIST(AUTHPGM)

PARMLIB LIST(AUTHTSF)

displays the IKJTSOxx member currently in use and the named authorization list.

PARMLIB CHECK(xx)

syntax checks a new or updated IKJTSOxx member.

PARMLIB UPDATE(xx)

activates member IKJTSOxx.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*