Download and Install IOF/CICS Release 8G

IOFTech    Maintenance   Release8G       Newsletters    Doc    FAQ    Contact    Home

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


Re-installing IOF Release 8G

A new spin level of IOF 8G can be installed by executing the new MPI file and specifying a new IOF level.  The default initial IOF level is level 0.  We suggest using level 1 or the next higher level when re-installing a new MPI.

Allocate the Mainframe MPI file

If IOF is currently running on your system, then the old MPI file may already be allocated. You can download and re-use the old 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 "IOFC8G0". The bottom level should be "MPI".

All of the new distribution libraries loaded from the MPI file will use the same media placement values as the new MPI file allocated below (volume serial, SMS values, etc.).   A blank volser requests allocation on any available volume mounted with the USE=STORAGE attribute. 

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

                            Allocate New Data Set
Command ===>

Data Set Name  . . . : SYSIOF.IOFC8G0.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  . . 3700           (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.    Both username and password are case sensitive, and must be entered exactly as supplied.

//INPUT DD *            <<<< note that site name and         <<<< userid have changed
password   (from the order email)
get iofc8g0.mpi 'SYSIOF.IOFC8G0.MPI' (R    

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

  password:  (provided from the order email)
      type:  binary
  filename:  iofc8g0.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 .

The username is:       iofc8g

The  password is  provided by email in response to your 8G 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.iofc8g0.mpi'

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.  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.

New Functions added to IOF 8G

Release 8G has several new functions. These are described in the October 2017 Newsletter.   As new functions are added and new releases supported, this Newsletter will be updated to reflect current status.

Fischer International Systems Corporation
For IOF support, please contact us below: