Client software uses return codes to provide information about operations on the client. The value that is returned as a return code from a CLIv2 routine is generated by the CLIv2 routine itself or is passed back from some other client-resident module used by the CLIv2 routine. A return code of zero is normal, and a return code of nonzero represents an exception.
A return code can appear in three areas:
- In the Assembler register 15 (the most direct and reliable location to find a return code)
- In a parameter in the call itself (if CLIv2 cannot access this parameter, the return code will not appear here)
- In the Return-code field of the DBCAREA (if CLIv2 cannot access the DBCAREA or this field, the return code will not appear here)