ADDRESS AXC Commands › Commands for Automation Processing Data › CLOSEBUF Command

CLOSEBUF Command

The CLOSEBUF command closes an automated asynchronous session's host message stream buffer. (The OPENBUF command opens a buffer for an asynchronous session.)

This command has the following format:

"CLOSEBUF SESSION(sessname)"

SESSION

Specifies the name of a session (sessname) that has a message stream buffer that you want to terminate. The session must be an automated asynchronous session.

Usage Notes:

• Always issue a CLOSEBUF command to explicitly close a buffer that you opened with a previously issued OPENBUF command.
• If the specified session is automated-that is, if you chose to automate the session when you defined the session- any unread host messages in the buffer are lost when you issue the CLOSEBUF command.
• Only the REXX program that opened the buffer for the specified asynchronous session can close that session's buffer. If another REXX program tries to close the buffer, the CLOSEBUF command generates a return code of 3.
• If your REXX program issues a CALL statement to call another REXX program, the called program can close the buffer.