The global root of the file, e.g., ^DIZ(16000.1,.

The lookup parameters as previously described for ^DIC.

The cross-reference in which to start looking. If DIC(0) contains M, then DIC will continue the search on all other lookup cross-references, in alphabetical order. If it does not, then the lookup is only on the single cross-reference. This variable is KILLed by VA FileMan; it is UNDEFined when the IX^DIC call is complete.

If DIC(0) contains "L", (i.e., user will be allowed to add a new entry to the file), then either a) D should be set to "B" or b) D should be set to an index that alphabetically comes before "B" and DIC(0) should contain "M" or c) D should contain the name of a compound index.

If DIC(0) does not contain an A, then the variable X must be defined equal to the value you want to look up.

If the lookup index is compound (i.e., has more than one data subscript), then X can be an array X(n) where "n" represents the position in the subscript. For example, if X(2) is passed in, it will be used as the lookup value to match to the entries in the second subscript of the index. If only the lookup value X is passed, it will be assumed to be the lookup value for the first subscript in the index, X(1). 

DIC always returns the variable Y. The variable Y is returned in one of these three formats:

This variable is only set if DIC(0) contains a Z. When the variable is set, it is equal to the entire zero node of the entry that was selected.

This variable also is only set if DIC(0) contains a Z. When the variable is set, it is equal to the external form of the .01 field of the entry.

The following are examples of returned Y variables based on a call to the EMPLOYEE file stored in ^EMP(:

    S DIC="^EMP(",DIC(0)="QEZ",X="SMITH"
    D ^DIC

Returned are:

    Y      = "7^SMITH,SAM"
    Y(0)   = "SMITH,SAM^M^2231109^2
    Y(0,0) = "SMITH,SAM"
	

If the lookup had been done on a file whose .01 field points to the EMPLOYEE file, the returned variables might look like this:

    Y      = "32^7"  [ Entry #32 in this file and #7 in 
                       EMPLOYEE file.]
    Y(0)   = "7^RX 2354^ON HOLD"
    Y(0,0) = "SMITH,SAM"  [.01 field of entry 7 in 
                           EMPLOYEE file]

Contains the value of the field where the match occurred.

If the lookup index is compound (i.e., has more than one data subscript), and if DIC(0) contains an A so that the user is prompted for lookup values, then X will be output as an array X(n) where "n" represents the position in the subscript and will contain the values from the index on which the entry was found. Thus, X(2) would contain the value of the second subscript in the index. If possible, the entries will be output in their external format (i.e., if the subscript is not computed and doesn't have a transform). If the entry is not found on an index (for example, when lookup is done with X=" " [the space-bar return feature]), then X and X(1) will contain the user input, but the rest of the X array will be undefined. 

This is only defined if DIC has timed-out waiting for input from the user.

This is only defined if the user entered an up-arrow.