Scripting › Web Option Scripting Control Values › The GET and PUT commands

The GET and PUT commands

The GET and PUT commands allow the user to retrieve data from an input or output field on one screen or from a Web Option control value or substitution variable and place it into an input field on the same or a different screen.

The GET command can take one of the following two formats:

GET RxxCyyLzz $variable-name
GET _Fnnnn $variable-name
GET substitution-variable $variable-name

The PUT command takes one of the following formats:

PUT _Fnnnn $variable-name
PUT _Fnnnn value
PUT substitution-variable $variable-name
PUT substitution-variable value

where RxxCyyLzz is a row/column/length identifier used where the data being retrieved is either an output field or a piece of static text and $variable-name is a (maximum 10-character) temporary variable name into which the retrieved value is placed. All variable-names must begin with a dollar-sign ($) and can be a maximum of 11 characters, including the initial dollar-sign. Variables are local to a given script and are only active during the processing of that script. Variable values themselves can be a maximum of 228 characters in length.

Substitution variables must begin with two ampersands (&&). If a substitution variable is specified in the GET statement, it can be one of the following:

• A Web Option control value (beginning with a 'Y')

  GET &&YDFTBGC $BACKCOLOR
  

• A user-defined substitution value

  GET &&_MYVAR1 $MYVAR
  

• A text constant from the MLS Text file YMLSTXTRFP

  GET &&1001060 $modelname
  

• A language-specific special value, such as the '#' symbol

  GET &&HASH $hashsign
  

If a substitution variable is specified in the PUT statement, it can be one of the following:

• One of the client-session specific control values YLSTLIB, YLSTFIL, or YPMTLIB

  PUT &&YLSTLIB FRNLIB
  PUT &&YLSTFIL $MYFIL
  PUT &&YPMTLIB FRNLIB
  

• A user-defined substitution value

  PUT &&_MYVAR1 $MYVAR
  

User-defined substitution values can be used within scripts and can be output directly into generated skeletons. For more details about user-defined substitution variables see the User-Defined Substitution Variables section in the appendix “Control Values”.