Procedure 2

Create Spectrum

capability

 

pathname length

 

pathname

 

dimension

dimension 1 base

dimension 2 base

:

dimension 8 base

dimension 1 range

dimension 2 range

:

dimension 8 range

data array 1 layout

data array 1 type

data array 2 layout

data array 2 type

REQUEST

If the access capability is valid creates a spectrum in the server with name given by pathname.
The remaining fields are as defined in the document EDOC061. Undefined fields should be set to -1 or all one bits.

procedure status

RESPONSE

procedure status indicates the result of the request.

0

success

3

invalid capability

4

invalid pathname

5

invalid parameter value

7

pathname not a directory

procedure status

XDR Specification

 
procedure   CreateSpectrum (cap, path, dim, bse, rng, layout1, type1, layout2, type2)
                   return(status)
            capability   cap;
            pathname   path;
            dimension   dim;
            base   bse;
            range   rng;
            arraylayout   layout1;
            arraytype   type1;
            arraylayout   layout2;
            arraytype   type2;
            stat   status;

Implementation

A spectrum may exist with data in either big endian format (that is as used by SunMicrosystems Sparc and Motorola processors) or in little endian format (as used by Intel processors of the x86 family and Digital). The Create Spectrum procedure will always create a spectrum and write the spectrum header in the native format of its processor.
See also corresponding handling in the Write Spectrum and Create Spectrum procedures.

The array layout and array type parameters may be defined here or left undefined (set to -1 or all one bits) and defined latter using the Change Array Options procedure. If data array 1 layout and data array 1 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.