Commands for creating, testing, and troubleshooting a RACF-Offline database

You can test RACF®-Offline by issuing some RACF commands in the RACF-Offline environment. Running any of the RACF-Offline functions requires RACF access to the authorization profiles. You also need access to an offline RACF database.

Creating an Offline RACF database

The example job B8RJUT2 provides the JCL to create a copy of the RACF database.

//STEP1   EXEC PGM=IRRUT200
//SYSPRINT  DD SYSOUT=*
//SYSIN     DD DUMMY
//SYSUT2    DD SYSOUT=*
//SYSRACF   DD DISP=SHR,DSN=Your-System-RACF-database
//SYSUT1    DD DISP=(NEW,CATLG),DSN=Your-Offline-database,
//             UNIT=3390,SPACE=(4096,space,,CONTIG,ROUND),
//             DCB=(LRECL=4096,RECFM=F)

You can adapt this job for your environment, or use your standard installation job for creating a copy of the RACF database. When using sample job B8RJUT2, specify the correct names and sizes for the RACF databases. In this JCL sample, the space is specified in blocks of 4 KB. If your current RACF database is allocated on an IBM® 3390 Direct Access Storage Device in cylinders, you can multiply the number of cylinders by 180 to find the number of blocks required.

Running commands against the Offline RACF database

After you have created a copy of the RACF database, you can use that RACF database to run some RACF-Offline commands. The member B8RJTST in the RACF-Offline installation library contains the following test JCL that runs RACF-Offline commands.

//RUNIT    EXEC PGM=B8RACF
//STEPLIB  DD DISP=SHR,DSN=Your-Product.SB8RLNK
//SYSTSPRT DD SYSOUT=*
//SYSTSIN  DD *
LU
END
//B8RPARM  DD *
RACFDB 'Your-Offline-database'
SMF ID($B8R)
//

Adapt this JCL for your environment, then run the job. The following example shows the output from the job.

B8R121I B8ROPT options module successfully processed
B8R274I RACF DB used is BCSC.ROFFLINE.TESTDB
B8R304I New SMF-ID: $B8R
B8R143I B8RPARM file processed
B8R200A Enter RACF Command or "END"
LU
USER=B8RTEST  NAME=UNKNOWN  OWNER=B8R       CREATED=03.169
 ...
SECURITY-LABEL=NONE SPECIFIED
B8R200A Enter RACF Command or "END"
END

Troubleshooting

If you receive RACF error messages such as IRR51004I, IRR51011I, or IRR52115I, or if you encounter an ABEND 483-024, update the Offline RACF database with the current templates by running IRRMIN00 with PARM=UPDATE.