NAME¶

new-message - (messages)

PURPOSE¶

Create new message.

SYNTAX¶

new-message <message> [ from <string> ]

DESCRIPTION¶

new-message will create a new <message> object.

If <string> is specified (in "from" clause), then it is used to create a <message> from it. The <string> must be in SEMI format, which may be in request's input, from get-message, from reading a file etc; in this case <message> can only be read from with read-message.

If new-message is used without "from" clause, data can be added to <message> with write-message.

EXAMPLES¶

begin-handler /msg public


    new-message msg


    write-message msg key "weather" value "nice"


    write-message msg key "distance" value "near"


    start-loop


        read-message msg key k value v status s


        if-true s not-equal GG_OKAY


            break-loop


        end-if


        @Key is <<print-out k>> and value is <<print-out v>>


    end-loop
end-handler

SEE ALSO¶

Messages

get-message new-message read-message SEMI write-message See all documentation