DOMBSWIT utility
Use the DOMBSWIT utility to invoke the Data Collector SWITCH command from a batch job.
This command generates an archive from the currently active log file for the specified output group. The DOMBSWIT utility can be used to make periodic copies of the data sets for long-term storage.
The program DOMBSWIT is shipped with the System and SQL Performance for DB2 products in the load library. The source code for DOMBSWIT is in the hlq.llqSAMP data set. If modifications are made to this source code, you must assemble DOMBSWIT and link it 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 parameters to this program are specified in the PARM portion of the EXEC JCL statement that invokes DOMBSWIT as in the following example:
- xxxx is the Data Collector subsystem ID
- yyy is the output group whose data sets are to be switched. Specify one of the following values:
- A number in the range 001–128
- ALL to indicate all output groups
The #DOMSWIT member of the hlq.llqSAMP data set contains sample JCL to invoke DOMBSWIT. See DOMBSWIT JCL.
DOMBSWIT JCL
// 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 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=*
/*
Related topic