Download and Install IOF/CICS Release 8C

IOFTech    Maintenance   Release8C       Newsletters    Doc    FAQ    Q&A    Contacts    Home    Webmaster

 

This process requires a download password.  Click here if you have not already obtained your download password.

The IOF distribution package is a single, sequential Mainframe Product Install file (MPI) which is exploded by the install process into the IOF product libraries.  Here’s an outline of the process:

  • Pre-allocate the Mainframe Product Install file (MPI) on your z/OS system.
  • Load the sequential MPI file from our web site to the z/OS MPI file
  • Execute the MPI file as a Rexx exec to extract the product libraries
  • Follow the customized “to do” list to complete the install

 

Allocate the Mainframe MPI file

Allocate the MPI file on your OS/390 or z/OS system. Any dataset name can be used, but we recommend that you use a three level dataset name. The DSNAME prefix (top level) should be the same prefix that will be used for the IOF/CICS distribution datasets. The second level should be "IOFC8C0". The bottom level should be "MPI".

Use ISPF Option 3.2 to allocate the MPI dataset. The example below allocates the IOF/CICS dataset for release 8C using a prefix of "SYSIOF". 


                            Allocate New Data Set
Command ===>

Data Set Name  . . . : SYSIOF.IOFC8C0.MPI

Management class . . .                (Blank for default management class)
Storage class  . . . .                (Blank for default storage class)
 Volume serial . . . .                (Blank for system default volume) **
 Device type . . . . .                (Generic unit or device address) **
Data class . . . . . .                (Blank for default data class)
 Space units . . . . . KB             (BLKS, TRKS, CYLS, KB, MB, BYTES
                                       or RECORDS)
 Average record unit                  (M, K, or U)
 Primary quantity  . . 3500           (In above units)
 Secondary quantity    500            (In above units)
 Directory blocks  . . 0              (Zero for sequential data set) *
 Record format . . . . FB
 Record length . . . . 80
 Block size  . . . . . 0
 Data set name type  :                (LIBRARY, HFS, PDS, or blank)  *
                                      (YY/MM/DD, YYYY/MM/DD
 Expiration date . . .                 YY.DDD, YYYY.DDD in Julian form
Enter "/" to select option             DDDD for retention period in days
   Allocate Multiple Volumes           or blank)

Download the MPI File

The MPI file can be FTP-ed directly into the pre-allocated MPI mainframe file if you have mainframe FTP capability. You can alternately download the MPI file to a PC and upload from the PC to the mainframe. Whatever upload method you use, the transfer type must be BINARY.

The JCL below downloads the MPI file using the MVS batch FTP command.  The username is IOFC8C.  The password will be supplied in response to your 8C order.  Both username and password are case sensitive, and must be entered exactly as supplied.

//DNIOFMPI JOB 1,WALKER
//FTP EXEC PGM=FTP
//INPUT DD *
ftp.business.earthlink.net
IOFC8C%triangle-systems.com
password   (from the order email)
binary
get iofc8c0.mpi 'SYSIOF.IOFC8C0.MPI' (R    
quit
/*

Interactive FTP commands are shown below. .  The password will be provided in response to your 8C order.  Both username and password are case sensitive, and must be entered exactly as supplied.

    server:  ftp.business.earthlink.net
    userid:  IOFC8C%triangle-systems.com
  password:  (provided from the order email)
      type:  binary
  filename:  iofc8c0.mpi

If you prefer, you can download the MPI file to your PC using your browser and then upload it from your PC to the mainframe.  Be sure to specify binary format when uploading to the mainframe. 

  Click here to download the IOF/CICS MPI File using your web browser .

Specify IOFC8C when prompted for a username.  The  password is  provided by email in response to your 8C order. Both username and password are case sensitive, and must be entered exactly as supplied.

After entering the correct username and password, click on the browser's "SAVE..." option to download the MPI file.

  Click here for more information if you have FTP or download errors.

Run the Install Dialog

From ISPF Option 6, execute the MPI file to run the install dialog. You must specify the fully qualified DSNAME enclosed in single quotes. 


                               ISPF Command Shell
 Enter TSO or Workstation commands below:

 ===> ex 'sysiof.iofc8c0.mpi'

Note:  IOF data sets are stored in the MPI file in terse format.  The IBM GIMUNPCK program is used to expand the tersed data sets.  Recent IBM PTFs cause GIMUNPCK to terminate with return code 8.  If you experience this problem please consult IOF Virtual Help Desk problem number A06.

The dialog is self documenting. It prompts you for a few required parameters. It extracts the IOF distribution datasets and saves them in MVS datasets you control. When installing from a previous version of IOF, it copies your old IOF options to the new options dataset. Less than five minutes is normally needed to run the MPI dialog.

The dialog builds a TO DO list in member $$TODO of the new INSTALL dataset. This list describes all the tasks required to complete installation of the new release. It references the IOF Installation Guide for additional information.  $$TODO is only a page or two long and is specifically tailored to your site.  Allowances are made for your previous release of IOF and for many of the options you specified.

Generate and Test the New Release

Follow the instructions in the $$TODO member of the new INSTALL dataset to complete generating the new release. It is a good idea to print $$TODO and use a highlighter to check off each paragraph when it has been successfully done. 

Release 8C has several new functions as described in the March 2007 Newsletter.  The new options will not appear on the IOF Option Menu unless users are authorized to them.  $$TODO provides information about how to authorize the new functions.  Virtual Help Desk problem number PC09 provides specific information about how to cause IOF options to be shown on the IOF Option Menu.

The new release can be tested in parallel with an existing version of IOF. The same SVC or ESR can be used. The $$TODO member describes testing techniques.

Triangle Systems, Inc. PO Box 12752, Research Triangle Park, NC 27709
Email IOFTech@Triangle-Systems.Com

774