# tibemsTextMsg_Create

Function

## Purpose

Create a text message.

## C Declaration

    tibems_status tibemsTextMsg_Create(
       tibemsTextMsg* message );

## COBOL Call

    CALL "tibemsTextMsg_Create"
         USING BY REFERENCE message,
               RETURNING tibems-status
    END-CALL.

Note: `message` has usage pointer.

## Parameters

Parameter | Description
--- | ---
`message` | Store a pointer to the new message.

## Remarks

Create a new text message.

When your application creates a message, it also allocates storage for that message. This storage must subsequently be freed by a call to `tibemsMsg_Destroy`.

## See Also

`tibemsMsg_Create`

`tibemsMsg_Destroy`

`tibemsSession_CreateTextMessage`

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