Using the GSO INFODIR Record

Using the GSO INFODIR Record

This appendix explains the Global System Option (GSO) INFODIR record and how to use it to make rule directories and rule sets resident. The information in this appendix is also documented in the CA ACF2 Administrator Guide.

This section contains the following topics:

Function

Function

The GSO INFODIR record indicates which rule directories are built and made globally resident at CA ACF2 initialization. The INFODIR record also indicates whether the rule sets associated with those directories are made resident and whether the residency is global (in common storage) or local (in an address space). The INFODIR record is similar in function to the GSO RESDIR record. While the RESDIR record enables you to specify a code and a type, the INFODIR record lets you specify a code, class, and type. The extra class parameter enables you to use different class codes for your applications. CA Technologies recommends that you migrate RESDIR records to INFODIR records.

Field Description

The TYPES field is explained below.

code

Indicates whether the rule set associated with the directory is made resident, and whether that residency is global or local. The three possible codes are:

• T—Rule sets are transient and never made resident.
• D—Rule sets are made resident in a user address space on a demand basis.
• R—Rule sets are made resident in global storage at CA ACF2 initialization time.

Note: Be aware that you must include a hyphen between the code and class, as shown in the above syntax.

class

Specifies the infostorage class of the rule set for which the directory is built. For CA ACF2 Option for DB2 rule sets, the storage class is D. For resource rule sets, the storage class is R.

type

Specifies pertinent rule sets for which a directory is built and made globally resident at CA ACF2 initialization. The type is the same three‑character type code used in the $TYPE control statement of the rule set. To create an INFODIR record for DB2 resources, you can enter:

TYPES(R‑DSYS,D‑DDBS,T‑DBPL)

These values are explained below:

• R‑DSYS—A rule directory is built and loaded into common storage for CA ACF2 Option for DB2 rules of $TYPE(SYS), and the rules themselves are made globally resident.
• D‑DDBS—A rule directory is built and loaded into common storage for CA ACF2 Option for DB2 rules of $TYPE(DBS) and the rules themselves are made resident in an address space upon request.
• T‑DBPL—A rule directory is built and loaded into common storage for CA ACF2 Option for DB2 rules of $TYPE(BPL), but the rules themselves are never made resident in common storage nor in an address space, but are loaded and unloaded into an address space on a transient basis.

Usage Notes

Regardless of whether a given type of rule set is resident or transient, a directory is built for each type of rule set specified in the INFODIR record. The directory itself is always made globally resident. Resident directories are rebuilt at each IPL, at each restart of CA ACF2, or when the console operator issues the F ACF2,REBUILD(type),CLASS(class) command.

To use masks (asterisks) in the $KEY or $SYSID control statements, you must make the directory resident for the given type of rule set.

To use the long resource names possible in DB2 release 8.1, you must use globally resident directories and globally resident resource rules. For information about other requirements for long resource names, see the Insert Application Definitions step in the “Installation” chapter of the Getting Started.

The RSCDIR field of the GSO RULEOPTS record indicates whether CA ACF2 tries to build globally resident rule directories above the 16 megabyte storage line (in ECSA) or always builds them below the 16 megabyte storage line (in CSA). The RSCRULE field of the GSO RULEOPTS record indicates whether CA ACF2 tries to build globally resident rule sets above the 16 megabyte storage line (in ECSA) or always builds them below the 16 megabyte storage line (in CSA).

Specification

(Optional). You can specify a total of 256 rule types.

SHOW Command

The SHOW RESIDENT, SHOW ACF2, and SHOW ALL subcommands of the ACF command display the types of resources as specified in the INFODIR record.