 |
Enhanced HOLDDATA for z/OS and OS/390
Enhanced HOLDDATA for z/OS and OS/390 replaces the HOLDDATA previously delivered on ESOs,
Corrective Service orders and PDOs.
Note: z/OS Release 10 and SMP/E Release 3.5 introduce FIXCAT HOLDDATA to
simplify identifying required service from PSP buckets. The new FIXCAT statements are available
only in the full.txt and full.bin files. SMP/E releases prior to SMP/E V3.5 cannot process the new
FIXCAT HOLDDATA. If you use a prior SMP/E release, you must install toleration APAR IO07480
(PTF UO00700 for SMP/E V3.3 or UO00701 for V3.4) to allow those releases to silently ignore the
FIXCAT HOLDDATA. Otherwise messages GIM20311E and GIM56701E will result.
Check the
SMP/E Reference
to learn more about FIXCAT HOLDDATA.
Enhanced HOLDDATA for z/OS, OS/390 and MVS is a single source of ERROR HOLDDATA,
and provides several advantages over previous sources of ERROR HOLDDATA to
simplify identification and management of critical service (PEs and HIPERs).
- Enhanced HOLDDATA includes ++HOLDs for ERROR not only for PE APARs, but
for HIPER (High Impact) APARs. This
allows customers to use the SMP/E REPORT ERRSYSMODS to identify not only
missing PE fixes but missing HIPER fixes, and the report is
specific to the target system. The additional ++HOLDs for HIPERs
requires a procedure change for the installation of
FMIDs.
- Enhanced HOLDDATA includes the fixing PTF number in the comment field when
the PTF is available for either corrective service (COR closed) or
preventive service (PER closed). The two date fields in the ++HOLD statement
represent the date that the ++HOLD was updated, and not necessarily the
original date of the APAR flag.
- Any reason flags for HIPER APARs are included in the comment field (IPL,
data loss, major function loss, performance and pervasive). This can aid
prioritizing the review of any uninstalled HIPER fixes. The reason flag for
Year 2000 is YR2000.
The reason flags are listed below.
- The updated SMP/E REPORT ERRSYSMODS on OS/390 1.3 and higher provides a
summary report of missing critical service, and will identify whether any
fixing PTFs are in RECEIVE status (available for installation) and if the
chain of PTFs to fix the error has any outstanding PEs. However, even earlier
level systems can use Enhanced HOLDDATA to better manage PEs and HIPERs.
SMP/E REPORT ERRSYSMODS support for Enhanced HOLDDATA was introduced via
APAR IR35282 for OS/390 V1R3 and V2R4, and it is integrated into OS/390
V2R5.
- Enhanced HOLDDATA is delivered with all ESO's, Corrective Service orders
and PDOs. Physical media delivers 2 years of data and electronic delivers 90
days of data.
- The entire z/OS, OS/390 and MVS platform is covered with a single set of
holddata which is cumulative and complete. There is no need to collect and
compile holddata from multiple sources for different systems at differing
times. Enhanced HOLDDATA serves as a single source of holddata for any
system. SMP/E ignores holddata for FMIDs not on the system (unless specified
otherwise on the RECEIVE command), so Enhanced HOLDDATA can serve any
system. Installations with many programmers receiving Enhanced HOLDDATA may
need to use caution to ensure that only the latest Enhanced HOLDDATA is
received. One way to ensure that latest Enhanced HOLDDATA is used is to get
electronic updates via the Internet (see next item).
- Daily updates to Enhanced HOLDDATA are available,
so customers can keep holddata as current as needed. Up to 3 years of
history is available. Customers using Enhanced HOLDDATA need only ensure
that the time period of the latest Enhanced HOLDDATA to be received overlaps
any previously received holddata. With the use of FTP from
the Host and job scheduling, retrieving updated data and generation of
reports can be automated.
Table of Contents
Download the file that will overlap the time from your last update of
Enhanced HOLDDATA. Receiving the same HOLDDATA again causes no problems, but
missing HOLDDATA may result in installation of a known PE and thus impact system
availability. Always select a time period long enough to overlap your last
update (i.e. if you are unsure whether to pick the month or quarter file, pick
the quarter file).
To identify your last update of Enhanced HOLDDATA, check the
production date of your last service deliverable that included Enhanced HOLDDATA,
the date of your last electronic Enhanced HOLDDATA update, the comments in the
header of your last Enhanced HOLDDATA file, or list your already-received
HOLDDATA.
To use the data, use the SMP/E RECEIVE command to receive Enhanced HOLDDATA
into your global CSI.
All files are updated daily.
To download the plain text files with a web browser:
- Click on the name in the Download Now column, the data will be downloaded
to your workstation. Most browsers will use a chached copy of previsouly
displayed pages, so you may need to use the reload/refresh button of the browser
to retrieve the latest copy from the server.
- Use "file/save-as" to save the data to the specified file on the
workstation. (This command will vary depending upon the web browser you are
using).
- Upload to the z/OS or OS/390 Host system using any file transfer facility, note
that the resultant dataset on the Host must be FB80. See note
below.
To download the Packed data files with a web
browser:
- Click on the name in the Download Now column, the data will be downloaded
to your workstation. Most browsers will use a chached copy of previsouly
displayed pages, so you may need to use the reload/refresh button of the browser
to retrieve the latest copy from the server.
- Use "file/save-as" to save the data to the specified file on the
workstation. (This command will vary depending upon the web browser you are
using).
- Upload to the z/OS or OS/390 Host system as binary data using any file transfer
facility. Note that the resultant dataset on the Host must be RECFM=FB LRECL=1024.
- Use TRSMAIN
to unpack the packed file into a dataset. Click
here for information on how to install and use TRSMAIN.
| Name |
Time Span |
Plain Text |
Packed Data |
FIXCATs
Included |
| Size |
Download
NOW |
Size |
Download
NOW |
| Month |
Last 30 days |
~ 100 Kb |
Month |
~ 24 Kb |
Month.bin |
No |
| Quarter |
Last 90 days |
~ 300 Kb |
Quarter |
~ 47 Kb |
Quarter.bin |
No |
| Year |
Last 365 days |
~1200 Kb |
Year |
~ 200 Kb |
Year.bin |
No |
| Full |
Last 730 days |
~2250 Kb |
Full |
~ 400 Kb |
Full.bin |
YES |
| YRS3 |
Last 3 years |
n/a * |
n/a * |
~600 Kb |
YRS3.bin |
No |
* The 3 year file is only available in compressed (TRSMAIN) format.
Note: SMP/E requires the dataset containing HOLDDATA to be
recfm=FB and lrecl=80. FTP and emulator program uploads will usually default to
a dataset with a format of VB. Pre-allocate the dataset prior to running Batch
FTP or uploading to the OS/390 host or specify parameters that will create a
FB-80 dataset.
Table of Contents
FTP may be used to download Enhanced HOLDDATA. Request and receipt of
Enhanced HOLDDATA can be automated if FTP capability is in place on the z/OS
host system.
FTP anonymously to "service.boulder.ibm.com". Change directories to
"/s390/holddata". Get the appropriate file: "month.txt",
"quarter.txt", "year.txt", or "full.txt".
Note: SMP/E requires the dataset containing HOLDDATA to be recfm=FB and lrecl=80.
FTP will default to a dataset with a format of VB. Pre-allocate the dataset
prior to running Batch FTP or specify parameters that will result in a FB-80
dataset.
Link to
Sample Batch FTP Job.
Table of Contents
Enhanced HOLDDATA is processed the same way previously-provided HOLDDATA was
processed. Use SMP/E's RECEIVE HOLDDATA command to receive Enhanced HOLDDATA
into the Global zone.
Enhanced HOLDDATA introduces ERROR holds against product FMIDs for HIPER
APARs. This enables customers to easily check that all PE and HIPER
recommended service in the product PSP bucket is installed when the FMID is
being APPLYed.
Furthermore, it enables SMP/E's REPORT ERRSYSMODS to be used to identify any
HIPER fixes that are identified later.
Therefore you need to change the parameters specified on the APPLY command
when installing FMIDs unless you are a ServerPac customer. ServerPac
delivers a system with the FMIDs already installed.
There are two methods to complete an FMID installation:
- To ensure that all critical service is installed with the FMID, add
the SOURCEIDs of PRP, HIPER to the APPLY command. There may be
some HIPER APARs that do not have resolving PTFs available yet. You need to
analyze the symptom flags to determine if you want to BYPASS the specific
ERROR HOLDs and continue the FMID installation.
APPLY S(fmid,fmid,...)
FORFMID(fmid,fmid,...)
SOURCEID(PRP,HIPER,...)
GROUPEXTEND .
This method requires more initial research, but will provide resolution
for all HIPERs that have fixes available and are not in a PE chain.
- To install the FMID as it would have been installed prior to Enhanced
HOLDDATA, you can add a BYPASS(HOLDCLASS(HIPER)) operand to the APPLY
command. This will allow the FMID to be installed even though there are HIPER
ERROR HOLDs against it. Note that not all ERROR HOLDs were bypassed,
only the HIPER ERROR HOLDs. After the FMID(s) are installed, the
SMP/E REPORT ERRSYSMODS command should be run to identify an missing HIPER
maintenance.
APPLY S(fmid,fmid,...)
BYPASS(HOLDCLASS(HIPER))
...any other parameters documented in the program directory...
This method is the quicker of the two, but requires subsequent work to
investigate any HIPERs.
One other procedural point about Enhanced HOLDDATA. Since it is likely (and
advantageous) to receive updates to Enhanced HOLDDATA between the APPLY and
ACCEPT steps for a system, it is possible to encounter ++HOLDs on the ACCEPT
that were not identified at the time of the APPLY. Reviewing the REPORT
ERRSYSMODS before the ACCEPT will identify any outstanding PEs or HIPERs on the
target system.
Table of Contents
Below are the currently delivered flags and their meanings.
| Flag |
Keyword |
Description |
| DAL |
DATALOSS |
Destruction and/or contamination of customer data. |
| FUL |
FUNCTIONLOSS |
Causes a major loss of function on the customer's system. |
| IPL |
SYSTEMOUTAGE |
Causes the customer to re-IPL, reboot, recycle or restart one or more
systems or subsystems. |
| PRF |
PERFORMANCE |
Causes severe impact to system performance/throughput. |
| PRV |
PERVASIVE |
Problem may affect many customers. |
| YR2000 |
Year 2000 |
Identifies APARs that provide Year 2000 function, or fix a Year
2000-related problem. |
| SYSPLXDS |
SYSPLEXDS |
Identifies HIPER fixes needed to support and implement SYSPLEX Data
Sharing. |
| XSYS |
XSYSTEM |
Identifies HIPER fixes which provide cross-system, migration,
compatability or toleration support. |
| D/Tnnnn |
D/Tnnnn |
Identifies HIPER fixes which pertain to the Hardware device number nnnn.
|
| CST |
CST |
Indicates a fix that has been installed in CST outside the normal schedule for
installing maintenance in CST (i.e. to fix a problem in CST or to add new function such as hardware).
|
| DST2007 |
DST2007 |
Identifies HIPER fixes which support a provision of the
Energy Policy Act of 2005, extending Daylight Saving Time (DST) by four weeks, beginning in 2007.
|
| EURO99 |
EURO99 |
Identifies HIPER fixes which support the EURO currency
symbol introduced in 1999.
|
Table of Contents
Suspected errors in Enhanced HOLDDATA can be reported to the IBM Support
Center (Level 1).
Suspected errors and comments can also be directed via feedback:
Provide
Feedback on OS/390 Enhanced HOLDDATA.
In the event that you have ++HOLDs in your global zone which contain an incorrect APAR prefix, use
feedback
to report the problem.
For example, the correct ++HOLD for APAR OW12345 should be AW12345,
but the ++HOLD contains OW12345. This will result in the ++HOLD
statement never being satisfied when the fixing PTF is installed, because the
PTF will supersede AW12345 and the ++HOLD was for OW12345.
If the incorrect prefix was introduced by
Enhanced HOLDDATA, the appropriate ++RELEASE and ++HOLD statements will be included
in a subsequent update to Enhanced HOLDDATA. In addition,
there is a sample REXX utility available that will create appropriate ++RELEASE and
++HOLD statements based on output from your system. The REXX utility was written for the specific format
of ++HOLDs created by Ehnanced HOLDDATA, but it can be modified to scan and correct ++HOLDs
from sources other than Enhanced HOLDDATA.
To receive the REXX utility with the instructions, click on each of the
following to download:
Table of Contents
PAGE 0001 - NOW SET TO GLOBAL ZONE DATE 10/13/97 TIME 19:13:26 GIMS
EXCEPTION SYSMOD REPORT FOR ZONE TGT0
HOLD SYSMOD APAR ---RESOLVING SYSMOD---- HOLD HOLD
FMID NAME NUMBER NAME STATUS RECEIVED CLASS SYMPTOMS
-------------------------------------------------------------------------------
HDZ11C0 HDZ11C0 AW27894 UW41039 GOOD NO HIPER FUL,PRV
AW27983 UW40486 GOOD NO HIPER PRF
AW28215 UW40597 GOOD NO HIPER DAL
AW28239 UW40151 GOOD NO HIPER FUL
AW28282 UW41113 GOOD NO HIPER FUL
AW28323 UW41042 GOOD NO HIPER FUL
AW28370 UW40634 GOOD NO HIPER IPL,FUL,PRF
AW28376 ***NONE HIPER PRF
AW28447 UW40671 GOOD NO HIPER FUL,PRF
AW28647 UW40834 GOOD NO HIPER FUL
AW28695 UW41811 GOOD NO HIPER FUL
AW28760 ***NONE HIPER DAL
AW28781 UW40994 GOOD NO HIPER FUL
AW28997 UW41721 GOOD NO HIPER
AW29023 UW41453 GOOD NO HIPER IPL,FUL
AW29031 ***NONE HIPER FUL,PRV
AW29078 UW42017 GOOD NO HIPER
AW29205 ***NONE HIPER FUL,PRV
AW29214 ***NONE HIPER IPL
AW29344 UW42279 GOOD NO HIPER FUL
AW29445 UW42362 GOOD NO HIPER IPL,PRV
AW29497 UW42367 GOOD NO HIPER FUL
AW29498 UW42255 GOOD NO HIPER FUL
AW29568 ***NONE HIPER PRF
AW29622 ***NONE HIPER PRF
AW29632 ***NONE HIPER FUL
AW29654 ***NONE HIPER FUL,PRV
AW29669 ***NONE HIPER FUL,PRV
AW29698 ***NONE HIPER IPL
AW29708 ***NONE HIPER
JDZ1135 JDZ1135 AW18463 UW26396 GOOD NO HIPER PRF
AW19628 UW28776 GOOD NO HIPER DAL
AW20828 UW30624 GOOD NO HIPER PRF
AW21095 UW29889 GOOD NO HIPER DAL
AW21744 UW30808 GOOD NO HIPER DAL
AW21778 UW31017 GOOD NO HIPER DAL
AW22601 UW33209 GOOD NO HIPER DAL
AW22983 UW32884 GOOD NO HIPER FUL
AW24733 UW36658 GOOD NO HIPER IPL
AW26120 UW37459 GOOD NO HIPER FUL,PRV
AW26810 UW38287 GOOD NO HIPER DAL
AW27467 UW40513 GOOD NO HIPER FUL
AW29344 UW42282 GOOD NO HIPER
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
PAGE 0002 - NOW SET TO GLOBAL ZONE DATE 10/13/97 TIME 19:13:26 GIMS
EXCEPTION SYSMOD REPORT FOR ZONE TGT0
FIXES FOR HELD RESOLVING SYSMODS
-------------------------------------------------------------------------------
HOLD SYSMOD APAR ---RESOLVING SYSMOD---- HOLD HOLD
FMID NAME NUMBER NAME STATUS RECEIVED CLASS SYMPTOMS
-------------------------------------------------------------------------------
HDZ11C0 UW33444 AW23915 UW34081 GOOD NO PE
UW34347 AW25948 UW37705 GOOD NO PE
UW35231 AW24792 UW35430 GOOD NO PE
UW35621 AW26115 UW39119 GOOD NO PE
UW35638 AW25977 UW37249 GOOD NO PE
UW35694 AW26299 UW37372 GOOD NO PE
UW38610 AW28695 UW41811 GOOD NO PE
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
PAGE 0003 - NOW SET TO GLOBAL ZONE DATE 10/13/97 TIME 19:13:26 GIMS
EXCEPTION SYSMOD REPORT SUMMARY
ZONE FMID TOTAL APARS TOTAL RESOLVING
AGAINST FMID SYSMODS AGAINST FMID
-------------------------------------------------------------------------------
TGT0 HDZ11C0 37 25
JDZ1135 13 13
Table of Contents
Table of Contents
This page last updated October, 2008.
|
