Los mensajes enviados y recibidos de las colas, se representan por el objeto SAMMessage. El objeto SAMMessage encapsula el cuerpo del mensaje (si existe alguno) y las propiedades de cabecera asociadas al mensaje. Un objeto SAMMessage es proporcionado como un parámetro a una operación de mensajería o devuelto como un resultado.
Ejemplo #1 Creación de un mensaje con un cuerpo de texto simple
<?php
$msg = new SAMMessage('Este es un mensaje de texto simple');
?>
Los mensajes deben tener las propiedades de cabecera asociadas, lo que permitirá tener control sobre el transporte del mensaje o información futura sobre la aplicación receptora. Por defecto las propiedades del mensaje se distribuirán al sistema de mensajería como strings y en ese caso pueden ser definidas con la siguiente sintaxis sencilla:
Ejemplo #2 Definición de una propiedad de formateado de texto utilizando la sintaxis por defecto
<?php
$msg->header->myPropertyName = 'textData';
?>
Si se desea pasar la información de tipo, se puede utilizar una sintaxis alternativa, donde el valor y la declaración de tipo son pasados en un array asociativo:
Ejemplo #3 Establecer una propiedad empleando una declaración de tipo
<?php
$msg->header->myPropertyName = array(3.14159, SAM_FLOAT);
?>
Las propiedades también pueden extraerse de la cabecera del mensaje.
Ejemplo #4 Recuperación de una propiedad desde la cabecera del mensaje
<?php
$myProperty = $msg->header->myPropertyName;
?>