PDF documentation
Summary of changes
About this document
These topics provide information needed to plan for, customize, maintain, and diagnose problems with HCL Z Data Tools.
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
    - Z Data Tools supported software environments
    - 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
      - Using a licensed site PL/I compiler
    - 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 various interfaces such as Eclipse and Microsoft Visual Studio Code IDEs.
Z Data Tools on Eclipse
Z Data Tools plug-in for Eclipse, when used with an Eclipse-based platform such as IBM® Explorer for z/OS® or IBM Developer for z/OS, provides easy access through a graphical user interface (GUI) on the workstation to HCL Z Data Tools.
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

Customizing for processing PL/I include books

Z Data Tools provides a choice of two internal PL/I compilers that are used in any addition to external PL/I compiler previously installed.

The Z Data Tools internal PL/I compiler to be used is selected with the ALTPLI option. See ALTPLI.

The SHOWPLI command can be used to display the PL/I compiler being used.

Z Data Tools uses its internal PL/I compilers instead of the licensed site compiler. Use the ALTPLI option to select the version of the internal compiler. For more information, see the Available COBOL compilers for details.

For information about using a licensed site PL/I compiler, see Using a licensed site COBOL compiler. For information about using the Z Data Tools internal PL/I compiler, see Using the Z Data Tools COBOL compiler.

If you want to use Z Data Tools view, edit, copy, print, or data create functions with a PL/I include book, you must use the Language Environment® runtime library.

To ensure that you use the correct Language Environment® runtime, either add the Language Environment® runtime library, SCEERUN, to your LINKLIST, or add it to the STEPLIB DD statement in your TSO logon procedure.

Table 1. PL/I compiler order of precedence
	Option	Version	PL/I Module	Notes
HFMPL/I	DD DUMMY	Internal	HFM provided	Allocated in JCL or TSO command
HFMPL/I	DSN=library	External	HCLPL/I	Allocated in JCL or TSO command
RACROUTE	ATUS=ACCESS FACILITY Class PROFILE FILEM.PLI.EXTERN AL CONTROL access or higher	External	HCLPL/I	Force Z Data Tools to use an external PL/I compiler
If none of the above		Internal		Default. See ALTPLI.

SHOWPLI command

The SHOWPLI command displays the level of the internal PL/I compiler or if the usage of external PL/I compiler is in effect.

In batch, submit a Z Data Tools batch job with the following control statement:

$$FILEM SHOWPLI

If a licensed PL/I compiler is available, the output includes the following message: HFMNB920I The Customer Licensed PL/I Compiler will be used.

If the Z Data Tools supplied PL/I compiler is used, the output includes the following message: HFMNB925I The File Manager supplied PL/I Compiler will be used.

Under ISPF, enter SHOWPLI on any Z Data Tools command line alternatively the following messages, according to the PL/I complier in use.

Using ZDT PL/I V61
The Z Data Tools supplied Vxx PL/I Compiler will be used

Or

HFMPLI is allocated
The licensed PL/I Compiler in library dataset name allocated via HFMPLI will be used.