Previous Topic: Displaying Fields that Cannot Be CopiedNext Topic: Using REGISTER

Using the ACF Command › Masking ACF Subcommands

Masking ACF Subcommands

You can use the LIKE and UID operands with the CHANGE, DECOMP, DELETE, and LIST subcommands of the ACF command under certain ACF command settings. When you use the LIKE operand, you must mask its value. When you use the UID operand, specify a portion of the UID, and CA ACF2 for VM automatically pads out the rest with standard masking characters.


Operand

ACF Subcommand Settings

Valid under ACF Subcommands

LIKE (must be masked)

LID

LIST
CHANGE
DELETE

 

RULE

DECOMP

 

ENTRY

LIST
CHANGE
DELETE

 

SCOPE

LIST
CHANGE
DELETE

 

SHIFT

LIST
CHANGE
DELETE

 

CMDLIM

DECOMP
LIST

 

DIAGLIM

DECOMP
LIST

 

RESOURCE

DECOMP
DELETE

UID (needs no masking)

LID

LIST
CHANGE
DELETE

Masking the LIKE Operand

The LIKE operand of the CHANGE, DECOMP, DELETE, and LIST subcommands processes multiple logonid records, access rules, and other CA ACF2 for VM records. You must mask the value of this operand with at least one masking character. CA ACF2 for VM supports the asterisk and the dash. Otherwise, CA ACF2 for VM displays the following message:

ACFpgm008E SUPPLIED MASK DOES NOT CONTAIN ANY ASTERISKS
Asterisks

Asterisks in LIKE operand masks are substituted on a one‑to‑one basis for any character, including blanks. If the asterisk is at the end of the value or a trailing asterisk, it can also match a null. When you use asterisks, no padding takes place. 

LIST LIKE(PRG*)

This LIST subcommand under the LID setting lists PRG and PRG1, but does not include PRG12.

LIST LIKE(LID*)

The LIST subcommand under the SCOPE setting lists LID and LID1, but not LID12. 

DECOMP LIKE(SYS*)

The DECOMP subcommand under the RULE setting decompiles SYS1 and SYS2, but not SYSABC.

Dashes

When you use the LIKE parameter, you can use a dash as the last position of the masked field. The field pads out to its maximum length. 

LIST LIKE(PRG-)

This LIST subcommand under the LID setting might list the following logonid:

PRG

PRG1

PRG11

PRG111

The following LIST subcommand under the SCOPE setting might list all logonids:

LIST LIKE(-)

Unlike the asterisk that translates on a one‑to‑one basis, the dash at the end of the mask results in padding out the field. Imbedded dashes in a field or those that are leading characters of a field are treated as literal dashes.