Advanced Commands › Using ACFNRULE to Delete Rule Entries

Using ACFNRULE to Delete Rule Entries

The ACFNRULE command deletes individual rule entries from access rule sets. CA ACF2 for VM automatically compiles, sorts, and stores the rules. You can also process resource rules with ACFNRULE. The syntax of the ACFNRULE command is:

ACFNRULE {ruleid      } [TYPE(rsrctype)]
         {KEY(ruleid) }
 
         {[DELETE(ruleentry)]}
 
         [ List|NOList     ]
         [ Verify|NOVerify ]

ruleid|KEY(ruleid)

Indicates the $KEY value of the rule. To process a single rule set, specify the $KEY of the rule you want to process. Both ruleid and KEY(ruleid) function alike. You must specify this operand.

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 this value. This operand is optional and you must omit it when you process access rules.

DELETE(ruleentry)...

Removes one or more individual rule entries from a rule set. For example, DELETE(V0191.volume uid(TEST-)) deletes one rule entry from a rule set.

List|NOList

LIST displays the rule set at the terminal. NOLIST suppresses the display. The default is LIST.

Verify|NOVerify

These operands are valid only when you specify DELETE. VERIFY displays each rule entry you are deleting, followed by a verification request. You must respond Y to delete the rule entry or N to suppress the delete. VERIFY is the default. NOVERIFY deletes rule entries without user verification.

Examples of how you can use ACFNRULE to delete individual rule entries from an access rule set or a resource rule set follow.

Deleting a Rule Entry

ACFNRULE deletes individual rule entries from a rule set.

ACFNRULE TLCAMS DELETE(V193.VOLUME UID(*)) NOLIST
ACFULE874E The following entries will be deleted
 
 V193.VOLUME UID(*)
 
ACFULE875R Verify delete ‑ reply 'Y', 'N' or '?' for individual prompts
Y
ACFCMP510I ACF compiler entered
 
ACFCMP551I Total record length=245 bytes ‑ 5 percent utilized
ACFULE727I Rule TLCAMS stored
Ready; T=0.04/0.19 13:03:58

In the above example, V0193.VOLUME was deleted. Before it was deleted, it was displayed and a prompt was issued asking for verification to delete it. You can use this feature to delete multiple rule entries with one command.