APAR status
Closed as new function.
Error description
FP Online Pointer checker (OPC) will provide a compression routine for Image Copy. This will solve Performance and , DASD space problem that occur using the standard, non-FPO compression utility. This is a forward fit APAR of FPO V2R1 APAR PK04154.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All Online Pointer Checker users of High * * Performance Fast Path Utilities FP Online * * Tools Version 2 Release 1 (FMID: H31A210). * **************************************************************** * PROBLEM DESCRIPTION: Forward Fit of FPO V2R1 APAR PK04154 * * and PK07233. * * By applying this APAR, the High Perfor- * * mance Image Copy (HPIC) can be invoked * * from Online Pointer Checker. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** This APAR adds Online Pointer Checker supports the High Performance Image Copy (HPIC) except for the standard IMS Image Copy when OPC creates an image copy data set.
Problem conclusion
Temporary fix
Comments
Online Pointer Checker supports the High Performance Image Copy (HPIC) except for the standard IMS Image Copy when OPC creates an image copy data set. The new parameter comprtn is added to the IC keyword. OPC allows FABJCMP1, FABJCMP2 and FABJCMP3 as a compression routine. FPXPARM1 has been modified to allow a new format of IC keyword, IC=(YES|NO,comprtn). FPXOXIT1 has been modified to set BFTEK, RECFM, LRECL, and BLKSIZE into DCB for the compressed IC data set. FPXAICW0 has been modified to call FABJCMPx (HPIC module) to generate the compressed IC data set. FPXAICE7, FPXAICE8, and FPXAICE9 have been modified to issue FPX0074I message for the compressed IC data set. FPXTERM0 has been modified to add final processing for the compressed IC data set. FPXTERM7, FPXTERM8 and FPXTERM9 have been modified to add FPXICLST, a new DSECT of FABJCMPx parameter list. FPXMSG00 has been modified to add new FPX0123E message. FPXMBLK has been modified to add the work area for the compressed IC data set. FPXICLST has been added to define FABJCMPx parameter list. FPXUDHDR has been modified to change the equation definition of standard IC to avoid a duplication for Header DSECT definition of a compressed IC data set. ======================== = DOCUMENTATION CHANGE = ======================== The IMS High Performance Fast Path Utilities for z/OS User's Guide Volume 3: Fast Path Online Tools (SC18-9239-00) should be changed as follows: --------------------------------------------------------------- Part 1. Online Pointer Checker Chapter 3. Using Online Pointer Checker INPUT DASYSIN data set The description of IC keyword of DASYSIN DD should be changed to specify the compression routine. IC Keyword The IC keyword lets you specify that an IMS standard image copy or High Performance Image Copy be taken while scanning the database area. This keyword is optional; if omitted, the default is NO. If the IC keyword is specified, but no value is assigned, the default is YES. The keyword comprtn is allowed only when HP Image Copy has been installed. If The keyword comprtn is omitted, Image Copy records are not compressed. The format of the IC keyword is: +--------YES-------------+ | | >>---IC=-------------------------------------------->< | | +------------------------+ | | | | | +-----NO-----------+ | | | +--(YES|NO)--------------+ | | +--(YES,comprtn)---------+ The variable field of the new IC keyword format is defined as follows: NO Specifies that no image copy is to be taken. You can specify just N rather than NO. YES Specifies that an image copy is to be taken. You can specify just Y rather than YES. comprtn Specifies the name of the compression routine that is provided three compression exit routines: FABJCMP1, FABJCMP2, and FABJCMP3 by HP Image Copy. To specify the comprtn, High Performance Image Copy is required. --------------------------------------------------------------- Appendixes. Messages: The FPX0123E message description should be added as follows: --------------------------------------------------------------- FPX0123E Compression routine compression_routine is not loaded. ABEND CODE: Sxxxx REASON CODE: yyyy. Explanation: The compression routine has not been loaded. High Performance Image Copy (HPIC) library may be not concatenated to the STEPLIB library. System Action: Processing terminates with a return code of 8. User Response: Correct the incompatible specification, and resubmit the job. Issuing Module: FPXPARM1 --------------------------------------------------------------- The FPX0074I message description should be added to existing message texts as follows: --------------------------------------------------------------- FPX0074I Image Copy using compression_routine completes. Record count nnnnnnnn Explanation: Image copy processing has completed using HPIC compression routine successfully. The number of records processed is shown. System Action: Processing continues. User Response: None. This message is informational. Issuing Module: FPXAICE7, FPXAICE8, FPXAICE9 --------------------------------------------------------------- The FPX0003E message description should be changed as follows: --------------------------------------------------------------- FPX0003E Error(s) processing dataset. Explanation: This message is issued for one of the following reasons: .The DD name specified with the OFILE or RFILE keyword is not allocated to the job .The message data set identified with the RFILE keyword could not be opened .The DEVTYPE macro for the FPXOFILE DD data set failed .The DYNALLOC macro for the FPXOFILE or the ODESORT DD data set failed This message might be accompanied by the following additional text: Function = typ DD name = ddname MVS RET and RSN codes are: rc + rsn Explanation: The accompanying text identifies the following associated with the failure: .typ The failing operation .ddname The DDNAME associated with the file .rc The MVS return code associated with the failure .rsn The MVS reason code associated with the failure | System Action: Processing generally terminates with a return | code of 12. In module FPXOXIT0 and FPXOXIT1, processing | terminate with abend code 3509. User Response: If the error was due to a DD name with keyword OFILE or RFILE not allocated to the job, supply the appropriate DD statement and resubmit the job. For other errors, determine the nature of the problem with the data set, correct it, and resubmit the job. | Issuing Module: FPXPARM1, FPXOXIT0, FPXOPEN0, FPXOXIT1
APAR Information
APAR number
PK05666
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
2005-05-12
Closed date
2005-07-04
Last modified date
2005-08-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK05108
Modules/Macros
FABUDHD8 FPXAICE7 FPXAICE8 FPXAICE9 FPXAICW0 FPXICLST FPXMBLK FPXMBLK0 FPXMSG00 FPXOXIT1 FPXPARM1 FPXTERM0 FPXTERM7 FPXTERM8 FPXTERM9 FPXUDHDR
| SC18923900 |
Fix information
Fixed component name
IMS HP FP UTILI
Fixed component ID
5655K9400
Applicable component levels
R210 PSY UK05108
UP05/07/06 P F507
[{"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 August 2005