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

Name

mcf_nm_write — Write to neutral file

Synopsis

subroutine mcf_nm_write(handle,patt,nfname,status)

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

Description

mcf_nm_write writes (encodes) one or more datasets residing on the database identified by handle to the neutral file handle nfname (see mc_nm_open for obtaining the neutral file handle). If the dataset pattern matching string patt is not blank only datasets matching patt will be written to the neutral file.

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.