Modifying the DBC started task

Running the DBC$STC started task procedure starts the subsystem.

Before you begin

The DBC SSID referenced in the started task procedure must match what you are using for this LPAR. You can use the same started task member on each LPAR by specifying the SSID value in the startup command.

Important

In the following JCL example:

The DOMTMPLT and DOMPARMS DD statements are used only by System and SQL Performance products. These DD statements might be missing or commented out if you do not have those products.
In version 10.1.00 of DBC, the DBCPARMS member contained the DBC repository data set name. If you have a DBC repository for an existing DBC that had agents defined to it, add the DBCPARMS DD to the procedure. When DBC starts, the DBCPARMS member will be read and the definitions migrated to the new version of DBC as products are upgraded. Once all products are upgraded and all definitions from the DBC repository are deleted, the DBC repository can be deleted.
If you have an existing DBC that had the NGL agent defined to it, the REGISTRY DD with that data set can be specified in this PROC. Each PIID will get a new registry data set and data will be migrated from the REGISTRY DD data set to the new one for each PIID. After that, the REGISTRY DD can be removed from the JCL. The REGISTRY DD is not needed for a new DBC.

Example of DBC started task JCL

//DBC    PROC ACC=4111,
//             SSID=DCSA,       ====> SSID
//             G=DBCPLEX1,      ====> GROUP
//             T=NO,            ====> TRACE
//             TIM=1440         ====>
//*
//DBC      EXEC PGM=DBCMAIN,REGION=0M,ACCT=&ACC,TIME=&TIM,
//         PARM='SSID=&SSID,GROUP=&G,TRACE=&T'
//STEPLIB DD DSN=BMCPERF.TEST.BMCLINK,
//            DISP=SHR
//DBCPRINT DD SYSOUT=*,RECFM=VA
//SYSPRINT DD SYSOUT=*,RECFM=VA
//BMCPSWD   DD DISP=SHR,
//          DSN=BMCPERF.TEST.BMCLINK
//SYSTSPRT DD SYSOUT=*
//SYSTERM   DD SYSOUT=*,RECFM=VA
//DBCENV    DD DISP=SHR,
//          DSN=BMC.&G..S&SYSCLONE..DBCENV.PDSE
//DBCPARMS DD DISP=SHR,
//          DSN=BMCPERF.TEST.UBMCSAMP($DBC&SSID)
//DBCSECUR DD DISP=SHR,
//          DSN=BMCPERF.TEST.UBMCSAMP($SEC&SSID)
//DOMTMPLT DD DISP=SHR,
//          DSN=BMCPERF.TEST.BMCTMPLT
//DOMPARMS DD DISP=SHR,
//          DSN=BMCPERF.TEST.BMCPARM

To modify the DBC started task

Change the ACC= value at the top of the PROC (if necessary) for accounting information. This is optional.

To setup another DBC

The DBC$STC started task references the following members for the DBC SSID:

$DBC&ssid
$SEC&ssid

Replicate the members in the appropriate user or runtime data set as appropriate.