Previous Topic: Parameter GuidelinesNext Topic: Exclusive Processing Examples


Inclusive Processing Examples

The following examples are based on the subschema TESTSUB and invoke inclusive processing.

Example 1 - Audit one set only

PROCESS,SUBSCHEMA=TESTSUB,STARTWITH=NONE
AUDIT,USERSETS
SET=ROOM-CLASS,AUDIT

When you audit a single set, you do not have to specify the areas because CA IDMS/DB Audit automatically accesses the areas containing the set. The area LOC-REGION contains the set owner and is automatically set to SWEEP.

If you specify Standard as the audit type, the member area CLASS-REGION is made accessible. If QuickCheck is the audit type, member area CLASS-REGION is set to SWEEP.

Example 2 - Sweep a single area

PROCESS,SUBSCHEMA=TESTSUB,STARTWITH=NONE
AUDIT,USERSETS
AREA=DEPT-REGION,SWEEP

In this example, only those sets whose owners reside in DEPT-REGION are audited. Specifically, the following sets are audited:

DEPT-TEACHER
DEPT-ACADEMIC
DEPT-GENERAL
PREREQSFOR
PREREQSARE
SUBJECT-CLASS
TEACHER-CLASS

The index (IX) sets would not be audited because their owners are in the INDEX-REGION.

Example 3 - Sweep more than one area

PROCESS,SUBSCHEMA=TESTSUB,STARTWITH=NONE
AUDIT,USERSETS
AREA=DEPT-REGION,SWEEP
AREA=INDEX-REGION,SWEEP
AREA=CLASS-REGION,SWEEP
AREA=STUDENT-REGION, SWEEP
SET=PERIOD-CLASS,AUDIT

All index and user sets except ROOM-CLASS are audited. In this particular case, however, it would be easier to use exclusive processing (STARTWITH=ALL) to exclude the one set ROOM-CLASS.

Example 4 - Audit all sets owned by a single record

PROCESS,SUBSCHEMA=TESTSUB,STARTWITH=NONE
AUDIT,USERSETS
RECORD=SUBJECT,SWEEP

In this case, the following sets are audited:

PREREQSFOR
PREREQSARE
SUBJECT-CLASS

To sweep a record, you do not need to specify SWEEP for the area where the record resides because CA IDMS/DB Audit handles that automatically. All sets that the record owns are swept when you specify record sweep.

Under QuickCheck, sweeping an owned set implies sweeping the area containing the records that participate in the set. Multiple areas may also be swept if the record owns cross-area sets. A cross-area set is a set whose owners and members reside in different areas. Under Standard auditing, sweeping all owned sets may also cause multiple areas to be accessed if the record owns cross-area sets.

Example 5 - Confine processing to specific pages

PROCESS,SUBSCHEMA=TESTSUB,STARTWITH=NONE,AUDITTYPE=STANDARD
AUDIT,USERSETS
AREA=STUDENT-REGION,BEGIN=00010,END=00030

Because BEGIN and END imply SWEEP, you do not need to specify SWEEP.

In this example, the audit type can only be Standard. You cannot specify USERSETS with QuickCheck if you also want to perform partial page range audits with BEGIN and END. For QuickCheck, the USERSETS option requires entire area page ranges to be swept in order to detect errors properly. Therefore, you cannot specify BEGIN or END in QuickCheck when USERSETS is also specified.

The same restriction against specifying BEGIN or END applies to QuickCheck CALCSETS as well.