DOMBSWIT utility

The program DOMBSWIT is shipped with the System and SQL Performance products in the load library. The source code for DOMBSWIT is in the BBSAMP data set. If modifications are made to this source code, DOMBSWIT must be assembled and linked into the Data Collector or other APF-authorized load library. You must specify AC=1 in the linkage editor parameters to show that this routine executes from an APF-authorized library in supervisor state.

The Data Collector and output group are specified in the PARM portion of the EXEC JCL statement that invokes DOMBSWIT, as in the following example:

PARM= <xxxxyyy>

where xxxx is the Data Collector subsystem ID and yyy is the output group whose LOGSET log files are to be switched. Valid values are:

The #DOMSWIT member of the BBSAMP data set contains sample JCL to invoke DOMBSWIT (see the following figure).  

//DOMBSWIT JOB (ACCT),'SWITCH AMFORDB2 TRACE', <== MODIFY                  
//            USER=AMFORDB2,                  <== MODIFY                   
//            MSGCLASS=X,                     <== CHECK                    
//            class="A"                         <== CHECK                    
//*                                                                        
//*Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z     
//*                                                                        
//*  DOMBSWIT -- SWITCH DATA COLLECTOR TRACE DATASET                       
//*                                                                        
//*  DOMBSWIT FORCES THE DATA COLLECTOR TO EXTERNALIZE EXISTING TRACE      
//*  RECORDS OF THE TARGET OUTPUT GROUP(S) TO THE ARCHIVE PROCESS          
//*                                                                        
//*    MODIFY ==>  ?BMC-HLQ?                                               
//*                ?DOM1?        = DATA COLLECTOR SUBSYSTEM NAME           
//*                ?OG?          = DATA COLLECTOR OUTPUT GROUP NUMBER      
//*                                EG. '001' FOR OUTPUT GROUP 001          
//*                                                                        
//*Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z/Z     
//*                                                                        
//DOMBSWIT EXEC PGM=DOMBSWIT,PARM='?DOM1??OG?'                             
//STEPLIB  DD   DISP=SHR,DSN=?BMC-HLQ?.BBLINK                              
//*                                                      
//DOMCUST   DD DISP=SHR,DSN=?BMC-HLQ?.BBCSTM             
//DOMBARC   DD DISP=SHR,DSN=?BMC-HLQ?.COPYDIR            
//DOMPROF   DD DISP=SHR,DSN=?BMC-HLQ?.PROFILE            
//DOMAUTH   DD DISP=SHR,DSN=?BMC-HLQ?.SECURITY           
//DOMHELP   DD DISP=SHR,DSN=?BMC-HLQ?.BBHELP             
//*                                                      
//SYSPRINT DD   SYSOUT=*                                 
/*