C.5.1. Subroutines FMSRED, FMSRD8, FMSSRD

PURPOSE

To read data from a FMS file.

SYNOPSIS

CALL FMSRED (LOGUNT, LOCUNT, ARRAY, NUMWRD)

CALL FMSRD8 (LOGUNT, LOCUNT, ARRAY, NUMWRD)

CALL FMSSRD (LOGUNT, ARRAY, NUMWRD)

INPUT PARAMETERS

LOGUNT = Integer.
The FMS file number, which is stored by FMS in the file attribute list.
LOCUNT = Integer. (FMSRED only)
LOCUNT = REAL*8. (FMSRD8 only)
The file address (in words) where you want to start to read. The first word on the file is located at LOCUNT=1. . For FMSRED, this is an INTEGER. For FMSRD8, this is a REAL*8 Floating Point Number. FMSRD8 allows the addressing of files greater than 2 Gbytes on systems supporting only 32-bit integers.
ARRAY(NUMWRD) = Complex, Real or Integer array.
Memory array where you want to receive data.
NUMWRD = Integer.
Number of WORDS to transfer. For complex data, count each real and imaginary pair as two words.

OUTPUT PARAMETERS:

None.

DESCRIPTION:

These subroutines provide read access to FMS files.

Subroutine FMSRED provides random access, subroutine FMSSRD provides sequential access. You may reset the file location used by FMSSRD by calling FMSEEK, FMSRED, FMSWRT or FMSSWR. When using FMSSRD to read a fixed-length record file, you must specify the record length for NUMWRD.

These subroutines are typically used to read vectors after FMS processing.