TPX RESET INTEGRITY (BATCHINI) - What it is and when it should be run

Products

• TPX - Session Management

Issue/Introduction

What does the TPX RESET INTEGRITY batch job BATCHINI provide and when should it be run ?

Environment

Release : 5.4

Component : TPX for z/OS

Resolution

TPX uses "control record 0" to guarantee that the VSAM control information, maintained on each system, is in sync.
Doing this avoids possible index problems if and when CA/CI splits occur on the VSAM files.

If a TPX VSAM file is Restored, Reorged or Copied/Moved, the control record 0 on the file will probably contain incorrect information.
This should be deleted by running the BATCHINI job found in the sample library, before any image of TPX is started.

The Reset Integrity batch job (BATCHINI) must be executed anytime you REORG, COPY, MOVE or catalog the TPX VSAM Databases (ADMIN1, ADMIN2, MAIL, VIEW and NOTES).
It should also be run when you observe VSAM Integrity Errors in the TPX LOG.

Follow the 3 steps below:

1) Stop TPX task.


2) Submit the job found at **. CB0VSRC(BATCHINI)

  //TPXBATCH JOB 1,TPX,MSGLEVEL=1,CLASS=A,MSGCLASS=H               
  //*                                                              
  //BATCHADM  EXEC TPXPROCNAME,VNODE='*BATCH*'                     
  //SYSIN DD *                                                     
  C                                                                 
  C THIS SAMPLE TPX BATCH ADMINISTRATION JOB WILL RESET THE VSAM VSI
  C INTEGRITY RECORD FOR TPX VSAM FILES.                           
  C                                                                
  RESET INTEGRITY (ADMIN1 ADMIN2 NOTES MAIL VIEW)                  
  //   
                                                           
Note1:  'TPXPROCNAME' in this sample should be changed to the TPX procedure name for the Started task.


3) Start TPX task.


Note:
When the RESET INTEGRITY statement is executed, following messages may appear in the batch log:

  TPBL1010 VSAM ERA CTLREC 0 RETURN CODE IS 8
  TPBL1051 MEANS RECORD ACCESSED NOT ON FILE

These messages indicate that the file did not need to be reset because control record zero has already been deleted.
No error has occurred, and your batch file will continue to execute - This is considered normal and not an error situation.

Additional Information

For more information review TPX 5.4 - Batch Administration - VSAM Data Sets.