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.

You might need to refer to the Z Data Tools User’s Guide and Reference for IMS Data.

  1. Edit and submit the batch installation verification program (IVP) job, HFMVERIF, as described in the Z Data Tools Program Directory.

    Check the results to ensure the job ran successfully.

  2. Log on to a TSO user ID that is enabled to access and use Z Data Tools.
  3. Start Z Data Tools:
    • If you have added an option for Z Data Tools to your ISPF Primary Options menu (see Adding Z Data Tools to the ISPF menu), type the option value you have assigned to Z Data Tools and press Enter. For example, if you have assigned Z to Z Data Tools, type Z and press Enter.
    • If you defined Z Data Tools to the ISPF command table (see Defining Z Data Tools in an ISPF command table), verify that Z Data Tools can be started by entering the command HFM on any ISPF command line.

    The Z Data Tools Primary Option Menu is displayed.

    Note: The first time you use Z Data Tools, a Copyright panel appears. After reading the panel text, press the Cancel key (PF12). In subsequent Z Data Tools sessions, this panel will not automatically appear.
  4. Enter VER on the command line to display the release level and PTF level of Z Data Tools. A panel is displayed similar to this: 
    HCL Z Data Tools Version 1 Release 1 Modification 0

(not APF authorized)

Service Levels of installed components

             Base       IMS        Db2        CICS
English      -NONE-     -NONE-     -NONE-     -NONE-
    Note:
    1. This will always show Z Data Tools as not APF authorized, even if you have made Z Data Tools APF-authorized, as Z Data Tools cannot run APF-authorized under ISPF.
    2. When you first install Z Data Tools, -NONE- will be shown under each component that you have installed. Subsequently, when you have applied service to Z Data Tools, a PTF number will be shown, indicating the PTF level of each component you have installed. If you have not installed a component, that component will not be shown at all.
  5. Press the Exit key (PF3) to end the Z Data Tools session and return to your ISPF menu.
Several other sample batch jobs are distributed in HFM.SHFMSAM1 to help you verify the installation of Z Data Tools and demonstrate its functions. They are:
Sample job
Function
HFMSAMC1
Copy all records from one file to another, modifying a record in the process.
HFMSAMF1
Find JCL exec statements that run a particular program.
HFMSAMF2
Find JCL EXEC statements that run a particular program, and rename the program in each member in place.
HFMSAMP1
Print the JCL members that execute a particular program.
HFMSAMP2
Print selected records and drop all other records, formatting the output from a template.
HFMSAMRS
Perform a simple record selection, and copy the selected records to a file.
HFMSAMSP
Split selected records to two output files.
HFMSAMU1
Make selective updates in a member of a data set, in place, using function DSEB and REXX.
HFMSAMU2
Make selective updates in a member of a data set, in place, using function DSU and FASTREXX.

You will have to make changes to these jobs before you can run them. See the sample jobs for information about the changes you need to make.

You can now complete the installation of Z Data Tools by performing the ACCEPT processing. The steps involved are described in the Z Data Tools Program Directory.