xpmstore

xpmstore ?-list? xpmId field type args

This command stores values into the output fields of xpmId.

  • If -list is used, then args is a list containing all of the values to store. Otherwise, the value list is all of the remaining arguments to the command.
  • field is interpreted as an output field. A leading @ identifies a temporary field variable. Input fields cannot be modified.
  • type identifies the default item type for the list, although the datum can be without identification. Type choices are c, d, or v.

Store both strings and datum objects using this command.

  • Constant strings use -c.
  • Datum objects use -d.
  • Special values use -v.

The only special value currently supported is null, which represents a value that is present, but empty. In HL7, for example, it is encoded as ""(two double-quotes). It is not treated specially in FRLs.

Constant string values default to type ch when stored. Specify an hci data type with a -type datatype trailer.

For example:

xpmstore xpm0 PatientName d datum0 datum1
xpmstore -list xpm0 {PatientName.[0,1]} d "datum0\ datum1"
xpmstore xpm1 0(0).PID(0).00041 d -c Smith datum2\
-v null

This command returns an empty string.