RECONID locate processing

Before Extended Functions can begin processing, it must locate the RECONID member and be able to retrieve it from the repository.

Information gathered from the RECONID member

The RECONID member contains information that IMS Database Recovery Facility Extended Functions needs in order to process.

This information includes:

  1. The eight-byte external name associated with the RECONID member.
  2. The RECON1, RECON2, and RECON3 data set names.
  3. The XCF group name that is used to communicate with IMS Tools Online System Interface in the IMS control regions.
  4. The IMSPLEX name as defined to the RECON data sets, if present.
  5. The RACF® security class to be used for securing IMS commands that are issued through Extended Functions.
    Note: When issuing commands, Extended Functions performs security checking based on the definition in the RECONID record. The security checks are performed against the RACF security class specified in the RECONID record.

    The security processing normally performed by IMS Tools Online System Interface (RACFCHK=value) is bypassed.

RECONID locate process flow

The ways that the RECONID member can be specified, and the order that is used to locate the RECONID member are outlined in the next list.

When the RECONID member is located, the search terminates (in other words, subsequent steps are performed only until the RECONID member is located).

  1. If you specify the RECONID() parameter in either the IMSRECFG= PROCLIB member or the IMSREIN DD, this RECONID() parameter value is used to look up the RECONID member in the repository.

    If this RECONID member is not located, the job step terminates.

  2. If the RECON1 DD is allocated in the JCL, the data set name that is associated with the DD is retrieved.

    A lookup is performed for that data set name to locate the RECONID member.

    If no RECONID member with this RECON1 data set name is located, the job step terminates.

  3. If the IMSDALIB DD is allocated in the JCL, a BLDL request is performed for member RECON1.

    If found, the RECON1 member is loaded and the RECON1 data set name is retrieved.

    A lookup is performed for that data set name to locate the RECONID member.

    If no RECONID member with this RECON1 data set name is located, the job step terminates.

  4. A load is issued for member RECON1 which will attempt to load the member from JOBLIB, STEPLIB, or the link-pack area.

    If loaded successfully, the RECON1 data set name is retrieved.

    A lookup is performed for that data set name to locate the RECONID member.

    If no RECONID member with this RECON1 data set name is located, the job step terminates.

If, after attempting these steps, Extended Functions is unable to locate the RECONID member, the job terminates with error messages and an ABEND.