Skip to content

Unloading the Software

This chapter lists tasks you perform to unload ChangeMan ZMF components from the ZMF installer and create libraries on the mainframe.

Introduction

Components for ChangeMan ZMF are delivered in compressed binary format in a ZMF installer. This chapter tells you how to unload files from the installer to your workstation or network drive, copy component files to the mainframe, and expand those files into PDS libraries.

In this chapter:

  • v = Version number for ChangeMan ZMF
  • r = Release number
  • p = Patch release number

ChangeMan ZMF Libraries

The libraries installed by the ZMF installer contain all of the components necessary to install and run the ChangeMan ZMF base product and all selectable options.

This table shows the libraries that are unloaded from the ZMF installer and created on the host.

Libraries Library Contents
CMNZMF.VvRrPp.ASMCPY ChangeMan ZMF copybooks for exit programs
CMNZMF.VvRrPp.ASMSRC ChangeMan ZMF source for exit programs
CMNZMF.VvRrPp.CEXECVB ChangeMan ZMF compiled REXX VB
CMNZMF.VvRrPp.CLIST CLIST to connect to ChangeMan ZMF
CMNZMF.VvRrPp.CNTL ChangeMan ZMF JCL
CMNZMF.VvRrPp.DBRMLIB ChangeMan ZMF Db2 Option and ERO DBRM
CMNZMF.VvRrPp.ERR ChangeMan ZMF ERO Release Audit error descriptions
CMNZMF.VvRrPp.JYTHON ChangeMan ZMF-WebSphere integration script (zmfws.jy). Installs to a Unix directory.
CMNZMF.VvRrPp.LOAD ChangeMan ZMF load modules
CMNZMF.VvRrPp.MESSAGES ChangeMan ZMF ISPF messages
CMNZMF.VvRrPp.PANELS ChangeMan ZMF ISPF panels
CMNZMF.VvRrPp.REX ChangeMan ZMF REXX program source
CMNZMF.VvRrPp.SAMPLES ChangeMan ZMF samples
CMNZMF.VvRrPp.SKELS ChangeMan ZMF ISPF skeletons
SERCOMC.VvRrPp.ASMCPY SERNET/Common/SER10TY exit copybooks
SERCOMC.VvRrPp.ASMSRC SERNET/Common/SER10TY exit source
SERCOMC.VvRrPp.CEXEC SERNET/Common/SER10TY compiled REXX modules
SERCOMC.VvRrPp.CLIST SERNET/Common/SER10TY CLIST
SERCOMC.VvRrPp.CNTL SERNET/Common/SER10TY JCL
SERCOMC.VvRrPp.LOAD SERNET/Common/SER10TY load modules
SERCOMC.VvRrPp.PANELS SERNET/Common/SER10TY ISPF panels
SERCOMC.VvRrPp.SKELS SERNET/Common/SER10TY ISPF XML page models
SERCOMC.VvRrPp.XML SER10TY NAMES XML page

Documentation

ChangeMan ZMF documentation is available for download at the Customer Support website. See "Accessing the Documentation" in the ChangeMan ZMF Readme.

Unload Process

The automated and manual steps in the unload procedure perform the following actions:

  • Copy and decompress files from the ZMF installer to a work station or network drive.

  • Build an FTP command file.

  • Build JCL on the work station or network drive for a mainframe job to execute TSO RECEIVE commands.

  • Edit the FTP command file.

  • Execute FTP with the command file to transfer files from the work station or network drive to the host mainframe computer.

  • Edit the RECEIVE job JCL on the mainframe.

  • Submit the RECEIVE job on the mainframe to expand the binary XMIT files into PDS libraries.

Requirements

To execute the unload process you need:

  • TCP/IP FTP connectivity from your work station to the mainframe computer

  • The dotted decimal IP address or domain name of the LPAR on the mainframe

  • A mainframe user ID and password

  • Security authorization to allocate the required files on the mainframe

Step 1: Unload the ChangeMan ZMF Files

Perform this procedure to copy files from the ZMF installer to a work station or network drive, build an FTP command file, and create JCL for a mainframe job to execute TSO RECEIVE commands.

  1. Download ZMFvrpSetup.exe from the SupportLine website to any directory on your workstation. Double-click ZMFvrpSetup.exe.

  2. If this version of ChangeMan ZMF is already installed on this workstation, the ChangeMan ZMF v.r.p Removal dialog is displayed.

    1. Click Remove on this dialog and the next dialog.

    2. Click Finish on the Completed the ChangeMan ZMF v.r.p Setup Wizard dialog.

    3. Restart the unload procedure from step 1.

  3. Read the text in the End-User License Agreement scroll box. If you agree to the terms stated in the End-User License Agreement, check “I accept the terms in the License Agreement" and click Next.

  4. Select the desired installation option.

  5. On the Now Confirming Installation... dialog, click Next to accept the default folder, or click Change Installation Target... to select a different folder, then click OK and Next.

  6. On the Host FTP and Transmission Information dialog, type the following information:

    • Host Name or IP - The dotted decimal IP address or DNS name of the mainframe host

    • Host Logon ID - Your host log-on (TSO) ID

    • Transmitted File HLQ - High level qualifiers for the host data set names of the binary XMIT files transmitted from your workstation

    • PDS Library HLQ - High level qualifiers for the host data set names of the PDS libraries expanded via RECEIVE from the binary XMIT files.

    • HFS Directory - Directory for the Jython script that ZMF uses to deploy Java applications to WebSphere on z/OS. If you do not intend to use the Jython script, you can leave it as the default directory.

    Note

    Follow these rules when setting high level qualifiers:

    • Your mainframe user ID must have authority to allocate files with the HLQ you specify.

    • Do not enter leading or trailing periods.

    • Do not enter parenthesis or quotes (single or double).

    • Do not specify an HLQ longer than 17 characters, including embedded periods.

    • An HLQ entered in this dialog box is not case sensitive, even though it will be embedded in the RECEIVE job that is run on the host.

    Caution

    Do not choose high level qualifiers that will create data set names that already exist on the mainframe. The transmit process and the RECEIVE job will overlay existing data sets.

    Click Next.

  7. On the Ready to install Micro Focus ChangeMan ZMF dialog, click Install.

  8. The Setup Status dialog is displayed as files are decompressed and copied to your desktop or network destination folder, the FTP command file is built, and JCL for the mainframe RECEIVE job is created.

  9. When the unload process is completed, the Completed the Micro Focus ChangeMan ZMF Setup Wizard dialog is displayed. Check the “Open Read Me for ChangeMan ZMF ...", click Finish.

