Skip to Content

JCL requirements for the DB Scan function

The following figure shows that the JCL requirements for the DB Scan function are similar to those for the IMS Database Scan utility (DFSURGS0).

Depending on how you installed the Unload function, you might need to modify the JCL by adding a STEPLIB DD statement.

//UNLOAD   EXEC PGM=DFSRRC00,PARM='ULU,DFSURGS0'
//STEPLIB  DD DISP=SHR,DSN=bmc.xxx.load
//IMS      DD DISP=SHR,DSN=IMSVS.DBDLIB
//DFSURCDS DD DISP=SHR,DSN=your.DFSURCDS
//database DD DISP=OLD,DSN=dataSetName
//DFSURWF1 DD DISP=(NEW,CATLG),UNIT=TAPE,DSN=your.DFSURWF1,
//            DCB=(LRECL=300,BLKSIZE=4096)
//*
//BMCPRINT DD SYSOUT=A                         <=== optional
//BMCMSG   DD SYSOUT=A                         <=== optional
//PLUSIN   DD *                                <=== optional
   DBSCAN   PTRERROR(ACCEPT)                   <=== optional
/*                                             <=== optional
//*

An explanation of the JCL follows:

EXEC

You must specify PGM=DFSRRC00,PARM='ULU,DFSURGS0'. You can add the IMSID parameter to override the IMSID specified in the IMS RESLIB.

STEPLIB DD

Optional. For more information, see STEPLIB-DD.

IMS DD

Required. Describes the library, typically IMSVS.DBDLIB, containing the DBDs that describe the databases being scanned.

DFSURCDS DD

Required. For more information, see DFSURCDS-DD.

database DD

Required. Defines the data sets that contain the database being scanned. You must supply one DD statement for each data set appearing in the DBD. The ddnames must match the ddnames specified in the DBD.

BMCMSG DD

Optional. For more information, see BMCMSG-DD.

DFSURWF1 DD

Required. For more information, see DFSURWF1-DD.

Warning

Note

The Unload function uses the BMC DFSURWF1 work file generator to build the work file records. If you scan the database with the Unload function and then use the IBM DFSURWF1 work file generator when loading it, you must specify the DCB information on the SORTIN or DFSURWF1 DD statement in the JCL for PREFIX RESOLUTION PLUS or the IMS Prefix Resolution utility.

PRPURWF1 DD

Optional. For more information, see PRPURWF1-DD.

BMCPRINT DD

Optional. For more information, see BMCPRINT-DD.

PLUSIN DD

Optional. The DBSCAN command is required. The following keywords are optional:

  • DESCCODE
  • DYNALLOC
  • IMSID
  • LPCK
  • MONITOR
  • MONUSERS
  • PTRERROR
  • ROUTCODE
  • USEINDEX

For information about the tasks these keywords accomplish, see User-controlled-options For information about how to specify the keywords, see PLUSIN control statement syntax—user-controlled options.

PDX DD

Optional. For more information, see PDX-DD.

SYSUDUMP DD

Recommended. For more information, see SYSUDUMP-DD.


Related topic

DB-Scan-function


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC AMI Online Reorg for IMS 5.2