Skip to content

Adding Operations to an Entity

After you've created an entity and have added patterns and attributes to that entity, you're ready to add or edit an operation.


Object names for entities, attributes, operations, recordsets, recordset fields, and, variables are not case sensitive.

To add or edit an operation:

  1. On the Operation tab, click the New Operation button in the Name box. By default, the operation is named Operation_1.
  2. To change the name, select it and type a new name in the Name box.
  3. Configure your new operation in the Destination box, Command list box, and Properties boxes.
  4. After configuring your operation, click Apply to save your changes.

To copy an operation:

You can copy the operation to create another that is similar.

  1. Select the operation you want to copy.
  2. Click the list next to the New Operation button and select Create Copy. A new operation with a similar name and a number appended to the end is created (for example, ToMainMenu_2).
  3. Modify the new operation so that it is distinguishable from the operation on which it is based.

More information

Mapping Operations

The Design Tool provides several commands that enable advanced configuration of entities in the host application model. To edit an existing operation, click the Operation tab and then click the Edit button to open the Operation Edit dialog box.

See Operation command summary for a complete list of available commands.

Reset Current Recordset

This operation can be used when multiple database records have the same entity definition but scrolling changes entity attributes and entity recordset contents. To ensure that new records are fetched, add the Reset Recordset command in a scrolling operation before the actual keystroke that performs the scroll.

To use Reset Current Recordset:

  1. On the Operation tab, create a Down operation and rename it DownReset. If you already have a Down operation on the entity, you can click Copy Operation and rename it DownReset. For an IBM host, the operation looks like this.

    TransmitTerminalKey rcIBMpf2Key


    For VT, the terminal key is VTNextPage; for HP, the terminal key is HPPageDown.

  2. Add the ResetRecordset command as the second line of the DownReset operation. The operation for an IBM recordset reset looks similar to the following:


    ResetRecordset "<recordsetname>"

    TransmitTerminalKey rcIBMpf2Key

More information