SAMINVL

The SAMINVL routine causes all buffered index data to be ignored and causes physical reads of index data to occur on the next access of the database. Because the database can be concurrently updated by any number of users, the started task buffered index data can be incorrect or outdated.
view
The SAMINVL routine causes all buffered index data to be ignored and causes physical reads of index data to occur on the next access of the database. Because the database can be concurrently updated by any number of users, the started task buffered index data can be incorrect or outdated.
This situation can be resolved by invalidating buffers and rereading the index data. We do not recommend that the user issue an invalidate request for each index record that is retrieved since this slows down access to the database.
Note:
 If there is a large span of time from one access of the database to another, or if a new pass of the index is to be invoked, we recommend that an invalidate request be issued.
Calling Parameters
None.
Return Codes
Output Return Codes (general register 15):
  • 0
    Successful completion
  • 4
    Not used
  • 8
    Invalidation failed
Calling Example: Assembler
The following is an example using assembler:
. . . CALL SAMINVL INVALIDATE BUFFERS LTR 15,15 CHECK RETURN CODE BNZ DBERR
Calling Example: COBOL
The following is an example using COBOL:
. . . CALL 'SAMINVL'. IF RETURN-CODE NOT = ZERO GO TO DBERR.