damload [-b batch-processing-blocks-count] block-length blocks-count physical-file-name [input-file-name]

The damload command allocates a physical file in an OpenTP1 file system and then outputs data from a specified input file to the allocated physical file. The size of the physical file will be (block length + 8) x (blocks count + 1). The access right to the physical file is 0644 (right to read and write by the owner, right to read by a group, and right to read by others).

-b batch-processing-blocks-count~<unsigned integer> ((1-2147483647)) <<10>>

Specifies the number of blocks to be output simultaneously. When you specify 0, 10 is assumed.

block-length~<unsigned integer> ((sector length x n-8))

Specifies the block length of the physical file to be created.

This specification is also required for the input file.

blocks-count~<unsigned integer> ((1-2147483647))

Specifies the number of blocks in the physical file to be created. If too many blocks are specified, the chain of cache blocks that are managed within the shared memory by DAM may become too large, with possible adverse effects on performance. When you create a DAM file with many blocks, use the damchlmt definition command in the DAM service definition to specify a threshold for the number of cache blocks.

physical-file-name~<path name>

Specifies a name for the physical file to be created in the OpenTP1 file system, expressed as the full path name.

input-file-name~<path name>

Specifies the name of the file to which data is to be input.

When this command argument is omitted, physical file allocation only is performed.

• If an error occurs during execution of the damload command, the physical file will remain allocated. Therefore, the physical file must be deleted by the damdel command before reexecution of the damload command.
• If the number of blocks specified in the damload command differs from the number of blocks in the input file, the following results:
  

  Specified blocks count > number of blocks in input file

  NULL data blocks are output through the end of the physical file.

  Specified blocks count < number of blocks in input file

  Input of blocks from the input file is cancelled, the KFCA02599-W message is output, and the damload command terminates normally.

• The maximum block length you can specify in the damload command is 32760.
• The DAM file is created on the OpenTP1 file system. Therefore, specify the block length and the block count that satisfy the following expression, in the damload command.
  OpenTP1 file system capacity > ((Block length + 8) x (Block count + 1))