Procedure 5

Read String

capability

 

pathname length

 

pathname

 

string type

string number

REQUEST

If the access capability is valid and the spectrum defined by pathname exists then the string of type string type identified by string number is returned.

0

information

1

annotation

2

calibration

3

efficiency

string type

string number is in the range 1 to 32 for information strings and 1 to the spectrum dimension for others.

success = 0

string length

 

string

 

RESPONSE - success

The requested string is returned. If the requested string is not defined (but the type and number are within valid range) then a null length string is returned.

procedure status

RESPONSE - failure

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

3

invalid capability

4

invalid pathname

5

invalid parameter value

6

pathname not a spectrum

procedure status

XDR Specification

 
procedure   ReadString (cap, path, stype, snumber)   returns(reply)
            capability   cap;
            pathname   path;
            stringtype   stype;
            stringid   snumber;

            union switch (stat status)  {
                OK:
                string   data <>
                default:
                struct   {}
            }  reply;

Implementation