Toolkit V. 7.3 APIs Banner [skip navigation]
VHA Office of Information - Health Systems Design and Development (HSD&D) Banner

$$SETMASTR^XTID(): Set Master VUID Flag (Term/Concept)

Reference Type: Supported, Category: Data Standardization, Integration Agreement: 4631

Description

This extrinsic function stores (sets) the value of the MASTER ENTRY FOR VUID flag for a given term/concept reference. The MASTER ENTRY FOR VUID flag is used to distinguish references that might be duplicates.
 

Format

  $$SETMASTR^XTID(file,[field],iref,mstrflag)

Input Parameters

file:

(required) VistA file/subfile number where term/concept is defined.
field:

(optional) Field number in the "file" input parameter where term/concept is defined:

  • Not Defined—If not defined, this field defaults to the .01 field number and it represents the terms defined in the file entered in the "file" input parameter.

  • Defined:

    • Entered as .01. It represents the terms defined in the file entered in the "file" input parameter.

    • Otherwise, the field number entered must be a SET OF CODES data type field in the file entered in the "file" input parameter.
iref:

(required) Internal reference for term/concept:

  • File Entries—This will be an IENS. For example:

        iref = "5,"

  • Sets of Codes—This will be the internal value of the code. For example:

        iref = 3 or
        iref = "f" or
        iref = "M"
mstrflag:

(required) The internal value of the MASTER ENTRY FOR VUID field. Possible values are as follows:

  • 0—NO

  • 1—YES

Output

returns:

Returns:

  • 1—Successful

  • 0^<error message>—Unsuccessful

Example 1

For terms defined in fields that are SET OF CODES:

>S file=2,field=.02,iref="M",mstrflag=0

>W $$SETMASTR^XTID(file,field,iref,mstrflag)
1

Example 2

For terms defined in a single file:

>S file=16000009,field=.01,iref="3,",mstrflag=1

>W $$SETMASTR^XTID(file,field,iref,mstrflag)
1

Example 3

>S file=16000009,field=.01,iref="6,",mstrflag=1

>W $$SETMASTR^XTID(file,field,iref,mstrflag)
0^pre-existing master entry

 

VA (Internet) / VA (Intranet) / OI / HSD&D / Site Map / Terms of Use / VA Privacy Policy / Accessibility

Reviewed/Updated: December 14, 2005

If you have questions, need more information, or are having accessibility problems with this website, please contact us by E-Mail: Webmasters, Phone: 510-768-6800, or FAX: 510-768-6850.