Procedure 4

Look Up Spectrum

capability

 

pathname length

 

pathname

 

REQUEST

If the access capability is valid and the spectrum defined by pathname exists attribute information extracted from the spectrum header is returned.

success = 0

dimension

 

creation time and date

 

 

modification time and date

 

dimension 1 base

:

dimension 8 base

dimension 1 range

:

dimension 8 range

information string map

annotation string map

calibration string map

efficiency string map

data array 1 layout

data array 1 type

data array 2 layout

data array 2 type

data array 1 base address

RESPONSE - success

The fields returned are as defined in the document EDOC061. Undefined fields are returned set to -1 or all one bits.

The field data array 1 base address will only be defined for on-line spectra.

procedure status

RESPONSE - failure

procedure status which is non zero indicates the cause of the failure.

3

invalid capability

4

invalid pathname

6

pathname not a spectrum

procedure status

XDR Specification

 
procedure   LookUpSpectrum (cap, path)   returns(reply)
            capability   cap;
            pathname   path;

            union switch (stat status)  {
                OK:
                dimension   dim;
                timedate   creation;
                timedate   modification;
                base   bse;
                range   rng;
                map   information;
                map   annotation;
                map   calibration;
                map   efficiency;
                attrib   array1;
                attrib   array2;
                unsigned   address;
                default:
                struct   {}
            }  reply;

Implementation

The string maps provide a convenient indication of the existance or not of the various data strings. If string n exists then bit n (with the most significant bit being 0 and the least being 31) is set to 1 otherwise it is set to 0. For example if information strings 1,2 and 3 are defined then the information string map will have the value @70000000. This avoids the need for a read string procedure to be used for non-existant strings.