instantiate - TDF dataset copying routine

SYNOPSIS

#include "gp.h"
#include "uif.h"

int instantiate(inname, outname)
char *inname, *outname;

DESCRIPTION

instantiate copies the complete contents of an input dataset i.e., dimensions, attributes, variables, etc., to a new dataset with a different name. inname specifies the path of the input dataset, outname specifies the path of the output dataset.

This routine is used in special circumstances when the input dataset may have linked data (datasets), meaning the data for the input dataset actually resides in another file. In these cases, a simple Unix cp command for example, would create a new identical dataset, with again, links to the actual data. instantiate creates the new dataset and includes the actual data in the output dataset.

FILES

include/gp.h, include/uif.h, lib/libapp.a