Error handling in IDMSIN01 calls from assembler

Products

• IDMS
• IDMS - Database

Issue/Introduction

This document clarifies how errors are to be handled in IDMSIN01 calls from an assembler program.

Environment

Release: All supported releases.

Resolution

One of the parameters on a call to the IDMSIN01 assembler macro is ERROR=error-label. For the purposes of this macro, an "ERROR" has occurred if the value in R15 after the call is non-zero. The ERROR parameter identifies a label to which control will be passed when an error has occurred (i.e., when R15 is not zero).

The specific R15 values are not documented, as there are many different functions and many possible values for each function. The best practice is to consider any non-zero R15 value as an unexpected condition which your program cannot handle.