Token

You can abbreviate TOKEN to T.

The following parameters are valid with the TOKEN statement:

INCLUDE

You can abbreviate INCLUDE to INC.

Specifies a token to include in the scan for the TWU, SOR, and TSP reports.

To specify a token explicitly enter the exact search token between matching delimiter characters. For example:

TOKEN INC="DATE/TIME"

ASMXREF scans all the source files specified with the ASMXREF control statements, searching each for an exact match with the specified explicit tokens.

You can also specify the INCLUDE token generically with a mask character inserted in the search token.ASMXREF treats the mask character as a wildcard and retrieves all, or any, characters in the position of the mask character. The default mask character is the asterisk (*) that represents any number of characters (including none). For example:

TOKEN INC="DATE/*I*"

retrieves:

DATE/TIME
DATE/LINE

ASMXREF allows spaces within the token string but does not accept them between the parameters and the start of the token string. The following example is acceptable:

TOKEN INC='ab c'

The following example is not acceptable:

TOKEN INC= 'ABC'

EXCLUDE

You can abbreviate EXCLUDE to EXC.

Specifies a token to exclude from the scan for the TWU, SOR, and TSP reports.

When a TOKEN INCLUDE statement contains a generic mask (wildcard) character, the TOKEN EXCLUDE statement specifies the exclusion of the token when it is found by the INCLUDE statement token. You cannot enter a generic mask character in a TOKEN EXCLUDE statement.

Note: The TOKEN EXCLUDE statement only applies to the previous TOKEN INCLUDE statement that must contain a generic mask. If you need to repeat the TOKEN EXCLUDE statement, for another TOKEN INCLUDE statement, then you must repeat the token exclude statement.

Example:

TOKEN INC="DDMM*"
TOKEN EXC="DDMMCCYY"

retrieves:

DDMMYY
DDMMM

ASMXREF does not report the following string because it matches the exclude token:

DDMMCCYY

MASK

Specifies a wildcard character.

The asterisk (*) character is the default generic mask (wildcard) symbol.

If you enter a search token that contains the mask character itself you must specify an override to the mask character, with the MASK parameter. This is applicable only to the previous TOKEN INCLUDE statement.

If multiple MASK parameters are entered together, ASMXREF uses only the last one for the previous INCLUDE token. The following example shows the MASK parameter:

TOKEN INC="DA%E/*IM%"
TOKEN MASK="%"

retrieves:

DATE/*IMAGE
DANE/*IMAGINARY

In the previous example ASMXREF takes the % character as the mask symbol for the previous TOKEN INC statement.

If you enter this statement:

TOKEN INC="***"

ASMXREF treats the statement as an explicit token and retrieve all occurrences of ***.

Note: The TOKEN MASK statement only overrides the default for the previous token statement. On finding another token statementASMXREF reapplies the default value of a * representing the mask character.

NODEFLT

Turns off processing of the default tokens supplied in the XRFLANG file. This statement does not affect the processing of the language-specific exclusion verbs.

Note: To create the TWU and SOR reports ASMXREF must have tokens specified. If you turn off processing of the default tokens, with the TOKEN NODEFLT statement, you must supply tokens in the XRFTOKN file. If you do not specify a XRFTOKN file ensure default tokens exist in the XRFLANG file.

Example:

TOKEN NODEFLT

NOSEP

Suppresses the separator records in the Tagged Source Program (TSP).

Example:

TOKEN NOSEP

ASMXREF creates separators by default and saves them in the Tagged Source Program (TSP) that it creates in the scan phase. Producing separators allows this file to be split into individual members that you can use to replace or create macro or copy libraries. For details on splitting the TSP see Tagged Source Program (TSP).