WKBUF-START-RECORDING-FILE-APPEND

isCOBOL Evolve : Appendices : Library Routines : W$KEYBUF : WKBUF-START-RECORDING-FILE-APPEND

This operation causes keys typed by the user to be recorded in a file. If that file exists, the recorded keystrokes are appended to the existing file.

Keystrokes generated by WKBUF-ADD-TO-END and WKBUF-ADD-TO-BEGINNING, if any, are recorded along with the user input.

Use WKBUF-STOP-RECORDING to stop recording and close the file.

Syntax

CALL "W$KEYBUF" USING WKBUF-START-RECORDING-FILE-APPEND

fileName

GIVING returnCode

Parameters:

WKBUF-START-RECORDING-FILE-APPEND	Constant
fileName	PIC X(n)	Specifies the name of the file where recorded keystrokes are saved. It can be either a full or a relative pathname.

Return Code:

returnCode can be any numeric data item and provides additional information:

0	The file has been successfully opened for recording.
1	An I/O error occurred while opening the file.