Name Mask Formation

Programmer Utilities › Lists › Filtering Lists › Name Mask Formation

Name Mask Formation

A name mask is used to specify the names of the list items which are to be selected.

Apart from containing the normal characters of a valid i OS system name, a Toolkit name mask may contain any combination of the following three special characters:

Type	Character	Location in Mask	Scan action
Wild	'?'	Anywhere in Mask	Match on any character
Generic	'*'	At the end of the Mask	Generic name beyond this character
Contains	'*'	Anywhere within the Mask	Floating scan beyond this character

Name Masking Examples:

A* would select all names beginning with the letter A.
*A* would select any names containing the letter A.
*A would select any names ending with the letter A.
A?C would select any names that begin with the letter A, and that also have the letter C in the third position - any character may be in the second position.
*A? would select any names with the letter A as the last character but one.
A*B* would select any names beginning with the letter A, and containing the letter B in any other position.
Q???SRC will match QRPGSRC and QDDSSRC, but not QCLSRC.
Q*SRC will match QRPGSRC and QCLSRC, but not QRPGSRC1.
Q*S?C* will match all QRPGSRC, QCLSRC, QDDSSRC, plus names such as QSXC.

Filtering Examples:

Your example is an object list call FRED in library QGPL with the following items in it:

To select all RPG programs in object list FRED that are owned by user ME and that have object names:

Either containing the letters FRED anywhere in the name.
Or beginning with the string M?SH, where ? represents any character.

Enter the following command:

YFLTOBJLST OBJ((*FRED*) (M?SH))OBJTYPE (*PGM) OWNER(ME) + OBJLST(QGPL/FRED)

Your original list would thus be filtered down to: