A fix is available
APAR status
Closed as new function.
Error description
A new keyword is being introduced to force an error when the syntax of the Online Expert Reorganization AREA= keyword is incorrect. Currently, in the case of such keyword rule error, the job runs to completion with just one AREA (the last one) instead of ending in error. Here is the syntax error being used: REORG AREA=area1 AREA=area2 AREA=area3 The correct syntax would be: REORG AREA=(area1,area2,area3) or REORG AREA=(area1-area3) The User's Guide is also being enhanced to better document Fast Path Online Tools keyword usage. Additional issue addressed: There is an inconsistent response when adding a blank line in the global site default options proclib member. OER and ODM end with RC08 and message FPX0240E but OPC successfully completes with RC=00. We'll adjust OER and ODM to allow for blank lines to make things consistent.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of HPFPU Fast Path Online Tools * * in Fast Path Solution Pack Version 1 * * Release 3 (FMID: HAHQ130). * **************************************************************** * PROBLEM DESCRIPTION: This APAR provides the following new * * functionalities: * * 1. Online Pointer Checker, Online Data * * Extract, Online Expert Reorganization * * and Online DMAC Print have been * * enhanced to provide a new keyword to * * force an error in case of duplicate * * keyword. * * 2. Online Expert Reorganization * * and Online DMAC Print have been * * enhanced to remove a restriction * * for site default options. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** 1. A new keyword KEYWORD_DUPCHK has been added to the GLOBAL control statement of OPC/ODE/OER/ODM. When KEYWORD_DUPCHK=YES, the job ends with an error in case of duplicate keyword. 2. For OER and ODM, the control statements of site default must start with a line that contains a command. This restriction has been removed by this enhancement. Also, the description of some FPO keywords has been modified for easier reference. A code error about flags of PREFIX keyword and SUFFIX keyword has been corrected in this APAR also.
Problem conclusion
Temporary fix
Comments
======================== = DOCUMENTATION CHANGE = ======================== The IMS Fast Path Solution Pack for z/OS Version 1 Release 3 IMS High Performance Fast Path Utilities User's Guide. (SC19-4010-01). > Analyzing a DEDB online with FPO >> Running OPC >>> Utility control statements for OPC Add the new keyword KEYWORD_DUPCHK to Table 1. GLOBAL statement keywords. KEYWORD_DUPCHK | YES | NO |Specifies whether to force an | (Optional)| |error in case of duplicate | | |keyword. > Extracting a DEDB online with FPO >> Running ODE >>> Utility control statements for ODE Add the description of new GLOBAL control statement. GLOBAL control statement The GLOBAL control statement defines the job step keyword values. If specified, GLOBAL must be the first command in the input stream. The GLOBAL control statement can be specified only in FPXIN DD. GLOBAL statement keywords The GLOBAL control statement specifies the job step keyword values. This control statement is optional. The keywords associated with the GLOBAL statement are available for site default options. For the GLOBAL statement, you can specify the keywords that are listed in the following table. For the details of the keywords, see the related topics. Table 1. GLOBAL statement keywords Keyword | Used in | Used in | Description | FPXIN DD | FPXCTL DD | | | or areaname| | | DD | --------------------------------------------------------------- KEYWORD_DUPCHK | YES | NO |Specifies whether to | (Optional)| |force an error in case | | |of duplicate keyword. > Reorganizing a DEDB online with FPO >> Running OER >>> Utility control statements for OER Add the new keyword KEYWORD_DUPCHK to Table 1. GLOBAL statement keywords. KEYWORD_DUPCHK | YES | NO |Specifies whether to force an | (Optional)| |error in case of duplicate | | |keyword. > Printing DMAC blocks in a DEDB online with FPO >> Running ODM >>> Utility control statements for ODM Add the new keyword KEYWORD_DUPCHK to Table 1. GLOBAL statement keywords. KEYWORD_DUPCHK | YES | NO |Specifies whether to force an | (Optional)| |error in case of duplicate | | |keyword. > Keyword reference for FPO >> Syntax rules for FPXIN Before: . If the same keyword is specified for a command more than once, the last one coded is used. After: . If the same keyword is specified for a command more than once, the last one coded is used when the KEYWORD_DUPCHK=YES keyword is not specified. > Keyword reference for FPO >> FPO control statements >>> ANALYZE Add ICNOTIFY keyword and PROC_AFT_ERROR keyword to the list of the related keywords. Add the following lines to the syntax of ANALYZE: +--NO-------+ | | >>---ICNOTIFY=--+--YES------+--->< +--STOP-----+ | | >>---PROC_AFT_ERROR=--+--NEXTAREA-+--->< > Keyword reference for FPO >> FPO control statements >>> DMACPRT Add PROC_AFT_ERROR keyword to the list of the related keywords. Add the following lines to the syntax of DMACPRT: +--STOP-----+ | | >>---PROC_AFT_ERROR=--+--NEXTAREA-+--->< > Keyword reference for FPO >> FPO control statements >>> GLOBAL Add KEYWORD_DUPCHK keyword to the list of the related keywords. Add the following lines to the syntax of GLOBAL: +--NO-------+ | | >>---KEYWORD_DUPCHK=--+--YES------+--->< > Keyword reference for FPO >> FPO control statements >>> FPXCTL Add RFILE keyword to the list of the related keywords. Add the following lines to the syntax of FPXCTL: +--FPXRPTS--+ | | >>---RFILE=--+--ddname---+----->< > Keyword reference for FPO >> FPO control statements >>> OUTPUT Change FIELD keyword in the list of the related keywords to FIELDS keyword. > Keyword reference for FPO >> FPO control statements >>> PTRCHK Add ICNOTIFY keyword to the list of the related keywords. Add the following lines to the syntax of PTRCHK: +--NO-------+ | | >>---ICNOTIFY=--+--YES------+--->< > Keyword reference for FPO >> FPO control statements >>> REORG Add PROC_AFT_ERROR keyword to the list of the related keywords. Add the following lines to the syntax of REORG: +--STOP-----+ | | >>---PROC_AFT_ERROR=--+--NEXTAREA-+--->< > Keyword reference for FPO >> FPO control statements >>> REPORT There are two REPORTDD keywords in the list of the related keywords, delete one. > Keyword reference for FPO >> FPO keywords >>> SEGLDIST Before SEGLDIST is an optional keyword for the REPORT statement: After SEGLDIST is an optional keyword for the following statements: . REPORT statement of OPC . REPORT statement of OER > Keyword reference for FPO >> FPO keywords >>> SEGLSTAT Before SEGLSTAT is an optional keyword for the REPORT statement: After SEGLSTAT is an optional keyword for the following statements: . REPORT statement of OPC . REPORT statement of OER > Keyword reference for FPO >> FPO keywords Add KEYWORD_DUPCHK keyword: KEYWORD_DUPCHK The KEYWORD_DUPCHK keyword specifies whether to force an error in case of duplicate keyword. DBRC is an optional keyword for the following statements: . GLOBAL statement of OPC . GLOBAL statement of ODE . GLOBAL statement of OER . GLOBAL statement of ODM Format +---------------------------------------------------------+ | +--NO-------+ | | | | | | >>---KEYWORD_DUPCHK=--+--YES------+--->< | +---------------------------------------------------------+ The variable fields are defined as follows: NO In case of duplicate keyword, the last one coded is used. You can specify N rather than NO. YES In case of duplicate keyword, the job ends with an error. You can specify Y rather than YES. Default: NO, if the KEYWORD_DUPCHK keyword is not specified. Site default support: Supported. Restriction: . The KEYWORD_DUPCHK keyword can be specified only in FPXIN. . For the following keywords, the job ends with an error in case of duplicate keyword regardless of KEYWORD_DUPCHK specification. . For OPC, ODE, OER and ODM . Keywords that are associated with the OVERRIDE control statement . For ODE . The SEGREC_PREFIX keyword and the SEGREC_SUFFIX keyword of the FPXCTL control statement. . The SEG keyword of the OUTPUT control statement. . The SEG keyword and the FIELD keyword of the SELECT control statement . The BREAK keyword and the FIELDS keyword of the USER_RECORD control statement. For the BREAK keyword, the job ends with an error only when the same parameters are specified. > Site default options support for FPO >> How keyword values are determined Before An exception is that the AREA member is not used for the following cases: . GLOBAL control statement . OPC except when AREA=areaname is specified . OER except when AREA=areaname is specified . ODE running with the run-level control . ODM After An exception is that the AREA member is not used for the following cases: . OPC except when AREA=areaname is specified . OER except when AREA=areaname is specified . ODE running with the run-level control . ODM the DB member and the AREA member are not used for the GLOBAL control statement. > Site default options support for FPO >> Setting site default options for FPO >>> Creating configuration member of FPXCFG00 Before . The DB-level site default options or the area-level site default options of the ODM utility are created in HPFP.ODM.PARMLIB After . The DB-level site default options of the ODM utility are created in HPFP.ODM.PARMLIB > Messages and codes of IMS HP Fast Path Utilities >> Messages >>> FPX messages Modify the explanation of FPX0248E to: Explanation: This keyword cannot be specified more than once in a control statement.
APAR Information
APAR number
PI18225
Reported component name
IMS FP SOLUTION
Reported component ID
5655W1400
Reported release
130
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
YesSpecatt / New Function / Xsystem
Submitted date
2014-05-19
Closed date
2014-08-01
Last modified date
2014-09-03
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI20175
Modules/Macros
FPXAURT0 FPXAUTR0 FPXDCFX0 FPXDCSE0 FPXUCA00 FPXUCKE0 FPXUCM00 FPXUGBB0 FPXUGBD0 FPXUGBK0 FPXUGRP0 FPXUGRS0
| SC19401001 |
Fix information
Fixed component name
IMS FP SOLUTION
Fixed component ID
5655W1400
Applicable component levels
R130 PSY UI20175
UP14/08/02 P F408
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.
[{"Line of Business":{"code":null,"label":null},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCV35A","label":"IMS Fast Path Solution Pack"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"130"}]
Document Information
Modified date:
03 October 2020