MemCom Reference Manual > MemCom ftn Fortran API > The Neutral File Formatter (NM) > mcf_nm_read

Name

mcf_nm_read — read from neutral file

Synopsis

subroutine mcf_nm_read(handle,patt,nfname,status)

integer*4 handle
character*(*) patt
character*(*) name
integer*4 status

Description

mcf_nm_read reads (decodes) one or more datasets from the neural file nfname and writes them to the MemCom database identified by handle (see mc_nm_open for obtaining the neutral file handle). If the dataset pattern matching string patt is blank all dataset found on the neutral file are written to the database. If the dataset pattern matching string patt is not blank, datasets matching patt will be read from the neutral file and added to the database.

Parameters

handle

Database handle of open database from where data are written to the neutral file (input).

patt

Dataset matching pattern (input). If patt is not NULL or blank only datasets matching patt will be encoded.

nfhandle

Neutral file handle (input).

status

Status code returned (output). Upon successful completion of the operation, the status value 0 is returned. A negative value is returned, if an error has been detected. A positive value is returned, if a warning has been issued.