PURPOSE
To make a copy of a FMS file and optionally open or create the output file.SYNOPSIS
CALL FMSCPY (LUA, NAME, LUB)
INPUT PARAMETERS
- LUA(25) = Integer array.
Matrix, Vector or Submatrix file attribute list for the existing file. - NAME = Character string.
A 1 to 119 character string that contains a unique alphanumeric name for the new file. If the output file exists and is already open, this name is not used.
OUTPUT PARAMETERS
- LUB(25) = Integer array.
Matrix, Vector or Submatrix file attribute list for the output file. This file must be the same type and have the same record structure as the input file LUA.
FMS PARAMETERS
The following FMS Parameters are especially important to this routine:| Parameter | Description |
|---|---|
| IEXIST | Use existing file |
DESCRIPTION:
This subroutine makes a copy of the file described by LUA and places the contents into the file described by LUB. After this subroutine exits, the two files LUA and LUB are identical.If file LUB is not opened, this routine will create and/or open it, using the name specified.
If file LUB is already opened, the contents of LUA are copied to LUB. When LUB is open, it must have the same structure as the input file LUA. Specifically the following must match:
- File type (matrix, vector, submatrix)
- Matrix format, where appropriate (profile, block, slab)
- Record length
- Number of records
- File location (incore, disk)