The DBRC API token

The DBRC API token is a 4 byte field that is used to relate a series of API requests.

Your program receives this token when a DSPAPI FUNC=STARTDBRC macro is issued. This token must be supplied with all other macro calls that are associated with this instance of the STARTDBRC macro. The token is no longer valid after a DSPAPI FUNC=STOPDBRC macro call. Your program does not receive a token if the macro encounters a severe error (return code X'0000000C'). If the function receives a warning error (return code X'00000004'), find the meaning of the accompanying reason code in DBRC start request (STARTDBRC) to determine what action is needed.