Transaction Processing Facility (TPF) - Online MaintenanceTPF : Support : Maintenance TPF : Support : Maintenance
SUBJECT: APAR NUMBER: PJ27446
REFERENCE: AREA: COMMIT/ROLLBACK SUPPORT
SEGMENT: C$CK1KE40 - RELEASE: TPF4 (C-Header)
SEGMENT: CK1KE40 - RELEASE: TPF4 (Macro)
SEGMENT: CLH040 - RELEASE: TPF4 (Assembler)
SEGMENT: CLH240 - RELEASE: TPF4 (Assembler)
SEGMENT: CLH340 - RELEASE: TPF4 (Assembler)
SEGMENT: CL1140 - RELEASE: TPF4 (Assembler)
SEGMENT: CL2140 - RELEASE: TPF4 (Assembler)
SEGMENT: CL2440 - RELEASE: TPF4 (Assembler)
SEGMENT: CTIN40 - RELEASE: TPF4 (Copy)
SEGMENT: CT0940 - RELEASE: TPF4 (Copy)
SEGMENT: CT4140 - RELEASE: TPF4 (Copy)
SEGMENT: I$TMCR40 - RELEASE: TPF4 (C-Header)
SEGMENT: ICRCT40 - RELEASE: TPF4 (Dsect)
Pre-requisite APARs are:
FOR SEGMENT C$CK1KE40 (C-Header) - REL TPF4
PJ14605 PJ17852 PJ19422 PJ21167
PJ21968 PJ23178 PJ23493
PJ24530PJ24541PJ25094PJ24945PJ24659PJ27087PJ27373
FOR SEGMENT CK1KE40 (Macro) - REL TPF4
PJ14605 PJ17852 PJ19422 PJ21167
PJ21968 PJ23178 PJ23493
PJ24530 PJ24434 PJ25094PJ24945PJ24659PJ27087
FOR SEGMENT CLH040 (Assembler) - REL TPF4
PJ17852 PJ21167 PJ24530PJ25094PJ24945PJ26575
FOR SEGMENT CLH240 (Assembler) - REL TPF4
PJ17852 PJ21167 PJ25094PJ24945PJ26575
FOR SEGMENT CLH340 (Assembler) - REL TPF4
PJ25094PJ24945PJ26456PJ26575
FOR SEGMENT CL1140 (Assembler) - REL TPF4
PJ25094PJ25182PJ26439PJ26687PJ27023
FOR SEGMENT CL2140 (Assembler) - REL TPF4
PJ25094PJ25182PJ26320PJ26439PJ26687PJ26915PJ27023
FOR SEGMENT CL2440 (Assembler) - REL TPF4
PJ25094PJ25182PJ27023
FOR SEGMENT CTIN40 (Copy) - REL TPF4
PJ14856 PJ17852 PJ17912 PJ21167
PJ21479 PJ21040 PJ24530PJ25094PJ24659PJ26146PJ26384
FOR SEGMENT CT0940 (Copy) - REL TPF4
PJ25094PJ26687PJ27326
FOR SEGMENT CT4140 (Copy) - REL TPF4
PJ21167 PJ22898 PJ25094PJ26707PJ26687PJ27023
FOR SEGMENT I$TMCR40 (C-Header) - REL TPF4
PJ25094PJ25182PJ25258PJ26439PJ26687PJ27023PJ27460
FOR SEGMENT ICRCT40 (Dsect) - REL TPF4
PJ25094PJ25182PJ25258PJ26439PJ26687PJ27023PJ27460
To be applied in the order listed for each segment.
ABSTRACT OF PROBLEM
___________________
Usage of RLOG records may lead to VPARS full condition.
COMMENTS ON PROBLEM
___________________
When running under VPARS the size of the VPARS buffer area may
be much smaller than the number of RLOG records allocated to the
TPF recovery log. The TPF recovery log is use by TPF services as
well as customer applications. The writing of RLOG records will
eventually cause a VPARS full condition. A method needs to be
implemented to reduce the number of RLOG records used for the
recovery log when the system is running under VPARS.
SOLUTION
________
Changes have been made to the RLOG record discovery and allo-
cation process. When TPF is running under VPARS, VPARS is
queried to retrieve the size, in blocks, of the buffer area.
This size is a factor in weather or not the number of records
used for the RLOG should be reduced. The formula for reducing
the RLOG records is to take a percentage of the buffer size and
determine if the RLOG allocation will fit within that per-
centage. If the RLOG allocation is greater than the calculated
percentage value it will be reduced to fit within the value. The
percentage used is settable by using the new 'RLVAL' keyword on
the ZCTKA functional message. Until this CTKA value is set a
default value of 30% is used.
DEPENDENCIES
____________
Related Segments Affected By This APAR.
_______________________________________
Segments to be assembled or compiled:
CCCTIN
Segments to be link edited:
Load Modules to be loaded:
CPS0
Migration Considerations
========================
Functional Changes
----------------------------------
The ZCTKA functional message has a new keyword 'RLVAL' which allows you
to specify what percentage of the VPARS buffer area you want to use for
RLOG records. Since this is a new value in CTKA it is expected that it
is not initialized and is set to X'00's. In this case a default value of
30% is used. RLVAL can be set anywhere from 10% through 99%.
Automation and Operation Changes
----------------------------------
Several messages have been added and will appear during restart.
CT090001I RLOG ALLOCATION REDUCED TO FIT INTO VPARS BUFFER AREA
The number of records allocated for the recover log is more than can
be contained in the VPARS buffer area. The RLOG allocation has been
reduced to be a percentage of the VPARS buffer area.
CT090002W UNABLE TO REDUCE RLOG ALLOCATION FOR VPARS
The number of records allocated for the recover log cannot be reduced
by the percentage contained in keypoint A.
Any attempt to do so would result in a recovery log to small to use.
You must change the value, ZCTKA A RLVAL=, in keypoint A to be a higher
percentage of the VPARS buffer area and re-IPL the system. If this
approach does not work then the VPARS buffer area has to be increased
in size.
CL210005I VPARS RLOG ALLOCATION CHANGE ACCEPTED
The number of records allocated for the TPF recovery log has been changed
to allow a test system controlled by VPARS to run withiut filling up the
1
VPARS buffer area. This message indicates that the new allocation has
been accepted.
-- END APAR PJ27446
Download file(s):
Login once to access server, leave window open, then
click on link(s) below.
