$GETSMFB – Acquire a JES2 SMF buffer from the JES2 SMF buffer pool

Use $GETSMFB to obtain a buffer from the JES2 SMF buffer pool, clear the buffer contents to binary zeros, and return the address of this buffer in register 1. The macro returns condition code 0 and a 0 in register 1 if no buffers were available and WAIT=NO was specified in the macro.

Format description


>>-+--------+--$GETSMFB--+------------------------+------------->
   '-symbol-'            |           .-STANDARD-. |   
                         '-,SIZE--=--+-LARGE----+-'   

>--+------------------+----------------------------------------><
   |          .-NO--. |   
   '-WAIT--=--+-YES-+-'

SIZE=

Specifies the size of the SMF buffer to be obtained.

STANDARD: Indicates that the 920-byte standard size buffer be obtained. This is the default for the SIZE= parameter.
LARGE: Indicates that a 32K-byte SMF buffer be obtained.

WAIT=

Specifies the action to be taken if no JES2 SMF buffers are available as follows:

YES: Control is not returned to the caller until a JES2 SMF buffer has become available.
NO: An immediate return is made. If no buffers are available, register 1 contains a 0 on return to the calling routine. The condition code is nonzero if a buffer is available or 0 if no buffers are available.

Format description

Environment