MAKEBUF

Authorization

General User

Purpose

Use the MAKEBUF command to create a new buffer within the program stack.

Usage Notes

1. When you issue a MAKEBUF command, CMS returns as a return code the number of the program stack buffer just created. If you issue a MAKEBUF command in an exec that has the &ERROR statement in effect, the MAKEBUF return code causes the &ERROR statement to execute.
2. Use the LINERD or RDTERM macro, the WAITRD function, the PULL or PARSE REXX instruction, or the &READ statement in EXEC or EXEC 2 to read lines from the buffers created by MAKEBUF. For more information, see z/VM®: CMS Macros and Functions Reference.
3. When reading a line from the most recently created buffer, if this buffer is empty, it will be dropped (except for buffer 0) and the line will be read from the next buffer. This process will continue until a line is read. If there is no data to be read from the program stack, a line will be read from the terminal input buffer. If there is no data in the terminal input buffer, a line will be read from the virtual console. For more information on the program stack, see z/VM: CMS Application Development Guide.