PDF documentation
About this document
These topics provide information needed to plan for, customize, maintain, and diagnose problems with HCL Z Data Tools.
Summary of changes
Customizing Z Data Tools
- Preparing to customize Z Data Tools
- Customizing the operating environment for Z Data Tools
  - License and enable Z Data Tools
  - Modifying the ISPF environment
    To make it easy to start Z Data Tools under ISPF, configure your ISPF environment as described in the following sections.
  - Enabling Z Data Tools to work with certain products
    - Enabling WebSphere® MQ support
      To access WebSphere® MQ queue managers and queue contents on the local z/OS® system where Z Data Tools is running, the WebSphere MQ libraries must be made available to Z Data Tools and users must be granted read and update access.
    - Customizing for processing COBOL copybooks
      To use the view, edit, copy, print, or data create functions with a COBOL copybook, you need to make a COBOL compiler available to Z Data Tools.
    - Customizing for processing PL/I include books
    - Customizing for processing HLASM copybooks
    - Customizing to use DFSORT to improve Z Data Tools performance
      Z Data Tools can use DFSORT to improve the performance of the Data Set Copy and Data Set Print functions under ISPF and in batch.
    - Binding Db2® to use Z Data Tools object access method (OAM) functions
  - Disabling Websphere MQ feature by system name
  - Running Z Data Tools with APF-authorization
  - Language Environment® considerations
- Customizing Z Data Tools
- Customizing the Z Data Tools security environment
  Z Data Tools provides security for system-oriented functions through RACF® (or an equivalent security product).
- Customizing Z Data Tools to write audit records to SMF
- Customizing the Z Data Tools audit facility for the Z Data Tools Base component
- Customizing Z Data Tools for national languages
  You can customize Z Data Tools for national languages other than English.
- Customizing Z Data Tools Service Provider for z/OS® Connect
  Z Data Tools Service Provider for IBM® z/OS® Connect Enterprise Edition enables client applications to access IBM Z data sources using z/OS Connect.
- Customizing Z Data Tools to use library management system libraries
- Customizing Z Data Tools to use the Optim™ Data Privacy Provider API
- Customizing Z Data Tools to use an I/O exit
- Customizing Z Data Tools to use a scrambling exit
- Verifying the customization of Z Data Tools
  After you have completed the initial installation and customization of Z Data Tools Base function, you can perform the following steps to verify your customization.
Customizing Z Data Tools Db2® Component
Customizing Z Data Tools IMS™ Component
Customizing Z Data Tools CICS® Component
Z Data Tools on VS Code
HCL Z Data Tools is a host component that supports a Microsoft Visual Studio Code IDE.
Preparing for Z Data Tools Remote Services
Customizing Z Common Components server
Z Data Tools options
ZDT/Db2 options
ZDT/IMS options
Z Data Tools options specified in PARMLIB members
The library management system exit
Z Data Tools audit records
Notices

Binding Db2® to use Z Data Tools object access method (OAM) functions

If you intend to use Z Data Tools OAM functions, you must bind the Z Data Tools plan, HFMODIRS, into the Db2® system where the OAM objects are defined, to allow the proper working of OAM functions. The following sample jobs are provided in HFM.SHFMSAM1 and can be used to bind the HFMBDIRS plan/collection into a Db2® subsystem.

HFMBDI2K: Db2® V12 JOB to bind the collection associated with plan HFMBDIRS.
HFMBDI2P: Db2® V12 JOB to bind the plan HFMBDIRS.
HFMBDI3K: Db2® V13 JOB to bind the collection associated with plan HFMBDIRS.
HFMBDI3P: Db2® V13 JOB to bind the plan HFMBDIRS.

Customize the sample jobs according to your Db2® installation requirements. See the instructions in the sample jobs for more information about changes you need to make.

The DBRM associated with the plan HFMBDIRS is distributed in HFM.SHFMDBRM.

The following Db2® authorities must also be granted to each user of OAM functions:

Directory processing requires READ authority for the following tables:
- GROUPnn.OSM_OBJ_DIR (all group directories) nn = 00 … 99 inclusive
- SYSIBM.SYSTABLES
- owner.VOLUME
- OAMADMIN.CBR_COLLECTION_TBL
- OAMADMIN.CBR_MGT_CLASS_TBL
- OAMADMIN.CBR_STO_CLASS_TBL
Restoring objects requires UPDATE authority for the following tables:
- GROUPnn.OSM_OBJ_DIR (all group directories) nn = 00 … 99 inclusive
- OAMADMIN.CBR_COLLECTION_TBL