# tibemsMsg_ClearBody

Function

## Purpose

Clear the body of a message.

## C Declaration

    tibems_status tibemsMsg_ClearBody(
        tibemsMsg message );

## COBOL Call

    CALL "tibemsMsg_ClearBody"
         USING BY VALUE message,
               RETURNING tibems-status
    END-CALL.

Note: `message` has usage pointer.

## Parameters

Parameter | Description
--- | ---
`message` | Message to be cleared.

## Remarks

Clearing the body of a message leaves its header and property values unchanged.

If the message body was read-only, this function makes it writeable. The message body appears and behaves identically to an empty body in a newly created message.

Copyright © Cloud Software Group, Inc. All rights reserved.