Creating JCL

You can use IDCAMS REPRO job streams by changing the PGM= specification to XBMXUTIL on the EXEC card and including a STEPLIB DD statement pointing to the XBM load library.

The XBM utility program supports cluster names for input. Output can be one of several forms and may be empty or nonempty files:

• Sequential data set
• Entry-sequenced data set (ESDS)
• Key-sequenced data set (KSDS)
• Relative record data set (RRDS)

Use XBMIN DD, SYSIN DD, or both to supply control cards to the XBM utility program. Control cards in XBMIN DD are always processed first and are processed as SYSIN cards.

For example, assume that you have an existing IDCAMS REPRO job with a SYSIN DD that points to a set of control cards in a partitioned data set (PDS). To use snapshot utilities without changing the control cards, perform the following steps:

To specify JCL

1. Add XBMIN DD statement to the JCL.
2. Change PGM=IDCAMS to PGM=XBMXUTIL.

3. Include a SETXBM command with the XBMIN DD.The SETXBM command is used to group XBM utility program commands for processing by XBM. When the SETXBM command is specified, at least one keyword must also be specified.

   Warning

   Important

   SETXBM control cards cannot occupy the first-byte column of JCL you submit for the  utility program.

   The following figure shows an example of the JCL required to run a Snapshot Copy job with the XBM utility program . This example shows an existing IDCAMS REPRO job with the XBMIN DD statement added.

   //XBMCOPY JOB  (ACCT),'XBM SNAPSHOT COPY'
   //*******************************************************
   //*  (C)COPYRIGHT 1993-2013 BMC SOFTWARE INC.
   //*     AS AN UNPUBLISHED WORK.
   //*******************************************************
   //*   JCL TO RUN THE XBM UTILITY PROGRAM
   //*******************************************************
   //XBMCOPY  EXEC PGM=XBMXUTIL,REGION=4096K
   //STEPLIB  DD DISP=SHR,DSN=<high-level-qualifier>.LOAD
   //*******************************************************
   //* UPDATE THE VSAM CLUSTER TO BE COPIED AND THE OUTPUT FILE
   //* ALSO, PROVIDE OUTPUT FILE DCB ATTRIBUTES
   //******
   //INPUT DD  DISP=SHR,DSN=BMCXBM.KSD46.CI02048 ***INPUT DSN***
   //*
   //*
   //OUTPUT DD  DISP=(     ),DSN=BMCXBM.VSC46K7.VSC1,  ***OUTPUT DSN***
   //     DCB=(      )  ***PROVIDE DCB INFO FOR OUTPUT DSN***
   //*
   //*******************************************************
   //****** XBMXUTIL COPY CONTROL CARDS
   //XBMIN    DD  *
    SETXBM    XBMID(XBM) CONCURRENT(REQUIRED)
   //SYSIN    DD  *
    REPRO INFILE(INPUT) OUTFILE(OUTPUT)
   //*
   //SYSUDUMP DD  SYSOUT=*
   //SYSTERM  DD  SYSOUT=*
   //SYSPRINT DD  SYSOUT=*
   //*******************************************************

   When you install XBM, the preceding sample JCL is automatically customized with your job card, STEPLIB library, and XBM subsystem ID.

   The following figure shows another way to run a snapshot utility job with JCL that uses the SYSIN DD statement for the SETXBM control card.

   //XBMCOPY JOB  (ACCT),'XBM SNAPSHOT COPY'
   //*******************************************************
   //*  (C)COPYRIGHT 1993-2013 BMC SOFTWARE INC.
   //*     AS AN UNPUBLISHED WORK.
   //*******************************************************
   //*   JCL TO RUN THE XBM UTILITY PROGRAM
   //*******************************************************
   //XBMCOPY  EXEC PGM=XBMXUTIL,REGION=4096K
   //STEPLIB  DD DISP=SHR,DSN=<high-level-qualifier>.LOAD
   //*******************************************************
   //* UPDATE THE VSAM CLUSTER TO BE COPIED AND THE OUTPUT FILE
   //* ALSO, PROVIDE OUTPUT FILE DCB ATTRIBUTES
   //******
   //INPUT DD  DISP=SHR,DSN=BMCXBM.KSD46.CI02048 ***INPUT DSN***
   //*
   //*
   //OUTPUT DD  DISP=(    ),DSN=BMCXBM.VSC46K7.VSC1,  ***OUTPUT DSN***
   //     DCB=(     ) ***PROVIDE DCB INFO FOR OUTPUT DSN***
   //*
   //*
   //*******************************************************
   //****** XBMXUTIL COPY CONTROL CARDS
   //SYSIN    DD  *
    SETXBM    XBMID(XBM) CONCURRENT(REQUIRED)
    REPRO INFILE(INPUT) OUTFILE(OUTPUT)
   //*
   //SYSUDUMP DD  SYSOUT=*
   //SYSTERM  DD  SYSOUT=*
   //SYSPRINT DD  SYSOUT=*
   //*******************************************************

This section contains the following topics: