Input values

There are three types of input values:

  • Raw character strings
  • DAT object handles
  • Special-values

The input values list can contain any mix of these elements. It can be a single list, first form, or discrete command-line elements, second form.

The type parameter declares the input value list's default element type:

  • c: Character string
  • d: Datum handle
  • v: Special value string

Use other types by preceding them with an identifier.

null is the only special-value string supported. It represents the active null value.

-type is used with grmstore using character-string (for example, not special-value or datum) input list elements.

By default, character-string data are treated as ch data.

If -type is used, then specify any GRM data type. For example, any value usable with datcreate.

For example, these are equivalent:

Input: grmstore $grmIdHl7 0(0).PID(0).00041 c Last\ First MI
Output:

Input: grmstore -list $grmIdHl7 0(0).PID(0).00041\ c "Last First MI"
Output: 

In both cases, grmstore assigns the strings Last, First, and MI, in order, to the target field’s first three components.

These commands set a field value that is encoded as Last^First^"".
Input: datcreate First
Output: datum0

grmstore $grmIdHl7 0(0).PID(0).00041 c Last -d datum0 -v null

Input values are matched one-to-one to target addresses. If there are more addresses than input values, then the unmatched addresses are not modified; unmatched input values are ignored without error message.