$REALTIMER shareable tool exceeds field capacity in September 2011.

$REALTIMER shareable tool exceeds field capacity in September 2011.

book

Article ID: KB0085187

calendar_today

Updated On:

Products Versions
TIBCO Object Service Broker for z/OS -
Not Applicable -

Description

Description:
The output from the $REALTIMER shareable tool will exceed the capacity of its 8 byte packed length output field definition in September 2011.   In order to prevent this the size of the output field has been increased  to be packed length 16, i.e. 31 decimal digits.  This maintenance has been delivered in TIBCO Object Service Broker for z/OS 5.0.0 Hotfix 12:
  AP13248  Increase length of return value from $REALTIME


This may have significant implications for some customers who store $REALTIMER values in tables.  

* If the difference between two $REALTIMER values are stored in tables there should be no impact.
* If full $REALTIMER values are stored then the length of the fields will need to be increased. The length of non-key fields can simply be increased in the table definition.
* Tables where $REALTIMER values are part of the primary key will need to be unloaded, cleared, changed and reloaded.
* Tables where $REALTIMER values are part of a secondary key will need the secondary key to be removed before the change and then rebuilt.

This LBN item is being issued so that customers can evaluate the impact to their environment and make any required changes to table definitions.  This can be done before the fix is applied.

Delivered Maintenance:
----------------------
For customers using TIBCO Object Service Broker for z/OS, refer to the following maintenance which upgrades the Screen and Report Definer to support larger field sizes for packed and binary numbers as well as offline utilities and expands the $REALTIMER packed response:

5.2 -LBN1-C3K6I4 TIBCO(R) Object Service Broker for z/OS 5.2.0 Hotfix 06 is now available.
5.0 -LBN1-C3L0JI Hotfix 18 for TIBCO(R) Object Service Broker for z/OS 5.0.0 is now available.
    -LBN1-ARHV83 Hotfix 12 for TIBCO(R) Object Service Broker for z/OS 5.0.0 is now available.


History:
--------
Feb 1, 2010 -LBN1-AJEW6S issued.
July 11, 2011 -information regarding LBN1-C3K6I4 and LBN1-C3L0JI added.
July 12, 2011 -information regarding LBN1-ARHV83 Hotfix 12 added.
Symptoms:

Cause:

Issue/Introduction

$REALTIMER shareable tool exceeds field capacity in September 2011.