damadd [{-d|-n[-f]}] [-l boundary-for-reusing-cache-blocks] logical-file-name physical-file-name

The damadd command adds and catalogs a specified logical file.

Another logical file cannot be allocated to an existing physical file.

-d

Adds and catalogs a logical file as a file using the deferred update facility. This option cannot be specified if no file using the deferred update facility is specified in the DAM service definition.

This option cannot be specified with the -n option.

-n

Adds and catalogs a logical file as a file not to be recovered.

If the -n option is not specified, a logical file is added and cataloged as a file to be recovered.

The -n and -d options are mutually exclusive.

-f

Adds and catalogs a logical file as a file not to be recovered, for access by cacheless access. Specify this option together with the -n option.

-l boundary-for-reusing-cache-blocks~<unsigned integer>((0-4000000))<<0>>

Specify the boundary for reusing cache blocks for a DAM file.

If you do not specify this option, the boundary for reusing cache blocks for the registered DAM file is assumed to be zero regardless of whether the dam_default_cache_num operand is specified in the DAM service definition.

logical-file-name~<identifier, 1-8 characters>

Specifies the name of the logical file to be added and cataloged.

physical-file-name~<path name>

Specifies the name of the physical file that is to correspond to the logical file, expressed as the full path name.

Message ID	Description	Output destination
KFCA01650-E	Specification of a command argument is invalid.	Standard error output
KFCA01651-E	Logical file name exceeds 8 characters.	Standard error output
KFCA01652-E	Physical file name exceeds 63 characters.	Standard error output
KFCA01653-I	Help message	Standard output
KFCA01654-E	User does not have access right to a special file.	Standard error output
KFCA01655-E	User does not have access right to the file.	Standard error output
KFCA01656-E	Block length is too large.	Standard error output
KFCA01657-E	Specified file is not a DAM file.	Standard error output
KFCA01658-E	Logical file name already exists.	Standard error output
KFCA01659-E	Physical file name already exists.	Standard error output
KFCA01660-E	Initialization has not been performed.	Standard error output
KFCA01661-E	I/O error occurred.	Standard error output
KFCA01662-E	Memory is inadequate.	Standard error output
KFCA01663-E	Physical file was not found.	Standard error output
KFCA01664-E	Additional area is inadequate.	Standard error output
KFCA01665-E	Number of opened files exceeds the maximum.	Standard error output
KFCA01666-E	Physical file name is invalid.	Standard error output
KFCA01667-E	Versions do not match.	Standard error output
KFCA01679-E	DAM service has not been started.	Standard error output
KFCA01680-E	Name service has not been started.	Standard error output
KFCA01681-E	Communication error occurred.	Standard error output
KFCA01682-E	Network error occurred.	Standard error output
KFCA01683-E	Overtime occurred.	Standard error output
KFCA01684-E	DAM service is terminating.	Standard error output
KFCA01695-E	DAM file is incomplete.	Standard error output
KFCA01696-E	Error occurred during definition analysis.	Standard error output
KFCA01698-E	Insufficient record lock segment	Standard error output
KFCA02524-E	No additional file can be cataloged by deferred specification.	Standard error output

• A logical file corresponding to a physical file cannot be added or cataloged if its block length is greater than the block length of the existing physical file.
• The number of files to be added and cataloged cannot exceed the value defined in the DAM service definition of the maximum number of logical files to be added in the online mode.