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
//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.
//STEPLIB DD DSN=&HFMSMOD1,DISP=SHR
//* DD DSN=MQHLQ.SCSQLOAD,DISP=SHR
//* DD DSN=MQHLQ.SCSQANLE,DISP=SHR
//* DD DSN=MQHLQ.SCSQAUTH,DISP=SHR
//* 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.
//*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.//*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:
- Copy the HFMFTEXC member from HFM.SHFMSLIB to your own source library.
- 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.
- 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.
- Install SMP/E usermod HFMUMODB.