Syntax
SENDLISTDYNAMIC expression variableParameters
SendListDynamic can be abbreviated as SLDYN.
expression
The name of the list box to download is specified. This can be a literal, String attribute or String expression. The list box name is contained as the value of the attribute or expression.
A common convention for the format of the list box name is one of the following forms (where <item> is the variable the list box applies to):
<ispec>.<item>
Indicates that the list box applies only to users of the specified ispec
*.<item>
Indicates that the list box applies to users of all ispecs
variable
An attribute or a variable that contains the value-description pair (expression) to download
This value-description pair (expression) must be a string, and is restricted to a maximum combined length of 80. Lengths in excess of 80 are truncated. Refer to List Boxes for more information on the format of this value-description pair.
The variable might be an attribute with members.
Description
The SendListDynamic logic command populates a dynamic list box with a single value-description pair (expression). The SendListDynamic command creates a list box specific to a particular transaction, which adds a single value-description pair (expression) in the list box. To populate a list box with multiple value-description pair (expression) in multiple rows, use the SendListDynamic logic command multiple times. Each execution of this command adds a single line to the list box content. This can also be achieved by a loop construct in code. For example, to create a list box that includes 10 lines of data, you can execute the SendListDynamic command 10 times or provide a loop construct in logic.
The SendListDynamic logic command can be executed in ispecs initiated by a user station (or NOF program or terminal), or reports initiated from a user station (or NOF program or terminal).
The list box is updated at end-of-transaction, or when a Sleep or CriticalPoint logic statement is executed. To clear a list box for a new transaction, use another SendListDynamic statement to overwrite the values with spaces.
SOK (start-of-Kanji) and EOK (end-of-Kanji) characters need to be supplied to the description field of the list box data as required.
Refer toSendListStatic for more information on populating static list boxes.
When processing an OLTP-originated transaction, the SendListDynamic command is ignored. No user indication is given.
Restrictions
The SendListDynamic logic command is ignored in OLTP-originated transactions.
Examples
Example 1
This example used the SD_AreaCode group variable, with members (in order): SD_Delim, SD_Code (length 6), SD_Delim2, and SD_Desc (length 20).
SD_AreaCode.SD_Delim := "/"
SD_AreaCode.SD_Delim2 := "/"
LookUp From Glb.Spaces Areas
SD_AreaCode.SD_Code := Areas.AreaCode : Set values in
SD_AreaCode.SD_Desc := Areas.Descript : SD_AreaCode group variable
SendListDynamic "*.AreaCode" SD_AreaCode
End
Example 2
This example uses a String attribute called GSDLBXVal1 to populate one-line into the LBX.LBox1 list box.
SendListDynamic "LBX.LBox1" GSDLBXVal1
GSDLBXVal1 is defined according to the data format described in List Boxes.