Using the DFSMSrmm web service sample client

This topic describes how to use the DFSMSrmm Web service sample client.

To use the DFSMSrmm Web service client, do this:

Download the /usr/lpp/dfsms/rmm/rmmSampleWSClient.java file from the z/OS file system directory to your workstation. This file is found in the SMP/E part name, EDGSJWS1, and contains sample code to use to access the DFSMSrmm Web service.
Compile the sample client source with javac rmmSampleWSClient.java. This generates several *.class files, where rmmSampleWSClient.class is the main executable.

Ensure that these libraries are added to your CLASSPATH:

Table 1. Libraries needed for DFSMSrmm web service
Name	Version Used	Download location
activation.jar	1.1	http://java.sun.com/products/javabeans/jaf/downloads/index.html
axis.jar	1.4	http://ws.apache.org/axis/
commons-discovery-0.2.jar	1.4	http://ws.apache.org/axis/
commons-logging-1.0.4.jar	1.4	http://ws.apache.org/axis/
jaxrpc.jar	1.4	http://ws.apache.org/axis/
log4j-1.2.8.jar or higher		http://logging.apache.org/log4j/2.x/download.html http://logging.apache.org/log4j/2.x/manual/migration.html
saaj.jar	1.4	http://ws.apache.org/axis/
wsdl4j-1.5.1.jar	1.4	http://ws.apache.org/axis/
mail.jar	1.4	http://java.sun.com/products/javamail/downloads/index.html
xerces-2.2.1.jar or higher		mirrors.ibiblio.org/pub/mirrors/maven2/xerces/xerces/2.2.1/xerces-2.2.1.jar

Build the program.

Invoke the client executable from a command prompt by: java rmmSampleWSClient -i ip_address [-p port] [-u userid:password] [-d] [-o output_file] [-x xml_schema] [-svwz] command

Where:

 i = IP-address or domain name of the remote server 
-p = Port number of the web service (default: 8080) 
-u = Authorized user credentials, separated by a colon (default: none) 
-o = Output file name (default: Screen output) 
-d = Debug mode, for network connection test only 
-x = XML schema file to be used for validation (default: No validation) 
-s = Short XML response (default: Long XML response) 
-v = Verbose mode On (default: Off) 
-w = Use WebSphere server (default: Use Tomcat server) 
-z = Zipped request (default: Unzipped request) 
command = A valid DFSMSrmm TSO subcommand e.g. "LISTCONTROL OPTION"

Note that zipped requests to a WebSphere server are not supported by this client.

An example showing these parameters is:

java rmmSampleWSClient -i 100.200.300.400 -u myuser:mypassword -o result.xml "LISTCONTROL ALL"

This issues the command "LISTCONTROL ALL" to a Tomcat web service on port 8080 (default) and stores the result into file result.xml.

You are now ready to use the DFSMSrmm Web service. You can add to this sample source, or write your own application based on the definitions and files contained in the Enterprise ARchive (EAR) file, rmmapi.ear.