Updates to IMS High Performance Image Copy V4.2 User's Guide (SC19-2756-01)

Product documentation


Abstract

Updates that apply to IMS High Performance Image Copy V4.2 User's Guide (SC19-2756-01).

Content

The most recent updates appear at the top of the list.



Update 16
Date of change: February 2014
Change description: Documentation change by APAR PI08979 (DB Sensor enhancement). By this APAR, additional data element is collected when you specify SENSOR_HOME=YES.
Topic:
> 3.0 Running IMS HP Image Copy
>> 3.5 IMS HP Image Copy control statements and keywords
>>> 3.5.2 ICEIN control statement keywords
>>>> 3.5.2.82 SENSOR_HOME keyword

Description of the SENSOR_HOME= keyword has been updated as follows:

The SENSOR_HOME keyword specifies whether to collect the data elements that are related to root segment distribution and store them in the Sensor Data repository of IMS Tools KB. This keyword is effective only when processing full-function databases.
The following data elements are collected when SENSOR_HOME=Y:
  • DB_NUM_ROOT_NOHOME
  • DB_PCT_NUM_ROOT_NOHOME
  • Start of changeDB_AVG_LEN_SYNONYM_CHAINEnd of change

This keyword is valid when SENSOR=Y is specified.

...

Start of change Restriction: If the key compression option of the Segment Edit/Compression exit routine is specified for the root segment, these data elements are not collected even when SENSOR_HOME=YES is specified.

The data elements that are additionally collected when SENSOR_HOME=YES are useful factors for determining the need of database reorganization. For more information about these data elements, see the topic "GLOBAL command keywords for FF Stand-alone DB Sensor" in the Database Sensor User's Guide. End of change



Update 15
Date of change: September 2013
Change description: User's Guide update.
Topic:
> 6.0 Troubleshooting
>> 6.1 Messages and codes
>>> 6.1.3 Messages

The explanation, system action, and user response sections of the following message have been updated as follows:

FABJ3930W TIMESTMP=LASTIC IS REQUIRED FOR TIMECHK=NO TIMECHK WAS IGNORED
Start of change
Explanation: TIMECHK=NO is specified, however, because TIMESTMP=LASTIC or TIMESTMP=LASTICALL is not specified, TIMECHK=NO is ignored. TIMECHK=NO must be specified with TIMESTMP=LASTIC or TIMESTMP=LASTICALL.
System action: Program FABJMAIN continues processing with TIMECHK=YES.
User response: If you want to rerun the job with TIMECHK=NO, specify TIMESTMP=LASTIC or TIMESTMP=LASTICALL and then rerun the job.
End of change




Update 14
Date of change: July 2013
Change description: User's Guide updates.
Topics: Changes apply to the following multiple topics


> 3.0 Running IMS HP Image Copy
>> 3.5 IMS HP Image Copy control statements and keywords
>>> 3.5.5 ICEFICO control statement

This topic has been updated as follows:

The ICEFICO is the optional input data set that contains the user-specified control statements that define the allocation attribute for the work data set of the FASTIC=(,DUMP) process.

Start of change
The FASTIC=(,DUMP) process uses the temporary data set as a work file during the DFSMSdss DUMP command process. IMS HP Image Copy dynamically allocates the data set. When either of the following conditions apply, the temporary data set cannot be used.
  • The temporary data set is allocated as a virtual input/output (VIO) data set by system definition.
  • The TEMPDSN class of RACF is active.

If either condition applies, use the ICEFICO data set and provide allocation information for the temporary data set in it.

VIO data sets and tape units cannot be used as the temporary output work data set for DFSMSdss. If you specify an ICEFICO DD, IMS HP Image Copy allocates a work data set for FASTIC=(,DUMP) by providing allocation information. This data is then deleted when the process is ended. When the ICEFICO data set is not provided, IMS HP Image Copy uses the OS temporary data set for the work data set.

The allocated space for the data set is one cylinder.

If you specify the data set name that is specified on the DSSTEMP= option parameter of the GLOBAL statement, IMS HP Image Copy allocates the ICEFICO DD dynamically and uses it. For the specification of DSSTEMP=, see “DSSTEMP keyword” on page 231.

Note: You do not need to use the ICEFICO data set, unless you have the RACF control class 'TEMPDSN' active. When you specify the data set name that is specified in DSSTEMP= of the option parameter for the GLOBAL statement, IMS HP Image Copy allocates ICEFICO DD dynamically, and uses it. For the specification of DSSTEMP=, see “DSSTEMP keyword” on page 2 31.
End of change
-----------------
>> 3.7 Using the Advanced Image Copy Services
>>> 3.7.4 Enabling the Advanced Image Copy Services

This topic has been updated as follows:

FASTIC=(,DUMP) processing

When the second parameter of the FASTIC= keyword specifies DUMP, the output image copy is a batch image copy or a compressed image copy. The DFSMSdss DUMP command is used to create the image copy. If Concurrent Copy is available, then logical copy processing is performed. Once logical copy processing is complete, serialization for the data set is released and access to the data set is resumed while the physical copy takes place. During the physical copy process, records are read by DFSMSdss, reformatted into IMS HP Image Copy format and then rewritten to the output image copy. If DBRC is active, the image copy is registered as a BATCH or CIC type image copy.

Start of change Note: The FASTIC=(,DUMP) process uses the temporary data set as a work file during DFSMSdss DUMP command process. IMS HP Image Copy dynamically allocates the data set. When either of the following conditions apply, the temporary data set cannot be used.
  • The temporary data set is allocated as a virtual input/output (VIO) data set by system definition.
  • The TEMPDSN class of RACF is active.

If either condition applies, use the ICEFICO data set and provide allocation information for the work data set in it. IMS HP Image Copy allocates the data set based on the allocation information, and deletes it before the Image Copy function ends. End of change



Update 13
Date of change: June 2013
Change description: Documentation changes by APAR PM90276. This APAR enhances the IMS HP Image Copy Site Default Generation utility to support IMS Compatible JCL.
Topics: Changes apply to the following multiple topics:

> 2.0 Configuring IMS HP Image Copy
>> 2.2 Customizing IMS HP Image Copy
>>> 2.2.4 Performance and tuning
>>>> 2.2.4.4 Tuning the image copy process run by IMS compatible JCL

The following update has been made:

Buffer tuning for image copy data set

The default value of the I/O buffer of the image copy data set is Start of changeBUFNO= 15 50. End of change

...

=================
> 4.0 Using IMS compatible JCL
>> 4.1 Taking image copies with IMS compatible JCL
>>> 4.1.1 Features for the Image Copy function with DFSUDMP0

The following entry has been added:

Table. Features for the Image Copy function (IMS compatible JCL)
(Table 35 in PDF and BookManager formats)
Feature Description
... ...
Start of changeSite Default Generation utility The Site Default Generation utility of IMS HP Image Copy sets default values for controlling IMS HP Image Copy jobs.End of change

-----------------
>>>> 4.1.2 Restrictions on the Image Copy function with DFSUDMP0

Restrictions on the Image Copy function
  • The Image Copy function supports only the following environments:
    • Batch image copy
    • Concurrent image copy
  • The Image Copy function does not support the functions that are provided the following IMS utilities:
    • Online image copy
    • HSSP image copy
    • Image copy 2
    • Restart function under UCF
  • Start of change The same data set group, DBDS, or area cannot be processed in the same job step. End of change
  • Start of changeA DBDS or area cannot be processed more than once in the same job step.End of change
  • The compressed image copy data set cannot be used in IMS Database Recovery utility as an input data set. Use either the Recovery function of IMS HP Image Copy or the IMS Database Recovery Facility.
  • Start of changeHASH Check for full-function databases cannot be activated from Concurrent Image Copy (CIC). End of change

-----------------
>>>> 4.1.2.4 Running the Image Copy function with DFSUDMP0 JCL

The Notes section has been updated as follows:

Notes:
  • If you use one of following functions with IMS compatible JCL, use the stand-alone DFSUDMP0.
    • Create a concurrent image copy (CIC)
    • Use High Performance Input/Output interface (HPIO)
    • Invoke the IMS HP Image Copy compression routine in zIIP processor
  • If you use the single step HASH Check option for HALDB, invoke DFSUDMP0 by using the IMS Region Controller program Start of change(DFSRRC00). End of change

-----------------
>>>>> 4.1.2.4.1 Invoking the Image Copy function through stand-alone DFSUDMP0

New paragraph has been added as follows:

Procedure
Step 1. ...
Step 2. Code the appropriate load module library in the STEPLIB DD statement.
    where:
    HPS.SHPSLMD0
    is the name of the library that contains the IMS HP Image Copy load modules.

    IMS.SDFSRESL
    is the name of the library that contains the IMS nucleus and required action modules.

    Start of changeIf you want to use the site default table to apply the control statement parameters that you defined in the table, specify the library that contains the site default table in the STEPLIB concatenations. Important: Ensure that you specify the site default table that is created for IMS compatible JCL jobs. For more information about creating a site default table and setting default values for IMS compatible JCL jobs, see "Setting default values for IMS Compatible JCL". End of change

-----------------
>>>>> 4.1.2.4.2 Invoking the Image Copy function through DFSRRC00

New paragraph has been added as follows:

Procedure
Step 1. ...
Step 2. Code the appropriate load module library in the STEPLIB DD statement.
    where:
    HPS.SHPSLMD0
    is the name of the library that contains the IMS HP Image Copy load modules.

    IMS.SDFSRESL
    is the name of the library that contains the IMS nucleus and required action modules.

    Start of changeIf you want to use the site default table to apply the control statement parameters that you defined in the table, specify the library that contains the site default table in the STEPLIB concatenations. Important: Ensure that you specify the site default table that is created for IMS compatible JCL jobs. For more information about creating a site default table and setting default values for IMS compatible JCL jobs, see "Setting default values for IMS Compatible JCL". End of change

-----------------
>> 4.2 Recovering databases with IMS compatible JCL
>>> 4.2.1 Features for the Recovery function with DFSURDB0

The following entry has been added:

Table. Features for the Recovery function (IMS compatible JCL)
(Table 42 in PDF and BookManager formats)
Feature Description
Start of changeSite Default Generation utility The Site Default Generation utility of IMS HP Image Copy sets default values for controlling IMS HP Image Copy jobs.End of change


=================
The following new chapter has been added in Part 4 Using IMS compatible JCL:

Start of change
x.0 Setting default values for IMS Compatible JCL

