login_reply
login_reply is an http response message to the login service request.

A login_reply response contains secure token and value (sid) in the http response message body. A UMS client application uses the sid in service requests to identify the client session created by the login service request.

A secure token is an unique id combined with its digital signature generated by UMS. Each secure token is encoded with base64 encoding.
http://en.wikipedia.org/wiki/Base64
http://tools.ietf.org/html/rfc4648
For the Simple Messaging API, login_reply sets the sid value in the message body, and also sets the following extension-header fields:

ums.service: login_reply
ums.mom: openmq
ums.status: 200
For the XML Messaging API, login_reply includes a SOAP message in the http response message body. The sid value is set to the sid attribute of the Service element of the SOAP message header. login_reply sets the following attributes of the message header:

<ums:Service
ums:service="login_reply"
ums:mom="openmq"
ums:sid="4-LTgxMDczMTczNQ== "
ums:status="200"/>
For both the Simple Messaging API and the XML Messaging API, a 200 status code indicates the login service request was successful. All other status codes indicate the login service request might not be successful.

1. Simple Messaging API Example:

The following is a login_reply response message.

HTTP/1.1 200 OK
Server: Apache-Coyote/1.1
ums.service: login_reply
ums.mom: openmq
ums.status: 200
Content-Type: text/plain;charset=UTF-8
Content-Length: 66
Date: Fri, 29 Aug 2008 22:03:58 GMT
4-LTgxMDczMTczNQ==
2. XML Messaging API Example:

The following is a login_reply response message that includes a SOAP message with Service element attribute values in the header.

HTTP/1.1 200 OK
Server: Apache-Coyote/1.1
Accept: text/xml, text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2
Content-Type: text/xml;charset=utf-8
Transfer-Encoding: chunked
Date: Sat, 23 Aug 2008 01:21:20 GMT
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header>
<ums:MessageHeader xmlns:ums="https://mq.java.net/ums" ums:id="1.0" ums:version="1.1">
<ums:Service
ums:service="login_reply"
ums:sid="4-LTgxMDczMTczNQ==" ums:status="200"/>
ums:mom="openmq"
</ums:MessageHeader>
</SOAP-ENV:Header>
<SOAP-ENV:Body/>
</SOAP-ENV:Envelope>
Back to UMS protocol page.