Limited support BMC provides limited support for this version of the product. As a result, BMC no longer accepts comments in this space. If you encounter problems with the product version or the space, contact BMC Support.BMC recommends upgrading to the latest version of the product. To see documentation for that version, see BMC AMI Storage Reporting 8.1.

Name masks for names or character-field values

You can specify names or any character-field value in any MainView SRM parameter explicitly by using the complete name.

You can also specify a partial name with special mask symbols to build flexible criteria. MainView SRM supports the following mask symbols:

 

Mask symbol

Description

% (percent)

Specifies a single numeric character; multiple mask characters can be specified and the mask can be embedded within text.

  • VOL=PRODV% would be satisfied by PRODV1 or PRODV9 (but not PRODVX).
  • VOL=TST%V% would be satisfied by TST5V1 or TST2V9 (but not TSTAV5 or TST44V).
  • VOL=WRK%%% would be satisfied by WRK104 or WRK582 (but not WRK33).

? (question mark)

Specifies any character except a period (.), including numeric, alphabetic, or special characters (such as #); multiple mask characters can be specified, and the mask can be embedded within text.

  • VOL=PR???? would be satisfied by PRODV1 or PR45B6 (but not PR64).
  • VOL=PR??9 would be satisfied by PR4B9 or PR#39 (but not PROD4).

/ (slash)

Specifies zero or more characters of any type at the end of a name; this mask character terminates a name mask and any characters that follow are ignored.

Note

A period is significant in a DSN name mask. The parameter DSN=TEST./ differs from DSN=TEST/

  • VOL=TST/ would be satisfied by TST, TSTA, TSTB14, or TST40V (but not TSXX44).
  • VOL=TST%/ would be satisfied by TST4BX or TST477 (but not TSTA64).
  • VOL=/ would be satisfied by any combination of characters.
  • DSN=TEST/ would be satisfied by TEST.CICS.PPT (but not PROD.CICS.PPT).
  • DSN=TEST./ would be satisfied by TEST.CICS.PPT (but not TESTX.CICS.PPT).

* (asterisk)

Specifies any character string in a single name node; this mask character can be embedded within other text.

Note

Leading asterisks can be confusing. Name matching stops after the name mask has been exhausted, even if more characters remain in the name. LLQ=*T selects LAST but not TEST. The asterisk requires a nonzero number of characters. LAST has three characters (matching the asterisk) before the T (matching the T in the mask). TEST, however, has zero characters before a T is encountered; the initial T in TEST matches the T in the mask *T, but because no characters precede the T, the match fails.

  • DSN=AP1177A.*.MASTER would be satisfied by AP1177A.VNDR.MASTER or AP1177A.VOUCHER.MASTER (but not AP1177A.VNDR.TEST.MASTER or AP1177A.MASTER).
  • DSN=AP117A.PER*.MASTER would be satisfied by AP117A.PER11.MASTER or AP117A.PER07A.MASTER (but not AP117A.MON12.MASTER).
  • DSN=AP117A.*TST.MASTER would be satisfied by AP117A.YEARTST.MASTER or AP117A.TST.MASTER (but not AP117A.DAILY.MASTER).

** (double asterisk)

Specifies any nonzero number of name nodes; this mask character can be embedded within other text.

Note

Using ** at the end of a name string is equivalent to using /. For example, AP.TEST.MAS** is equivalent to AP.TEST.MAS/. The / mask, however, cannot be used with following characters, as it terminates the mask. The value of the ** mask is that it can be followed by more name nodes.

  • DSN=AP.**.MASTER would be satisfied by AP.VNDR.MASTER or AP.VNDR.TEST.MASTER or AP.VNDR.TEST.YTD.MASTER (but not AP.VNDR.MASTER.TEST or AP.MASTER)
  • DSN=**.TEST.CICS would be satisfied by GLYTD5.TEST.CICS or GLYTD.PER04.TEST.CICS (but not TEST.CICS)
  • DSN=AP.TST**D.MASTER would be satisfied by AP.TST002.YTD.MASTER (but not AP.PRD002.YTD.MASTER)

Do not use masking characters with operators other than = or ¬=. If masking characters are specified with an operator other than = or ¬=, the masking characters are treated like any other character and not a masking character.

If the length of the name mask and the name value are different and the comparison operator is other than = or ¬=, the shorter name is padded with blanks for the comparison.

Example

VOL<=TST* would be satisfied by TSTXY because * is lower than X.

VOL>TST%% would not be satisfied by TSTXY because % is lower than X.



 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*