The ADD command adds a record to a block.

The format of the ADD command is:

         AD[D] [-B[LOCK]=block]
        

For blocks with a level greater than zero (0) is:

        
        
         ADD [ -B[LOCK]=[block] -STAR -POINTER=block
            or
         ADD -[-B[LOCK]=[block]-OFFSET=offset|-RECORD=record -KEY=key -POINTER=pointer
        
        

For level 0 blocks, it is:

        
        
        ADD-[-B[LOCK]=[block]-OFFSET=offset|-RECORD=record -KEY=key -DATA=string
        
        

The ADD command requires either the -OFFSET or -RECORD qualifier to position the record in the block, and either the -KEY or the -STAR qualifier to define the key for the block.

The -STAR qualifier is invalid at level 0 (a data block). The ADD command requires the -DATA qualifier at level 0 or the -POINTER qualifier at any other level to provide record content.