APAR status
Closed as new function.
Error description
Provide option to place certain segments into overflow CI's (including IOVF). Forward fit of APAR PQ91752.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All FP Basic Tools Version 2 Release 1 * * users of DEDB Unload/Reload users. * * (FMID: H1J3120) * **************************************************************** * PROBLEM DESCRIPTION: Forward Fit of APAR PQ91752. * * FABCUR1/3 enhancement to support * * LOADCTL=(segname,0) and LOADPLACE=RAP| * * DOVF|IOVF new control statement. * **************************************************************** * RECOMMENDATION: * **************************************************************** FABCUR1/3 enhancement to support LOADCTL=(segname,0) and LOADPLACE=RAP|DOVF|IOVF new control statement. This enhancement will allow DEDB Unload/Reload users to place all indicated segments "far" from their ROOT segment into RAP, DOVF, or IOVF. This enhancement is for Fits MR061603224.
Problem conclusion
Temporary fix
Comments
This enhancement solves Fits MR061603224. This APAR introduces a new 2nd parameter value 0 of LOADCTL=(segname,nnn) and a new control statement LOADPLACE=RAP| DOVF|IOVF in FABCUR1 (Unload) SYSIN DD statement. The LOADCTL=(segname,0) indicates that all specified segments are placed "far" from their ROOT segment. The LOADPLACE= indicates where the segments specified by LOADCTL= are placed. LOADPLACE= RAP All segments which should be "far" from their root will be placed in the available RAP CI space. If no enough space in the RAP CI, they are placed in DOVF or IOVF part. DOVF All segments which should be "far" from their root will be placed in the available DOVF CI space. If no enough space in the DOVF CIs, they are placed in IOVF part. IOVF All segments which should be "far" from their root will be placed in the available IOVF CI space. The function specified by this control statement is ignored if LOADCTL control statement is not specified. Example with DEDB containing one area, with root ROOT1, and its child DDEP DD1, DD2, and DD3. DD1, DD2, and DD3 each segment have twin segments and their child segments DD12, DD22, and DD32. FABCUR1 Sample Control Statements //SYSIN DD * DBDNAME=DEDBJN22 REORG STATS AREACTL=(1) FILECTL=1,1 TASKCTL=(1) LOADCTL=(DD1,0) LOADCTL=(DD2,1) LOADPLACE=IOVF FORMAT=TFMT /* In the above example, for AREA 1, all DD1 and their child DD12 segments are placed into IOVF part. The DD2 segments except 1st DD2 and their child DD22 segments are placed into IOVF part. The DD3 and their child segments are placed into RAP section. The module FABC1GCD has been modified to add a new LOADPLACE= control statement in SYSIN DD statement. The module FABC1INI has been modified to analyze the LOADCTL= (segname,0) and LOADPLACE=RAP|DOVF|IOVF. The module FABCUR1U has been modified to set the flag of ILC record (Insert Limit Count record) into the USR (unloaded segment records) file. The module FABC3UOW has been modified to recognize and reload LOADCTL=(segname,0) and LOADPLACE=RAP|DOVF|IOVF records in the USR file. The module FABCFORM has been modified to set the flag of ILC record into the USR file when FORMAT=TFMT specified. The module FABC1EXR has been modified to renumber its sequence number. The macro FABCOP1M has been modified to add the LOADPLACE=RAP| DOVF|IOVF parameter as a site default value. The macro UR#DCCI0 has been modified to introduce the flag of LOADPLACE=RAP|DOVF|IOVF for FABC1GCD. The macro UR#DUCT0 has been modified to introduce the flag of LOADPLACE=RAP|DOVF|IOVF for the unload sub-task. The macro UR1WSTG0 has been modified to introduce the flag of LOADPLACE=RAP|DOVF|IOVF for FABC1INI. The macro UR3WRK10 has been modified to introduce the flag of LOADPLACE=RAP|DOVF|IOVF for FABC3UOW. The macro UR3WRK20 has been modified to introduce the flag of the parent segment whose child segment is indicated as LOADCTL= (segname,0). The macro FABCMUSR has been modified to introduce the flag of the reload destination (RAP, DOVF, IOVF) and the counter of the child segments with LOADCTL=(segname,0). --------------------------------------------------------------- Documentation Changes: IMS High Performance Fast Path Utilities for z/OS User's Guide Volume 2: Fast Path Basic Tools Version 2 Release 1 (SC18-9238-00) should be changed as follows: Part 4. DEDB Unload/Reload Utilities Chapter 9. Using the DEDB Unload Utility - FABCUR1 FABCUR1 Control Statements LOADCTL Control Statement should be changed as follows: LOADCTL= The LOADCTL statement specifies the type of control statement. segname Specifies the segment name as coded on the SEGM statement in your DBD. nnnn Specifies the maximum number of segname segments that can be stored "close" to their root segment. | The maximum value is 9999 and the minimum value is 0. | The the minimum value 0 specifies that all specified | segments are stored "far" from their root segment. LOADPLACE Control Statement should be added as follows: LOADPLACE Control Statement The optional LOADPLACE statement is a specification of a place, RAP, DOVF, or IOVF. It allows the user to specify a place in which segments selected by the LOADCTL statement are loaded. The LOADPLACE control statement contains the following: LOADPLACE={RAP|DOVF|IOVF} LOADPLACE= The LOADPLACE statement is composed of: RAP All segments which should be "far" from their root segment will be placed in the available RAP CI space. If the space is not enough in the RAP CI, they are placed in the DOVF or the IOVF part. This is default value. DOVF All segments which should be "far" from their root segment will be placed in the available DOVF CI space. If the space is not enough in the DOVF CIs, they are placed in the IOVF part. IOVF All segments which should be "far" from their root segment will be placed in the available IOVF CI space. If LOADCTL control statement is not specified, the function specified by this control statement is ignored. Part 5. Appendixes Appendix K. Unload/Reload Record Layout Following the description of the fieldname should be added as follows: +---------------------------------------------------------+ | Table 48. DEDB Unload/Reload Record Layout | +----------+------------+---------------------------------+ | Field | Assembler | Description | | Name | Definition | | +----------+------------+---------------------------------+ | USRLCFLG | X | "Insert Limit Count" Flag | | | | ==> set to X'00' | | | | One of the following codes is | | | | set for the ILC record: | | | | X'FF' : Twin chain GT | | | | User-Supplies LIMIT | | | | | X'FE' : Put into DOVF | | | | | X'FD' : Put into IOVF | +----------+------------+---------------------------------+ | USRPFLG1 | X | Processing Flag 1 | | | | X'01': More Segs on Twin Chain | | | | (But 'ISRTLIMCT' Reached)| | | | X'02': Unloaded Seg | | | | is compressed. | | | | X'04': Fixed length segment | | | | (see note). | | | | | X'08': One or more ILC children | | | | | (ILC=0 defined in child) | | | | | X'10': ILC=0 | | | | | The first twin record | +----------+------------+---------------------------------+ | Blank | X | 1 byte filler | | | or | | | | | USR#ILC0 | | The number of child with ILC=0 | | | | | accompanies with USRPFLG1=X'10' | +----------+------------+---------------------------------+ Appendix X. Fast Path Basic Tools - Messages and Codes FABC messages The FABC0180E and FABC0181E message descriptions should be added as follows: -------------------------------------------------------------- FABC0180E - INVALID LOADPLACE= CONTROL CARD - SYNTAX ERROR DETECTED Explanation: Self-explanatory. System Action: Program FABCUR1 discards the control statement, sets an internal flag, and continues processing. Programmer Response: Correct the control statement, and rerun the job. -------------------------------------------------------------- FABC0181E - LOADPLACE= CONTROL CARD PREVIOUSLY PROCESSED Explanation: Self-explanatory. System Action: Program FABCUR1 discards the control statement, sets an internal flag, and continues processing. Programmer Response: Correct the control statement, and rerun the job.
APAR Information
APAR number
PQ96893
Reported component name
IMS HP FP UTILI
Reported component ID
5655K9400
Reported release
210
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2004-11-08
Closed date
2004-11-18
Last modified date
2004-12-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UQ95203
Modules/Macros
FABCFORM FABCMMCL FABCMUSR FABCOP1M FABCUR1U FABC1EXR FABC1GCD FABC1INI FABC1OP1 FABC3UOW UR#DCCI0 UR#DSIT0 UR#DUCT0 UR1WSTG0 UR3WRK10 UR3WRK20
| SC18923800 |
Fix information
Fixed component name
IMS HP FP UTILI
Fixed component ID
5655K9400
Applicable component levels
R210 PSY UQ95203
UP04/11/22 P F411
[{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCX89D","label":"IMS HP Fast Path Utilities"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"210","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
02 December 2004