API call to start recording

A call to start recording will increment the user count by 1 for each start command. When the count was initially at zero, then the VSAM interim file is opened and the collection exits are installed. It is not until the user count returns to zero, by using the stop recording calls, that the exits are removed from the CICS system. This allows for the possibility of multiple users recording at the same time.

To start recording, an EXEC CICS LINK call needs to be made to program BZUCIDRP passing it a COMMAREA in the following format:

Area Type	Description
Character 4 bytes	The function that the API is to perform. Set this value to STRT.
Integer 4 bytes	The status code returned by the call. Refer to the API Status Codes table.
Integer 4 bytes	CICS response code (EIBRESP) if an error occurred.
Integer 4 bytes	CICS response code (EIBRESP2) if an error occurred.
Hex 8 bytes	The API calls returns a token, which must be preserved and passed back on the STOP and TRAP calls.