Values
A value may be specified for both parameters and attributes.
There are two types of values:
- Values that you choose from a selection list
- Values that you type into an entry field
- Selection list values
- You can choose a parameter or attribute value from a selection list. For example, an Enable status field may offer a choice of ENABLED or DISABLED.
- Entry box values
- You can type a parameter or attribute value into an entry box.
A value typed into an entry box may be:
- A character string
- Note that for character attributes that allow mixed case values, for example, transaction IDs, the filter character values are case sensitive.
- Special characters, that is quotes and non-printable characters, may be used as described in Entering data in the WUI.
- You can use generic characters, if necessary. The conventions
for using generic characters in filters are:
- An asterisk (*) represents any number of characters, including
zero. It must be the last or only character in the string. For example:
- ABC* means all values beginning with the characters ABC
- * means all values
- A plus sign (+) represents a single character and may occupy any
position. For example:
- TERM0+ means all six-character values beginning with TERM0
- A+BC+DE means all seven-character values with any character in the second and fifth positions, A in the first position, B in the third, C in the fourth, D in the sixth, and E in the seventh position
- An asterisk (*) represents any number of characters, including
zero. It must be the last or only character in the string. For example:
- A hexadecimal string. If you use a terminating asterisk (*) as
a filter character, it must be preceded by an even number of hexadecimal
digits. Note: If a generic character is represented directly in the filter, this is considered to be a literal string. For example:
If the filter contains a generic character immediately following the hexadecimal string, this is considered to be a generic string. For example:'AB*'X is equivalent to AB5C.'AB'X* is equivalent to AB*.You cannot use a plus sign (+) as a filter character in a hexadecimal string.
See Table 1 for examples of generic characters and their implications in character and hexadecimal filters.
- For numeric data and CVDA or EYUDA values, follow the rules in Entering data in the WUI.
Table 1. Using generic characters Generics and quotes HEX attributes Char attributes Generic in quotes 'HELLO*' 'F1F2F3*'X 'F4+F5'XLiteral match C8C5D3D3D65C F1F2F35C F44EF5Generic match HELLO* 123* 4+5Generic outside quotes 'HELLO'* 'F1F2F3'X*Generic match C8C5D3D3D6* F1F2F3*Not valid Generic without quotes HELLO* F1F2F3* F4+F5Generic match HELLO invalid F1F2F3* + invalidGeneric match HELLO* F1F2F3* F4+F5 - A character string
Note: If the combination of relational operators and generic characters
is meaningless, you get an error. Generic characters only have meaning
when used with the "=" and "<>" relational operators for character
attributes. They cannot be used for parameters or numeric values.