BPLCF JCL
You can generate a coupling facility report by running the batch coupling facility report job.
The following sample JCL is included in the SBPLSAMP library in
member BPLCF.
You can define the following symbolic parameters in the sample
job.
- SBPLLINK
- The SBPLLINK symbolic parameter sets the data set name of the IMS Buffer Pool Analyzer load library that is used in the STEPLIB DD statement.
- ITKBSRVR
- You can use the optional ITKBSRVR parameter to set the XCF group name for the IMS Tools Knowledge Base servers on the LPAR where the report job will run. If IMS Tools Knowledge Base is not used in your installation, or if you do not want to write the coupling facility report to the Knowledge Base repository, leave this symbolic parameter blank.
The following DD names are included in the JCL for the Buffer Pool
report:
- STEPLIB
- Required DD statement that must refer to a data set that contains the IMS Buffer Pool Analyzer load modules. The library does not require APF authorization for any batch report jobs.
- SYSPRINT
- Print output file for error messages and SYSIN control statements. This DD statement is required. The DCB information for this DD statement, which does not need to be specified, is RECFM=FBA,LRECL=133.
- GTFRPT
- Print output file for the GTF trace report. If you do not specify this DD statement, the GTF trace report will not be produced. DCB information is not required, but is RECFM=FBA,LRECL=133,DSORG=PS.
- SPLRPT
- Print output file for the current configuration (actual) coupling facility reports. If you do not specify this DD statement, the current configuration reports will not be produced. DCB information is not required, but is RECFM=FBA,LRECL=133,DSORG=PS.
- MDLRPT
- Print output file for the model configuration coupling facility reports, if an alternate configuration was requested in a DFSVSAMP DD statement or a CHANGE DBD statement in the SYSIN DD. If you do not specify this DD statement, the model subpool report will not be produced. DCB information is not required, but is RECFM=FBA,LRECL=133,DSORG=PS.
- DSNRPT
- Print output file for the Data Set Information report. You can disable this report by using the SYSIN statement DSNRPT=NO. If you do not specify this DD statement, the Data Set Information report will not be produced. DCB information is not required, but is RECFM=FBA,LRECL=133,DSORG=PS.
- SYSUDUMP
- Diagnostic information. If an abend occurs, the information that is produced by specifying this DD statement can be useful for troubleshooting purposes.
- TRACExxx
- You can include an unlimited number of TRACExxx DD names in the report job.
The last three characters of the DD name can be any characters that are valid in JCL. All of the
specified trace data sets are read and combined for reporting purposes. At least one
TRACExxx DD statement is required.Restriction: Each TRACExxx DD statement can have only one trace data set. Concatenated data sets are not supported. To include multiple trace data sets, code each data set with a different DD name.
For other considerations, see Combining multiple traces into a single report.
- DBDRPT
- Optional DD statement that can be used to specify an alternate configuration to model. When provided, this data set must contain IMS buffer pool definition statements, as described in the IMS System Definition, and IMS Buffer Pool Analyzer control statements described in DFSVSAMP statements.
- SYSIN
- Optional DD that can be used to specify IMS Buffer Pool Analyzer coupling facility report options. When provided, this data set must contain IMS Buffer Pool Analyzer statements, as described in SYSIN statements.