xvsamImport

xvsamImport loads the content of a UNIX flat file into the XVSAM file system. The UNIX input file can be a binary or a text file. The difference between a binary file and a text file resides in the fact that each record in the text file is terminated by the new line character. (‘\n’ in C-language).

In case of binary files, each record is written at the end of the preceding one.

Syntax

xvsamImport [-p][-d][-l<debug level>][-r][-s][-i<char|0xHH>]

<catalog> <cluster> [<data file> <B|T>]

Options

-r        existing record keys are overwritten

-s        input is read from STDIN

-p        print input parameters

-i<char|0xHH>        inits record to value specified ( in hex or character )

-s        input is read from STDIN

Parameters

A protocol file can be created during the import function, by specifying -d<name>. If no name is specified, the protocol file will be created as xvsamImport.log.

This logging file is useful when the number of read records does not correspond to the number of written records; in the logging file each input and output record is saved, and in case of error an explanation message is written.

The level of detail with which XVSAM should report the sequence of operations on the protocol file, may be specified by means of the -l<level> optional parameter.

At the end of the import operation, xvsamImport reports how many records have been read from the UNIX file and how many records have been written in the XVSAM data set. The two numbers should correspond; if not, check the reason in the xvsamImport.log protocol file.

Example

# xvsamImport TESTCAT SNICTHLP /some/where/CUAHLP B
xvsamImport: Records read[159] written[159]

Return codes