[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


NAME
    CreateRexxMsg - Create an ARexx message structure

SYNOPSIS
    rexxmsg = CreateRexxMsg(port, extension, host)
    D0,A0                   A0    A1         D0

    struct RexxMsg *CreateRexxMsg(struct MsgPort *, UBYTE *, UBYTE *);

FUNCTION
    This functions allocates an ARexx message packet.  The RexxMsg
    consists of a standard EXEC message structure extended to include
    the ARexx specific information.

INPUTS
    port - A pointer to a public or private message port.  This *MUST*
           be a valid port as this is where the message will be replied.

    extension - A pointer to a NULL terminated string that is to be used
                as the default extension for the REXX scripts.  If this
                is NULL, the default is "REXX"

    host - A pointer to a NULL terminated string that is to be used
           as the default host port.  The name must be the same as the
           name of the public message port that is to be the default host.
           If this field is NULL, the default is REXX.

RESULTS
    rexxmsg - A RexxMsg structure

NOTES
    The extension and host strings must remain valid for as long as the
    RexxMsg exists as only the pointer to those strings are stored.

SEE ALSO
    DeleteRexxMsg(), ClearRexxMsg(), FillRexxMsg()

BUGS