To execute the REXX RACVAR function, your REXX parameter module
must contain an entry for RACF's IRREFPCK directory package, which
supports the RACVAR function. For information on REXX parameter modules
and how to update and integrate them, see the sections on programming
services, function packages, and function directories in z/OS TSO/E REXX Reference.
To install the REXX RACVAR function, follow these steps:
Note: Module
names, label names, and characteristics specified here are samples
derived from current packages and are subject to change. For up-to-date
accuracy and completeness, refer to
z/OS TSO/E REXX Reference.
- You need to update one or more of the following REXX parameter
modules:
- IRXPARMS (for MVS™)
- IRXTSPRM (for TSO/E)
- IRXISTRM (for ISPF)
Locate these modules. You should use the ones that are already
installed in your system, but sample copies are available in the SYS1.SAMPLIB
library. Their member names are: - IRXREXX1 for IRXPARMS
- IRXREXX2 for IRXTSPRM
- IRXREXX3 for IRXISTRM
- In the parameter module, the section for the function package
entries is under the header PACKTB_HEADER, which is followed by headers
for each level (system, local, and user). The system level is a good
place to install RACVAR, although you can also install it in the local
or user level.
The header for the system level is labelled PACKTB_SYSTEM_FIRST.
There are two fields under the header for number of entries. For the
system level, these fields are PACKTB_SYSTEM_TOTAL and PACKTB_SYSTEM_USED.
Increment the count in each field by one. For example if the field
is DC F'2', change it to DC F'3'.
- Locate the set of entries pointed to by the header. For the system
level, the entries are pointed to by PACKTB_SYSTEM_FIRST. Add another
entry here for IRREFPCK. An entry is an 8-byte character constant.
Its format should follow the pattern of other entries in the parameter
module.
- Assemble and link-edit the parameter module and place it in SYS1.LINKLIB
or any other load module accessible by your system.