xpmfetch

This retrieves data from the specified field within the XPM handle.

xpmfetch ?-warn var? xpmId field

Depending on the underlying record format, a single field string can imply multiple values. For example, an FRL field that is defined with multiple subfields.

This command returns a list of datum handles, one per value (subfields for FRL, subcomponents for HL7). If any warning messages are generated during the retrieval, then they are appended to var, if specified.

An error is returned if the field specification is invalid, with respect to the record definition. An error is also returned if any item's value cannot be retrieved. For example, not present in XPM handle data-state, or the underlying message is too short to cover the field.

field is interpreted as an input value to an XPM operation. Its leading character identifies which side of the translation the data is retrieved from:

  • @name: Temporary field name
  • ~name: Output field name
  • name: Input field name