A fix is available
APAR status
Closed as new function.
Error description
This APAR provides a new enhancement for HPIC V4.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All IMS High Performance Image Copy for z/OS * * Version 4 Release 1 users ( FMID=H1J0410 ) * **************************************************************** * PROBLEM DESCRIPTION: This APAR provides: * * 1. Enhancement of symbolic parameters. * * 2. Enhancement of AREA= keyword. * * 3. A new optional keyword IGNORCAT=. * * 4. A new optional keyword RSTTYPE=. * * * * This APAR also includes some fixes of * * HPIC V4R1. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** This APAR provides: 1. Enhancement of symbolic parameters. 2. Enhancement of AREA= keyword. 3. A new optional keyword IGNORCAT=. 4. A new optional keyword RSTTYPE=. This APAR also includes fixes for following problems: 1. HPIC Recovery function terminates with ABEND S0C4 ( ABEND0C4 ) at IGG019B0 + X'1A' or HPIC Create Image Copy function terminates with RC=08 and message FABJ0148E ( MSGFABJ0148E ) when the input image copy is taken by DFSUDMT0 and the input image copy is not cataloged. 2. HPIC Recovery function terminates with ABEND U3916 ( ABENDU3916 ) when all of the following conditions are satisfied: - CAUNIT= or LOGUNIT= is specified in the GLOBAL statement. - DBRC is in NOCATDS status. - the UNIT name registered in RECON is not same of the UNIT name where the input data set resides. 3. HPIC Restart process terminates with ABEND U4067-10 ( ABENDU4067 ) when both STACK=* and TASKCTL=n are specified. 4. HPIC Image Copy function terminates with ABEND S0C4 ( ABEND0C4 ) at FABJDPSx (x=7,8,9,A) CSECT DPSNSTAE + X'84' when the ESTAE of FABJDPSx is processed.
Problem conclusion
Temporary fix
Comments
======================== = DOCUMENTATION CHANGE = ======================== IMS High Performance Image Copy for z/OS Version 4 Release 1 User's Guide SC18-9409 ( SC189409 ) should be changed as follows: 2.0 What is High Performance Image Copy? 2.6.4 Checkpoint Restart Add following sentences to this paragraph. | You can select the unit of restart with RSTTYPE= keyword. For | more information about the unit of restart, see 3.4.3.XX | RSTTYPE=. 3 Operating instructions 3.4.2.1 GLOBAL statements The GLOBAL statement contains the following keywords: | . IGNORCAT= | . RSTTYPE= 3.4.2.3 AREA= Modify the sentence as follows: | The AREA keyword specifies the name of areas in the database | to be processed. The AREA keyword is valid only for DEDB. | +---------------------------------------------------------+ | |AREA=areaname|(areaname1,areaname2,...)|RANGE(n1,n2) | | +---------------------------------------------------------+ | where: | areaname | is the name of an area in a database. areaname can be | specified with wild cards. Wild cards are the asterisk (*) and | the percent (%) symbol. An asterisk (*) represents from 0 to 8 | characters, whereas a percent (%) symbol represents a single | character. For example, AREA=area* matches area, area1, | area1234, and so on. If two or more asterisks (*) are | specified in sequence, only the first asterisk is recognized. | The specification by using wild cards cannot be used for the | RCV control statement. | | (areaname1,areaname2,...) | is the list of target areas in a database. Area names in the | list can also be specified with wild cards. 1 to 2048 areas | can be specified in the list. All areas specified in the list | must exist at run time. The list form cannot be used for the | RCV control statement. | | RANGE(n1,n2) | is the range of area numbers of the target areas | in a database. n1 and n2 are area numbers, which are | sequentially assigned decimal number to the areas in a | database.The value for n1 and n2 can be from 1 to 2048. n2 | must be equal to or greater than n1. At least one area must | exist in the range that is specified. The specification by | using the range cannot be used for the RCV control statement. | | This keyword does not have a default. | | This keyword can be used in the following control statements: | IC, AIC, CIC, ACIC, CRC, RCV | | Note: The specification of area names by using wild cards, in | the list form, or in the range format cannot be used for the | RCV control statement. | 3.4.3.XX IGNORCAT= | The IGNORCAT keyword specifies whether HPIC uses the catalog | information or not when HPIC dynamically allocates the input | data sets for the Recovery or the Create Image Copy function. | +---------------------------------------------------------+ | | IGNORCAT=Y|N | | +---------------------------------------------------------+ | where: | Y specifies that HPIC ignores DBRC CATDS status and | dynamically allocates the input data sets without catalog | information. HPIC uses the UNIT name registered in RECON or | that is specified by the ICEIN keyword CAUNIT=, ICUNIT= or | LOGUNIT=. | | N specifies that HPIC uses catalog information if DBRC is in | CATDS status. If DBRC is in NOCATDS status, HPIC uses the UNIT | name in the RECON record or that is specified by ICEIN | keyword. | This is the default. | | This keyword can be used in the following control statements: | GLOBAL | This keyword can be defined in the site default table. 3.4.3.58 RESTART= Modify the sentences as follows: In order for a restart to begin, ... | When a restart is initiated, all DBDSs or stacks which have | failed will be image copied again, including any jobs that | were restarted previously. DBDSs or stacks which have | successfully completed image copies, will be bypassed. | The unit of restart is specified by RSTTYPE= keyword. For more | information about the unit of restart, see 3.4.3.XX RSTTYPE=. This keyword is optional. | 3.4.3.XX RSTTYPE= | The RSTTYPE= keyword specifies the unit of restart for | checkpoint restart function. The specified value is used to | decide the DBDSs to be reprocessed in the next run. | This keyword is optional. | +---------------------------------------------------------+ | | RSTTYPE=1|2 | | +---------------------------------------------------------+ | where: | 1 specifies that image copies are reprocessed for: | - all databases which have failed. | - all groups which have failed. | - all stacks which have failed. | This is the default. | | 2 specifies that image copies are reprocessed for: | - in the case of DEDB, all AREAs which have failed. | - in the case of HALDB, all partitions which have failed. | - in the case of DL/I DB, all databases which have failed. | - all stacks which have failed. | | This keyword can be used in the following control statement: | GLOBAL | This keyword can be defined in the site default table. 4 Site Default Generation utility 4.2.2 Input The keywords for the Site Default Generation utility are as follows: | . IGNORCAT= | . RSTTYPE= 5.0 Using dynamic allocation 5.2.3.3 Specification syntax Add following sentences to this section. | Subparameter is provided to following symbolic parameters: | >>____ _&DBD__ _ _______________________ .____>< | |_&PART_| | | | |_&DDN__| |_(__n_ _____________ )_| | | |_, ________ _| | | | |_length_| | | | | | | _1_ | | |_(|___|_,length______)_| | |_n_| | | These symbolic parameters with subparameter return the | substring of name string that begins at the nth character and | is of length length. The name string means DBD name for &DBD | or PART name for &PART or DD/AREA name for &DDN. | The n is an integer that satisfies 1 <= n <= 8 for &DBD or | &DDN, and satisfies 1 <= n <= 7 for &PART. The length is an | integer that satisfies 1 <= length <= 8 for &DBD or &DDN, and | satisfies 1 <= length <= 7 for &PART. | | If you omit n, it means 1. If you omit length, the rest of | name string is returned. You cannot omit n and length at the | same time. 5.2.3.4 Symbolic parameters The symbolic parameters of HPIC are listed in Table 16. Table 16. Symbolic parameters Modify the table as follows: +------------------+-----------------------------------------+ | &DBD | DBD name | || &DBD(n,length) | When the organization of the database | | | is HALDB, the &DBD symbol is | | | interpreted as the master DBD name. | | || Use the &DBD() parameter if you want to| | || extract a part of a string in the DBD | | || name. | +------------------+-----------------------------------------+ | &PART | The partition name of the HALDB. | || &PART(n,length) || Use the &PART() parameter if you want | | || to extract a part of a string in the | | || partition name of the HALDB. | +------------------+-----------------------------------------+ | &DDN | DB data set ddname or AREA name | || &DDN(n,length) | When the organization of the database | | | is HALDB, the &DDN symbol is | | | interpreted as the DD name of the | | | partition database data set. | | || Use the &DDN() parameter if you want to| | || extract a part of a string in the DD | | || name or AREA name. | +------------------+-----------------------------------------+ : : : : +------------------------------------------------------------+ | Notes: | | : | || 4. n is the position of the first character that is to | || appear in the result, length is the length of the result. | +------------------------------------------------------------+ A.0 Appendix A. Return codes, abend codes, and messages A.3 Messages The message FABJ0122E is modified. | FABJ0122E SAME DATASET NAME FOR OUTPUT IC | Explanation: The same data set naming template was specified. The following messages are added. | FABJ0208E 1ST OPERAND VALUE OF THE SYMBOLIC VARIABLE | &$$$$(n,l) EXCEEDS $$$$ NAME LENGTH | | Explanation: The value exceeds length of the $$$$ name, which | is specified in the 1st operand of the symbolic variable | &$$$$(n,l). | System action: Program FABJMAIN stops processing with a | return code of 16. | Programmer response: Correct the error and rerun the job. | FABJ0209E NTH OPERAND VARIABLE IS REGARDED AS INCORRECT FOR | SYMBOLIC PARAMETER | | Explanation: An incorrect value was found in the subparameter | of a symbolic parameter. If an error was detected in 2nd | operand, the value exceeds a range of the specification, or | extracted strings were exceed the maximum length of the name. | System action: Program FABJMAIN stops processing with a | return code of 16. | Programmer response: Correct the error and rerun the job. | FABJ0210E DBD=dbdname,DD/AREA=ddname,DSNx | | Explanation: The information of same data set naming template | was specified. | System action: Program FABJMAIN stops processing with a | return code of 16. | Programmer response: Correct the error and rerun the job. | FABJ3970E MULTI TARGET SELECTION INTERNAL ERROR FOR: xxxxxxxx | | Explanation: An internal error has occurred in xxxxxxxx where | xxxxxxxx is an internal function name of HPIC. | System action: Program FABJMAIN issues a user error abend code | of 3970. | Programmer response: Contact IBM Software Support. | FABJ3971E SPECIFIED AREA IS NOT FOUND | | Explanation: An AREA keyword is specified, but no DEDB area | was found that matches specified value. | System action: Program FABJMAIN issues a user error abend code | of 3971. | Programmer response: Check the DBD and specify correct value | to AREA= keyword and rerun the job. | FABJ4142W RSTTYPE IS DIFFERENT FROM PREVIOUS RUN. | | Explanation: The specified value on RSTTYPE= keyword is | different from the previous run. | System Action: HPIC will take image copies of DBDSs which have | been decided to be reprocessed in previous run. The specified | value for current run is used to decide the DBDSs to be | reprocessed in the next run. | Programmer Response: None.
APAR Information
APAR number
PK72893
Reported component name
IMS HP IMAGE CO
Reported component ID
5655K9600
Reported release
410
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2008-09-26
Closed date
2008-09-30
Last modified date
2008-11-04
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK40317
Modules/Macros
FABJACQG FABJAPIM FABJASPM FABJATRC FABJBLKD FABJCMDB FABJCRC0 FABJCRC1 FABJCRC3 FABJCTCV FABJCZCV FABJDALC FABJDALO FABJDALS FABJDBAL FABJDBCM FABJDBC1 FABJDBDA FABJDBDN FABJDBD7 FABJDBD8 FABJDBD9 FABJDBF0 FABJDBLK FABJDBRA FABJDBRC FABJDBR7 FABJDBR8 FABJDBR9 FABJDCTL FABJDDIM FABJDEMP FABJDFCA FABJDFCN FABJDFC7 FABJDFC8 FABJDFC9 FABJDMPA FABJDMPN FABJDMP0 FABJDMP7 FABJDMP8 FABJDMP9 FABJDOPN FABJDPSA FABJDPSN FABJDPS7 FABJDPS8 FABJDPS9 FABJDPUT FABJDREQ FABJDRQS FABJDRSN FABJESSV FABJFCAI FABJFCCA FABJFCCM FABJFCCN FABJFCC7 FABJFCC8 FABJFCC9 FABJFCDA FABJFCDN FABJFCD7 FABJFCD8 FABJFCD9 FABJGDGB FABJGLRP FABJHSHI FABJHSHL FABJICDD FABJIDXA FABJIDXN FABJIDX7 FABJIDX8 FABJIDX9 FABJINT1 FABJINT2 FABJINT3 FABJIPRC FABJLINK FABJMAIN FABJMAS1 FABJMDPA FABJMDPN FABJMDP7 FABJMDP8 FABJMDP9 FABJMRGE FABJMSGC FABJMSUI FABJMSUL FABJNTFC FABJNTFI FABJNTFS FABJOFDD FABJOFL0 FABJOFL1 FABJORCA FABJORCN FABJORC7 FABJORC8 FABJORC9 FABJPARM FABJPRMD FABJPRM2 FABJPRM3 FABJRCHA FABJRCHK FABJRCH7 FABJRCH8 FABJRCH9 FABJRDBA FABJRDB7 FABJRDB8 FABJRDB9 FABJRETC FABJRETM FABJRFCA FABJRFCN FABJRFC7 FABJRFC8 FABJRFC9 FABJRPT0 FABJRPT1 FABJSAS1 FABJSAS2 FABJSTA FABJSTMD FABJSTMP FABJTERM FABJTGEN FABJTOI FABJUIC1 FABJWLDI FABJWLDL FABJXCR FABJXCRR FABJXHPC FABJXLIM H1J0410J
| SC18940900 |
Fix information
Fixed component name
IMS HP IMAGE CO
Fixed component ID
5655K9600
Applicable component levels
R410 PSY UK40317
UP08/10/03 P F810
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":"4.1.0","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
14 December 2020