A fix is available
APAR status
Closed as new function.
Error description
Online Area Extender ( OAE ) to use multiple volumes if the single volume is out of space. The out of space condition would result in an OAE ABENDU3519. U3519 This enhancement is being implemented as a result of RFE requirement 32577 and 38640.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All users of Fast Path Solution Pack Version * * 1 Release 3 (FMID: HAHQ130). * **************************************************************** * PROBLEM DESCRIPTION: This APAR enhances OSM and OAE to * * support multi-volume allocation for * * the extended original ADS. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** 1. OSM and OAE allocate the extended original ADS on multiple volumes if the single volume does not have sufficient space. This enhancement is being implemented as a result of RFE requirements 32577 and 38640. 2. The following potential problems have been also solved in this APAR: (1). OSM didn't store Audit report and Processing report in IMS Tools KB repository. (2). The temporary ADS DEFINE error occurred when the volume names that are specified on the VOLUME keyword across multiple lines. (3). FPX0135E message was issued twice when more than 59 volumes are specified for the VOLUME keyword. (4). The number of SDEP Cis to expand was incorrect when it is multiples of 100.
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). > Extending a DEDB online with FPO >> Utility control statements for OAE >>> FPXIN DD data set (Original expansion) >>>> EXTEND statement keywords Add MAXVOLS keyword and VOLUME_EXT keyword in Table 128. EXTEND statement keywords: MAXVOLS | Optional | Specifies, for SMS environments, the maximum number of volumes for the extended original area data set. VOLUME_EXT | Optional | Specifies, for non-SMS environments, one or more volume-serial identifiers for the temporary area data set. > Keyword reference for FPO >> FPO Control statements >>> EXTEND Add MAXVOLS keyword and VOLUME_EXT keyword to the list of the related keywords. Add the following lines to the syntax of EXTEND: +--2--------+ | | >>---MAXVOLS=--+--integer--+--->< >>---VOLUME_EXT=--+--volume-----------------+-->< | | +--(volume1,...,volumen)--+ > Keyword reference for FPO >> FPO keywords Add MAXVOLS keyword at EXTEND control statement: MAXVOLS The MAXVOLS keyword specifies the maximum number of volumes for the extended original ADS. This keyword is effective only in SMS environments. MAXVOLSis an optional keyword for the EXTEND statement of OAE. Format: +----------------------------------------------------* | | | +--2--------+ | | | | | | >>---MAXVOLS=--+--integer--+--->< | | | +----------------------------------------------------+ The variable field is defined as follows: integer An integer value in the range of 1 - 59. Default: 2, if the MAXVOLS keyword is not specified. Site default support: Not supported. Restrictions: . The MAXVOLS keyword can be specified only in FPXIN. . This keyword is mutually exclusive with the VOLUME_EXT keyword. Add VOLUME_EXT keyword to EXTEND control statement: VOLUME_EXT The VOLUME_EXT keyword specifies one or more volume-serial identifiers for the extended original ADS. This parameter is used for the preparation of the extended original ADS. VOLUME_EXT is an optional keyword for the EXTEND statement of OAE. Format: +----------------------------------------------------* | | | >>---VOLUME_EXT=--+--volume-----------------+-->< | | | | | | +--(volume1,...,volumen)--+ | | | +----------------------------------------------------+ The variable fields are defined as follows: volume Specifies the volume-serial identifier for the extended original ADS. (volume1,....,volumen) Specifies multiple volume-serial identifiers for the extended original ADS. Default: The volume-serial identifiers of original ADS before expansion. Site default support: Not supported. Restrictions: . The VOLUME_EXT keyword can be specified only in FPXIN. . This keyword cannot be specified when the original ADS is MADS. . This keyword is mutually exclusive with the MAXVOLS keyword. > JCL requirements for the Online Space Management utility >> Utility control statements for the Online Space Management utility >>> SETEXTENDPARM subcommand keywords Add the following lines to the syntax of SETEXTENDPAMR subcommand: +--2--------+ | | >>---MAXVOLS=--+--integer--+--->< >>---VOLUME_EXT=--+--volume-----------------+-->< | | +--(volume1,...,volumen)--+ Add MAXVOLS keyword to SETEXTENDPAMR subcommand: MAXVOLS The MAXVOLS keyword specifies the maximum number of volumes for the extended original ADS. This keyword is effective only in SMS environments. MAXVOLS is an optional keyword for the SETEXTENDPARM subcommand. Format: +----------------------------------------------------* | | | +--2--------+ | | | | | | >>---MAXVOLS=--+--integer--+--->< | | | +----------------------------------------------------+ The variable field is defined as follows: integer An integer value in the range of 1 - 59. Default: 2, if the MAXVOLS keyword is not specified. Site default support: Not supported. Restrictions: . This keyword is mutually exclusive with the VOLUME_EXT keyword. Add VOLUME_EXT keyword to SETEXTENDPAMR subcommand: VOLUME_EXT The VOLUME_EXT keyword specifies one or more volume-serial identifiers for the extended original ADS. This parameter is used for the preparation of the extended original ADS. VOLUME_EXT is an optional keyword for the SETEXTENDPARM subcommand. Format: +----------------------------------------------------* | | | >>---VOLUME_EXT=--+--volume-----------------+-->< | | | | | | +--(volume1,...,volumen)--+ | | | +----------------------------------------------------+ The variable fields are defined as follows: volume Specifies the volume-serial identifier for the extended original ADS. (volume1,....,volumen) Specifies multiple volume-serial identifiers for the extended original ADS. Default: The volume-serial identifiers of original ADS before expansion. Site default support: Not supported. Restrictions: . This keyword cannot be specified when the original ADS is MADS. . This keyword is mutually exclusive with the MAXVOLS keyword. > Troubleshooting >> Messages and codes of IMS HP Fast Path Utilities >>> Messages >>>> FPX messages The following messages are added: FPX0341E TRKCALC macro failed. RC=rc Explanation: The TRKCALC macro failed. The return code is shown in rc. System action: Processing ends with a return code of 8. User response: See the z/OS MVS Authorized Assembler Services Guide to determine the meaning of the return code. Correct the error and rerun the job. If the problem persists, contact IBM Software Support. FPX0342E The maximum number of volumes for the original | temporary ADS is 1, but the size of the extended ADS exceeds the total number of CIs available for the device. Explanation: The extended ADS needs more volumes for allocation. System action: Processing ends with a return code of 8. User response: For the temporary ADS, use the device with bigger capacity. For the extended original ADS, specify more volumes on the MAXVOLS keyword in a SMS environment, or on the VOLUME_EXT keyword in a non-SMS environment. Then, rerun the job. FPX0343E The VOLUME keyword must be supplied in a non-SMS environment. Explanation: The VOLUME keyword is necessary for a non-SMS environment, but it is not specified. System action: Processing ends with a return code of 8. User response: Specify the VOLUME keyword, and rerun the job. FPX0344E The VOLUME_EXT keyword is not supported when the original ADS is a MADS. Explanation: The VOLUME_EXT keyword is specified, but the original ADS is a MADS. System action: Processing ends with a return code of 8. User response: Remove the VOLUME_EXT keyword specification, or change the original ADS to a SADS, and rerun the job. FPX0345E Specify a volume with sufficient space to contain the temporary ADS. Explanation: The volume that is specified on the VOLUME keyword has not sufficient space to contain the temporary ADS. System action: Processing ends with an abend code of U3519. User response: Specify a volume with sufficient space to contain the temporary ADS on the VOLUME keyword, and rerun the job. The following messages are modified: | FPX0135E The number of VOLUME | VOLUME_EXT keyword limit exceeded. Explanation: More than 59 volumes were specified for | a temporary area data set or an extended original area data set. The limit is 59 or fewer. System action: Processing ends with a return code of 8. User response: Correct the specification, and rerun the job.
APAR Information
APAR number
PI16740
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-04-24
Closed date
2014-07-17
Last modified date
2014-08-04
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UI19724
Modules/Macros
FABAHEXT FPXBAMS0 FPXBASO0 FPXBCSI0 FPXBCSO0 FPXBDFC0 FPXBMBL0 FPXBPAR1 FPXBPSZ0 FPXBPS40 FPXBVOL0 FPXMSG00 FPXUITI0 FPXUITO0 FPXUSNB0 HAHQ130J HFPCCDT0 HFPCDEF0 HFPFGOC0 HFPFSNC0 HFPGBIT0 HFPLMAN0 HFPLYST0 HFPMCCC0 HFPMTRM0 HFPOMGT0 HFPONAD0 HFPTMNG0
| SC19401001 |
Fix information
Fixed component name
IMS FP SOLUTION
Fixed component ID
5655W1400
Applicable component levels
R130 PSY UI19724
UP14/07/21 P F407
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.
[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"130","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCV35A","label":"IMS Fast Path Solution Pack"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"130","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
04 August 2014