Rational Developer for System z, Version 7.6

Adding a Field Pattern descriptor

A Field Pattern descriptor is evaluated as true if the text in the specified field of the application screen matches the specified pattern.
Note: When a Field Pattern descriptor is used in a screen message that contains BMS map information, then in most cases the descriptor must apply only to fields that have BMS names (see Contents of a screen message that contains BMS map information and When the flow type is Link3270 Bridge -- BMS map information).
To create a Field Pattern descriptor:
  1. Right-click the screen description to which you want to add the descriptor.
  2. Click Add Descriptor > Add Field Pattern Descriptor
    Note: Alternatively, instead of doing steps 1 and 2, you can do the following:
    1. On the Screen Descriptions tab, click the screen description to which you want to add the descriptor.
    2. Click Editor Menu > Add Field Pattern Descriptor on the menu bar of the workbench.
  3. Set the properties for the new Field Pattern descriptor:
    1. In the Properties view, select the property that you want to modify.
    2. Type or select the value that you want the property to have.
    Tip: If the Properties view is not visible, see Opening or reopening a view.

    Also, for the Field property, you can use the marking rectangle displayed in the screen image on the right side of the Screen Descriptors tab:
    1. When you click Add Field Pattern Descriptor, the screen message editor displays a dotted red marking rectangle around the entire area of the field over which you clicked the mouse:
    2. Drag the marking area so that it marks the field whose contents you want to be compared with the pattern.
    3. To clear the marking rectangle, click once over the screen image.
    4. To make the marking rectangle appear again, click once over the screen image.

Table 1 lists each property and its significance:
Table 1. Field Pattern descriptor
Property: Significance:
Case Sensitive
  • If this property is set to true, then the contents of the specified field are compared with the pattern in the descriptor, using a case-sensitive comparison.
  • Otherwise a case-insensitive comparison is used.
Field The name of the field whose contents are to be compared with the pattern (see Default field name).
Invert Match After the descriptor has been evaluated as true or false with respect to the currently displayed application screen, the value of the Invert Match property is checked:
  • If the Invert Match value is true, then the boolean result obtained by evaluating the descriptor is inverted, changing true to false or false to true.
  • If the Invert Match value is false, then the boolean result is not inverted.
Pattern The pattern to which the contents of the specified field are to be compared.
  • The pattern is an ordinary text string (for example, "Customer accounts") and can include blanks. There are no "wild card" characters.
  • The pattern string must begin at the first character of the specified field.
  • The pattern string can be shorter in length than the specified field, but it cannot be longer than the specified field and it cannot overlap part of another field.

Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)