Q_SETVALUE Function

RAMP-TS

previous page next page

Q_SETVALUE Function

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.

previous page start next page