PUT C-1





Copyright (C) 1994-95 Conetic Software Systems, Inc. All names, products, and services mentioned are the trademarks of their respective organizations.



NAME


put - put text data into RMSfile

SYNOPSIS


put [-ufv] datafile [datafields]

DESCRIPTION


Put reads lines from the standard input, creates data records from the 
input and puts the data records into the specified RMSfile.  Each 
datafield argument is a data field in the data file, and each input line
lists the values for these fields that make up one record.  The fields
in each input line are separated by carets (^), and these fields must 
correspond to the order in which the datafields are listed.  The last 
input field is a record number.  The format of an input line is:

	value^value^value^...^value^recordnumber

A data record is constructed from the input line, and the record is added 
to the data file.  If the data record has additional fields that are not 
specified as one of the datafields, these fields are set to zero.  If a 
record with the same key value already exists in the RMSfile, it is not 
deleted.

If the -u flag is used, the last field of each input line is assumed to 
be a record number in the RMSfile.  In this case, the input lines are 
used to update the contents of an existing record in the RMSfile.  Any
data fields in the record not specified in the command line are not 
changed.  Also, put does not change any fields that are key fields when
the -u flag is used.  This flag is meant to be used with output generated
by pull(C-1).

If the -f flag is specified, the first input line contains the list of 
data fields separated by carets and any datafields specified in the 
command line are ignored.

If the -v flag is specified, put will print out a running total of how 
many records have been put into this datafile.

Put can be used to load data that was produced by some other program into 
the data files.  If the input file has been produced by some other program, 
a dummy field that represents a record number must be appended to each 
input line.  In this case the -u flag must not be used, and the dummy 
record number is not referenced.

SEE ALSO


pull(C-1).
C/Base Utilities Manual Chapter 6, Transferring C/Base Applications.