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

(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.

(required) Internal reference for term/concept:

• File Entries—This is an IENS. For example:
  
  iref = "5,"
  
  
• SET OF CODES—This is the internal value of the code. For example, any of the following:
  
  iref = 3
  iref = "f"
  iref = "M"

(optional) VA FileMan date/time. It defaults to  NOW.

Returns results of operation as follows:

• Successful—<internal value>^<FileMan effective date/time>^<external value>
  
  For example:

    0^3050220.115720^INACTIVE
  
    1^3050225.115711^ACTIVE

• Unsuccessful—^<error message>
  
  NOTE: The first piece is empty. This differentiates it from the successful case, where the first piece is either 0 or 1.

>S file=2,field=.02,iref="M",datetime=$$NOW^XLFDT

>W $$GETSTAT^XTID(file,field,iref,datetime)
1^3050121.154752^ACTIVE

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

>W $$GETSTAT^XTID(file,field,iref,datetime)
0^3050122.154755^INACTIVE