The ADD command adds a record to a block.

The format of the ADD command 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/D ATA=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.