HLASM Toolkit Feature User's Guide
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Generic matching rules

HLASM Toolkit Feature User's Guide
GC26-8710-10

You can specify a token with the mask character in the first-character or last-character position. ASMXREF then searches for a match on any number of characters before or after the token specified. If ASMXREF finds a match, in the source record for the token, it scans forwards and backwards from the match to the scan end character. The scan end character is a space, ' '.ASMXREF passes the space delimited match to the matching process of the EXCLUDE tokens. If ASMXREF matches the retrieved token with an exclude token it excludes the match from the report.

Here is an example to help you understand this rule:

Source Record
MVC DATE(8),SYSDATETIME
ASMXREF control statements
TOKEN INC="*DATE*"
TOKEN EXC="DATETIME"

After finding the first match ASMXREF restarts the scan from the character following the token. In the previous example theASMXREF scanning process finds the first occurrence of DATE. As the token is specified generically with an * in the first and last character ASMXREF scans forwards and backwards from the match, until it encounters the space scan end characters.ASMXREF retrieves the string DATE(8),SYSDATETIME. ASMXREF then continues the scan from the character following the first DATE match, which in the example is the '(', until it finds the second match. Again ASMXREF scans forwards and backwards from this match, until it encounters the space characters. The second match again retrieves the string DATE(8),SYSDATETIME.ASMXREF compares the retrieved string with the exclude statement, which in this example does not apply to either match.

If you had specified the following exclude statement:
TOKEN EXC="DATE(8),SYSDATETIME"

ASMXREF excludes the two matches from the TWU, SOR, or the TSP reports.

Another example:

Source Record
GETMAIN R,LV=(0),LOC=BELOW
ASMXREF control statements
TOKEN INC="*LV=(0)*"
TOKEN EXC="R,LV=(0),LOC=BELOW"

When ASMXREF finds the match it scans forwards and backwards until it encounters the space end characters. In the previous example the match is "R,LV=(0),LOC=BELOW". The exclude token "R,LV=(0),LOC=BELOW" matches the retrieved token and so ASMXREF excludes the match.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014