QMHSNDM()--Send Nonprogram Message for i5/OS PASE


  Syntax
 #include <os400msg.h>

 int QMHSNDM(const char  *msgid,
             const char   *msgf,
             const void   *msgdata,
             int          msgdataLen,    
             const char   *msgtype,
             const char   *msgqList,
             int          msgqCount,
             const char   *rpyq,
             int          *msgkey,
             void         *errcode);

 int QMHSNDM1(const char  *msgid,
              const char  *msgf,
              const void  *msgdata,
              int         msgdataLen,
              const char  *msgtype,
              const char  *msgqList,
              int         msgqCount,
              const char  *rpyq,
              int         *msgkey,
              void        *errcode,
              int         ccsid);
  Public Default Authority: *USE

  Library: Standard C Library (libc.a)

  Threadsafe: Yes

Note: These functions can only be used in an i5/OS PASE program. See i5/OS PASE for more information about creating i5/OS PASE programs.

The Send Nonprogram Message (QMHSNDM and QMHSNDM1) i5/OS PASE runtime functions allow an i5/OS PASE program to send a message to a nonprogram message queue so it can communicate with another job or user.


Parameters

These i5/OS PASE runtime functions accept the same arguments as the Send Nonprogram Message (QMHSNDM) i5/OS API, except that the i5/OS PASE functions use character string inputs that are null-terminated strings in the i5/OS PASE CCSID. i5/OS PASE runtime automatically converts input character strings to the job default CCSID and pads with blanks (as necessary) to match the fixed-length inputs required by the system API.

No conversions are done for the msgdata (input) argument and the errcode (input/output) argument because they can contain a mixture of character and binary data. The ccsid argument specifies the CCSID for character data in the msgdata argument, and users can request CCSID information for the errcode argument by using ERRC0200 format. The QMHSNDM i5/OS PASE runtime function uses the current i5/OS PASE CCSID as a default for the ccsid value passed to the system API.

See QMHSNDM()--Send Nonprogram Message for further description of the arguments for the QMHSNDM and QMHSNDM1 i5/OS PASE runtime functions.


Authorities

See QMHSNDM()--Send Nonprogram Message for information about authorities required for the QMHSNDM and QMHSNDM1 i5/OS PASE runtime functions.


Return Value

The function result is zero for normal completion. The result is nonzero if any input character string could not be converted to the job default CCSID or was too long for the QMHSNDM API, or if the QMHSNDM API returned error information in the errcode argument.


Related Information



API introduced: V5R1
Top | i5/OS PASE APIs | APIs by category