__le_record _dump() — Record information for the active condition
Standards
Standards / Extensions | C or C++ | Dependencies |
---|---|---|
Language Environment |
both | AMODE 64 |
Format
#include <__le_api.h>
int __le_record _dump(int function_code,
void *information);
General description
The __le_record _dump() function records information of the active condition, so that the information can be retrieved from the CIB later. Use this function only during condition handling.
- Parameter
- Description
- function_code
- A fullword integer that contains the function code of the following
value:
- 1
- Record the dataset name of a dump for the active condition.
- information
- The information to be recorded. When the value of function_code is 1, the information is a halfword length-prefixed EBCDIC character string, which is expected to be the dataset name of a dump for the active condition. Language Environment will validate that the length is positive and it does not exceed 44.
Returned value
If successful, __le_record_dump() returns 0.
If unsuccessful, __le_record_dump() returns nonzero and sets errno to one of the following values:
- Error Code
- Description
- EMVSERR
- No active CIB is available.
- EINVAL
- Incorrect parameters detected.
Usage notes
- After the condition handling functions return control to your application, CIB that represents the condition is no longer valid, therefore the recorded information is no longer accessible.
- If __le_record_dump() is called more than once for the same condition, the information of the last call is recorded.