Rational Developer for System z, Version 7.6

Adding a String descriptor

A String descriptor is evaluated as true if the characters in the specified string occur at the specified location and for the specified length in the currently displayed application screen.
Note: When a String 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 String descriptor:
  1. Right-click the screen description to which you want to add the descriptor.
  2. Click Add Descriptor > Add String 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 String Descriptor on the menu bar of the workbench.
  3. Set the properties for the new String descriptor. You can set the properties in either of two ways:
    • Modify the property in the Properties view:
      1. 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.
    • Use the marking area displayed in the screen image on the right side of the Screen Descriptors tab:
      1. When you click Add String Descriptor, the host editor displays a magenta marking area in the screen image around a default segment of text.
      2. Drag or resize the marking area so that it marks the area of text that you want the String descriptor to match.
      3. To clear the marking area, click once over the screen image.
      4. To make the marking area appear again, click once over the screen image.
Table 1 lists each property and its significance:
Table 1. String descriptor
Property: Significance:
Case Sensitive
  • If this property is set to true, then the text string in the descriptor is compared with the text string in the application screen, using a case-sensitive comparison.
  • Otherwise a case-insensitive comparison is used.
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.
Length The number of characters in the Match String that are compared with the text in the application screen.
Match String The string of characters that is compared with the text in the application screen.
Start Position The offset within the application screen of the character at which the comparison begins. The first character in the application screen (that is, the character in the upper left corner of the application screen) is at offset 1.

Terms of use | Feedback

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