{
{    The purpose of this request is to move the contents of the message to a
{ specified data area and to release the message.
{
{    NOTE:  If the message identifier is invalid, a system error ('Buffer
{          Manager Caller') will occur.
{
{       NLP$BM_FLUSH_MESSAGE (DATA_AREA, MESSAGE_ID, MESSAGE_LENGTH, STATUS)
{
{ DATA_AREA: (input)  This parameter specifies a data area to receive the
{       message contents.
{
{ MESSAGE_ID: (input, output)  This parameter specifies the identifier of the
{       message to be flushed.  An invalid identifier will be returned if the
{       request completes successfully.
{
{ MESSAGE_LENGTH: (output)  This parameter specifies the length of the message
{       content moved to the data area.
{
{ STATUS: (output) This parameter specifies the request status.
{       CONDITIONS:
{             nae$data_area_too_small
{
