Wsutil.jar is a command-line based Java application provided
as a test client to test your IBM InfoSphere Identity Insight Web
services installation and configuration. To use wsutil.jar, you specify
a wsutil.jar operator with the corresponding input and output modifiers.
The syntax for wsutil.jar usage is based on which Web
services operation you want to test:
wsutil (unix)
or wsutil.bat (win) --operator=URI --input=URI --output=URI
- help
- Displays online help and command line information for the wsutil.jar
test client.
- wsutil (unix) or wsutil.bat (win) --help
- load=URI
- Specifies pipeline style UMF records and the Uniform Resource
Identifier (URI) for the IBM InfoSphere Identity Insight Web services
interface.
- wsutil (unix) or wsutil.bat (win) --load=URI [--xslt=URI][--input=URI][--output=URI]
- This operation loads the UMF records from the specified URI into
the Web services pipelines for entity resolution processing. After
processing, the operation returns the entity ID and an indicator of
whether the inbound entity was merged with an existing entity or caused
a new entity to be created.
- process=URI
- Specifies generic XML or UMF records and the Uniform Resource
Identifier (URI) for the IBM InfoSphere Identity Insight Web services
interface.
- wsutil (unix) or wsutil.bat (win) --process=URI [--xslt=URI][--input=URI][--output=URI]
- Use this operation to process any UMF input document and receive
a UMF output document as a result. The process method is intended
to handle all requests and responses supported by the pipeline. It
is usually the method of choice for all operations.
- search=URI
- Specifies pipeline search style UMF requests and responses with
the Uniform Resource Identifier (URI) for the IBM InfoSphere Identity
Insight Web services interface.
- wsutil (unix) or wsutil.bat (win) --score=URI [--xslt=URI][--input=URI][--output=URI]
- This operation can either perform a search against the entity
database for a specific entity and returns requested information about
that entity, or it can query the entity database for entities that
match a given attribute and return the list of entities that matched
the query.
- xslt=URI
- Specifies the XSLT transform and the XML file the operation will
transform into UMF records.
- wsutil (unix) or wsutil.bat (win) --xslt=URI][--input=URI][--output=URI]
- Use this operation to transform XML records into UMF before using
one of the Web services operations.
wsutil.jar modifiers
Use these modifiers
with wsutil.jar operators to specify the input and output methods
for the Web services command.
- input=URI
- Specifies the input method for UMF records. The default input
method is stdin.
- output=URI
- Specifies the output method for UMF records. The default output
method is stdout. You can use this method to specify a location and
file name to save the UMF output to a file.
Example wsutil.jar usage
The following wsutil.jar
command on a UNIX system loads records from a file, transforms those
records into UMF, and displays the results on the command line interface
console:
wsutil --load=http://localhost:13510/easws/services/SRDWebService --input=raw_entities.xml --xslt=transform.xsl
The
following wsutil.jar command on a Windows system acquires requests
from stdin and displays the results on the command line interface
console:
wsutil.bat --process=http://localhost:13510/SRDWebService