Set the content of a field on a 5250 screen to a value, the request is queued up and processed when the next screen arrives. The field may be identified by name or by its order on the screen.

Syntax

function Q_SETVALUE(argCondition, sVariable, sValue, iIndex)

Parameters

argCondition

Optional. May be passed as:

  • null or "", indicating that no condition applies
  • "=<<screen name when the queued instruction is executed>>" indicating that the resulting SENDKEY/SETVALUE should only be performed if the next screen is as named.
  • "!=<<screen name when the queued instruction is executed>>" indicating that the resulting SENDKEY/SETVALUE should only be performed if the next screen is not as named.

The screen name condition is tested when the next or resulting screen arrives. The name specified does not have anything to do with the current screen name.

sVariable

Required. String that contains the RAMP field name. 

sValue

Required. String that contains the value to set the field to. 

iIndex

Optional. An Integer that specifies the subfile row of the field, for fields that are part of a subfile.

Note: the specified row index must exist in the current subfile page. CHECK_FIELD_EXISTS can be used to check whether a particular row exists in the subfile.