BCL for impact analysis queries

The remote build feature uses an MVS™ program called BCCIAQRY to query the impact analysis data on the mainframe system. This topic contains sample BCL for running BCCIAQRY.

ClearCase® users working on a distributed system can construct rccbuild requests that call this load module to query the impact analysis data. To support these remote build requests, you need to create BCL such as that shown in the following example. Refer to the callouts in the sample BCL for an explanation of the data sets and options shown in this sample BCL. The following list refers to the callouts shown in the right margin of the sample.
  • 1 BCCIAQRY is the load module on MVS that performs the query. The PARM clause specifies one parameter: NOXML.. NOXML indicates that the query input is in text format. This parameter is required.
  • 2 The library containing program BCCIAQRY.
  • 3 The data set where the input file (query conditions) is uploaded to MVS. In this example, a temporary data set is allocated for this purpose.
  • 4 The data set where the input file is uploaded. The DD name must be QUERYIN. Otherwise BCCIAQRY is not able to use the input file.
  • 5 The data set where the query results are written. The results can also be returned to the distributed system by the remote build command. The DD name must be QUERYOUT. Otherwise BCCIAQRY is not able to write the query result.
  • 6 The data set to which error messages for BCCIAQRY are written. Error messages can also be returned to the distributed system.
  • 7 The data set to which standard output messages for BCCIAQRY are written. Standard output messages can also be returned to the distributed system.
//QUERY EXEC PGM=BCCIAQRY,PARM='NOXML'   1
//STEPLIB DD DSN=RCC.IA.TSCLOAD,DISP=SHR   2
//INPDS DD RCCEXT=(TXT),DISP=(NEW,DELETE),    3
//       SPACE=(TRK,(10,5,1)),UNIT=VIO,
//       DCB=(RECFM=VB,LRECL=256,BLKSIZE=2560),
//       DSNAME=&&CCUTEMP
//QUERYIN   DD DISP=(SHR,KEEP),DSN=&&CCUTEMP(&INPUT)   4
//QUERYOUT DD RCCEXT=OUT,DISP=(NEW,DELETE),   5
//         SPACE=(32000,(30,10)),UNIT=VIO,
//         DCB=(RECFM=FB,LRECL=200,BLKSIZE=3200)
//SYSOUT DD RCCEXT=RCCERR,DISP=(NEW,DELETE),   6
//         SPACE=(32000,(30,10)),UNIT=VIO,
//         DCB=(RECFM=FBA,LRECL=121,BLKSIZE=1210)
//SYSPRINT DD RCCEXT=RCCOUT,DISP=(NEW,DELETE),   7
//         SPACE=(32000,(30,10)),UNIT=VIO,
//         DCB=(RECFM=FBA,LRECL=121,BLKSIZE=1210)
//
Tip: Users can also call BCCIAQRY on MVS by submitting JCL to perform the query.