HPOS 4.0 technical note 3

HP Web Services for Output Server 45
Using HP Web Services for Output Server
Document transfer functions
The following is an example of COUNTSAPDEVICES XML contract request:
<wsg-request>
<operation-attributes>
<operation-type>COUNTSAPDEVICES</operation-type>
<user- info><![CDATA
[<user><username>hpos</username><password>hpos1</password><sysNum>00<
/sysNum>
<IP>16.74.60.119</IP><clientId>001</clientId><locale>EN</locale></user>]
]></user-info>
</operation-attributes>
<request-attributes>
</request-attributes>
</wsg-request>
The following is an example of COUNTSAPDEVICES XML contract response:
<wsg-response>
<status-code>0</status-code>
<status-message>success</status-message>
<operation-attributes/>
<device-info>
<device-count>1745</device-count>
</device-info>
</wsg-response>
Document transfer functions
The document transfer functions supported by Web Services for Output Server are as follows:
• HP Web Services for Output Server file transport
You can transfer documents as SOAP attachments over the HTTP protocol by using the HP Web Services for
Output Server file transport functionality. HP Web Services for Output Server uses the Public String
sendDocument(String docContract,DocumentData data) API for document transfer. The
SOAP attachments are transferred using the MTOM. For more information about MTOM, see
http://www.w3.org/TR/soap12-mtom/
.
• Document chunking
Document chunking is transferring a large file in smaller chunks. The client and the server must agree upon the
chunk size of the document. For example, a document of 2 GB can be broken into chunks of 20 KB each. The
server assembles the chunks, creates the original file, and persists it into a unique (named as session ID) user
folder.
NOTE: If the client sends a bulky document, for example of 2 GB, with chunking disabled, the
JBoss server might generate an error. A java.lang.OutOfMemory error in the JBoss
server.log file indicates that a higher heap size is required.
SSL
To configure SSL, perform the following steps:
1. Create keystores, which will hold the certificates using the following link: