A fix is available
APAR status
Closed as new function.
Error description
HPIC V3.2 currently does not wait, for a device mount in dynamic allocation, when there are no available device. This HPIC APAR will provide a new operational keyword that will control the waiting device automatically when the keyword in the site default table or GLOBAL statement is specified.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All IMS High Performance Image Copy for z/OS * * Version 3 Release 2 users ( FMID=H1J0320 ) * **************************************************************** * PROBLEM DESCRIPTION: This APAR provides a new optional * * keyword WAITALOC= and enhances * * optional keyword WAITTIME=. These * * keywords control the WAIT policy in * * case of the tape device is in use by * * another process. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** This APAR provides a new optional keyword WAITALOC= and enhances optional keyword WAITTIME=. These keywords control the WAIT policy in case of the tape device is in use by another process.
Problem conclusion
Temporary fix
Comments
A new module FABJRPC0 has been created. This module checks HPIC authorization status and get PC number for program call. A new module FABJDALS has been created. This module requests dynamic allocation of IC data set. FABJMAIN has been modified to attach and detach the new module in IC process. FABJDCTL has been modified to attach and detach the new module in Type-A IC process under IPR. FABJDRQS has been modified to attach and detach the new module in Type-A IC process for S-index under IPR. FABJIPRC has been modified to attach and detach the new module in Type-B IC process under IPR. FABJDMPN has been modified to attach and detach the new module if retries dynamic allocation. FABJDALC has been modified to control the request of dynamic allocation to FABJDALS when STACK= is specified. FABJDALO has been modified to control the request of dynamic allocation to FABJDALS when ICOUT= is specified. FABJBLKD, FABJMRGE, FABJPARM, FABJPRM2, FABJSTMD and FABJTGEN has been modified to add new areas for new keyword and new keyword parameters. FABJMSGC modified to add new message. FABJMAS1 has been modified to calculate data space origin correctly. The following modules have been reassembled. FABJACQG FABJATRC FABJCMDB FABJCRC0 FABJCRC1 FABJCTCV FABJCZCV FABJDBCM FABJDBC1 FABJDBD7 FABJDBD8 FABJDBD9 FABJDBF0 FABJDBLK FABJDBR7 FABJDBR8 FABJDBR9 FABJDEMP FABJDMP0 FABJDMP7 FABJDMP8 FABJDMP9 FABJDOPN FABJDPS7 FABJDPS8 FABJDPS9 FABJDPUT FABJDREQ FABJINT1 FABJINT2 FABJMDP7 FABJMDP8 FABJMDP9 FABJNTFC FABJORC7 FABJORC8 FABJORC9 FABJRCH7 FABJRCH8 FABJRCH9 FABJRDB7 FABJRDB8 FABJRDB9 FABJRPT0 FABJSAS2 FABJTERM FABJUIC1 FABJXLIM FABJDBDN FABJDBRC FABJDPSN FABJORCN FABJRCHK ======================== = DOCUMENTATION CHANGE = ======================== IMS High Performance Image Copy for z/OS Version 3 Release 2 User's Guide: Document Number: SC18-7617-01 ( SC18761701 ) should be changed as follows: 2.3.4.1 GLOBAL Statement : . VOLSER7= | . WAITALOC= . WAITMSG= : | 2.3.5.57 WAITALOC= | This keyword specifies whether to display the 'WAIT' option on | the message IEF238D or not, when the dynamic allocation failes | on the tape unit. | | +---------------------------------------------------------+ | | WAITALOC=Y|N + | +---------------------------------------------------------+ | | where: | Y | displays the 'WAIT' option on the message IEF238D. | WAITALOC=Y is ignored, if any of the libraries specified in | the STEPLIB DD statement are not APF-authorized. | | N | does not display the 'WAIT' option on the message IEF238D. | This is the default. | | When 'WAIT' is replied to the message IEF238D, HPIC waits | dynamic allocation until the required units are released. | | This keyword can be used in the following control statement: | GLOBAL 2.3.5.58 WAITTIME= This keyword specifies the wait time for repeating the dynamic allocation on the tape unit when the dynamic allocation reason | code (SVC99) is 214, 220, 228 or 484. +---------------------------------------------------------+ | | WAITTIME=nnnn|(nnnn,CANCEL|CANGO)|(,CANCEL|CANGO) + +---------------------------------------------------------+ where: nnnn is the time for repeating the dynamic allocation for the | tape unit when the reason code is 214, 220, 228 or 484. The unit is in minutes. The minimum value is 0 and the maximum value is 9999. The default is 30. | CANCEL|CANGO | specifies whether to retry dynamic allocation or not when | the reason code is 484. | | CANCEL | does not retry dynamic allocation when the reason code is | 484. | CANGO | retry dynamic allocation when the reason code is 484. When 0 is specified for the WAITTIME, HPIC does not retry dynamic allocation and terminates with a U3916 message. This keyword can be used in the following control statement: GLOBAL 2.3.5.59 WAITMSG= This keyword specifies whether to display the FABJ3929A WTO message on the operator console or not, when dynamic allocation is being performed on the tape unit. This keyword is effective for the dynamic allocation (SVC99) reason codes | 214, 220, 228 and 484. +---------------------------------------------------------+ | WAITMSG=Y|N + +---------------------------------------------------------+ where: Y displays the FABJ3929A WTO message on the operator console until dynamic allocation on the tape unit is successful. This is the default. N does not display the FABJ3929A WTO message on the operator console. If WAITTIME=0 is specified, this keyword does not work. | When CANGO is specified for the WAITTIME and the reason code | of dynamic allocation is 484, the FABJ3929A WTO message is | displayed even if WAITMSG=N is specified. This keyword can be used in the following control statement: GLOBAL A.0Appendix A. Return Codes, Abend Codes, and Messages A.3 Messages The message FABJ0186I is added. | FABJ0186I WAITALOC=Y WAS IGNORED. HPIC RUNS AS AN UNAUTHORIZED | PROGRAM. | Explanation: | WAITALOC=Y was ignored. Because HPIC runs as unauthorized | program. | System Action: | Program FABJMAIN continues processing. HPIC does not wait when | the requested device is in use. | Programmer Response: | Check APF-authorized library list contains all libraries | concatenated to STEPLIB.
APAR Information
APAR number
PK11169
Reported component name
IMS HP IMAGE CO
Reported component ID
5655K9600
Reported release
320
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2005-08-30
Closed date
2005-09-02
Last modified date
2005-10-04
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK06891
Modules/Macros
FABJACQG FABJATRC FABJBLKD FABJCMDB FABJCRC0 FABJCRC1 FABJCTCV FABJCZCV FABJDALC FABJDALO FABJDALS FABJDBCM FABJDBC1 FABJDBDN FABJDBD7 FABJDBD8 FABJDBD9 FABJDBF0 FABJDBLK FABJDBRC FABJDBR7 FABJDBR8 FABJDBR9 FABJDCTL FABJDEMP FABJDMPN FABJDMP0 FABJDMP7 FABJDMP8 FABJDMP9 FABJDOPN FABJDPSN FABJDPS7 FABJDPS8 FABJDPS9 FABJDPUT FABJDREQ FABJDRQS FABJICDD FABJINT1 FABJINT2 FABJIPRC FABJLINK FABJMAIN FABJMAS1 FABJMDPN FABJMDP7 FABJMDP8 FABJMDP9 FABJMRGE FABJMSGC FABJNTFC FABJORCN FABJORC7 FABJORC8 FABJORC9 FABJPARM FABJPRM2 FABJRCHK FABJRCH7 FABJRCH8 FABJRCH9 FABJRDB7 FABJRDB8 FABJRDB9 FABJRPC0 FABJRPT0 FABJSAS2 FABJSTMD FABJTERM FABJTGEN FABJUIC1 FABJXLIM H1J0320J
| SC18761701 |
Fix information
Fixed component name
IMS HP IMAGE CO
Fixed component ID
5655K9600
Applicable component levels
R320 PSY UK06891
UP05/09/08 P F509
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"},"Platform":[{"code":"PF054","label":"z Systems"}],"Version":"320","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
14 December 2020