Extended Functions configuration parameters

Configuration parameters are used to control the overall operation and environment of IMS Database Recovery Facility Extended Functions.

You can specify configuration parameters in one of two places:
  • The configuration member specified by the IMSRECFG parameter in the Extended Functions job EXEC statement.

    The IMSRECFG parameter specifies the name of the Extended Functions configuration member that is located in the JCL procedure library (PROCLIB).

  • The IMSREIN input DD statement in the Extended Functions job.

    The IMSREIN input DD statement specifies configuration parameters and function control cards that drive Extended Functions processing.

    Note: If you specify a configuration parameter in both the IMSREIN DD statement and member IMSRECFG, the value that is specified in the IMSREIN DD statement overrides the value that is specified in member IMSRECFG.
Note: Configuration parameters are processed before any function control statements.

Configuration parameter reference

ITKBSRVR
This parameter identifies the IMS Tools Knowledge Base server name (XCF group name) that is associated with your IMS Tools Knowledge Base environment.

The parameter value is the 8-character XCF group name that is associated with the IMS Tools Knowledge Base server.

This parameter is required and has no default value.

ITKBSRVR syntax:

   ITKBSRVR( ITKB-XCF-group )
RECONID
This parameter identifies the RECONID member that is obtained from the repository in order to retrieve environmental information.

This is an 8-character name that is assigned to the RECONID member as defined in the repository.

This parameter is optional but, if you do not supply it, the RECON1 data set name must be available either through the JCL (allocated to the RECON1 DD statement), or by the DFSMDA dynamic allocation member in the //STEPLIB or //IMSDALIB.

RECONID syntax:

   RECONID( reconid-member-name )
REPORT
Use this parameter to specify your preferences for the reports that are created by Extended Functions.
REPORT syntax:
    REPORT(ITKBOUT( YES | Y | NO | N )
            PAGEBR( YES | Y | NO | N )
           TIMEFMT( LOCAL | DATA | UTC )
           DATEFMT( YYYYDDD | MMDDYYYY | DDMMYYYY | YYYYMMDD )
          )

REPORT parameter reference:

ITKBOUT( YES | Y | NO | N )
Use this parameter to specify whether the reports that are generated by Extended Functions are placed into the IMS Tools Knowledge Base output repository.

The default is ITKBOUT(YES).

PAGEBR( YES | Y | NO | N )
Use this parameter to specify whether the reports that are generated by Extended Functions include page breaks and headers that make the reports easier to interpret when they are printed.

If your reports will be viewed online only, PAGEBR( NO ) is recommended.

The default is PAGEBR( NO ).

TIMEFMT( LOCAL | UTC | DATA )
Use this parameter to specify whether timestamps that are displayed on your reports are in local time ( LOCAL ), global time ( UTC ), or the time that is associated with the data ( DATA ).

For TIMEFMT( DATA ), if the processed data (such as, log records) are from a location other than the current location, the timestamps that are displayed are from the location where the data was created.

The default is TIMEFMT( LOCAL ).

DATEFMT( YYYYDDD | MMDDYYYY | DDMMYYYY | YYYYMMDD )
Use this parameter to specify the format of the date that is displayed on all of your report headings.
  • The YYYY variable represents the value for the year.
  • The MM variable represents the value for the month.
  • The DD or DDD variable represents the value for the day.

The default is DATEFMT(MMDDYYYY).

TEMPDSN
Use this parameter to control the allocation of temporary data sets that might be needed by internal services.

If you do not specify this parameter, the system defaults are used to allocate all necessary temporary data sets.

TEMPDSN syntax:
   TEMPDSN( TUNIT( unit-name ) 
            TVOLSER( volser )
            TSTORCLASS( SMS-storage-class )
            TMGMTCLASS( SMS-management-class )
            TDATACLASS( SMS-data-class )  	
          )

TEMPDSN parameter reference:

TUNIT( unit-name )
Use this parameter to specify the DASD unit that is used to allocate temporary data sets.
TVOLSER( volser )
Use this parameter to specify the DASD volume serial that is used to allocate temporary data sets.
TSTORCLASS( SMS-storage-class )
TMGMTCLASS( SMS-management-class )
TDATACLASS( SMS-data-class )
Use these three SMS parameters to specify the SMS classes that are used to allocate temporary data sets.
USESLBIC
Use this parameter to determine whether IMS Recovery Expert system level backups are considered recovery assets in the HCHECK and VERIFY functions.
Note: It is strongly suggested that configuration parameter USESLBIC is set to match the same parameter in IMS Database Recovery Facility.
USESLBIC syntax:
   USESLBIC(NO | N | YES | Y)
The default is USESLBIC(NO).