Parameter Named Entries

Use the Parameter Named Entries section to change the elements of a delimited list of name/value pairs. For multiple elements, include them as a comma-separated list. If no element has a specified name as its pair’s first value, the corresponding scalarExpr is not used.

The contents of the Entries field must use this syntax:

param, [delimiter, [separator,]] name = scalarExpr

where:

  • param is the name of an event parameter that contains a string comprised of zero or more elements separated by the delimiter character. Each element consists of a name and a value separated by the separator character.
  • delimiter is the character or string which separates elements in param from each other. This argument is optional. If this argument is not used, the comma (,) character is used, and the equals sign (=) is used as the separator. In this case, each element may contain commas if they are enclosed within a ~LIT~(…) wrapper.
  • separator is the character or string which separates the name from the value in each element. This argument is optional. If this argument is not used, the equals sign (=) is used.
  • name is the first value of the pair of values in the element whose second value is to be changed.
  • scalarExpr is the value to whose string representation the element is to be set.

If multiple elements of the same parameter are to be changed, include their names and values as additional pairs separated by commas; for example:

param, [delimiter, [separator,]] name1 = scalarExpr1, name2 = scalarExpr2[, ...]

When you click OK to return to the Event Actions form, the application "wraps" this content within a SETPARMNAMEDENTRIES( ) parameter, which yields this final syntax:

SETPARMNAMEDENTRIES( param, [delimiter, [separator,]] name = scalarExpr[, …] )

Note: If any scalarExpr is a literal value, the application automatically encloses it in double quotation marks when returning it to the Event Actions form. If a scalarExpr is an expression, the application does not enclose it in quotation marks.