Step 2: Transfer Files to the Mainframe

Your work station must be connected to the network to transfer files to the host

Perform this procedure to transfer ChangeMan ZMF files from your work station or network drive to the mainframe using FTP.

Note

If you want to use 3270 emulator software instead of FTP to transfer the files to the host, go to Appendix A, "Manual File Transfer and Expand".

  1. Go to the folder where you specified that the installation files be installed. Expand the Micro Focus folder to display the ChangeMan ZMF instance that you want to install.

  2. Open the FTP.Input text file. This file contains the FTP commands that are used to transfer the ChangeMan ZMF XMIT format files to the mainframe.

  3. Overtype <PASSWORD> in the third line of the file with your mainframe password, making sure that the case matches what z/OS expects.

  4. If you do not intend to use the Jython script to deploy Java applications to WebSphere on z/OS, you can delete the put command for the JYTHON file at the bottom.

  5. Save the file under the same name.

  6. Initiate the FTP transfer by double-clicking the FTP.bat file.

    When the transfer starts, a command prompt window opens and shows:

    FTP process has begun.
    

    When the transfer is completed, the command prompt window shows:

    FTP process has completed.
    FTP Execution Log: ...
    Press any key to continue . . .
    
  7. View the FTP.log file to verify that the files were transferred to the mainframe host.

    If you see the following errors in the FTP Log, make the recommended corrections to the FTP.Input file, then restart the process at #4 above.

    Message Corrective Action
    Unknown host... Edit the FTP.Input file and verify the IP address or domain name of your mainframe host.
    530 PASS command failed Edit the FTP.Input file and verify that you entered the correct user ID and password.
    Block size specified for the host [binary] data set is invalid for the record length Record length... invalid. Edit the FTP.Input file:

    a. Delete these four command lines: literal site cylinders
    literal site blocksi=3120
    literal site lr=80
    literal site recfm=fb
    b. Replace the deleted lines with this command (on a single line): literal site recfm=fb lr=80 blocksi=3120 cylinders
    Not connected The FTP connection was lost so files were not transferred. Reconnect and restart the FTP process.
  8. Remove your mainframe log-on password from the FTP.Input command file:

    1. Overtype your password in the third line with <PASSWORD>.

    2. Save the file under the same name.

Note

If you have difficulty with this automated FTP process, you can transfer ChangeMan ZMF files manually from your work station to the mainframe and expand the files into PDS libraries with the manual procedure in Appendix A, "Manual File Transfer and Expand".

Step 3: Expand PDS Libraries with RECEIVE

The Setup Wizard process creates a batch mainframe job to execute the RECEIVE command on binary XMIT files transferred to the host. The RECEIVE job is transferred to the mainframe along with the binary XMIT files.

Perform this procedure to submit the RECEIVE job on the mainframe to expand the ChangeMan ZMF component files into PDS libraries.

  1. Log on to the mainframe host.

  2. Edit the file named node.RECEIVE.ZMFvrm.JCL, where node is the Transmitted File HLQ you entered in the Setup Wizard.

  3. Replace the four //JOBCARD lines at the top of the file with your JOB statements.

  4. Make global changes to the DATASET parameter of the RECEIVE commands to change the low-level nodes in the library data set names to match your local requirements. Retain the last node name. For example:

    Original
    
    //SYSTSIN DD     * 
      RECEIVE INDATASET('hlq1.CMNZMF.V8R2P01.ASMCPY') 
      DATASET('hlq2.**CMNZMF.V8R2P01**.ASMCPY')
    
    After change
    
    //SYSTSIN DD     * 
      RECEIVE INDATASET('hlq1.CMNZMF.V8R2P01.ASMCPY') 
      DATASET('hlq2.CMN82P1.ASMCPY')
    
  5. If you did not transfer the JYTHON file from your workstation to the mainframe because you do not intend to use the Jython script, delete job step JYTHON.

  6. Submit the job.

  7. Examine each of the output PDS libraries created with the host high level qualifier to ensure that they are PDS libraries.

    Note

    The RECEIVE job can give a Return Code 00, and the job SYSOUT can show the message “Restore successful to data set...”, even when the RECEIVE process did not complete successfully.

  8. Save the RECEIVE job JCL.