Updated 29 July, 2012
IOF Maintenance Dialog
IntroductionIOF Release 7F introduced a new, improved maintenance dialog. Maintenance for all releases after 7F is packaged as a cumulative fix file that can be downloaded from this web page. The maintenance dialog allows you to receive the cumulative maintenance file and apply individual fixes. It manages IOF maintenance so that it is easy to determine the status of all fixes.
The maintenance dialog was improved, and it's appearance changed in release 7J. Depending on the version of IOF you are running, some of the panels may be slightly different from the panels shown.
All IOF maintenance, including superzaps, is now applied and managed by the maintenance dialog.
Cumulative Maintenance FileIndividual IOF fixes are packaged into a cumulative maintenance file (iof7Jfix.cfx). This file is in terse format, so it is quite small. IOF/TSO and IOF/CICS fixes are packaged together in a common cfx file. Most fixes are universal fixes that apply to both IOF/TSO and IOF/CICS. The receive process copies only the fixes that are applicable to the product being updated (IOF/TSO or IOF/CICS).
Instructions for downloading the cumulative fix file are given
below. First you should allocate a cumulative
maintenance data set on OS/390 as shown on the ISPF 3.2 menu
below. The "prefix" should be the same top level that is
used for the IOF distribution data sets.
You can download the cumulative fix file using the FTP command, or you can download using your web browser. Note that the download logon has changed. The tags and file names shown below are case sensitive, and must be entered exactly as shown. To download via FTP:
URL: ftp.triangle-systems.com User: firstname.lastname@example.org <<<< note that the user and password Password: IOF <<<< have changed Directory: download <<<< You don't need to change the directory Format: binary File: iof8ffix.cfx (8F) iof8efix.cfx (8E) iof8dfix.cfx (8D) iof8cfix.cfx (8C) iof8bfix.cfx (8B) iof8afix.cfx (8A)
After downloading to the PC, file transfer the cfx file to the OS/390 data set. Be sure to specify BINARY format when doing the file transfer from the PC to the OS/390 system.
We recommend that you download a new copy of the cumulative maintenance occasionally. The fixes contained in the file are cumulative, so the file will grow larger over time. Downloading and receiving a newer cumulative file will not affect the status of any older fixes that have already been applied.
Updates Data SetThe IOF UPDATES partitioned data set was created by the IOF installation. Fixes must reside in the UPDATES data set in order to be applied to IOF. Fixes can be added to UPDATES by the maintenance dialog receive function, or manually by using the ISPF editor.
The maintenance dialog receives fixes from the cumulative maintenance
file into the UPDATES data set. You may also receive special or optional
fixes by email or fax. Use the ISPF editor to add these fixes to the UPDATES
dataset as directed by the email or fax cover letter.
Invoking the Maintenance DialogThe maintenance dialog can be invoked from IOF/TSO by entering the "MAINT" command from the IOF Option Menu.
The IOF/TSO maintenance dialog can also be invoked from ISPF Option
6 if IOF has not yet been generated or will not run. Specify
the fully qualified data set name of the IOF/TSO INSTALL data set
with member name "VFIX", enclosed in single quotes.
The maintenance dialog must be invoked for IOF/CICS from ISPF Option 6. Specify the IOF/CICS INSTALL data set name.
Both the "MAINT" command, and ISPF Option 6 will cause the IOF
Product Maintenance Dialog panel to be displayed.
Verify the product UPDATES library name on this panel. Correct
the DSNAME if you use non-standard IOF data set names. Then press
ENTER to display the IOF Product Maintenance Dialog Option Menu
. The dialog menu for release J is shown below. This menu has a
different style in earlier releases of IOF.
Maintenance Dialog FunctionsSelect "2" to receive new fixes from the cumulative file into the UPDATES data set.
Specify the data set name of the cumulative fixes data set you previously downloaded from this web page. The receive process will expand the cumulative fixes data set and copy applicable members to the UPDATES data set. Fixes that have previously been applied will not be overlaid.
Select "1" to display the UPDATES Dataset Member
List, which shows the status of all fixes in the UPDATES data
set. Specific fixes can be browsed or selected to be applied from this
panel. For releases prior to release 7J, use option "A".
The panel above shows five IOF 8B fixes. Fixes that have been received but not applied are sorted first, followed by applied fixes. The first three fixes above were received on November 11, 2006 by user SPGMR05. The last thirteen fixes show a user of "IOFSPIN" which means that they were applied to the base product when you installed it.
One or more fixes can be selected to be applied from this menu. "RC 0" will be displayed in the comments field for each fix that applies correctly. If an error is encountered in applying a fix, a popup window will be displayed and the bad return code will be displayed in the comments field.
Notice that optional fixes are not displayed. To display optional fixes, enter the "OPT" command. Enter "OPT" again to re-display normal fixes.
Select "I" to display an index of all of the fixes in the UPDATES dataset. The index is a quick way to read the descriptions of all received and applied fixes.
A maintenance log is created for each IOF Maintenence Dialog session. Select "L" to display a browse entry panel for maintenance logs. Detailed maintenance history is kept in the log.
After applying maintenance to IOF data sets, one or more IOF generation jobs may need to be run in order to apply the maintenance to the running IOF system. If so, a window will be displayed when you exit the maintenance dialog showing the required generation jobs and specific run order. A copy of this information is also added to the maintenance session log.
SummaryThe IOF Maintenance Dialog completely manages IOF maintenance for an IOF site. It receives and applies IOF maintenance and keeps track of the status of specific fixes.
The IOF distribution MPI files occasionally will be refreshed by applying maintenance to the IOF distribution data sets. This process is called a new SPIN level. All fixes applied to a SPIN level will be included in the distributed UPDATES dataset and flagged as applied. A userid of IOFSPIN indicates that a fix was applied as part of the MPI spin level build process.
We recommend that you occasionally download the cumulative maintenance file, receive the fixes, and apply any new fixes.
Triangle Systems, Inc. PO Box 12752, Research Triangle
Park, NC 27709
[an error occurred while processing this directive]