Skip to main content

Creating a Demo System

Copyright statement

© Copyright Transiom Software, Inc. 2015, 2020. All rights reserved. Unauthorized use or disclosure of any part of the system is prohibited. Transiom Software, Inc. has granted IBM a non-exclusive license to market PEngiGUI as IBM Migration Utility Explorer.

© Copyright IBM® Corporation 2015, 2020. All rights reserved. For legal information, see http://www.ibm.com/legal/copytrade.shtml.
_______________________

Creating Demo Directories on your local system

Creating a Demo System to experiment with is optional but strongly recommended.

To create a Demo System, at the tool bar click:

     File -> New Demo Directories

Follow all dialogs to a successful completion.

After successful completion, the following directories are created on your local system:

   &TSOID.DEMO.DCLGEN     - Reserved for DCLGENs
   &TSOID.DEMO.JCL        - Contains JCL and files for testing
   &TSOID.DEMO.MACROS     - Contains EZT/IMU Plus Macros
   &TSOID.DEMO.PROCS      - Contains RMU Procedures
   &TSOID.DEMO.UTILITY    - Contains Utility Jobs

Tailor your demo system as described in the 'Setup instructions' below.

Setup instructions

    All jobs contain TSO User and System dependent variables.

    Submit with 'Submit Template' button is recommended
        or
    Use editor to tailor user dependent statements to your requirements.

  1. Create Demo Libraries on your own z/OS system.
    • Tailor and submit JGENDEMO.jcl job located in &TSOID.DEMO.JCL.
    • Retrieve the #JesSpool output to verify the job ran successfully.
    • All PDS/PDSE libraries needed on z/OS must be LRECL=80, DSNTYPE=LIBRARY.
    • JGENDEMO.jcl creates the following PDS/PDSE libraries on z/OS:
              &TSOID.DEMO.DCLGEN     - Reserved for DCLGENs
              &TSOID.DEMO.JCL        - Contains files as per list below
              &TSOID.DEMO.MACROS     - Contains EZT/IMU Plus Macros
              &TSOID.DEMO.PROCS      - Contains RMU Procedures(PROCS)
              &TSOID.DEMO.UTILITY    - Contains Utility Jobs
      
  2. Receive a working copy of #EZTPROC and #EZTCOB5 IMU Procedures from z/OS.
    • These procedures must have been tailored so that IMU functions properly.
    • Right click on &TSOID.DEMO.JCL node then select 'Receive from z/OS':
      • Receive your tailored version of #EZTPROC from the IMU (&SYS1.SFSYJCLS) library on z/OS. (Do this to run COBOL V4 and prior versions)
      • Receive your tailored version of #EZTCOB5 from the IMU (&SYS1.SFSYJCLS) library on z/OS (Do this to run COBOL V5 and later versions)
  3. Send local demo directories to the newly created PDS/PDSE libraries on z/OS.
    • Select and send multiple directories at a time. Ctrl -> left Mouse click on each directory node, then right Mouse click -> 'Update z/OS'.
    • or
    • Select one directory at a time. Right click a directory node in the tree and select Send to z/OS. Careful, choose the correct library as created above.
  4. Repeat send for each &TSOID.DEMO.* directory above.
  5. Look at &TSOID.DEMO.JCL for various available jobs.
  6. To start with, double click on file you wish to edit, make changes and click on Submit on the menu bar: (Read comments at the top of each file to learn more about what it does.)
          JCMUXML1
          JCMUXML2
          FZHRMUJ0
          FZHRMUJ1
    

Files in &TSOID.DEMO.JCL directory

	#EZTPROC.jcl  - Example of #EZTPROC (IMU translator procedure)
	#EZTCOB5.jcl  - Example of #EZTCOB5 (IMU translator FOR COBOL 5.n)
	#README0.txt  - Read me file
	#SQLDD.txt    - SQLDD for DB2 runtime SSID and PLANID

	DEMOSHL1.ezx  - Example of IBM Migration Utility Explorer Express 
	EZPARAMS.ccl  - IMU EZPARAMS file (needed to run DEMO Jobs)

	FZH#PROC.jcl  - Example of FZH#PROC (RMU compiler procedure)
	FZHRMUJ0.jcl  - Create RMU report
	FZHRMUJ1.jcl  - Create RUMU report
	FZHRMUJ2.jcl  - create RMU report

	JCMUCJBP.JCL  - Example of in line  Link & Go (run this program as is)

	JCMUCLGP.JCL  - Example of Link & Go when submitting from IMU_explorer

	JCMUCLGQ.JCL  - Example of Link & Go for DB2/SQL (needs DB2 connection)

	JCMUSHL1.JCL  - JCL to run DEMOSHL1.ezx (use it as JCL when submitting)

	JCMUSQLP.JCL  - Example of Link & Go when program is on z/OS PDS

	JCMUSQLX.JCL  - Example of DB2/SQL Link when program is on z/OS PDS

	JCMUXML1.JCL  - Example of IMU XML Reports  (Link & Go)
	JCMUXML2.JCL  - Example of XML Parser (Link & Go, reads JCMUXML1 files) )

	JGENDEMO.jcl  - JOB creates demo libraries on z/OS

	TESTCOL0.EZT  - DB2/SQL DEMO program

Files in &TSOID.DEMO.UTILITY directory

	JSPUFI02.JCL  - Utility to generate DCLGEN for DB2 tables
** END OF DOCUMENT **