IBM Support

CICS BAC Reset abnormal termination flag for CICS region in batch

Question & Answer


Question

Is it possible to reset the CICS Batch Application Control (BAC) abnormal termination flag setting in the CBAC control file for a CICS region in a batch job? I would prefer to do this instead of waiting until the CICS region can be restarted and the CICS BAC PLTPI initialization program runs to reset the flag

Answer

Yes there is a batch option to reset the abnormal terminal flag in the CBKCNTL control file. The CICS BAC documentation describes the file maintenance utililty command UPDATE REGION where you can specify the CLIENTRESETFLAG(YES).

You can use JCL similar to the following to change the abnormal termination flag in batch and list the change.

 //S1 EXEC PGM=CBKFMAIN,PARM='APPLID(your_applid)'
 //*
 //STEPLIB  DD  DISP=SHR,DSN=&hlq..SCBKLOAD
 //         DD  DISP=SHR,DSN=&hlq...SDFHEXCI
 //CBKPARMS DD  DISP=SHR,DSN=&hlq..PARMLIB
 //CBKPRINT DD  SYSOUT=*
 //CBKIN    DD  *
 *
   UPDATE REGION(your_applid),CLIENTRESETFLAG(YES)
   LIST REGION(your_applid)

The LIST REGION is not required, but the CBKPRINT DD will display the results of the region termination flags. Here is an example of the LIST REGION SYSPRINT where you can see the region termination options show CLIENTRESETFLAG(YES).

 Region startup options:                                                                    
   CICS startup processing:                                                                 
     COLDSTART(YES)  WARMSTART(YES)  EMERGENCYSTART(YES)                                    
   State monitor activation:                                                                
     MONITORFILES(YES)  MONITORTDQUEUES(YES)  MONITORTRANSIDS(YES)  MONITORPROGRAMS(YES)    
   Internal Trace Options:                                                                  
     TRACEENTRIES(1000)  TRACEOPTIONS(ENTRY)                                                
   Close/Enabled status change:                                                             
     STARTUPLEAVECLOSED(NO)                                                                 
 Region termination options:                                                                
   Abnormal termination options for workstation client requests:                            
     CLIENTFLAG(CONTINUE)  CLIENTRESETFLAG(YES)                                             
   Abnormal termination options for batch request utIlity:                                  
     ABENDFLAG(WRITE)  RESETFLAG(YES)                                                       
 Batch request processing:                                                                  
   Batch request utility command types:                                                     
     FILEREQUEST(YES)  TDQUEUEREQUEST(YES)  TRANSIDREQUEST(YES)  PROGRAMREQUEST(YES)        
     CEMTREQUEST(YES)  LINKREQUEST(YES)  STARTREQUEST(YES)                                  
   Disallowed command action:                                                               
     DISALLOWED(TERMINATE)  DISALLOWEDRETCODE(12)                                           
   Closed Enabled status change:                                                            
     BATCHLEAVECLOSED(NO)                                                                   
 Undefined object processing:                                                               
   Undefined objects encountered by batch request utility:                                  
     UNDEFINEDFILE(YES)  UNDEFINEDTDQUEUE(YES)  UNDEFINEDTRANSID(YES)  UNDEFINEDPROGRAM(YES)
     UNDEFINED(TERMINATE)  UNDEFINEDRETCODE(12)                                             
   Undefined objects encountered by CICS state monitor:                                     
     SYSCREATE(YES)                                                                         
 Miscellaneous(1):                                                                          
   Audit log options:                                                                       
     LOGERRORS(YES)  LOGSTATE(YES)  LOGNATIVE(YES)                                          
     DYNALLOG(SYSOUT)  LOGDSN()  LOGDISP(MOD)                                               
   Convert SET FILE/TDQ Open status commands:                                               
     CONVERTOPEN(YES)                                                                       
 Miscellaneous(2):                                                                          
   Default VSAM RLS options:                                                                
     RLSOPTIONS(PROCESS)                                                                    
   CICS command user exit programs:                                                         
     PRECOMMANDEXIT()  POSTCOMMANDEXIT()                                                    
                                                                                            
 


[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SSWHM2","label":"CICS Batch Application Control for z\/OS"},"Platform":[{"code":"PF035","label":"z\/OS"}],"Component":"","Version":"","Line of Business":{"code":"LOB17","label":"Mainframe TPS"}}]

Product Synonym

CICSBAC CICS BAC

Document Information

Modified date:
18 November 2015

UID

dwa1238218