ASMXREF Token Statement

Edit online

A token is an arbitrary string of characters specified for inclusion or exclusion in the ASMXREF scan. The TWU, SOR, and TSP reports show occurrences of all include tokens, unless ASMXREF matches a retrieved token with an exclude token.ASMXREF does not use tokens in other reports.

If the language is case-insensitive, ASMXREF converts source records to uppercase internally. This simplifies the matching process.

The XRFLANG file supplied with ASMXREF lists the default tokens included in a scan. When you create the TWU or SOR reports ASMXREF processes the default tokens unless you enter a TOKEN NODEFLT statement in the XRFTOKN file. For details on the TOKEN NODEFLT statement see Token. The default tokens have been designed primarily for the assembler language and represent most fields of interest, in that language. You can modify the default token list to include tokens more suited to your site. For details of the default tokens supplied with ASMXREF, and modifying those tokens, see ASMXREF XRFLANG Statements.

The default tokens may be sufficient for all your ASMXREF scans, but you may need to supplement, or replace, the default tokens in the XRFLANG file with your own tokens for a scan with special requirements. When you need to do this it is not advisable to modify the default token list, but instead create your own XRFTOKN file.

You must enclose all tokens in the XRFTOKN file within matching delimiter characters. The delimiter character can be any non-space character but the start and end delimiter must be the same. You can use a different pair of delimiter characters for each token. For example, if you have a double quote (") character embedded in the token, such as MM"DD, then you can use the ? character as the delimiter and then use the " for the next token. For example:

?MM"DD?
"YY/MM"

For details of the scanning rulesASMXREF applies see Scanning rules for ASMXREF.