Ignoring ON Phrases for Absent Fields

How to:

You can select the ONFIELD command in the Set tool to control whether ON phrases are ignored for fields not referenced in a request. The ONFIELD parameter determines whether ON phrases that refer to fields not present in the request are ignored or cause the request to terminate. Allowing ON phrases for absent fields enables user selections at run time to determine which elements are included in each execution of the request.

Top of page
x
Procedure: How to Ignore ON Phrases for Absent Fields
  1. From the Procedure Viewer in Developer Studio, click and hold a component connector (yellow diamond), then click the Set button on the Component Connector toolbox.

    The Set tool opens.

  2. Select ONFIELD from the Available Settings list and click Add.

    or

    Double-click ONFIELD.

    ONFIELD is added to the Used Settings list.

  3. Select a value from the Current Value list to set the ONFIELD command.

    You may select from the following options:

    • ALL. Issues a message and terminates execution when a field referenced in an ON phrase is not present in the request. ALL is the default value.
    • IGNORE. Ignores ON phrases that reference fields that are not present in the request as well as ON phrases that include options not supported by the type of field specified.

    The following image is an example of the ONFIELD command in the Set tool.

  4. Click OK to save the SET ONFIELD command and close the Set tool.

    The corresponding syntax is:

    SET ONFIELD = {ALL|IGNORE}
WebFOCUS