RACF Utilities HTML readme file.
1. Overview of utilities
2. Release Notes
3. Quick Reference
4. More detailed notes on each utility
5. Sample JCL used to obtain input data
1. Overview of
utilities
The idea of these utilities is to take a flatfile download from the mainframe
onto the PC and then process it to produce reports and or JCL. The JCL can be
checked and when you are satisfied it will do what you want you then upload it
onto the mainframe and submit it as with any other JCL.
To get started you will need to get the flat file download from RACF, one or
more of these utilities, and a suitable RACF.INI file. I have supplied sample
JCL at the end for obtaining the flat file from RACF although this is well
documented in the IBM manuals. The utilities can be downloaded from my home
page much as with this readme.htm file. The home page also has a sample
RACF.INI file, which should be downloaded.
The sample RACF.INI file is expecting to find the flat file input in the
sub-directory prod and with a filename of racfprod.
The output refers to the prefix on the output files. For example utility
RACF02.EXE will write its output to file ???02.HTM and ???02.JCL where ??? is the output string defined. Hence the sample RACF.INI defines the
output files as RACF02.HTM and RACF02.JCL.
When transferring the flat file to PC the ASCII and CR/LF options should be selected
so that the PC file is a conventional ASCII text file.
Essentially, I keep all my programs in a 'RACF' directory. Then under that in
sub-directories called DEV and PROD I copy the flat file. Also residing in DEV
and PROD are the RACF.INI files. The main purpose of these is to tell the
programs which flat file to look at, although they contain some other self
explanatory stuff as well.
I have my ..\RACF directory defined in my PATH statement and simply change
directory into the desired directory, i.e. DEV or PROD and the utilities look
for an ini file in the current directory.
..\RACF\RACF*.EXE -- directory included in PATH
this is also the directory used for comparison
utilities, namely RACF35 and RACF40
..\RACF\DEV\RACF.INI -- ini file
\RACFDEV -- downloaded ASCII flat file
\RACF*.HTM -- generated html reports
\RACF*.JCL -- generated jcl
..\RACF\PROD\RACF.INI
\RACFPROD
\RACF*.HTM
\RACF*.JCL
2. Release
Notes
Release 1.10 dated 4 July 2001
RACF38 and RACF69 bug fixes.
Bug fixes were required due to differences in the resultant data downloaded
depending on method used for file transfer. These utilities were originally
developed around native 3270 terminal emulator
Release 1.09 dated
RACF36 bug fix.
Readme updated to include revised notes on RACF68
Release 1.08 dated 25 March 2001
RACF07, RACF12 changed in two ways,
first length restriction which was pre-html format has been removed from the
installation data field giving much more info and making the reports much more
readable, and second the WARNING attribute has been added to the information.
Release 1.07 dated
RACF92 added to list all users.
All html reports have also been amended so that the title displays both the
name and date of the unload file from which the report was generated.
Minor cosmetic fixes made to RACF07, RACF09,
RACF12, RACF38, RACF53
Sample reports.bat
and associated reports.htm
now available. Save these to the directory containing the unload and racf.ini
files, run the reports.bat file and then view reports.htm.
Release 1.06 dated
RACF89 minor fix to show correct owner on dataset
profiles.
Also, readme.htm (i.e. this file) corrected not to force web access when
following internal links within the readme file.
Release 1.05 dated 24 January 2001
Utilities have had all conversions to uppercase removed except in RACF08 so
that they are capable of handling lower case data such as irrcerta supplied User ID.
Minor fix to RACF37
RACF00 and RACF91 have been added.
RACF01, RACF02, RACF11,
RACF66 updated to include v2.10 changes such as LNOTES
and KERB segments etc.
RACF17, RACF39, RACF40,
RACF41 have all been discontinued.
Release 1.04 dated
Utilities which were previously written for CICS classes and had the class
names hard coded have now been converted to operate on classes specified on the
command line parameters.
Utilities amended are RACF16, RACF22,
RACF33, RACF34, RACF35,
and RACF37.
(Utilities RACF17, RACF39, RACF40 and RACF41 have been dropped as they were
CICSCMD versions of CICSTRN utilities and are no longer required as the CICSTRN
versions have been made generic)
Release 1.03 dated 1 September 2000
RACF42 extended to list all discrete profiles with ALTER
access, i.e. DATASET and General Resource not just DATASET as before.
Release 1.02 dated 21 July 2000
RACF01 fixed enabling it to cope with hex values in the
record type
RACFAWK also fixed to enable it to cope with hex values
in record type
RACF38 extended to include a section listing all
PROTECTED User IDs
RACF68 extended to include additional output file listing
APFs which do not have corresponding DATASET profiles. This can be used as
input to RACFJCL to generate required JCL to correct.
Release 1.00 dated
This is a major new release. Here is a sum
All code has been converted from 16-bit DOS code to 32-bit Windows code,
although it is still intended to be run from a command prompt. This has meant a
reduction in the sizes of the executables along with the ability to
significantly extend some of the previously limiting array parameters. Running
it from the command prompt still allows for the development of batch (or
command) files containing many steps so that when an up-to-date unload is
downloaded fresh reports are easily generated.
Virtually all output reports have been converted from dull text format to a
much slicker HTML format. This has meant that they always overwrite any
previous reports rather than appending as some used to do. If at the command
prompt having generated a report simply enter the report name including
extension and if using NT it will make the association with your default
hypertext browser and load the report.
RACF88 has been both fixed and extended to give more
information.
The README file has been converted to HTML and enhanced.
RACF01 and RACF66 have been updated
to take account enhancements made to RACF. This brings the utilities up to
being in line with OS390 Version 2 Release 6.
U=User ID G=Group D=Dataset
R=General Resource C=CICS X=General Function
|
Utility |
U |
G |
D |
R |
C |
X |
Key |
Key words |
|
|
|
|
|
|
■ |
|
Pre-processor |
|
|
■ |
■ |
■ |
■ |
■ |
■ |
|
Sum |
|
|
■ |
|
|
|
|
|
JCL |
Non-existent
User IDs |
|
|
|
■ |
|
|
|
|
|
Group tree |
|
|
|
■ |
|
|
|
|
JCL |
All Groups |
|
|
■ |
|
|
|
|
|
JCL |
Expired User
IDs |
|
|
|
■ |
|
|
|
|
JCL |
List Group |
|
|
|
|
■ |
|
|
|
|
Dataset (mask) |
|
|
■ |
|
|
|
|
|
TEXT |
User ID(s)
(not-HTML) |
|
|
■ |
|
|
|
|
|
JCL |
User IDs (mask) |
|
|
RACF10 |
|
|
|
|
|
|
|
Discontinued |
|
■ |
■ |
|
|
|
|
JCL |
XREF (JCL to
grant) |
|
|
|
|
|
■ |
|
|
|
General
Resources (mask) |
|
|
RACF13 |
|
|
|
|
|
|
|
Discontinued |
|
RACF14 |
|
|
|
|
|
|
|
Discontinued |
|
RACF15 |
|
|
|
|
|
|
|
Discontinued |
|
|
|
|
|
■ |
|
|
List Member /
Group Class |
|
|
RACF17 |
|
|
|
|
|
|
|
Discontinued |
|
■ |
|
|
|
|
|
TEXT |
All User IDs
(not-HTML) |
|
|
|
|
|
■ |
|
|
|
General
Resource |
|
|
|
|
|
■ |
|
|
JCL |
General
Resource - Re-create - Prefixed |
|
|
■ |
■ |
|
|
|
|
JCL |
XREF (JCL to
remove) |
|
|
|
|
|
|
■ |
|
|
Member class
Installation data |
|
|
|
|
■ |
|
|
|
JCL |
Dataset -
Re-create - Prefixed |
|
|
■ |
|
|
|
|
|
JCL |
Revoked User
IDs |
|
|
|
|
|
■ |
|
|
JCL |