APAR status
Closed as new function.
Error description
To allow Fast Path Online Pointer Checker and FastPath Online Data Extract to support site default options. ODE OPC
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All Online Pointer Checker users and Online * * Data Extract users of High Performance Fast * * Path Utilities FP Online Tools Version 2 * * Release 2 (FMID: H31A220). * **************************************************************** * PROBLEM DESCRIPTION: Allow Online Pointer Checker (OPC) and * * Online Data Extract (ODE) to support * * site default options (requirement * * number: MR0220036430). * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** This APAR addresses the requirement for OPC and ODE to allow users to use site default options.
Problem conclusion
Temporary fix
Comments
OPC and ODE have been enhanced to support site default options. Also, a new keyword has been added to allow them only to evaluate control statement keywords. All messages related to parameter analysis have been changed to be output to SYSPRINT. ======================== = DOCUMENTATION CHANGE = ======================== The IMS High Performance Fast Path Utilities for z/OS User's Guide Volume 3: Fast Path Online Tools Version 2 Release 2 (SC18-9239-01) should be changed as follows: Part 1. Online Pointer Checker Chapter 3. Using Online Pointer Checker: Input OPC allows you to specify site default options. For details, see Appendix D, "Site default options support." New keyword PCHKONLY for keyword check only option has been introduced and the following description is added. PCHKONLY keyword The PCHKONLY keyword specifies whether only to evaluate control statement keywords or also to collect pointer verification data from an online DEDB area. Regardless of PCHKONLY specification, OPC connects to the area to obtain information about the area. The format of PCHKONLY keyword is: PCHKONLY=NO|YES. NO: Processing continues after evaluating the site default options and utility control statements. You may specify just N rather than NO. YES: Processing ends after evaluating the site default options and utility control statements. You may specify just Y rather than YES. Default: NO if the keyword is not specified. If the keyword is specified, but no value is specified, PCHKONLY=YES is assumed. Part 2. Online Data Extract Chapter 6. Using Online Data Extract: Input and output ODE allows you to specify site default options. For details, see Appendix D, "Site default options support." New keyword PCHKONLY for keyword check only option has been introduced and the following description is added. PCHKONLY keyword The PCHKONLY keyword specifies whether only to evaluate control statement keywords or also to extract segment data from online DEDB area. Regardless of PCHKONLY specification, ODE connects to each area to obtain information about the area. The format of PCHKONLY keyword is: PCHKONLY=NO|YES. NO: Processing continues after evaluating the site default options and utility control statements. You may specify just N rather than NO. YES: Processing ends after evaluating the site default options and utility control statements. You may specify just Y rather than YES. Default: NO if the keyword is not specified. If the keyword is specified, but no value is specified, PCHKONLY=YES is assumed. Appendix D. Site default options support Both OPC and ODE support site default options. Section: Using site default options To define the site default options, a configuration member FPXCFG00 must be created in a PROCLIB library specified on the PROCLIB DD statement, which is always coded in the FPUTIL cataloged procedure of IMS. If the configuration member FPXCFG00 is not created in PROCLIB, no site default option is applied. The following keyword parameters can be specified in FPXCFG00: OPCSUF=xx ODESUF=yy OPCPARMLIB=an_opc_parameter_library ODEPARMLIB=an_ode_parameter_library Each keyword parameter must be specified on a 80-byte line, and a line must not contain more than one keyword parameter. Each keyword parameter must start in the first column. The keyword parameters can be specified in any order. If a same keyword parameter is specified more than once, the value specified in the last occurrence is used. The keyword OPCSUF (ODESUF) specifies the 2-character suffix for the PROCLIB member FPXOPCxx (FPXODEyy), which contains the global site default options for OPC (ODE). The member FPXOPCxx (FPXODEyy) must reside in a library concatenated to the PROCLIB DD statement. If OPCSUF=xx (ODESUF=yy) is specified but the member FPXOPCxx (FPXODEyy) does not exist, OPC (ODE) ends with an error. If the OPCSUF (ODESUF) parameter is not specified in FPXCFG00, the default member FPXOPC00 (FPXODE00) is used. If no default member exists in the PROCLIB, processing continues as if no global site default options specified. The keyword OPCPARMLIB (ODEPARMLIB) specifies the name of the parameter library for OPC (ODE). In each parameter library, a member with a DBD name (a DB member) that contains DB level site default options can be created for each DEDB, and a member with an AREA name (an AREA member) that contains AREA level site default options can be created for each area. The DB member is used for an area to be processed only when the corresponding AREA member does not exist. The statements specified in each of the following members for OPC or ODE must follow the control statement syntax for the respective utility: . A PROCLIB member for the global site default options . A DB member in the parameter library . An AREA member in the parameter library If none of these members exists for the respective utility, no site default option is applied to the subject utility. Section: Supported control statement keywords All of OPC keywords and ODE FPXCTL control statement keywords are available for site default options. The keywords associated with ODE SELECT control statement and OUTPUT control statement can not be specified as site default options. Section: How keyword values are determined For each keyword, the value specified for the keyword has the following order of priority; that is, a value in a higher position in the list overrides one in a lower position: 1. The value specified in the JCL stream 2. The value specified in the AREA member in the parameter library 3. The value specified in the DB member in the parameter library 4. The global default value specified in the PROCLIB member 5. The system default value An exception is that the AREA member is not used if ODE is running with run-level control. <--------------------------------------------------------------> Appendixes. Messages and codes: The following message descriptions should be added: ---------------------------------------------------------------- FPX0202I Site default options are specified. Explanation: There are site default options specified. System Action: Processing continues. User Response: This message is informational. Issuing Module: FPXPARM1 ---------------------------------------------------------------- FPX0203I xxx processing options in effect: Explanation: The keyword values following this message are the processing options in effect. .xxx The tool name, which is OPC or ODE. System Action: Processing continues. User Response: This message is informational. Issuing Module: FPXPPRC0 ---------------------------------------------------------------- FPX0204E PDS processing failed for xxxxxxxx: FUNC=yyyyyy, RC=nnnn, RSN=nnnn. Explanation: The accompanying text identifies the following associated with the PDS processing failure: .xxxxxxxx - DDNAME: OPEN/GETDSN/CLOSE error - member name: FIND error .yyyyyy The failing function, which will be one of the following: - OPEN: open a PDS - FIND: find a member in the PDS - GETDSN: get the data set name of the PDS where the current member resides .RC=nnnn, RSN=nnnn FUNCTION=OPEN RC=0004,RSN=0000: DD statement no found. FUNCTION=FIND RC=0004,RSN=0000: Member not found. See User Response for other return codes and reason codes. System Action: Processing terminates with a return code of 8, ODE run-level control terminates with a return code of 12. User Response: Correct the specification , and resubmit the job. The return code or reason code that is not seen in the list above is for an internal error. If such a return code or reason code is returned, call IBM Software Support. Issuing Module: FPXPARM1 ---------------------------------------------------------------- FPX0205E Site default options cannot be specified for keywords of SELECT and OUTPUT control statements. Explanation: For ODE site default options, only FPXCTL control statement is permitted. System Action: Processing terminates with a return code of 8, ODE run-level control terminates with a return code of 12. User Response: Correct the specification , and resubmit the job. Issuing Module: FPXPANA0 ---------------------------------------------------------------- FPX0206I Global level site default values have been read from the following member: PROCLIB: dsn MEMBER: member name Explanation: This message informs that the global level site default values were read from the PROCLIB member "member name". The message also shows the name "dsn" of the data set where the member was found. System Action: Processing continues. User Response: This message is informational. Issuing Module: FPXPCTL0 ---------------------------------------------------------------- FPX0207I xxxx level site default values have been read from the following member: ODEPARMLIB: dsn MEMBER: member name Explanation: This message indicates the DSN of the parameter library, and the name of the AREA level site default member or DB level site default member. .xxxx The level of site default options, which is AREA or DB. System Action: Processing continues. User Response: This message is informational. Issuing Module: FPXPCTL0 ---------------------------------------------------------------- FPX0208I Keywords are specified as follows: Explanation: The keyword values following this message are those specified in JCL, AREA/DB level site default options, Global level site default options and System default. System Action: Processing continues. User Response: This message is informational. Issuing Module: FPXPCTL0 ---------------------------------------------------------------- FPX0209I ODE SELECT/OUTPUT control statement: refer to FPX0049I. Explanation: This message is issued when a SELECT/OUTPUT control statement specified. System Action: Processing continues. User Response: This message is informational. Issuing Module: FPXPCTL0 ---------------------------------------------------------------- FPX0210I Parameter analysis for the global site default options started ... Explanation: This message indicates the parameter analysis for global level site default options started. System Action: Processing continues. User Response: This message is informational. Issuing Module: FPXPANA0 ---------------------------------------------------------------- FPX0211I Parameter analysis for the AREA/DB level site default options started ... Explanation: This message indicates the parameter analysis for AREA/DB level site default options started. System Action: Processing continues. User Response: This message is informational. Issuing Module: FPXPANA0 ---------------------------------------------------------------- FPX0212I Parameter analysis for control statements specified in the JCL stream started ... Explanation: This message indicates the parameter analysis for control statements specified in the JCL stream started. System Action: Processing continues. User Response: This message is informational. Issuing Module: FPXPANA0 ---------------------------------------------------------------- FPX0213E DYNALLOC failed for DSNAME: dsname, MVS RET and RSN codes are: rc+rsn Explanation: Dynamic allocation failed for dsname, rc is the return code from SVC99, rsn is the S99 ERROR contents. System Action: Processing terminates with a return code of 8, ODE run-level control terminates with a return code of 12. User Response: Correct the specification , and resubmit the job. Issuing Module: FPXPARM1 ---------------------------------------------------------------- FPX0214I Processing ends because of PCHKONLY=YES. Explanation: Processing ends after evaluating the site default options and utility control statements when PCHKONLY=YES. System Action: Processing continues. User Response: This message is informational. Issuing Module: FPXADRV0, FPXDRIV0 ---------------------------------------------------------------- FPX0215E Length error for xxxxxxxxxxx detected in FPXCFG00. Explanation: Keyword xxxxxxxxxxx has a length error. System Action: Processing terminates with a return code of 8, ODE run-level control terminates with a return code of 12. User Response: Correct the specification , and resubmit the job. Issuing Module: FPXPARM1 ---------------------------------------------------------------- FPX0216E Incorrect specification detected in FPXCFG00. Explanation: Incorrect control keyword is specified in FPXCFG00. System Action: Processing terminates with a return code of 8, ODE run-level control terminates with a return code of 12. User Response: Correct the specification , and resubmit the job. Issuing Module: FPXPARM1 ---------------------------------------------------------------- FPX0217I Starting keyword analysis: AREA name = areaname, AREA number=area# Explanation: The keyword analysis started. System Action: Processing continues. User Response: This message is informational. Issuing Module: FPXPARM1 ---------------------------------------------------------------- FPX0218I Completed keyword analysis: AREA name = areaname, AREA number=area# Explanation: The keyword analysis completed. System Action: Processing continues. User Response: This message is informational. Issuing Module: FPXPARM1 ---------------------------------------------------------------- FPX0219I AREA level site default values are not read because of run-level control. Explanation: This message indicates AREA level site default values are not processed because of run-level control. System Action: Processing continues. User Response: This message is informational. Issuing Module: FPXPCTL0 ×**** PE06/07/20 PTF IN ERROR. SEE APAR PK28459 FOR DESCRIPTION
APAR Information
APAR number
PK16264
Reported component name
IMS HP FP UTILI
Reported component ID
5655K9400
Reported release
220
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2005-12-05
Closed date
2005-12-21
Last modified date
2006-07-26
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK10345
Modules/Macros
FPXADRV0 FPXADRV7 FPXADRV8 FPXADRV9 FPXAPRM0 FPXAPRM2 FPXARPT0 FPXARPT7 FPXARPT8 FPXARPT9 FPXCONS0 FPXDRIV0 FPXDRIV7 FPXDRIV8 FPXDRIV9 FPXDYNA0 FPXMABLK FPXMBLK FPXMBLK0 FPXMSG00 FPXPANA0 FPXPARM0 FPXPARM1 FPXPCTL0 FPXPPRC0 FPXTREJ0 FPXUPDS FPXUPDS0 H31A220J
| SC18923901 |
Fix information
Fixed component name
IMS HP FP UTILI
Fixed component ID
5655K9400
Applicable component levels
R220 PSY UK10345
UP05/12/23 P F512
[{"Line of Business":{"code":null,"label":null},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCX89D","label":"IMS HP Fast Path Utilities"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"220"}]
Document Information
Modified date:
04 October 2020