AIB reason codes

This reference section provides detailed information about the AIB reason codes that are issued by IMS Queue Control Facility.

These topics describe the AIBRETRN and AIBREASN codes set by the IMS message requeuer modules IQCQMRQ0 and DFSQMR10, 20, 30, 40, 50, 60, 70, and A0-L0. These codes are recorded in the SCRAPLOG 6701-MRQE records. IMS Queue Control Facility reports when an error is detected while performing an IMS Queue Control Facility function.

Use the AIBREASN codes when diagnosing problems with IMS Queue Control Facility.

Related reading: For more information about how to diagnose IMS Queue Control Facility problems, see the section that discusses diagnosing problems in the Message requeuer in IMS Diagnosis. This information also describes how IMS Queue Control Facility communicates with certain functions in the IMS Transaction Manager and System Services.

X'000000F0' is a unique AIB return code assigned to the IMS Queue Control Facility manager message requeuer processor (IQCQMRQ0). It is set in the AIBRETRN field of the AIB by IQCQMRQ0 when an error is detected while performing an IMS Queue Control Facility function.

IQCQMRQ0 also sets the AIBREASN field in the AIB to a code indicating the type of error detected. These codes are passed back to the applicable IMS Queue Control Facility function, which stores the codes in the QCF prefix segment appended to the front of the message record that caused the error. The IMS Queue Control Facility function writes this record to the SCRAPLOG data set. IMS logs a corresponding 6701-MRQE record to the OLDS.

AIB return codes other than X'000000F0' indicate IMS errors that are not specific to message requeuing. To analyze these return codes and their associated reason codes, see the topic "AIB return and reason codes set by IMS" in IMS Messages and Codes, Volume 4: IMS Component Codes.

Each AIBREASN code associated with AIB return code X'000000F0' is described in the following list. Locate the unique AIBREASN code and analyze the error as described. Each AIBREASN code falls into one of three categories:
  1. The error is a normal condition and AIBREASN is set for informational purposes. The message is discarded according to protocol. There are seven AIBREASN codes in this category:
    1080
    Message destination is an APPC synchronous conversation type.
    1084
    Message is a nonrecoverable type.
    1088
    Message was flagged to be canceled.
    10A4
    Message is an internal IMS message that is not recoverable.
    1100
    Message is an IMSVERIFY command message.
    2014
    Destination is an inquiry LTERM not signed on.
    A070
    AOI command response cannot be deleted.
  2. The error is probably caused by an unsupported or changed IMS features, or destination or source resource names.

    An example of an error: a transaction is deleted from IMS SYSGEN and IMS Queue Control Facility subsequently tries to requeue a message destined for the deleted transaction.

    The IMS Queue Control Facility processor (IQCQMRQ0) would detect that the destination no longer exists and set an AIBREASN code of 1024 or 1040. The IMS system programmer should analyze these errors (by following the explanation and programmer response guidelines found in IMS Diagnosis) and verify whether the resource was deleted or altered.

  3. The error is an IMS or IMS Queue Control Facility internal error, and should be reported to IBM® Software Support for resolution.
AIB reason codes have the following numbering scheme:
  • X'0xxx' MRQ/QCF initialization error (IQCQMR10)
  • X'1xxx' LOAD processing error (IQCQMR70)
  • X'2xxx' PURG processing error (IQCQMR70)
  • X'3xxx' SETPRFX error (IQCQMR80)
  • X'4xxx' CPYPRFX error (IQCQMR80)
  • X'5xxx' Error while trying to cancel the message (IQCQMR10)
  • X'6xxx' MRQ/QCF detected error and requested cleanup (QCF client)
  • X'7xxx' XLATPFX error (IQCQMR80)
  • X'8xxx' BROWSE processing error (IQCQMR30)
  • X'9xxx' QUERY processing error (IQCQMR60)
  • X'Axxx' UNLOAD processing error (IQCQMR50)
  • X'Bxxx' RECOVER processing error (IQCQMR40)
  • X'Cxxx' Select criteria error (IQCQMR20, IQCQMRA0)
  • X'Dxxx' Load processing error (IQCQMR70)
  • X'Exxx' Queue space notification error (IQCQMRD0)
  • X'Fxxx' Environmental errors (IQCQMRC0)

All AIB reason codes associated with AIB return code X'000000F0' are described in this section. If the AIBREASN code is not documented here, this is probably because IMS has added an additional code.

See the IMS DFSMRAEQ macro for the latest codes.