xpmfetch

xpmfetch ?-warn var? xpmId field

This command retrieves data from the specified field within the XPM handle. 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 when any item’s value cannot be retrieved. For example, the value is 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