The IMS HP Image Copy Site Default Generation utility enables you to set your default values for the control statements that are applied when you run IMS HP Image Copy functions with IMS compatible JCL.

    x.1 Site Default Generation utility overview

    The Site Default Generation utility creates a user site default table that can be used when you run IMS HP Image Copy functions from IMS compatible JCL. All the control statement parameter values that are set in the user site default table are applied to IMS Compatible JCL jobs.

    The Site Default Generation utility analyzes the control statements and generates a source code for the site default table.

    To have the control statement parameters applied to IMS Compatible JCL jobs, the library that contains the site default table module (FABJGLI0) must be concatenated to the STEPLIB DD of IMS Compatible JCL. When IMS HP Image Copy finds FABJGLI0 in the STEPLIB libraries, IMS HP Image Copy loads and uses the table. The control statement parameter values that are set in the table are applied to IMS Compatible JCL jobs at run time.

    If you want to override the values that are set in the site default table, you can override them by specifying relevant values on the EXEC PARM statement or coding relevant control statements in the SYSIN data set of the IMS compatible JCL job.

    x.2 Specifying site default values

    To set the site default values for your environment, you must create a source code for the site default table by using the FABJTGEN program and assemble and link-edit the source code.

    Procedure
    1. Prepare JCL for the IMS HP Image Copy Site Default Generation utility (FABJTGEN).
      Sample JCL that runs the FABJTGEN program is provided in the SHPSSAMP data set that is provided by the product. The member name is FABJDFLX. Use the sample or prepare similar JCL of your own.
      To prepare JCL of your own, code the JCL statements as follows:
        a. Code the EXEC statement. The EXEC statement must be in the following form:
          // EXEC PGM=FABJTGEN,REGION= nM
        b. Supply the appropriate DD statements.
      For FABJTGEN DD statements, see "DD statements for the FABJTGEN program".

    2. In the ICEIN data set, code a TABLGEN statement and a GLOBAL statement.
      On the GLOBAL statement, code the control statement keywords and their parameters for which you want to change its default value.
      For descriptions of the control statements that you can specify for the Site Default Generation utility, see "Control statements for Site Default Generation utility".

      Important: To generate the site default table for IMS compatible JCL, you must provide a TABLEGEN statement in the ICEIN data set. If a TABLEGEN statement is not provided, the Site Default Generation utility generates a site default table for the FABJMAIN program.

    3. Run the Site Default Generation utility job step to create a source code of the site default table (FABJGLI0).
      The FABJDFLX sample JCL creates a source code, and then assembles and link-edits the source code. Therefore, if you use FABJDFLX, you can omit Step 4.

    4. Assemble and link the FABJGLI0 source code.
      To create the site default table module FABJGLI0, assemble and link the SYSPUNCH that is generated by FABJTGEN.
      For SYSIN of the assemble job step, specify the SYSPUNCH data set that is generated in the FABJTGEN.

      Both the module name and the entry name of the site default table must be FABJGLI0. Link-edit the site default table module with the following options:
      • AMODE=24
      • RMODE=24
      • REUSE

    5. Concatenate the load module library in which FABJGLI0 resides to the STEPLIB of IMS Compatible JCL.
      When IMS HP Image Copy finds FABJGLI0 in the STEPLIB libraries, IMS HP Image Copy loads and uses the table. The control statement parameter values that are set in the table are applied to IMS Compatible JCL jobs at run time.

    Example
    The following figure shows the FABJDFLX sample for creating the FABJGLI0 source code and assembling and link-editing the source code.


    //FABJDFLX JOB                                                          
    //*-------------------------------------------------------------------*
    //*  This JCL consists of following three steps                       *
    //*  1.  Generating source code of your site default definition.      *
    //*  2.  Assemble source code of your site default table.             *
    //*  3.  Link-Edit your site default table module.                    *
    //*                                                                   *
    //*-------------------------------------------------------------------*
    //*  Make the following global changes for this job:                  *
    //*                                                                   *
    //*    1. The JOB statement should be modified to suit your           *
    //*       environment.                                                *
    //*                                                                   *
    //*    2. Substitute your dsname where the site default module        *
    //*       is mad for the string "$site_def_lib".                      *
    //*       'CHANGE $site_def_lib your_site_def_lib_name ALL'           *
    //*                                                                   *
    //*    3. Substitute your dsname High Level Qualifier (HLQ) for IMS   *
    //*       HP Image Copy data sets for the string                      *
    //*       "$hpichlq".                                                 *
    //*       'CHANGE $hpichlq.SHPS your_hlq.SHPS ALL'                    *
    //*     6. Substitute your group-name or unit number for UNIT         *
    //*        parameters for the group-name "SYSALLDA", if applicable.   *
    //*        'CHANGE SYSALLDA your_sysda ALL'                           *
    //*-------------------------------------------------------------------*
    //*                                                                    
    //  SET HPICLIB=$hpichlq.SHPSLMD0                                      
    //  SET LIBNAME=$site_def_lib                                          
    //*                                                                   *
    //*-------------------------------------------------------------------*
    //*   FABGTGEN Process  - Generate Table Source for IMS Compatible JCL*
    //*-------------------------------------------------------------------*
    //TGEN     PROC                                                        
    //GEN      EXEC PGM=FABJTGEN,REGION=0M                                  
    //*                                                                    
    //STEPLIB   DD  DISP=SHR,                                              
    //             DSN=&HPICLIB                                            
    //*                                                                    
    //SYSPRINT  DD  SYSOUT=*                                                
    //SYSPUNCH  DD  DISP=(NEW,PASS,DELETE),                                
    //             DCB=(RECFM=FB,BLKSIZE=800),                              
    //             SPACE=(TRK,(1,1)),                                      
    //             DSN=&&SOURCE,                                            
    //             UNIT=SYSALLDA                                            
    //SYSUDUMP  DD  DUMMY                                                  
    //*                                                                    
    //ASM      EXEC PGM=ASMA90,COND=(4,LT,GEN),                            
    //           PARM='OBJECT,NODECK,LIST,XREF(SHORT)'                      
    //SYSLIB    DD  DISP=SHR,                                              
    //             DSN=SYS1.MACLIB                                          
    //SYSLIN    DD  DISP=(,PASS),                                          
    //             SPACE=(CYL,(5,5,0)),                                    
    //             DCB=(BLKSIZE=400),                                      
    //             DSN=&&OBJECT,                                            
    //             UNIT=SYSALLDA                                            
    //SYSUT1    DD  UNIT=SYSALLDA,                                          
    //             DISP=(,DELETE),SPACE=(CYL,(10,5))                        
    //SYSPUNCH  DD  DUMMY                                                  
    //SYSPRINT  DD  SYSOUT=*                                                
    //SYSIN     DD  DISP=(OLD,DELETE,DELETE),                              
    //             DSN=&&SOURCE                                            
    //*                                                                    
    //L       EXEC PGM=IEWL,COND=(4,LT,ASM),REGION=4096K,                  
    //           PARM='LIST,REFR,REUS,AMODE=24,RMODE=24'                    
    //SYSPRINT DD SYSOUT=*                                                  
    //SYSLIN   DD DSN=&OBJECT,                                              
    //           DISP=(OLD,DELETE,DELETE)                                  
    //*                                                                    
    //        PEND                                                          
    //*                                                                    
    //GO      EXEC TGEN                                                    
    //*                                                                    
    //GEN.ICEIN DD *                                                        
    *-------------------------------------------*                          
    *       YOUR SITE DEFAULT DEFINITION        *                          
    *-------------------------------------------*                          
      TABLEGEN   TYPE=IMSJCL                                                
      GLOBAL     COMP=Y,                                                    
                 COMPRTN=FABJCMP2,                                          
                 HDPC=Y,                                                    
                 DEDBPC=S,                                                  
    *                                                                      
                 HPIO=Y,                                                    
                 COMPMODE=COND,                                            
    *                                                                      
                 DBBUF=120,                                                
                 DSBUF=20,                                                  
                 ICBUF=20                                                  
    /*                                                                      
    //L.SYSLMOD DD DISP=SHR,                                                
    //            DSN=&LIBNAME(FABJGLI0)                                    
    //*                                                                    
    //                                                                      



    x.3 DD statements for the FABJTGEN program

    The Site Default Generation utility requires DD statements to identify the source of input and the placement of output information.

    The following table lists the DD statements you can use for the FABJTGEN JCL.

    DD name Use Format Required or optional
    STEPLIB Input PDS Optional
    ICEIN Input LRECL=80 Required
    SYSPUNCH Output LRECL=80 Required
    SYSPRINT Output LRECL=133 Required
    SYSABEND or
    SYSUDUMP
    Output LRECL=133 Optional

    STEPLIB DD
      This statement points to the load module library data set that contains the IMS HP Image Copy load modules.

    ICEIN DD
      This statement specifies the required input control statement data set. The data set can reside on tape or a direct-access volume, or it can be routed through the input stream (DD * or DD DATA).

    SYSPUNCH DD
      This statement specifies the required output data set. The data set contains assembler source code produced by FABJTGEN. The following DCB parameters must be specified:
      • RECFM=F or FB
      • LRECL=80
      • BLKSIZE=80 or multiple of 80

    SYSPRINT DD
      This statement defines the output message data set. The data set can reside on tape, a direct-access volume, or a printer; or it can be routed through the output stream (SYSOUT). SYSPRINT can be blocked but must be a multiple of 133.

    SYSABEND DD or SYSUDUMP DD
      This statement defines the dump data set. These DD statements are optional. If both statements are present, the last occurrence is used for the dump.

    x.4 Control statements for the Site Default Generation utility

    The ICEIN data set contains your description of the site default values. ICEIN is a mandatory input data set.

    This control data set usually resides in the input stream. However, it can also be defined as a member of a sequentially partitioned data set. The length of the ICEIN data set must be fixed at 80 bytes. BLKSIZE, if specified, must be a multiple of 80.

    In the ICEIN data set, you must code the following two statements:
    • TABLEGEN statement
    • GLOBAL statement

      x.4.1 TABLEGEN statement

      TABLEGEN statement defines the type of the site default table. TABLEGEN statement must be placed as the first statement of the ICEIN data set.

      TABLEGEN statement is a required statement. Only one TABLEGEN statement can be specified.

      Important: If you do not provide a TABLEGEN statement in the ICEIN data set, the Site Default Generation utility generates a site default table for the FABJMAIN program. If you want to generate a site default table for IMS compatible JCL, you must code the TABLEGEN statement.

      Specify the TABLEGEN statement as follows:
        TABLEGEN TYPE=IMSJCL

      x.4.2 GLOBAL statement

      GLOBAL statement defines the site default values that are applied to IMS HP Image Copy processes when the processes are invoked by IMS Compatible JCL.

      GLOBAL statement is a required statement. Only one GLOBAL statement can be specified.

      The following control keywords can be specified for the GLOBAL statement:
      • COMP
      • COMPMODE
      • COMPRTN
      • DBBUF
      • DEDBPC
      • DSBUF
      • HDPC
      • HPIO
      • ICBUF

      Control statement syntax
      You must follow the following coding conventions to code GLOBAL statement keywords for FABJTGEN:
      • A GLOBAL statement consists of a control statement name (GLOBAL) and one or more process option parameters. An option parameter consists of a keyword and an operand. The syntax is:
            Control-Statement blank option-parameter,option-parameter,...

          For example, ICEIN data set can be coded as follows:
            //ICEIN    DD *
              TABLEGEN TYPE=IMSJCL
            *
              GLOBAL   HPIO=Y,
                       COMP=Y,COMPRTN=FABJCMP2
            /*
      • Only one GLOBAL statement can be specified in the ICEIN data set.
      • GLOBAL statement and its option parameters must be coded between columns 1 and 72.
      • Control statement name (GLOBAL) must be separated from the first option parameter by one or more blanks.
      • Control statement name (GLOBAL) and the first option parameter must be written on the same line.
      • When more than one option parameter is specified, they must be separated by a comma (,) and no blanks are allowed between these option parameters.
      • Option parameters can be continued to the next control statement line. On the continued line, option parameters can start from column 2.
      • The GLOBAL statement must start with a control statement name (GLOBAL) and end with a comma after the option parameter.
      • An option parameter is constructed with a keyword and its operand associated value separated by an equal (’=’) sign. No blanks are allowed before or after the equal (’=’) sign.
      • If two or more values are needed to specify the keyword, the set of values must begin with a parenthesis ’(’ and end with a parenthesis ’)’. The values must be separated by a comma.
      • A comment must begin with an asterisk (’*’) in column 1. Or comments can follow the last option parameter on each control statement line separated by at least one blank.
      • GLOBAL statement can contain upper-case alphabetic characters, numeric characters, and the following special characters:
      • asterisk *
      • comma ,
      • equal sign =
      • parenthesis ( )
      • slash /
      COMP keyword
        The COMP keyword specifies whether the Image Copy function is to compress the output image copy data.

        This keyword sets the default value for column 39 of SYSIN data set. The system default value is COMP=N, which means output image copy data is not compressed.

        Related keywords
        • COMPMODE keyword
        • COMPRTN keyword

        Format
          COMP=Y| N

          Y
            Specifies that the output image copy data is to be compressed by the Image Copy function.
          N
            Specifies that the output image copy data is not to be compressed by the Image Copy function.

      COMPMODE keyword
        The COMPMODE keyword controls the priority of the compression methods for compressing the output image copy data sets. This keyword is effective only when the IDRC feature is activated by the JCL or the system.

        This keyword sets the default value for the COMPMODE= keyword in EXEC PARM. The system default value is COMPMODE=N, which means when the compression routine is not FABJCMP2, IMS HP Image Copy automatically turns off the software compression and uses IDRC.

        The compression methods are determined based on the specifications of the COMP keyword and the COMPRTN keyword. The following table summarizes the IMS HP Image Copy compression features that are applied by each combination of the COMP, COMPRTN, and COMPMODE specifications.

        COMP= COMPRTN= COMPMODE= Applied compression feature
        COMP=N N/A N IDRC compression
        COMP=Y FABJCMP2 N Software compression and IDRC compression
        COMP=Y FABJCMP1, FABJCMP3, or FABJCMP4 N IDRC compression
        COMP=N N/A COND IDRC compression
        COMP=Y FABJCMP2 COND Software compression and IDRC compression
        COMP=Y FABJCMP1, FABJCMP3, or FABJCMP4 COND Software compression

        Whether the IDRC feature is activated depends on the z/OS system definition and on the TRTCH subparameter of the DCB parameter in the output image copy data set DD statement.

        When the IDRC feature is activated for the primary image copy data set, the compression routine is ignored for the other image copies that are taken from the same database data set.

        Related keywords
        • COMP keyword
        • COMPRTN keyword

        Format
          COMPMODE=COND| N

          COND
            When the IDRC feature is active and the compression routine is not FABJCMP2, IMS HP Image Copy automatically turns off IDRC and uses the software compression.
          N
            When the IDRC feature is active and the compression routine is not FABJCMP2, IMS HP Image Copy automatically turns off the software compression and uses IDRC.

      COMPRTN keyword
        The COMPRTN keyword specifies the name of the compression routine that the Image Copy function invokes to compress the output image copy data.

        This keyword can be specified when COMP=Y is specified.

        This keyword sets the default value for column 40 of SYSIN data set. The system default value is COMPRTN=FABJCMP1, which means the Image Copy function uses FABJCMP1 to compress the output image copy data.

        Related keywords
        • COMP keyword
        • COMPMODE keyword

        Format
          COMPRTN= routine

          routine
            Is the name of the compression routine. IMS HP Image Copy provides four compression exit routines: FABJCMP1, FABJCMP2, FABJCMP3, and FABJCMP4.
            Specify one of these compression routines to be called by the Image Copy function. If the COMP=Y keyword is specified without the COMPRTN= keyword, FABJCMP1 is used as the default. The same compression routine is automatically called by the Recovery function to decompress the compressed data. IMS HP Image Copy provides the compression routine shown in the following table.

            Compression routine Compression algorithm
            FABJCMP1 Runs repeated character compression. Free space can also be compressed.
            FABJCMP2 Runs only free space compression. Segmented data is not compressed.
            FABJCMP3 Runs repeating-characters compression of the z/OS program compression method. Free space might also be compressed.
            FABJCMP4 Runs the repeating-characters compression of the z/OS program compression method. This routine runs the block compression, which does not distinguish between the data portion, free space, and unused space in the database.
        Considerations
        • When the IDRC feature is installed and is active on the native tape drive, software compression is suppressed for the IC1, IC2, or both output data sets except when FABJCMP2 is used.
        • If you want to use the software compression for the tape device on which the IDRC feature is active, specify the COMPMODE keyword to deactivate IDRC.

      DBBUF keyword
        The DBBUF keyword specifies the number of buffers to be used to access the database data set groups or areas.

        This keyword sets the default value for the BUFND parameter (for OSAM data sets) or the AMP parameter (for VSAM data sets) that you specify on the datain DD statement. With system's default, IMS HP Image Copy uses the optimized value based on the record size or the CI size of the database data sets.

        Format
          DBBUF= nnnnn

          nnnnn
            Is the left-aligned number of buffers used to access the database data set groups or areas.

        If you specify HPIO=Y, the DBBUF= keyword is ignored for OSAM and VSAM ESDS data sets of the database.

      DEDBPC keyword
        The DEDBPC keyword specifies whether the Image Copy function invokes the HASH Check option of the DEDB Pointer Checker utility.

        This keyword is effective when the executing function is batch image copy or concurrent image copy.

        This keyword sets the default value for columns 48 and 49 of SYSIN data set. The system default value is DEDBPC=N, which means DEDB HASH pointer check is not invoked.

        Format
          DEDBPC=Y|S| N

          Y
            Invokes the DEDB HASH pointer check during the execution of the Image Copy function.
          S
            Invokes the DEDB HASH pointer check and evaluates SSP pointers in the DEDB during the execution of the Image Copy function.
          N
            Does not invoke the DEDB HASH pointer check during the execution of the Image Copy function.

      DSBUF keyword
        The DSBUF keyword specifies how many buffers are to be used in getting access to the input data set in the Recovery function.

        This keyword sets the default value for the BUFND parameter that you specify on the DD statements for the input image copy data set, DFSULOG, and DFSUCUM. The system default value is DSBUF=50, which means 50 buffers are used.

        Format
          DSBUF= nnnn

          nnnnn
            Is the left-aligned number of buffers used in getting access to the input image copy data set, the log data set, and the change accumulation data set.

      HDPC keyword
        The HDPC keyword specifies whether the Image Copy function invokes pointer checking of the HD Pointer Checker utility.

        This keyword is valid when the executing function is batch image copy.

        This keyword sets the default value for column 48 of SYSIN data set. The system default value is HDPC=N, which means HD Pointer Checker is not invoked.

        Format
          HDPC=Y| N

          Y
            Invokes the HD Pointer Checker HASH pointer check during the execution of the Image Copy function.
            If HDPC=Y is specified for a database that is not supported by the HD Pointer Checker HASH Check function, an image copy of the database is created, but pointer checking is not done.
          N
            Does not invoke the HD Pointer Checker HASH pointer check during the execution of the Image Copy function. N is the default.


        Consideration: HD Pointer Checker HASH pointer check is not supported in the following cases:
        • Concurrent Image Copy process
        • Target database is a HALDB and IMS HP Image Copy is scheduled by PGM=DFSRRC00.

      HPIO keyword
        The HPIO keyword specifies whether to use the HP Input/Output interface to access the input database data sets in the Image Copy function.
        This keyword sets the default value for the HPIO= keyword in EXEC PARM. The system default value is HPIO=N, which means the HP Input/Output interface is not used.

        Format
          HPIO=Y| N

          Y
            Specifies that the HP Input/Output methods are to be used.

            HP Input/Output method is a high performance I/O method that is used by IMS Tools products to access input database data sets. This method can be used when the database data sets are OSAM or VSAM ESDS data sets.

            This keyword is ignored for when either or both of the following conditions apply:
            • IMS HP Image Copy is run by EXEC PGM=DFSRRC00
            • The input database data set is a VSAM KSDS data set.

            When you specify HPIO=Y, APF-authorize all load libraries of IMS HP Image Copy and the site default module.
          N
            Specifies that standard management methods are used to read database data sets and area data sets.

      ICBUF keyword
        The ICBUF keyword specifies the number of buffers to be used to access the output image copy data set.

        This keyword sets the default value for the BUFND parameter that you specify on the dataout DD statements. The system default value is ICBUF=50, which means 50 buffers are used.

        Format
          ICBUF= nnnn

          nnnnn
            Is the left-aligned number of buffers used to access the output image copy data set.
End of change

=================
> 6.0 Troubleshooting
>> 6.1 Messages and codes
>>> 6.1.2 Abend codes
>>>> 6.1.2.5 IMS Tools Online System Interface abend codes

Description has been updated as follows:

This topic describes the abend codes that are issued by the IMS™ Tools Online System Interface.

Start of changeDuring IMS Tools Online System Interface processing in FABJTOI, FABJSTA, and FABJTOI2, some error messages are written to DFSPRINT or SYSPRINT. If the errors are severe, IMS HP Image Copy abends with U4000 RSN=xx. The two-digit number shown as RSN= xx corresponds the last two digits of FABJ46 xxE messages. For example, if RSN=04, see the explanation of FABJ4604E message.

If IMS HP Image Copy abends with U3710, the error is in one of the TOSI API functions. See the Tools Base IMS Tools Common Services User's Guide and look up the function (FUNC), RC (return code), and RSN (reason code) that are indicated in the error messages. For the explanation of the messages, see the Tools Base IMS Tools Common Services User's Guide . End of change

-----------------
>>> 6.1.3 Messages

The message texts have been updated as follows:
  • FABJ0115E MORE THAN ONE ssssss STATEMENT SPECIFIED Start of change ssssss : STATEMENT NAME (GLOBAL,RCV) End of change
  • FABJ4602E DBRC QUERY FOR Start of changeDBD/PART/AREA=ccccEnd of change FAILED. FABDAI RSN=nnnn. ALL IC FOR THIS Start of changeDBD/PART/AREAEnd of change NOT PERFORM
  • FABJ4605E TOSI NOT ACTIVE ON IMS=cccc. IC NOT PERFORMING FOR Start of changeDBD/PART/AREA=ccccEnd of change
  • FABJ4606E /DBR COMMAND FAILED FOR Start of changeDBD/PART/AREA=ccccEnd of change ON IMS=cccc RC=nnnn RSN=nnnn. Start of change IC NOT PERFORM FOR THIS DBD/PART/AREA End of change
  • FABJ4613E /STA PROCESS FOR Start of changeDBD/PART/AREA=ccccEnd of change FAILED. DBIM BLOCK NOT FOUND. IC PROCESS ABEND U4000 RSN=13
  • FABJ4614E Start of changeDBD/PART/AREA=ccccccccEnd of change HAS NOT STOPPED WITHIN A TIME LIMIT.
          IMAGE COPY FOR THIS Start of changeDBD/PART/AREA End of change IS NOT PROCESSED.
  • FABJ4616I [/DBR | /DBD] GLOBAL COMMAND FAILED FOR Start of changeDBD/PART/AREA=ccccEnd of change ON IMS=cccc RC=nnnn Start of changeRSN=nnnn.End of change
  • FABJ4619I [/DBR|/DBD|DB QUIESCE] COMMAND RETRY FOR Start of changeDBD/PART/AREA=resourceEnd of change

---
The following new messages have been added:

Start of change
FABJ0238E TOIXCFGR KEYWORD NOT SUPPLIED.

Explanation: TOIAUTO=Y, TOIAUTO=S, or TOIAUTO_Q=Y is requested but TOIXCFGR keyword is not coded in the GLOBAL statement.
System action: IMS HP Image Copy stops processing with a return code of 8; no image copies are created.
User response: Supply the TOIXCFGR= keyword on the GLOBAL statement and rerun the job.
End of change
---
Start of change
FABJ0239E TABLEGEN STATEMENT MUST BE SPECIFIED FIRST

Explanation: The TABLEGEN statement, if specified, must be specified as the first statement in the ICEIN data set for the IMS HP Image Copy Site Default Generation utility (FABJTGEN).
System action: Program FABJTGEN stops processing with a return code of 16.
User response: Review the ICEIN data set and correct the position of the TABLEGEN statement.
End of change
---
Start of change
FABJ240E MORE THAN ONE ssssss STATEMENT SPECIFIED

Explanation: More than one ssssssss statement found in the ICEIN control card for the Site Default Generation utility. Only one ssssssss statement can exist in one ICEIN control statement. 
System action: Program FABJTGEN stops processing with a return code of 16.
User response: Correct the error and rerun the job.
End of change
---
Start of change
FABJ0303E THE TYPE OF THE SITE DEFAULT TABLE IS INCORRECT.

Explanation: The site default table was loaded, but the type of the site default table is incorrect. Either the site default table for IMS compatible JCL was loaded in an FABJMAIN job or the site default table for FABJMAIN was loaded in an IMS compatible JCL job.
System action: IMS HP Image Copy stops processing with a return code of 16.
User response: Re-create the site default table. While re-creating the site default table, ensure that the module name and the entry name of the site default table are specified correctly:
  • To create a site default table for FABJMAIN, specify FABJGLB0.
  • To create a site default table for IMS compatible JCL, specify FABJGLI0.
After you re-create the site default table, rerun the job.
End of change
---
Start of change
FABJ0304I THE HPIO INTERFACE IS USED.

Explanation: IMS HP Image Copy uses the High Performance Input/Output (HPIO) interface to access the databases that use OSAM data sets or VSAM ESDS data sets.
System action: IMS HP Image Copy continues processing.
User response: None.
End of change
---
Start of change
FABJ3710E TOSI API function FAILED WITH RC= rrrrrrrr and RSN= ssssssss . HPIC ABEND REASON CODE IS reason_code .

Explanation: An error occurred in the indicated TOSI API function. The HPIC ABEND REASON CODE provides additional information:
  • If the code is 01, the TOSI API error occurred before issuing the /DBR,/DBD,UPDATE START(QUIESCE) command. The resources are not stopped or quiesced.
  • If the code is 02, the TOSI API error occurred after issuing the /DBR,/DBD,UPDATE START(QUIESCE) command. Some resource must be activated manually.
System action: IMS HP Image Copy abends. If the HPIC ABEND REASON CODE is 01, no image copies are created.
User response: If the HPIC ABEND REASON CODE is 02, locate FABJ4623E messages. The FABJ4623E messages contain the resource names for which you must issue IMS commands. If no FABJ4623E messages are issued, then you do not need to issue IMS commands manually.
For each resource identified by the FABJ4623E messages, issue the following command:
  • If TOIAUTO=Y, restart the resource by manually issuing the /START command.
  • If TOIAUTO_Q=Y, release the quiesce of the resource by manually issuing the UPDATE STOP(QUIESCE) command.
To resolve the problem, locate the error message issued by the IMS Tools Online System Interface.
  • If the indicated TOSI API function is INIT, locate the FOI511E message.
  • If the indicated TOSI API function is CONNECT, locate the FOI524E message.
  • If the indicated TOSI API function is DISCONNECT, locate the FOI571E message.
  • If the indicated TOSI API function is TERM, locate FOI581W message.
Follow the User Response of the message in the Tools Base IMS Tools Common Services User's Guide and correct the error. If the problem persists, contact IBM Software Support.
End of change
---
Start of change
FABJ4620I NO IMS SUBSYSTEM IS AVAILABLE. IMS COMMANDS ARE NOT ISSUED.

Explanation: Because no IMS subsystem is available, IMS HP Image Copy did not issue IMS commands.
System action: IMS HP Image Copy continues processing without issuing IMS commands.
User response: If no active IMS subsystems exist, you can ignore this message. If this message was issued even though one or more active IMS subsystems exist, complete the following steps:
  • Ensure that the correct TOSI XCF group is specified on the TOIXCFGR= keyword.
  • Locate the FOI524E message (IMS Tools Online System Interface message) and ensure that the IMS subsystem and the TOSI server are active.
End of change
---
Start of change
FABJ4621E THE command COMMAND FAILED BECAUSE NO IMS SUBSYSTEM IS ACTIVE. HPIC ERROR REASON CODE IS 01.

Explanation: If the HPIC ERROR REASON CODE is 01, this message indicates that the indicated IMS command could not be issued because the IMS subsystem was shutting down. Either the /STA command, the /STA GLOBAL command, or the UPDATE STOP(QUIESCE) command must be issued manually for some databases. Such databases are reported in the accompanying FABJ4623E messages.
System action: IMS HP Image Copy ends with a return code of 4.
User response: Locate the FABJ4623E messages and identify the resources and the required commands. Activate the IMS subsystem, and issue the required command for each resource.
End of change
---
Start of change
FABJ4622E IMAGE COPIES OF DBD/PART/AREA= dddddddd ARE NOT CREATED.

Explanation: Due to TOSI API function errors or IMS command errors, image copies of the indicated resource are not created.
System action: IMS HP Image Copy continues without creating image copies of the indicated resource.
User response: Locate the preceding error messages, correct the error and rerun the job.
End of change
---
Start of change
FABJ4623E ISSUE THE command COMMAND FOR DBD/PART/AREA= resource

Explanation: Issue the indicated command against the indicated resource.
System action: The action taken is dependent upon the accompanying error message.
User response: When the IMS HP Image Copy job ends, issue the indicated command for the indicated resource.
End of change
---
The following messages have been updated as follows:

Start of change FABJ0137I SITE DEFAULT TABLE IS USED [AS GLOBAL STATEMENT] End of change

Start of changeExplanation: The site default values that are defined in the site default table are applied to this run. If EXEC PGM=FABPMAIN, the default values are applied as the GLOBAL statement values. End of change
Start of changeSystem action: IMS HP Image Copy continues processing. End of change
User response: None.

---
Start of change FABJ4604E TOSI SERVER LIST IS NOT FOUND. TOSI CONNECT PROCESS INTERNAL LOGIC ERROR. IC PROCESS ABEND U4000 RSN=04 End of change

Start of changeExplanation: TOSI server list is not found. This message indicates that an internal logic error occurred in the TOSI API client connect function. End of change
System action: IMS HP Image Copy abends with U4000 RSN=04.
User response: Contact IBM Software Support.

---
Start of change FABJ4607E /STA COMMAND FAILED FOR DBD/PART/AREA= cccc ON IMS= cccc RC= nnnn RSN= nnnn . ISSUE /STA MANUALLY End of change

Explanation: An attempt to run the /START command for the database or the area has failed. Start of change If IMS=*NO-IMS is displayed in the message, IMS™ HP Image Copy did not issue the /START command because no active IMS was found. End of change
System action: The database or the area remains offline, and IMS HP Image Copy ends with a return code of 4.
User response: Manually issue the /START command for the database or the area. If the problem persists, contact IBM Software Support and provide the return code and the reason code shown in the message.

---
Start of change FABJ4611E TOSI API function FAILED TO SEND THE command COMMAND TO DBD/PART/AREA= dddddddd ON IMS= iiii .
RC= rrrrrrrr , RSN= ssssssss . HPIC ERROR REASON CODE IS xx .

Explanation: An error occurred in the indicated TOSI API function. The TOSI API function could not send the indicated command to the indicated resource. command is one of the following commands:
  • /STA
  • /STA GLOBAL
  • /DBD GLOBAL NOFEOV
  • /DBR GLOBAL NOFEOV
  • /DBD
  • /DBR
  • UPD DB START(QUIESCE)
  • UPD DB STOP(QUIESCE)
System action: If the HPIC ERROR REASON CODE is 01, IMS HP Image Copy ends with a return code of 8; no image copies are created for the indicated resource. If the HPIC ERROR REASON CODE is 02, IMS HP Image Copy ends with a return code of 4.
User response: Because certain IMS commands were not issued, databases, partitions, and areas are not restarted or are quiesced. To recover the state of the resources, complete either of the following steps:
  • If the HPIC ERROR REASON CODE is 01, locate the FABJ4622E messages and follow the User Response of FABJ4622E.
  • If the HPIC ERROR REASON CODE is 02, some resources require the /STA command or the UPDATE STOP(QUIESCE) command. Locate the accompanying FABJ4623E messages, identify the required commands, and issue the commands.
To resolve the problem, locate the error message issued by the IMS Tools Online System Interface.
  • If the indicated TOSI API function is REQUEST, locate the FOI532E and FOI533I messsages.
  • If the indicated TOSI API function is RESPONSE, locate FOI541W message.
Follow the User Response of the message in the Tools Base IMS Tools Common Services User's Guide and correct the error. If the problem persists, contact IBM Software Support.
End of change
---
Start of change FABJ4617E UPDATE DB START(QUIESCE) COMMAND FAILED FOR DBD/PART/AREA= dddddddd [RC= rc1 , RSN= rsn1 ]
[IMSID= iiii CC= cc CCTEXT=' tttttttttttttttttttttttttttttttttttttttttttttt ' ]
[TOSI RC= rc2 , RSN= rsn2 ] End of change

Explanation: Database quiesce process that was called by the UPDATE DB or AREA START(QUIESCE) command failed. The database or the area is not quiesced. Start of changeCC shows the completion code from IMS, and CCTEXT briefly explains the meaning of the nonzero completion code. If TOSI return code and reason code are displayed in the message, the message indicates that the error occurred in one of the TOSI API functions. End of change
System action: IMS HP Image Copy does not create image copies for this database or area.
Start of changeUser response: See the topic "UPDATE DB command" or "UPDATE AREA command" in IMS Commands and identify the cause of the error from the completion code (CC) and the completion code text (CCTEXT) that are shown in this message. Correct the error and rerun the job.
If TOSI return code and reason code are displayed in this message, contact IBM Software Support. End of change

---
Start of change FABJ4618E UPDATE DB STOP(QUIESCE) COMMAND FAILED FOR DBD/PART/AREA= dddddddd [RC= rrrrrrrr , RSN= ssssssss ]
[IMSID= iiii CC= cc CCTEXT=' tttttttttttttttttttttttttttttttttttttttttttttt ' ]
[TOSI RC=0000008, RSN=00000001] End of change

Explanation: Database quiesce process that was called by the UPDATE DB or AREA STOP(QUIESCE) command failed. The database or the area remains quiesced. Start of changeCC shows the completion code from IMS, and CCTEXT briefly explains the meaning of the nonzero completion code. If TOSI return code and reason code are displayed in the message, the message indicates that the error occurred in one of the TOSI API functions. End of change
System action: IMS HP Image Copy stops processing with a return code of 4.
Start of changeUser response: See the topic "UPDATE DB command" in IMS Commands and identify the cause of the error from the completion code (CC) and the completion code text (CCTEXT) that are shown in this message. Correct the error and rerun the job. If the indicated resource is still quiesced, use IMS SPOC or BATCH SPOC to release the quiesce.
If TOSI return code and reason code are displayed in this message, contact IBM Software Support. End of change

---
The following messages have been deleted:
  • FABJ4601E TOIXCFGR KEYWORD NOT SUPPLIED. IC PROCESS ABEND U4000 RSN=01
  • FABJ4612E TOSI API RESPONSE FAILED FOR DBD/AREA=cccc RC=nnnn RSN=nnnn. IC NOT PERFORM FOR THIS DBD/AREA




Update 12
Date of change: May 2013
Change description: Documentation changes by APAR PM84891. This APAR adds a new option. By applying this APAR, you can use the FALLBACK keyword to request switching from the batch image copy process to the concurrent image copy process when exclusive authorization is not granted.
Topics: Changes apply to the following multiple topics.

> 3.0 Running IMS HP Image Copy
>> 3.5 IMS HP Image Copy control statements and keywords
>>> 3.5.2 ICEIN control statement keywords
>>>> 3.5.2.1 Summary of ICEIN control statement keywords

FALLBACK keyword has been added to the table:

Table. Summary of ICEIN keywords
(Table 24 in PDF and BookManager formats)
Keyword Description
... ...
Start of changeFALLBACK The FALLBACK keyword internally switches the batch image copy process to the concurrent image copy process when exclusive authorization of the input database is not granted during the batch image copy process.End of change
... ...

-----------------
>>>> 3.5.2.2 Relation of keywords to ICEIN control statements

FALLBACK keyword has been added to the table:

Table. Relation of keywords to ICEIN control statements
(Table 25 in PDF and BookManager formats)
Keyword GLOBAL GROUP IC/AIC CIC/ACIC RCV CRC Site default option Related keyword
... ...
Start of changeFALLBACK O - - - - - O
  • BYPDBAUTH keyword
  • CIC_KSDS keyword
  • DBRC keyword
  • TOIAUTO keyword
  • TOIAUTO_Q keywordEnd of change
... ...
-----------------
>>> 3.5.2 ICEIN control statement keywords

The following new topic has been added:

Start of change
FALLBACK keyword

The FALLBACK keyword internally switches the batch image copy process to the concurrent image copy process when exclusive authorization of the input database is not granted during the batch image copy process.

This keyword is effective for the Image Copy function when the requested process is batch image copy and the process runs with DBRC=Y.

Statements that support this keyword
    GLOBAL statement

Site default option
    Supported

Related keywords
  • BYPDBAUTH keyword
  • CIC_KSDS keyword
  • DBRC keyword
  • TOIAUTO keyword
  • TOIAUTO_Q keyword

Related ICEIN statements
  • IC statement
  • AIC statement
  • GROUP statement with FUNC=IC or FUNC=AIC

Format

           FALLBACK=Y|N

Y
    Requests to switch the batch image copy process to the concurrent image copy process when exclusive authorization of the input database is not granted during the batch image copy process.

N
    Does not request the FALLBACK option. If exclusive authorization is not granted during the batch image copy process, the IMS HP Image Copy job works as follows:
    • For full-function databases and HALDBs, IMS HP Image Copy ends abnormally.
    • For Fast Path databases, IMS HP Image Copy skips the area and continues with the next area. The job step return code is set to 8.

Default value
    FALLBACK=N

Even when FALLBACK=Y is specified, the process is not switched to the concurrent image copy process when one of the following conditions applies to the input database:
  • The database is not registered in the DBRC RECON data sets
  • The database is a non-recoverable database
  • The data set organization is VSAM KSDS and FASTIC=(,COPY) or FASTIC=(,FDUMP) processing of the Advance Image Copy Services is requested
  • When FASTIC=(,DUMP) processing of the Advance Image Copy Services is requested and the data set organization is VSAM KSDS that does not satisfy both of the following conditions:
    • SMS-managed data set
    • BWO(TYPEIMS) parameter is not specified on the AMS DEFINE or the ALTER command for the data set

FALLBACK=Y is not effective under the following conditions:
  • The data set organization is VSAM KSDS and the process runs with CIC_KSDS=N and FASTIC=N.
  • The input database is an index database and BYPDBAUTH=Y is specified.
  • When one of following keywords is specified:
    • DBRC=N
    • TOIAUTO=Y
    • TOIAUTO_Q=Y

Related reference:
  • BYPDBAUTH keyword
  • CIC_KSDS keyword
  • DBRC keyword
  • TOIAUTO keyword
  • TOIAUTO_Q keyword
End of change

=================
> 6.0 Troubleshooting
>> 6.1 Messages and codes
>>> 6.1.3 Messages

The following new messages have been added:

Start of change
FABJ0280I FALLBACK PROCESS IS ACTIVE.

Explanation: The FALLBACK option is in effect. IMS HP Image Copy switches the batch image copy process to the concurrent image copy process if exclusive authorization of the input database is not granted during the batch image copy process. If IMS HP Image Copy switches the process, it issues a FABJ0281I message.
System action: IMS HP Image Copy continues processing.
User response: None.
End of change
---
Start of change
FABJ0281I BATCH IMAGE COPY PROCESS AUTOMATICALLY SWITCH TO CONCURRENT IMAGE COPY PROCESS
    DBD/AREA=[ dbdname | partname | areaname ]

Explanation: IMS HP Image Copy switched the process for the indicated resource from the batch image copy process to the concurrent image copy process.
System action: IMS HP Image Copy continues processing.
User response: None.
End of change
---
Start of change
FABJ0282E BOTH BATCH IMAGE COPY PROCESS AND CONCURRENT IMAGE COPY PROCESS FAILED FOR DBD=[ dbdname | partname ]
    DDN/AREA=[ ddname | areaname ]

Explanation: The FALLBACK option is in effect. However, both the batch image copy process and the concurrent image copy process for the indicated resource failed.
System action: IMS HP Image Copy continues processing the next database. The job step return code is set to 8.
User response: Locate the corresponding messages, which are FABJ0183I, FABJ4232E, FABJ4243E, and FABJ0235E, and identify the cause of the error.
End of change
---
Start of change
FABJ0283E SWITCHING TO CONCURRENT IMAGE COPY PROCESS FAILED
    DBD/AREA=[ dbdname | partname | areaname ]

Explanation: The FALLBACK option is in effect and the process was switched to the concurrent image copy process. However, after switching to the concurrent image copy process, read-only authorization for the resource still could not be granted. The image copy data set of the database is not created.
System action: IMS HP Image Copy continues processing the next database. The job step return code is set to 8.
User response: Locate IMS message DFS047A or DFS3710A, and identify the cause of the error.
End of change
---
Start of change
FABJ3942E IGWARLS RETURNS AN UNEXPECTED ERROR RETURN CODE AND REASON CODE. RC= rc RSN= rsn

Explanation: IMS HP Image Copy received an unexpected error return code and reason code from the DFSMS module, IGWARLS.
System action: Program FABJMAIN issues a user error abend code of 3942.
User response: Contact IBM Software Support.
End of change



Update 11
Date of change: May 2013
Change description: Documentation changes by APAR PM75253. This APAR adds IMS Version 13 support.
Topics: Changes apply to the following multiple topics.

> 1.0 Introduction
>> 1.1 IMS HP Image Copy overview
>>> 1.1.3 IMS HP Image Copy terminology

IMS Version 13 has been added to the following list:

Abbreviations used in this information

To make this information easier to read, the version and release levels of IMS are abbreviated, as follows:
  • IMS Version 10 refers to IMS Version 10 Release 1.
  • IMS Version 11 refers to IMS Version 11 Release 1.
  • IMS Version 12 refers to IMS Version 12 Release 1.
  • Start of changeIMS Version 13 refers to IMS Version 13 Release 1.End of change
...

-----------------
>>> 1.1.8 IMS HP Image Copy documentation and updates

The following entries have been added to the table:

Prerequisite knowledge and publications

Short title used in this information Title
Start of changeIMS System Administration IBM IMS Version 13 System AdministrationEnd of change
Start of changeIMS System Definition IBM IMS Version 13 System DefinitionEnd of change
Start of changeIMS Commands IBM IMS Version 13 Commands, Volume 1: IMS Commands A-M
IBM IMS Version 13 Commands, Volume 2: IMS Commands N-V
IBM IMS Version 13 Commands, Volume 3: IMS Component and z/OS Commands End of change
Start of changeIMS System Utilities IBM IMS Version 13 System UtilitiesEnd of change
Start of changeIMS Database Utilities IBM IMS Version 13 Database UtilitiesEnd of change



Update 10
Date of change: May 2013
Change description: Documentation changes by APAR PM77057. By applying this APAR, you can store the messages that are written to the DFSPRINT data set in the IMS Tools Knowledge Base Output repository.
Topics: Changes apply to the following multiple topics.

> 2.0 Configuring IMS HP Image Copy
>> 2.2 Customizing IMS HP Image Copy
>>> 2.2.1 Storing reports in the central repository

"Image Copy Processing messages" has been added to the following list:

Reports that can be stored in the IMS Tools KB repository

IMS HP Image Copy enables you to store the following IMS HP Image Copy reports in the Output repository of IMS Tools KB:
  • ICEIN Statements report
  • Global Options report
  • Environment report
  • Start of changeImage Copy Processing messagesEnd of change
  • Image Copy Dump Process report
  • Image Copy Process Summary report
  • Image Copy Stacking Process report
  • Data Set Statistics report
  • Recovery Process report
  • Create Image Copy report
  • DBRC NOTIFY.IC Processing report
  • Selected Area report

=================
> 6.0 Troubleshooting
>> 6.1 Messages and codes
>>> 6.1.3 Messages

The following new messages have been added:

Start of change
FABJ0156E DD= ddname IS RESERVED BY HPIC

Explanation: DD= ddname, which is specified in the JCL stream, is reserved for use by IMS HP Image Copy for dynamic allocation.
System action: When the reported DD name is FABJDFSP and a FABJ0237W message is also issued, IMS HP Image Copy continues processing without storing the IMS HP Image Copy processing report in the IMS Tools KB Output repository. Otherwise, program FABJMAIN stops processing with a return code of 8.
User response: Change the DD name in the JCL stream and rerun the job.
End of change
---
Start of change
FABJ0237W THE PROCESSING MESSAGES ARE NOT STORED TO THE ITKB OUTPUT REPOSITORY.

Explanation: IMS HP Image Copy does not store the Processing Messages report of DFSPRINT in the IMS Tools KB Output repository. One of the following messages, which identifies the cause of the error, is also issued:
  • FABJ0156E
  • FABJ0302E
  • FABJ3916E
  • FABJ3972E
System action: IMS HP Image Copy continues processing, but the messages on written to the DFSPRINT data set are not stored in the IMS Tools KB Output repository.
User response: Locate the associated error message.
End of change
---
Start of change
FABJ0302E OPEN FABJDFSP FAILED.

Explanation: An attempt to open the internal data set that is associated with the FABJDFSP DD failed.
System action: IMS HP Image Copy continues processing, but the messages written to the DFSPRINT data set are not stored in the IMS Tools KB Output repository.
User response: Contact IBM Software Support.
End of change
---
Start of change
FABJ3900E HP IMAGE COPY DETECTS ERRORS DURING [IMAGE COPY DATA SET CREATING PROCESS | DATABASE RECOVERY PROCESS].

Explanation: IMS HP Image Copy ends due to some errors.
System action: Program FABJMAIN ends with an abend code of 3900.
User response: Locate other error messages and correct the errors. Rerun the IMS HP Image Copy job.
End of change
---
Start of change
FABJ3972E OPEN [FABJDFSP | DFSPRINT] FAILED.

Explanation: An attempt to open the data set that is associated with the DFSPRINT DD or the FABJDFSP DD failed. IMS HP Image Copy cannot write its processing messages in the data set that is specified by the DFSPRINT DD.
System action: Program FABJMAIN ends with an abend code of 3972.
User response: Contact IBM Software Support.
End of change



Update 9
Date of change: May 2013
Change description: Documentation changes by APAR PM74497. This APAR fixes several problems.
Topics: Changes apply to the following multiple topics.

> 3.0 Running IMS HP Image Copy
>> 3.5 IMS HP Image Copy control statements and keywords
>>> 3.5.2 ICEIN control statement keywords
>>>> 3.5.2.74 RESTART keyword

The following paragraph has been updated:

Format
...

Start of changeThe following optional parameters can be specified as the subparameters for 'Y' or 'C'. These optional parameters are ignored when used with 'N'. End of change

    HASH
    ...

=================
> 6.0 Troubleshooting
>> 6.1 Messages and codes
>>> 6.1.3 Messages

The following new messages have been added:

Start of change
FABJ4128I IMAGE COPY PROCESS WILL NOT BE RESTARTED BECAUSE reason

Explanation: The image copy process was bypassed for the database data set that is shown in messages FABJ4102I and FABJ4103I. reason shows one of the following texts:
  • A SEVERE POINTER ERROR WAS FOUND IN THE PREVIOUS RUN.
  • RELATED DBDS HAS A SEVERE POINTER ERROR IN THE PREVIOUS RUN.
System Action: IMS HP Image Copy continues processing other database data sets.
User Response: Determine the cause of the database errors by referring to the HD Pointer Checker reports or the DEDB Pointer Checker report that were generated in the previous run. If necessary, repair the database.
End of change
---
Start of change
FABJ4129I HASH CHECK IS INCOMPLETE. THIS DB IS TO BE RESTARTED.

Explanation: IMS HP Image Copy canceled the HASH Check process because it detected errors while creating image copy data sets. This database will be reprocessed in the next restart process. This message is issued only when RESTART=(Y,HASH) is specified.
System Action: IMS HP Image Copy continues processing other database data sets.
User Response: None.
End of change



Update 8
Date of change: May 2013
Change description: Documentation changes by APAR PM71579. This APAR enhances the Site Default utility to support the ICDALLOC= keyword.
Topics: Changes apply to the following multiple topics.

> 3.0 Running IMS HP Image Copy
>> 3.5 IMS HP Image Copy control statements and keywords
>>> 3.5.2 ICEIN control statement keywords
>>>> 3.5.2.2 Relation of keywords to ICEIN control statements

The Site default option column for the ICDALLOC keyword has been updated as follows:

Table. Relation of keywords to ICEIN control statements
(Table 25 in PDF and BookManager formats)
Keyword GLOBAL GROUP IC/AIC CIC/ACIC RCV CRC Site default option Related keyword
... ...
ICDALLOC O O O O - O Start of changeOEnd of change
  • ...
... ...
-----------------
>>>> 3.5.2.49 ICDALLOC keyword

The site default option entry has been changed as follows:

Site default option
    Start of changeSupported End of change
Related keyword
    None.

-----------------
>> 3.6 Allocating data sets dynamically
>>> 3.6.2 Output image copy data sets
>>>> 3.6.2.2 Using stacked image copy data set

The third paragraph has been updated as follows:

When the STACK keyword is specified, the output image copy data set is created as a stacked data set.

When stacking is requested by the STACK keyword, the IMS HP Image Copy functions function groups the output image copy data sets with the ddname specified in the STACK keyword. The grouped output image copy data sets are written into the same tape volume or set of tape volumes identified with the stacked data set.

Output stacked image copy data sets are always allocated dynamically Start of changeeven when ICDALLOC=N parameter is specified. End of change

...

=================
> 6.0 Troubleshooting
>> 6.1 Messages and codes
>>> 6.1.3 Messages

The following new message has been added:

Start of change
FABJ0165E DDNAME: icddn OF IMAGE COPY DATA SET FOR DBD dbdname DDN/AREA [ ddname | areaname ] IS NOT FOUND.

Explanation: The icddn DD name of image copy data set is not found in the JCL stream.
System Action: The image copy process fails.
User Response: Provide the DD statement that corresponds to the DD name that is specified on the ICOUT= keyword and rerun the job.
End of change



Update 7
Date of change: May 2013
Change description: Documentation changes by APAR PM76650. This APAR adds a new option. By applying this APAR, you can use the NOREUSE keyword to restrict the reuse of output image copy data sets.
Topics: Changes apply to the following multiple topics.

> 3.0 Running IMS HP Image Copy
>> 3.5 IMS HP Image Copy control statements and keywords
>>> 3.5.2 ICEIN control statement keywords
>>>> 3.5.2.1 Summary of ICEIN control statement keywords

NOREUSE keyword has been added to the table:

Table. Summary of ICEIN keywords
(Table 24 in PDF and BookManager formats)
Keyword Description
... ...
Start of changeNOREUSE The NOREUSE keyword specifies the Image Copy function to not reuse the image copy data sets that are cataloged in the system.End of change
... ...

-----------------
>>>> 3.5.2.2 Relation of keywords to ICEIN control statements

NOREUSE keyword has been added to the table:

Table. Relation of keywords to ICEIN control statements
(Table 25 in PDF and BookManager formats)
Keyword GLOBAL GROUP IC/AIC CIC/ACIC RCV CRC Site default option Related keyword
... ...
Start of changeNOREUSE O - - - - - O
  • DBRC keyword
  • ICDALLOC keywordEnd of change
... ...

-----------------
>>> 3.5.2 ICEIN control statement keywords

The following new topic has been added:

Start of change
NOREUSE keyword

The NOREUSE keyword specifies the Image Copy function to not reuse the image copy data sets that are cataloged in the system.

This keyword is effective for the Image Copy function only when the DBDS record of the database data set or the area data set is registered as NOREUSE in the DBRC RECON data set.

Statements that support this keyword
    GLOBAL statement

Site default option
    Supported

Related keywords
  • DBRC keyword
  • ICDALLOC keyword

Format

           NOREUSE=Y|N

Y
    Specifies that the Image Copy function does not reuse the image copy data sets. NOREUSE=Y becomes effective when all of the following conditions are satisfied:
    • The function is run with DBRC=Y.
    • The DBDS record of the database data set or area data set is registered as NOREUSE in the DBRC RECON data set.
    • The image copy data set is allocated dynamically by IMS HP Image Copy.
    • The name of the image copy data set that is expected to be allocated dynamically by IMS HP Image Copy is already cataloged in the system.

    If NOREUSE=Y is in effect and if an image copy data set that has the name of the target output image copy data set exists, the Image Copy function ends with a return code of 8. The names of the unprocessed database data sets or the area data sets are printed in messages FABJ0166E and FABJ0167E.

N
    Specifies that the Image Copy function reuses the image copy data sets if the data sets exist with the target names. This is true even when the DBDS record of the database data sets or the area data sets is registered as NOREUSE in DBRC RECON data sets.


Default value
    NOREUSE=N

The keyword is ignored when the process runs with DBRC=N.

This option is effective even when the output image copy data set is to be dynamically allocated on a tape volume.

Related reference:
  • DBRC keyword
  • ICDALLOC keyword
End of change

=================
> 6.0 Troubleshooting
>> 6.1 Messages and codes
>>> 6.1.3 Messages

The following new messages have been added:

Start of change
FABJ0166E REUSE OF THE IMAGE COPY DATA SET IS NOT ALLOWED FOR THE FOLLOWING DATABASE DATA SETS.

Explanation: NOREUSE=Y is specified, and the name of the output image copy data set that IMS HP Image Copy tried to dynamically allocate is already cataloged in the system. IMS HP Image Copy does not process the database data set. The names of such database and image copy data sets are reported in the subsequent FABJ0167E messages.
System Action: IMS HP Image Copy processing ends with a return code of 8.
User Response: Change the data set naming template of the image copy data set and rerun the job.
End of change
---
Start of change
FABJ0167E DBD= dbdname DDN/AREA= ddname ICDSN= data_set_name

Explanation: This message follows a FABJ0166E message.
System Action: See the explanation of message FABJ0166E.
User Response: See the explanation of message FABJ0166E.
End of change



Update 6
Date of change: May 2013
Change description: Documentation changes by APAR PM68259. This APAR adds a new option. By applying this APAR, you can have IMS HP Image Copy delete incomplete output image copy data sets.
Topics: Changes apply to the following multiple topics.

> 3.0 Running IMS HP Image Copy
>> 3.5 IMS HP Image Copy control statements and keywords
>>> 3.5.2 ICEIN control statement keywords

The following new topic has been added:

Start of change
DEL_ICDS keyword

The DEL_ICDS keyword specifies to delete the image copy data set of the database data set when errors occur in the image copy process of the database data set.

Statements that support this keyword
    GLOBAL statement

Site default option
    Supported

Related keywords
  • ICDALLOC keyword
  • DBRC keyword
  • NOTIFYMODE keyword
  • RESTART keyword
  • RSTTYPE keyword
  • RSTTYPE_STK keyword
  • VIC keyword

Format

           DEL_ICDS=Y|N

Y
    Specifies to delete the dynamically allocated image copy data set when errors occur in the image copy process of the database data set.

    When the Image Copy function runs with DBRC=Y and the database data set is registered in the DBRC RECON data set, the IC record in the DBRC RECON data set is also deleted.

    If the image copy data set is created on a tape volume, that image copy data set is not deleted even when DEL_ICDS=Y is specified. But that image copy data set will be uncataloged and the IC record in the DBRC RECON data set will be deleted.

N
    Specifies that the image copy data set is not deleted even when errors occur in the image copy process of the database data set.

    If the IC record is already registered in the DBRC RECON data set, the IC record is not deleted.

Default value
    DEL_ICDS=N

DEL_ICDS=Y is effective for the image copy data sets that are allocated dynamically by the Image Copy function of IMS HP Image Copy.

Even when DEL_ICDS=Y is specified, the image copy data sets are not deleted under the following conditions:
  • The image copy data set is defined by a DD card in the JCL stream.
  • The image copy data set is allocated outside of an IMS HP Image Copy process.
  • The image copy data set resides on a tape volume.
The IC record of the DBRC RECON data set is deleted even under these conditions.

Related reference:
  • ICDALLOC keyword
  • DBRC keyword
  • NOTIFYMODE keyword
  • RESTART keyword
  • RSTTYPE keyword
  • RSTTYPE_STK keyword
  • VIC keyword
End of change
-----------------
>>>> 3.5.2.1 Summary of ICEIN control statement keywords

DEL_ICDS keyword has been added to the table:

Table. Summary of ICEIN keywords
(Table 24 in PDF and BookManager formats)
Keyword Description
... ...
Start of changeDEL_ICDS The DEL_ICDS keyword specifies to delete the image copy data set of the database data set when errors occur in the image copy process of the database data set.End of change
... ...

-----------------
>>>> 3.5.2.2 Relation of keywords to ICEIN control statements

DEL_ICDS keyword has been added to the table:

Table. Relation of keywords to ICEIN control statements
(Table 25 in PDF and BookManager formats)
Keyword GLOBAL GROUP IC/AIC CIC/ACIC RCV CRC Site default option Related keyword
... ...
Start of changeDEL_ICDS O - - - - - O
  • ICDALLOC keyword
  • DBRC keyword
  • NOTIFYMODE keyword
  • RESTART keyword
  • RSTTYPE keyword
  • RSTTYPE_STK keyword
  • VIC keywordEnd of change
... ...

=================
> 6.0 Troubleshooting
>> 6.1 Messages and codes
>>> 6.1.3 Messages

The following new messages have been added:

Start of change
FABJ0168I DEL_ICDS=Y IS APPLIED TO ICDS OF DBD= dbdname DDNAME/AREA= ddname

Explanation: The DEL_ICDS=Y option, which requests to delete the image copy data set, is applied in the create image copy process. The image copy data set of the indicated database data set will be deleted.
System Action: The create image copy processing continues.
User Response: None.
End of change
---
Start of change
FABJ0169E DEL_ICDS=Y IS APPLIED TO ICDS OF DBD= dbdname DDNAME/AREA= ddname , BUT FOLLOWING DELETE PROCESS HAS NOT COMPLETED.
    [- DELETE DBRC IC RECORD | - UNCATALOG | - DELETE ICDS ]

Explanation: The delete process of the Image Copy function or the Create Image Copy function detected errors in the IDCAMS or the DSPURXRT process. The following FABJ0169E messages follow this message:
  • FABJ0169E ICDSN=data_set_name VOLSER=volser
  • FABJ0169E DBRC ICTIME=[yyyydddhhmmssthmiju offset |yydddhhmmsst offset ]
System Action: Processing ends with a return code of 8.
User Response: Locate the IDCAMS or DSPURXRT messages, correct any errors, and delete the resource manually.
End of change
---
Start of change
FABJ0205I THE IMAGE COPY STATUS IN THE RECON IS CHANGED TO IC NEEDED DDNAME/AREA= ddname

Explanation: The Image Copy function or the Create Image Copy function issued the CHANGE.DBDS command.
  • In the Image Copy function, this command is issued after the DELETE.IC or DELETE.UIC command.
  • In the Create Image Copy function, this command is issued after the NOTIFY.IC command.
This CHANGE.DBDS command prevents the image copy status of the database data set from being changed to IC RECOMMENDED.
System Action: IMS HP Image Copy continues processing.
User Response: None.
End of change
---
Start of change
FABJ3900E HP IMAGE COPY DETECTS ERRORS DURING IMAGE COPY DATA SET CREATING PROCESS.

Explanation: IMS HP Image Copy process ended because it detected errors.
System Action: IMS HP Image Copy processing ends with an abend code of 3900.
User Response: Identify and correct the cause of the error and then rerun the IMS HP Image Copy job.
End of change
---
Start of change
FABJ3939E [SHADOW DATA SET | IMAGE COPY DATA SET] DELETE FAILED. IDCAMS RETURNED ABNORMAL CONDITION CODE.

Explanation: IDCAMS failed to delete a target data set. The reason code is shown by the IDCAMS messages in ICEPRINT.
System Action: Processing ends with a return code of 8.
User Response: Locate the IDCAMS messages, correct any errors, and delete the data set manually.
End of change



Update 5
Date of change: May 2013
Change description: Documentation changes by APAR PM67215. This APAR provides a fix for an ABEND SOC4 problem that occurs when IMS HP Image Copy finds a specific version of IMS HP Fast Path Utilities module in the STEPLIB concatenations.
Topic:
> 6.0 Troubleshooting
>> 6.1 Messages and codes
>>> 6.1.3 Messages

The following new message has been added:

Start of change
FABJ0164E UNSUPPORTED LEVEL OF prodname IS BEING USED.

Explanation: The level of the prerequisite product prodname is not supported by this release of IMS HP Image Copy. prodname shows either of the following products:
  • IMS HP POINTER CHECKER
  • IMS HP FP UTILITIES
System Action: Program FABJMAIN stops processing with a return code of 08.
User Response: To run this job, ensure that the prerequisite product is at a compatible release level.
End of change



Update 4
Date of change: May 2013
Change description: Documentation changes by APAR PM60451. By applying this APAR, you can specify up to 2048 ICEIN DD statements when using the Image Copy function or the Create Image Copy function.
Topics: Changes apply to the following multiple topics.

> 3.0 Running IMS HP Image Copy
>> 3.1 Taking image copies
>>> 3.1.3 Restrictions on the Image Copy function

The following new restriction items have been added:

Restrictions on the Image Copy function
  • ...
  • The Image Copy function does not support the functions that are provided the following IMS utilities:
  • Online image copy
  • HSSP image copy
  • Image copy 2
  • Restart function under UCF
  • Start of changeThe maximum number of full-function database data sets that can be processed in a job step is 2000.End of change
  • Start of changeThe maximum number of DEDB area data sets that can be processed in a job step is 2048.End of change
  • Start of changeThe total number of database data sets that can be processed in a job step is equal to or less than 2048.End of change

-----------------
>> 3.3 Creating new image copies from an image copy
>>> 3.3.3 Restrictions on the Create Image Copy function

The following new restriction items have been added:

The following restrictions apply when using the Create Image Copy function:
  • ...
  • The input image copy data sets that are generated by the following utilities require that DBRC be active:
  • IMS Online Image Copy utility
  • IMS Image Copy 2 utility
  • Start of changeThe maximum number of full-function database data sets that can be processed in a job step is 2000.End of change
  • Start of changeThe maximum number of DEDB area data sets that can be processed in a job step is 2048.End of change
  • Start of changeThe total number of database data sets that can be processed in a job step is equal to or less than 2048.End of change

-----------------
>> 3.5 IMS HP Image Copy control statements and keywords
>>> 3.5.1 ICEIN control statements

The second note item has been updated as follows:
...

Notes:
  1. IMS HP Image Copy can perform only one function within a job step--Batch image copy, Concurrent image copy, Database Recovery, or Create Image Copy.
  2. Start of changeThe maximum number of GROUP, IC, AIC, CIC, ACIC, and CRC statements that you can specify in one job step for an IMS HP Image Copy function is 2048.End of change
  3. ...

=================
> 6.0 Troubleshooting
>> 6.1 Messages and codes
>>> 6.1.3 Messages

The following new messages have been added:

Start of change
FABJ0110E THE NUMBER OF SPECIFIED GROUP/IC/AIC/CIC/ACIC/CRC STATEMENTS IN ICEIN DD EXCEEDS 2048

Explanation: The total number of GROUP, IC, AIC, CIC, ACIC, and CRC statements in the ICEIN DD card exceeds 2048. The maximum allowed number for these statements is 2048.
System Action: Program FABJMAIN stops processing with a return code of 16.
User Response: Divide the job step into multiple job steps and ensure that the number of statements in each job step is less than the maximum number allowed. Rerun the job.
End of change
---
Start of change
FABJ0290E THE NUMBER OF REQUESTED DBDS OF FULL FUNCTION DATABASE EXCEEDS 2000

Explanation: The number of requested full-function database data sets in a step exceeds 2000. The maximum allowed number of database data sets in a step is 2000.
System Action: Program FABJMAIN stops processing with a return code of 16.
User Response: Confirm the number of requested database data sets and areas in the FABJ0293E message. Then divide the job step into multiple job steps and ensure that the requested number of database data sets and areas in each job step is less than the maximum number allowed. Rerun the job.
End of change
---
Start of change
FABJ0291E THE NUMBER OF REQUESTED AREA EXCEEDS 2048

Explanation: The number of requested DEDB areas in a step exceeds 2048. The maximum allowed number of areas in a step is 2048.
System Action: Program FABJMAIN stops processing with a return code of 16.
User Response: Confirm the number of requested areas in the FABJ0293E message. Then divide the job step into multiple job steps and ensure that the requested number of database data sets and areas in each job step is less than the maximum number allowed. Rerun the job.
End of change
---
Start of change
FABJ0292E THE NUMBER OF REQUESTED DBDS AND AREA EXCEEDS 2048

Explanation: The total number of requested database data sets and areas in a step exceeds 2048. The maximum allowed total number of database data sets and areas in a step is 2048.
System Action: Program FABJMAIN stops processing with a return code of 16.
User Response: Confirm the number of requested database data sets and areas in the FABJ0293E message. Then divide the job step into multiple job steps and ensure that the requested number of database data sets and areas in each job step is less than the maximum number allowed. Rerun the job.
End of change
---
Start of change
FABJ0293E THE NUMBER OF REQUESTED DBDS AND AREA: DBDS= nnnnnn AREA= mmmmmm

Explanation: This message shows the number of requested database data sets and areas in a step. This message is associated with FABJ0290E, FABJ0291E, or FABJ0292E messages. See the explanation and the user response of the associated message.
System Action: See the system action of the associated message.
User Response: See the user response of the associated message.
End of change



Update 3
Date of change: March 2013
Change description: User's Guide update.
Topic:
> 2.0 Configuring IMS HP Image Copy
>> 2.2 Customizing IMS HP Image Copy
>>> 2.2.1 Storing reports in the central repository
>>>> 2.2.1.1 Registering products and reports to IMS Tools KB

The Procedure section of this topic has been replaced with the following content:

Procedure

Start of change
1. Use the IMS Tools Knowledge Base product administration utility (HKTAPRA0) to register IMS HP Image Copy, as described in the topic "Registering IMS Tools products by using the product's definition table" in the Tools Base: IMS Tools Knowledge Base User's Guide.
    The product definition table for registering IMS HP Image Copy is FABJITKB. You can use the following ADDPROD statement to register IMS HP Image Copy:

    ADDPROD TABLE=FABJITKB REPLACE=YES

    In this example, even if IMS HP Image Copy Version 4 Release 2 is already defined in the IMS Tools KB registry, the job still runs because the REPLACE option is specified.

2. Follow the instructions in the topic "Listing registered products and reports" in the Tools Base: IMS Tools Knowledge Base User's Guide to list the registered products and reports, and ensure that IMS HP Image Copy (the product ID is DI) has been added.
End of change



Update 2
Date of change: January 2012
Change description: Documentation changes by APAR PM55260. Changes apply to several messages.
Topic:
> 6.0 Troubleshooting
>> 6.1 Messages and codes
>>> 6.1.3 Messages

Changes are made to the following messages and to their explanation section:

Before change:
    FABJ4201E IMAGE COPY PROCESSING TERMINATED DUE TO AN ERROR IN DFSMSDSS API
After change:
    Start of change FABJ4201E IMAGE COPY PROCESSING FOR DBD dbdname DDN/AREA ddname | areaname TERMINATED DUE TO AN ERROR IN DFSMSDSS API End of change

Explanation: During FASTIC= processing for the indicated resource, an error occurred in the DFSMSdss API causing the image copy to fail.
System action: The image copy request fails.
User response: Review the messages, correct the error, and rerun the job.

---
Before change:
    FABJ4215E ERROR DURING DFSMSDSS API PROCESSING RC= rrrrrrrr
After change:
    Start of change FABJ4215E ERROR DURING DFSMSDSS API PROCESSING FOR DBD dbdname DDN/AREA ddname | areaname RC= rrrrrrrr

Explanation: An error occurred while starting the DFSMSdss API for the indicated resource that is used for the FASTIC= processing. Start of changeRC= shows the DFSMSdss API return code in hexadecimal. End of change The contents of the general-purpose register 15 is shown.
System action: Image copy processing fails.
User response: Review the messages, correct the error, and rerun the job.

---
Before change:
    FABJ4219I HPIC RECEIVED RC=4 FROM DFSMSDSS API. HPIC CONTINUES PROCESSING.
After change:
    Start of change FABJ4219I HPIC RECEIVED RC=4 FROM DFSMSDSS API FOR DBD dbdname DDN/AREA ddname | areaname . HPIC CONTINUES PROCESSING. End of change


Explanation: The physical copy process for the indicated resource has ended, however IMS HP Image Copy received return code 4 from the DFSMSdss API.
System action: IMS HP Image Copy continues processing.
User response: Check the DFSMSdss message and the meaning of the return code. If necessary, correct the condition and rerun the job.

---
Before change:
    FABJ4242E MESSAGE ADR974I WAS ISSUED FOR DBD dbdname DDN ddname DSN data_set_name
After change:
    Start of change FABJ4242I MESSAGE ADR974I WAS ISSUED FOR DBD dbdname DDN ddname DSN data_set_name End of change

Explanation: During FASTIC= processing for a VSAM KSDS, DFSMSdss issued an ADR974I message for the database data set.
System action: The image copy processing continues.
User response: For a description of the ADR974I message, see z/OS System Messages. You should verify that the identified data set is good.

---
Before change:
    FABJ4260I COPY PROCESSING COMPLETE FOR DB/AREA [ failed_dbdname | partname | areaname ] OF total DATA SETS FAILED
After change:
    Start of change FABJ4260I [LOGICAL COPY|COPY PROCESSING] COMPLETE FOR DB/AREA [dbdname|partname|areaname ] [ failed_data_sets OF total_data_sets DATA SETS FAILED] End of change

Explanation: This message is issued during FASTIC= processing whenever all of the data sets for a database Start of changeare released from the DFSMSdss process. End of change The message is issued at the end of logical copy for all data sets of the database when the process is FASTIC=( opt,DUMP). Otherwise it is issued at the end of physical copy.

Start of changeThis message indicates the number of total data sets that were attempted for image copy in the job step ( total_data_sets) and the number of data sets that failed ( failed_data_sets) in either of the following processes:
  • Logical copy in the FASTIC DUMP process
  • Physical copy in the FASTIC COPY process or in the FASTIC FDUMP processEnd of change
System action: The image copy processing continues.
User response: It is safe to restart the specified database.




Update 1
Date of change: January 2012
Change description: Documentation changes by APAR PM54604. This APAR introduces a new keyword, TOSIXCFGRP keyword, which functions identically to the existing TOIXCFGR keyword. This APAR also introduces a new (HPIC) statement parameter, STACMDFAIL parameter, for the HPSRETCD control statement for return code handling.

Topics: Changes are made to the following topics.

> 3.0 Running IMS HP Image Copy
>> 3.5 IMS HP Image Copy control statements and keywords
>>> 3.5.2 ICEIN control statement keywords
>>>> 3.5.2.1 Summary of ICEIN control statement keywords

The TOSIXCFGRP keyword has been added to the following table:

Table: Summary of ICEIN keywords
(Table 24 in PDF and BookManager formats)
Keyword Description
... ...
TOIXCFGR= The TOIXCFGR keyword identifies the XCF group that the IMS Tools Online System Interface uses to interface with IMS HP Image Copy.
Start of changeTOSIXCFGRP= The TOSIXCFGRP keyword functions identically to the TOIXCFGR keyword. See the description of the TOIXCFGR keyword.End of change
... ...

-----------------
>>>> 3.5.2.2 Relation of keywords to ICEIN control statements

TOSIXCFGRP keyword entry has been added as follows:

Table: Relation of keywords to ICEIN control statements
(Table 25 in PDF and BookManager formats)
Keyword GLOBAL GROUP IC/AIC CIC/
ACIC
RCV CRC Site
default
option
Related keyword Topic
...
TOIXCFGR=
O
-
-
-
-
-
O
SENSOR=
SPMN=
TOIAUTO=
TOIAUTO_Q=
TOIXCFGR keyword
Start of changeTOSIXCFGRP=
O
-
-
-
-
-
O
SENSOR=
SPMN=
TOIAUTO=
TOIAUTO_Q=
TOIXCFGR keyword
TOSIXCFGRP keywordEnd of change
...
-----------------
>>>> 3.5.2.107 TOIXCFGR keyword

Considerations about using the TOSIXCFGRP keyword and the relationship between the TOIXCFGR keyword have been added as follows:

The TOIXCFGR keyword identifies the XCF group that the IMS Tools Online System Interface uses to interface with IMS HP Image Copy. Start of changeThe TOIXCFGR keyword and the TOSIXCFGRP keyword are functionally identical. End of change

This keyword is required if you are using the IMS Tools Online System Interface functions and the DB Sensor function.

...

Format
    TOIXCFGR=TOI xcf-group-name
      or
    Start of changeTOSIXCFGRP=TOI xcf-group-name End of change

TOI
    Is the prefix name of the XCF group name. Always specify this prefix 'TOI', when you use IMS Tools Online System Interface and identify a specific Start of changeXCF group name. End of change

xcf-group-name
    Indicates the XCF group name. The group name is a 1-5 alphanumeric character string that the IMS Tools Online System Interface prefixes with the characters TOI, to produce the XCF group name. This keyword is available only through FABJMAIN processing. There is no default.

    When you use the DB Sensor function to collect sensor data from a full-function database, certain considerations apply for the collected data element values. For details, see the topic "Considerations for collecting sensor data from full-function databases" in the IMS Solution Packs: Database Sensor User's Guide.

Start of changeNotes:
  • The TOIXCFGR keyword and the TOSIXCFGRP keyword are functionally identical. In IMS HP Image Copy reports and messages, TOIXCFGR is displayed even when TOSIXCFGRP is specified.
  • On the GLOBAL statement or in the site default table, TOIXCFGR and TOSIXCFGRP are exclusive; only one can be specified.
  • TOIXCFGR or TOSIXCFGRP specification on the GLOBAL statement replaces the TOSIXCFGRP or TOIXCFGR specification in the site default table.End of change

Default value
    None.

-----------------
>>> 3.5.2 ICEIN control statement keywords

A new topic, TOSIXCFGRP keyword, has been added:

Start of changeThe TOSIXCFGRP keyword identifies the XCF group that the IMS Tools Online System Interface uses to interface with IMS HP Image Copy. This keyword functions identically to the TOIXCFGR keyword.

See TOIXCFGR keyword for how to use this keyword. End of change

-----------------
>>> 3.5.3 HPSRETCD control statement

A new parameter, STACMDFAIL, has been added to the description as follows:

(HPIC) Statement

...

The (HPIC) statement contains optional parameters, which are specified by the following keywords:
  • SPMNWARN=nn|4
  • Start of changeSTACMDFAIL=nn|4End of change
  • T2ERROR=nn|2

...

Start of changeSTACMDFAIL=
    If IMS HP Image Copy detects a /START command failure or an UPDATE DB STOP(QUIESCE) command failure (issued for the database, partition, or area that is to be used by IMS Tools Online System Interface), IMS HP Image Copy returns the return code specified by this parameter. nn is 0 - 99. The default value is 4. End of change

Publication number

SC19-2756-01

Copyright date

2000, 2011

Original publication date

2012/1/16

Cross reference information
Segment Product Component Platform Version Edition
Information Management IMS Tools IMS Database Solution Pack z/OS 1.2.0, 2.1.0
Information Management IMS Tools IMS Fast Path Solution Pack z/OS 1.2.0, 1.3.0
Information Management IMS Tools IMS Recovery Solution Pack z/OS 1.1.0

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

IMS Tools
IMS HP Image Copy

Software version:

4.2.0

Operating system(s):

z/OS

Reference #:

7023909

Modified date:

2014-02-04

Translate my page

Machine Translation

Content navigation