The HPO libraries must be allocated to use the products. There are several ways to perform these allocations, depending on how QMF and DB2 library allocations are currently performed at your site.
If QMF and DB2 libraries are allocated in a user's TSO logon procedure, review and select from allocation scenarios 1 and 2, below.
If QMF and DB2 libraries are allocated dynamically from within a CLIST or EXEC, review and select from the allocation scenarios 3 and 4, described below.
Only HPO library allocations with corresponding QMF and DB2 allocations are shown in these allocation scenarios. Any additional QMF and DB2 allocations should be left unchanged.
If explicit library allocations for QMF and DB2 libraries currently exist in a user's TSO logon procedure, set the Automatically LIBDEF and ALTLIB? configuration parameter to N (see "Step 12c. Set data set names"). Also, add explicit HPO library allocations to the same logon procedure:
//ISPMLIB DD DSN=QMFHPO.SRAAISPM,DISP=SHR // DD DSN=QMF.SDSQMLBE,DISP=SHR // DD DSN=DSN.SDSNSPFM,DISP=SHR //ISPLLIB DD DSN=QMFHPO.SRAALOAD,DISP=SHR // DD DSN=QMF.SDSQEXIT,DISP=SHR // DD DSN=QMF.SDSQLOAD,DISP=SHR // DD DSN=DSN.SDSNLOAD,DISP=SHR //ISPPLIB DD DSN=QMFHPO.SRAAISPP,DISP=SHR // DD DSN=QMF.SDSQPLBE,DISP=SHR // DD DSN=DSN.SDSNSPFP,DISP=SHR //SYSPROC DD DSN=QMFHPO.SRAACLST,DISP=SHR // DD DSN=QMFHPO.SRAAEXEC,DISP=SHR // DD DSN=QMF.SDSQCLTE,DISP=SHR // DD DSN=DSN.SDSNCLST,DISP=SHR
If explicit library allocations for QMF and DB2 libraries currently exist in a user's TSO logon procedure, set the Automatically LIBDEF and ALTLIB? configuration parameter to Y (see "Step 12c. Set data set names"). In this case, there is no need to add explicit library allocations to the TSO logon procedure.
If QMF and DB2 libraries are currently allocated dynamically from within a CLIST or EXEC, set the Automatically LIBDEF and ALTLIB? configuration parameter to N (see "Step 12c. Set data set names"). Also, add dynamic allocations for the HPO libraries to the same CLIST or EXEC that dynamically allocates QMF and DB2:
ALTLIB ACTIVATE APPLICATION(CLIST) DATASET + ('QMFHPO.SRAACLST' + 'QMFHPO.SRAAEXEC' + 'QMF.SDSQCLTE' + 'DSN.SDSNCLST') ISPEXEC LIBDEF ISPMLIB DATASET ID + ('QMFHPO.SRAAISPM' + 'QMF.SDSQMLBE' + 'DSN.SDSNSPFM') ISPEXEC LIBDEF ISPPLIB DATASET ID + ('QMFHPO.SRAAISPP' + 'QMF.SDSQPLBE' + 'DSN.SDSNSPFP') ISPEXEC LIBDEF ISPLLIB DATASET ID + ('QMFHPO.SRAALOAD')
If the QMF and DB2 load libraries are allocated using the DSQLLIB DD and the ISPF LIBDEF service, the QMFHPO.SRAALOAD library must be added to the beginning of the allocation for the DSQLLIB DD:
ALLOC DD(DSQLLIB) DA('QMFHPO.SRAALOAD' + 'QMF.SDSQEXIT' + 'QMF.SDSQLOAD' + 'DSN.SDSNEXIT' + 'DSN.SDSNLOAD') SHR REUSE ISPEXEC LIBDEF ISPLLIB LIBRARY ID(DSQLLIB)
If QMF and DB2 libraries are currently allocated dynamically from within a CLIST or EXEC, set the Automatically LIBDEF and ALTLIB? configuration parameter to Y (see "Step 12c. Set data set names"). Also, you must modify the member named RAAALLOC in QMFHPO.SRAACLST to specify the names of the QMF and DB2 libraries:
SET &QMFCLIST = &STR('QMF.SDSQCLTE') SET &QMFMLIB = &STR('QMF.SDSQMLBE') SET &QMFPLIB = &STR('QMF.SDSQPLBE') SET &DB2CLIST = &STR('DSN.SDSNCLST') SET &DB2MLIB = &STR('DSN.SDSNSPFM') SET &DB2PLIB = &STR('DSN.SDSNSPFP')
If the QMF and DB2 load libraries are allocated using the DSQLLIB DD and the ISPF LIBDEF service, you must also specify the names of those data sets in the RAAALLOC CLIST:
SET &QMFEXIT = &STR('QMF.SDSQEXIT') SET &QMFLOAD = &STR('QMF.SDSQLOAD') SET &DB2LOAD = &STR('DSN.SDSNLOAD') SET &DB2EXIT = &STR('DSN.SDSNEXIT')
The RAAALLOC CLIST will use these variables to perform the appropriate LIBDEFs and ALTLIBs for all of the HPO, QMF, and DB2 libraries (overriding any allocations made prior to invoking HPO). If the CLIST or EXEC, which you were using to allocate QMF and DB2 libraries used a dynamic STEPLIB facility to allocate the load libraries, you should manually add commands to perform the same function in the RAAALLOC CLIST.