WHAT IMS RETURNS TO YOUR PROGRAM - IBM Mainframe

In addition to retrieving desired segments into the I/O area specified by your call, IMS returns status information about the call. For the high-level interface, this information is returned in the DL/I Interface Block (DIB). In the call-level interface, this information is returned in the PCB mask for the database being accessed. The fields in the DIB are as follows:

  • Translator Version - A two character code identifying the version of the DIB format being used (for documentation and troubleshooting).
  • Status Code - A two character code indicating whether the call was successful and, if not, why not. These return codes should be checked by your program after each call.
  • Segment Name - Name of the lowest level segment along the hierarchical path for which the call was successful.
  • Segment Level - Indicates the lowest hierarchical level for which the call was successful.
  • Key Feedback Length - Indicates the length of the concatenated key to the retrieved segment. If you want to see the actual key, you must specify the KEYFEEDBACK option on the call and reserve an area in the working storage large enough to accommodate the key.

The fields in the PCB mask are as follows:

  • Database Name - Name of the database being retrieved.
  • Segment Level - Indicates the lowest hierarchical level for which the call was successful.
  • Status Code - A two character code indicating whether the call was successful and, if not, why not. These return codes should be checked by your program after each call.
  • Processing Options - Four character code indicating all the functions this PSB can perform: G (GET), 1 (ISRT), R (REPL), D (DLET).
  • Segment Name - Name of the lowest level segment along the hierarchical path for which the call was successful.
  • Key Feedback Length - Indicates the length of the concatenated key to the retrieved segment.
  • Key Feedback Area - The actual concatenated key to the lowest level segment retrieved.

All rights reserved © 2018 Wisdom IT Services India Pvt. Ltd DMCA.com Protection Status

IBM Mainframe Topics