damadd (Add a logical file)

Format

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

Function

The damadd command adds and catalogs a specified logical file.

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

Options

-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.

Command arguments

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.

Output messages

Message IDDescriptionOutput destination
KFCA01650-ESpecification of a command argument is invalid.Standard error output
KFCA01651-ELogical file name exceeds 8 characters.Standard error output
KFCA01652-EPhysical file name exceeds 63 characters.Standard error output
KFCA01653-IHelp messageStandard output
KFCA01654-EUser does not have access right to a special file.Standard error output
KFCA01655-EUser does not have access right to the file.Standard error output
KFCA01656-EBlock length is too large.Standard error output
KFCA01657-ESpecified file is not a DAM file.Standard error output
KFCA01658-ELogical file name already exists.Standard error output
KFCA01659-EPhysical file name already exists.Standard error output
KFCA01660-EInitialization has not been performed.Standard error output
KFCA01661-EI/O error occurred.Standard error output
KFCA01662-EMemory is inadequate.Standard error output
KFCA01663-EPhysical file was not found.Standard error output
KFCA01664-EAdditional area is inadequate.Standard error output
KFCA01665-ENumber of opened files exceeds the maximum.Standard error output
KFCA01666-EPhysical file name is invalid.Standard error output
KFCA01667-EVersions do not match.Standard error output
KFCA01679-EDAM service has not been started.Standard error output
KFCA01680-EName service has not been started.Standard error output
KFCA01681-ECommunication error occurred.Standard error output
KFCA01682-ENetwork error occurred.Standard error output
KFCA01683-EOvertime occurred.Standard error output
KFCA01684-EDAM service is terminating.Standard error output
KFCA01695-EDAM file is incomplete.Standard error output
KFCA01696-EError occurred during definition analysis.Standard error output
KFCA01698-EInsufficient record lock segmentStandard error output
KFCA02524-ENo additional file can be cataloged by deferred specification.Standard error output

Notes