Downloading and Installing the Control-M Conversion Tools

Before You Begin

Ensure that Control-M for z/OS is installed before proceeding with this installation.

Begin

  1. Prepare your system.

    Do one of the following actions:

    Transfer the image file to the mainframe as a binary file. For more information about the space requirements, see the Release Notes that accompany the Control-M Conversion tools. The DCB information for the image file is as follows:

    Copy
    RECFM = FB, LRECL=1024,BLKSIZE=6144
  2. Uncompress the image file.

    The image file is compressed using the IBM TRSMAIN (alias of AMATERSE) program.

    Once the image file has been uploaded to your mainframe, make the necessary changes in the following UNTERSE job to uncompress the image file.

    ppp,ss,dd represents the space requirements for the UNTERSE file. For more information, refer to the Release Notes that accompany the Control-M Conversion tools.

    Copy
    **************************** Top of Data ******************************
    //UNTERSE JOB                   <=== tailor job card to local standards
    //*                                                                   
    //UNTERSES  EXEC PGM=TRSMAIN,PARM=UNPACK                              
    //SYSPRINT DD   SYSOUT=*                                              
    //INFILE   DD DISP=SHR,DSN=uploaded.image.file.from.step1    <===UPDATE
    //OUTFILE  DD   DISP=(NEW,CATLG,DELETE),                              
    //       UNIT=disk_unit,VOL=SER=disk_volser,                 <===UPDATE
    //       DSN=basepref.CONVLIB,                               <===UPDATE
    //       SPACE=(CYL,(ppp,ss,dd))                             <===UPDATE
    *************************** Bottom of Data ****************************

    In the preceding UNTERSE job, basepref represents your choice of prefix for the base libraries, which are described in the Installation and Customization Engine (ICE) chapter in the INCONTROL for z/OS Installation Guide. This parameter must be specified again later in the installation process.

    Submit the above job and review the output of the job. Ensure that the return code is 0.

  3. Install the Conversion tools.

    To install the Conversion tools, do the following:

    1. Select Customization from the ICE main menu.

    2. Specify product CTM.

    3. Select step 8 (Conversion installation).

    4. Select minor step 1 (Conversion installation).

    5. Submit the job.

      This job consists of 5 steps:

      • ADDDEF

        This step adds SMP/E DDDEFs for the conversion target and distribution libraries.

      • ALLOCT

        This step allocates the conversion libraries.

        The target conversion library name is ilprefa.CONV.

        The distribution conversion library name is spdpref.ACONV.

      • RCVAPLC

        This step performs the RECEIVE and APPLY CHECK operations for the conversion FMID and PTFs. The FMID and PTFs are located in the CONVINST member in the basepref.CONVLIB library.

      • APLACC

        This step performs the APPLY and ACCEPT CHECK operations for the conversion FMID and PTFs.

      • ACCEPT

        This step performs the ACCEPT operation for the conversion FMID and PTFs.

  4. Find any relevant updates.

    Look for Solution SLN000000197255 (List of APARs required for conversion to Control-M) in the Knowledge Base on the BMC Customer Support Site for the latest fixes and instructions.