Previous Topic: Compiling a Rule for Display at the TerminalNext Topic: Using ACFNRULE to Add Rule Entries


Using ACFDCMP to Decompile Rules

The ACFDCMP command quickly decompiles access rule sets to the terminal or to a CMS file. ACFDCMP also decompiles resource rule sets. The syntax of the ACFDCMP subcommand is:


ACFDCMP  {ruleid        }  [TYPE rsrctype   ]
         {LIKE rulemask }  [INTO fn {ft fm} ]
                           [(APPEND|REPLACE ]
ruleid|LIKE rulemask

Specify the $KEY of the rule to decompile a single rule set. To decompile multiple rule sets, use the LIKE rulemask operand and CA ACF2 for VM decompiles all rule sets with a $KEY that matches the rulemask. The rulemask can be any valid mask, an asterisk (*), or a dash (-).

TYPE rsrctype

Processes resource rules. The rsrctype value must be the three‑character resource type code where the resource rule is stored. You cannot mask the rsrctype. This operand is not valid for access rules.

INTO fn ft fm

Indicates the filename, filetype, and filemode (respectively) of a CMS file that contains the rule output. Only the filename fn is required. By default, the filetype is RULE and the filemode fm is A.

APPEND|REPLACE

These operands are valid only when decompiling rule sets into a CMS file. APPEND adds the decompiled rule sets to the end of the output CMS file. APPEND is the default. REPLACE overlays the decompiled rule sets to any existing rule sets in the output file.

Decompiling a Rule for Display at the Terminal

Specify the command and the $KEY of the rule set to decompile. For example:

ACFDCMP TLCAMS ACFDCO511I Processing access rule 'TLCAMS' *. ACFDCA556I ACCESS rule TLCAMS stored by MAINT on 11/02/97‑11:31 $KEY(TLCTST) V0191.JD‑ UID(*) V0191.VOLUME UID(*) READ(A) WRITE(A) EXEC(A) V0191.‑ READ(A) WRITE(A) EXEC(A) V0192.‑ UID(*) READ(A) EXEC(A) ‑ UID(****DOC) READ(A) EXEC(A) *. ACFDCA551I Total record length=205 bytes ‑ 5 percent utilized Ready; T=0.02/0.12 11:32:33

In the above example, CA ACF2 for VM decompiled and displayed the rule TLCAMS at the terminal.

Decompiling and Adding a Rule Set to a CMS File

Use ACFDCMP to decompile a rule and add it to a CMS file. Use this subcommand to maintain a history of rule changes. For example:

ACFDCMP TLCAMS INTO TLCTST *. ACFDCA551I Total record length=205 bytes ‑ 5 percent utilized *. ACFDCA556I ACCESS rule TLCAMS stored by MAINT on 11/02/97‑11:31 Ready; T=0.03/0.12 11:33:48

In the above example, the TLCAMS rule is decompiled and placed in a CMS file named TLCAMS RULES A. If this file had existed before you issued the ACFDCMP command, CA ACF2 for VM would add the rule to the end of the file. If it did not exist, CA ACF2 for VM would create the file.

Decompiling and Replacing a Rule Set in a CMS File

Use ACFDCMP to decompile a rule and replace it if it exists in the file. This saves only the most recent rules. For example:

ACFDCMP TLCAMS INTO TLCTST RULES A(REPLACE ACFDCO511I Processing access rule 'TLCAMS' *. ACFDCA551I Total record length=205 bytes ‑ 5 percent utilized *. ACFDCA556I ACCESS rule TLCAMS stored by MAINT on 11/02/97‑11:31 Ready; T=0.03/0.12 11:34:19

In the previous example, the TLCAMS rule is decompiled and placed into a CMS file named TLCAMS RULES A. If the rule existed in the file before you issued the ACFDCMP command, CA ACF2 for VM would replace the rule.

Decompiling Multiple Rule Sets

Use ACFDCMP to decompile multiple rules at one time. For example:

ACFDCMP LIKE TLC‑ INTO TLCRULES RULES A ACFDCO511I Processing access rule 'TLC' *. ACFDCA551I Total record length=205 bytes ‑ 5 percent utilized *. ACFDCA556I ACCESS rule TLC stored by MAINT on 11/02/97‑11:31 ACFDCO511I Processing access rule 'TLCDLW' *. ACFDCA551I Total record length=210 bytes ‑ 5 percent utilized *. ACFDCA556I ACCESS rule TLCDLW stored by MAINT on 10/02/97‑11:31 ACFDCO511I Processing access rule 'TLCGDP' *. ACFDCA551I Total record length=200 bytes ‑ 5 percent utilized *. ACFDCA556I ACCESS rule TLCGDP stored by MAINT on 11/30/97‑11:31 Ready; T=0.08/0.35 13:08:03

CA ACF2 for VM decompiles all rule sets with a $KEY that match the
TLC- mask and adds them to the CMS file.