A fix is available
APAR status
Closed as program error.
Error description
Add new HOF setting to allow UMON and IQ data to contain the "real" date from PR/SM instead of the z/OS date when a z/OS LPAR is deliberately IPLed with a displaced date.
Local fix
N/A
Problem summary
**************************************************************** * USERS AFFECTED: All IBM Tivoli Asset Discovery for z/OS V8.1 * * customers. * **************************************************************** * PROBLEM DESCRIPTION: When testing software by IPLing an LPAR * * with a future date, UMON and IQ data * * continue to report software asset * * status using the z/OS date and time, * * thereby giving a distorted view of * * software status and usage. * **************************************************************** * RECOMMENDATION: * **************************************************************** Usage Monitor and Inquisitor components always use the z/OS local date and time when time-stamping collected data, even when this is significantly different from the date and time as known by PR/SM. There is no provision for using the hardware or hypervisor date and time instead of the z/OS date and time.
Problem conclusion
A new HOF 'Y' or 'N' setting is added to the Usage Monitor. HOF(N) is the default and requests existing behaviour. HOF(Y) requests the new function of adjusting time-stamps in collected data by subtracting the STCK offset value in SMF type 89 record field SMF89HOF from the local z/OS date and time. For the Usage Monitor the new function is implemented by the writer task at switch time. The Inquisitor programs HSIPINQ and HSIXINQ will implement the new function based on the most recent Usage Monitor HOF setting on the system. Data written out before the Usage Monitor has detected an SMF type 89 record will be consistent with the HOF(N) setting. Documentation is altered as follows: +--- Tivoli Asset Discovery for z/OS Version 8 Release 1 ---+ | | |PROGRAM NUMBER: 5698-AA4 | | | |TITLE: Tivoli Asset Discovery for z/OS | | Administration Guide and Reference | | | |Chapter 6. Collecting and importing data with | | IBM Tivoli Asset Discovery for z/OS | | | |Section: | | "Usage Monitor commands" | | | |Insert the description for the new "HOF" command between | |the descriptions of "EXC" and "IDD", as follows: | | | | HOF - Adjust for hypervisor STCK TOD clock offset | | | | HOF is used to control whether a logical partition's | | TOD clock offset is to be applied to collected data | | or not. When HOF(N) is set data timestamps are | | derived from the local time as supplied by z/OS. | | When HOF(Y) is set, the hypervisor STCK date/time | | offset from field SMF89HOF in SMF type 89 records | | is subtracted from z/OS local time to form the | | collected timestamp values. | | | | For Usage Monitor data, the HOF setting at the time | | that the writer task is attached after the closure | | (or switch) of a collection repository is used. | | | | For Inquisitor data, the HOF setting active at the | | time of Inquisitor program initialization is used. | | | | HOF(Y) will not cause any change to data timestamp | | values unless the Usage Monitor has processed a | | type 89 SMF record. For this to occur, SMF parameter | | settings must specify the collection of type 89 | | records, and at least one SMF interval must have | | ended while the Usage Monitor is active before | | output file data generation commences. | | | | If the Usage Monitor has been stopped before an | | Inquisitor scan commences, the Inquisitor program | | will use the HOF status current at the time of | | Usage Monitor termination. | | | | >>--HOF(-+-Y-+-)----------------------------------->< | | +-N-+ | | | | Y Specifies that the hypervisor STCK TOD clock | | offset will be used to adjust date and time | | values present in collected data. | | | | N Specifies that date and time values present in | | collected data will be based wholly on the local | | time as maintained by z/OS. | | | | HOF(N) is the default setting that will be used if | | no HOF command has been issued since IPL. | | | |Chapter 11. Troubleshooting, messages, and support | | | |Section: | | "HSIZ - Usage Monitor messages" | | | |Insert the description for the new "HSIZ083I" message | |after that for "HSIZ082I" as follows: | | | | HSIZ083I csid ADJUSTING FOR HYPERVISOR TIME OFFSET? ans | | | | Explanation: Either a HOF or a D-S command was issued. | | When the answer is YES the message indicates that | | timestamps in collected data will be adjusted by | | subtracting the hypervisor time offset from the z/OS | | date and time. This adjustment is performed by the | | writer task of the Usage Monitor, and by both | | Inquisitor programs. When the answer is NO the | | unaltered local z/OS date and time will be used in | | the collected data. | | | | In the message text: | | | | csid | | current system identifier. | | | | ans | | YES or NO. | | | | System action: Processing continues. | | | | Operator response: None required. | | | | System programmer response: None. | | | | Module: HSIZMON | | | +--------------------------------------------------------------+
Temporary fix
Comments
APAR Information
APAR number
OA46093
Reported component name
TIV ASSET DISC
Reported component ID
5698B39TD
Reported release
810
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function / Xsystem
Submitted date
2014-09-23
Closed date
2014-10-21
Last modified date
2014-11-04
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UA75220
Modules/Macros
HSIPINQ HSISMNPM HSIXINQ HSIZHECK HSIZMON HSIZMSG HSIZUDEL HSIZU84X HSIZ0104 HSIZ0203 HSIZ0303 HSIZ3010 HSIZ3030 HSIZ3040 HSIZ3050 HSIZ3060
| SC22547400 |
Fix information
Fixed component name
TIV ASSET DISC
Fixed component ID
5698B39TD
Applicable component levels
R810 PSY UA75220
UP14/10/24 P F410
Fix is available
Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.
[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSBLR8","label":"Tivoli Asset Discovery for z\/OS"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"810","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]
Document Information
Modified date:
18 July 2023