Send a PIN message to BlackBerry devices

To send a PIN message message to multiple BlackBerry® devices, you can use the multi-object sendMessageToUsers() method. To send a PIN message to one BlackBerry device, you can use the single-object sendMessageToUsers() method.
Before you begin: Retrieve the following variables:
  • messageSubject string for the subject of the message that you want to send
  • messageBody string for the body of the message you want to send
  • userIDs integers for the user account IDs of the user accounts you want to send the message to.
  1. Create the message object.
    UserMessage message=new UserMessage();
    message.setSubject(messageSubject);
    message.setBody(messageBody);
  2. Specify the type of message that you want to send. To send a PIN message, use the DispatcherMessageTypeEnumType.PIN enumeration value.
    DispatcherMessageTypeEnum messageType=new DispatcherMessageTypeEnum();
    messageType.setEnum(DispatcherMessageTypeEnumType.PIN);
  3. Invoke sendMessageToUsers().
    SendMessageToUsersResult result=coreWebService.sendMessageToUsers(userIDs, message, messageType);
  4. Check the result for errors and handle any errors.
    if (result.getSendMessageToUsersReturnStatus().getCode()!= SendMessageToUserReturnStatusEnumType.SUCCESS) 
    {
        // handle any errors
    }

Was this information helpful? Send us your comments.