Procedure 11

Change Array Options

capability

 

pathname length

 

pathname

 

array number

array layout

array type

REQUEST

If the access capability is valid and the spectrum defined by pathname exists then the array layout and array type for the data array defined by array number may be set.

procedure status

RESPONSE

procedure status indicates the result of the request.

0

success

3

invalid capability

4

invalid pathname

5

invalid parameter value

6

pathname not a spectrum

procedure status

XDR Specification

 
procedure   ChangeArrayOptions (cap, path, number, layout, type)   returns(status)
            capability   cap;
            pathname   path;
            unsigned   number;
            arraylayout   layout;
            arraytype   type;
            stat   status;

Implementation

If a data array already exists then it will be destroyed by this operation. By setting the array layout and array type to undefined (-1 or all one bits) any existing data array may be just destroyed.

If array layout and array type are defined here for an on-line spectrum server then space will be allocated for the data array at this point. In the case of disc based spectra space for the data arrays will not be allocated until the first Write Spectrum procedure.