Changing the JCL skeleton for batch mode

Several functions in Z Data Tools are available in batch mode and the TSO batch environment. For these functions to run successfully, appropriate job control language statements must be provided. This is done by means of the set processing options, and a job control skeleton. The job control skeleton for Z Data Tools is the member HFMFTEXC in HFM.SHFMSLIB.

HFMFTEXC

There are some DD statements in HFMFTEXC that you may need to change. These statements are commented out in the distributed version of the skeleton. They are documented below.
//STEPLIB  DD DSN=&HFMSMOD1,DISP=SHR
//* If using WMQ queues via batch, uncomment and update MQHLQ to suit
//* your sites WMQ high level qualifier
//*        DD DSN=MQHLQ.SCSQLOAD,DISP=SHR
//*        DD DSN=MQHLQ.SCSQANLE,DISP=SHR
//*        DD DSN=MQHLQ.SCSQAUTH,DISP=SHR
//*        DD DSN=IGY.SIGYCOMP,DISP=SHR
//*HFMCOB  DD DUMMY     Uncomment to force use of ZDT COBOL Compiler
//*HFMCLERR DD SYSOUT=* Uncomment to force output of Compiler listing

HFMFTEXC assigns a STEPLIB DD statement to the Z Data Tools load library. HFMFTEXC assumes that you have installed Z Data Tools into the default target libraries, and that the load library is HFM.SHFMMOD1. If you have installed Z Data Tools into a different library than HFM.SHFMMOD1, you may either change the LOADLIB parameter in the HFM0POPT module or change the //STEPLIB DD statement in the HFMFTEXC skeleton.

If necessary, change &HFMSMOD1 in this statement to the name of your Z Data Tools load library.
//STEPLIB  DD DSN=&HFMSMOD1,DISP=SHR
Z Data Tools can process WebSphere® MQ queues in both online and batch scenarios for the common utilities; create, copy, compare and print. To interface with WebSphere, the libraries SCSQLOAD, SCSQANLE, and SCSQAUTH must be made available to the JOBLIB, STEPLIB or linklist concatenation. You can do this by uncommenting these lines:
//*        DD DSN=MQHLQ.SCSQLOAD,DISP=SHR
//*        DD DSN=MQHLQ.SCSQANLE,DISP=SHR
//*        DD DSN=MQHLQ.SCSQAUTH,DISP=SHR
The STEPLIB DD statement in this skeleton also concatenates the following statement, which appears as a comment in HFMFTEXC.
//*        DD DSN=IGY.SIGYCOMP,DISP=SHR

In this statement, IGY.SIGYCOMP is the supported, licensed COBOL compiler library. Some batch functions which make use of COBOL require this library. If you did not add your supported COBOL compiler library to your LINKLIST, remove the * to uncomment the line, and change the DSN to the name of your supported COBOL compiler library. All currently supported versions of IBM® Enterprise COBOL for z/OS® and OS/390® are supported by Z Data Tools.

If you have created a COBOL compiler library for Z Data Tools with a special version of IGYCDOPT, you can use this DD statement to make it available to Z Data Tools for all batch jobs using COBOL templates. See Using COBOL compiler options with Z Data Tools for information about a special version of IGYCDOPT for Z Data Tools.

If you do not have a supported COBOL compiler available to Z Data Tools (for example, if you are using Z Data Tools in a production environment, where the COBOL compiler is not used), Z Data Tools can use its own internal COBOL compiler. To enable this feature, remove the * to uncomment the third statement:
//*HFMCOB  DD DUMMY     Uncomment to force use of ZDT COBOL Compiler
If Z Data Tools encounters a statement, //HFMCOB DD DUMMY, the Z Data Tools COBOL compiler will be used. For information about the Z Data Tools COBOL compiler, see Using the Z Data Tools COBOL compiler.
If you want to produce a compile listing of copybooks processed by Z Data Tools functions, in case of compile errors, remove the * to uncomment the fourth statement:
//*HFMCLERR DD SYSOUT=* Uncomment to force output of Compiler listing
You can also change the specification of SYSOUT on this statement, if necessary, to suit your site's requirements.

If you plan to enable Z Data Tools to use the DFSORT COPY function to improve Z Data Tools performance, you might want to add the DFSORT libraries to this STEPLIB DD statement. If you do this, you must add them in the order SICELINK, followed by SORTLPA. If you choose to do this and DFSORT is not your primary sort product, you must also add your sort products libraries in front of the DFSORT libraries. For more information about using DFSORT to improve Z Data Tools performance, see Customizing to use DFSORT to improve Z Data Tools performance.

If you plan to enable Z Data Tools to access COBOL copybooks, PL/I include books, or HLASM copybooks in library management system (LMS) libraries, and you plan to link edit your LMS exit, HFMCRAEX, into your own load library, you might want to add this load library to the STEPLIB DD statement in the JCL skeleton. For more information about enabling Z Data Tools to access LMS libraries, see Customizing Z Data Tools to use library management system libraries.

You use the usermod HFMUMODB to modify the job control skeleton. HFMUMODB is distributed in HFM.SHFMSAM1. To do this:

  1. Copy the HFMFTEXC member from HFM.SHFMSLIB to your own source library.
  2. Modify the HFMFTEXC member in your own library. Change the name of the Z Data Tools load library on the first line of the STEPLIB DD statement to the name of your load library, if necessary. Uncomment the second line of the STEPLIB DD statement if you want to add your COBOL compiler library, and change the DSN to the name of your COBOL compiler library, if necessary. Uncomment the WMQ lines, if necessary. Add your sort and LMS exit libraries if necessary.
  3. Modify the HFMUMODB member in HFM.SHFMSAM1 to meet your site's requirements. Refer to the usermod for information about changes you might need to make.
  4. Install SMP/E usermod HFMUMODB.
Note: Z Data Tools does not provide support for the automatic generation of job routing control statements in the JCL generated by HFMFTEXC.