Defining fields

Use the following procedure to define the input and output fields on each screen that the 3270 server needs. The 3270 server script uses the defined fields to identify screens and to read and write information.

Fields can be defined most easily by their position on the screen. That position can be one of the following:

• Absolute, that is, always in a specified row and column
• Relative to some other field
• At the position of the cursor on the screen

At least one field on each screen must be defined as a unique field. A unique field is a constant data field that uniquely identifies the screen to which it belongs. Up to 10 unique fields can be defined per screen.

Blueworx Voice Response does not support multiline fields that span multiple rows (but you can have them in your 3270 application).

To define the input and output fields:

1. From the Welcome window click on, Applications —>3270 Servers
2. Select the server: Click the 3270 server you want under Servers.
3. Display list of screens: If the screens defined for the selected 3270 server are not displayed, click View —> Screens. The window displays the screens captured for the selected 3270 server under Screens.
4. Select screen: Click the screen you want, then click Object —> Open. The system displays the 3270 Screen window, showing the selected screen.
5. Select fields: Use the mouse to select a field you need to define (you can double-click on a field, or draft the mouse pointer over the field).

   The field is highlighted on the screen.

6. Defining fields: Click Fields —> Add
7. In the 3270 Field Description input area, type a description of the field (up to 256 characters).

   The system displays the 3270 Field Information window.

8. To define a field that is always at the same location on the screen:
   • Click the pushbutton next to Access Type, then Physical Location.
   • Verify the row, column, and length values that are displayed.
9. To define a field that always contains the same data and is always at the same location:
   • Click the pushbutton next to Access Type, then Constant Data.
   • Verify the row, column, and length values that are displayed.
   • Make sure that the value of the field is displayed in the entry field below Access Type.

   Any null characters in the field are assumed to be space characters.

10. To define a field that is always located at the cursor when the screen displays:
    • Click the pushbutton next to Access Type, then At Cursor Position.
    • Examine the row, column, and length values that are displayed, and modify as necessary. The row and column values specify how far from the cursor the field is located.

      A field defined in this way does not have a fixed position. When the field is accessed at runtime, it retrieves the text at the cursor position. You can move the cursor using the SET_CURSOR script command.

11. To define a field by its position relative to a constant or another field that you have already defined:
    • Click the pushbutton next to Access Type, then Relative to Constant or Relative to Field.
    • Type the constant value or the name of a previously defined field in the entry field below Access Type, or click the pushbutton labeled ... select a field name.
    • Enter position values relative to the constant or defined field:
      1. Click the pushbutton next to Relation, then the applicable relative positioning: To Right, To Left, Under, or Above the constant or defined field.
      2. Type a Row value. If the Relation is To Right, To Left, or Under, the row value specifies how many rows below the defined field the new field is positioned; if the relation is Above, the row value specifies how many rows above the defined field the new field is positioned.
      3. Type a Column value. If the Relation is To Right, the column value specifies how many columns to the right of the rightmost edge of the defined field the new field begins. To Left specifies how many columns to the left of the leftmost edge the new field ends. If the relation is Under or Above, the column value specifies how many columns to the right of the leftmost edge the new field begins.
    • Check the length value that is displayed.
12. Name the field: In the 3270 Field Name input area, type a name for the field. Enter a unique name, up to 63 characters with no imbedded blanks.
13. Check the field position: Click Apply to check the field location and relation information, and change it if necessary. The defined field on the 3270 screen is highlighted.
    Note: Click Apply at any time to check the results of your input.
14. When you have finished specifying all information that the server needs to identify this field, click OK. The system reactivates the 3270 Screen window.
15. Define a unique field: To define a constant data field as the unique field for the current screen, click Options —> Define Unique Fields. In the 3270 Field Selection window, click the constant data field name.
16. More?: Repeat this procedure, starting with Step 5, for all fields that you need to define on the current screen.
17. Close the 3270 Screen window.