+ HOME

+ DATA & ORBITS

+ MODELS

+ RESOURCES

+ RESEARCH

+ EDUCATION

RSI IDL SSC Web Services Example

The Satellite Situation Center (SSC) Web services allow a software developer to use portions of the SSC software in their own application.  The following describes an example of how to utilize the SSC Web Services from a client program written in the Research Systems Inc. (RSI) Iteractive Data Language (IDL) programming language. This example doesn't provide any useful, end-user functionality but is intended merely as an example for developers of client applications to examine.

Prerequisites

The following is required in order to execute the example program:

• IDL 6.0 or higher on a platform that supports the IDL-Java bridge. Refer to the IDL product documentation for the list of supported platforms and the procedure for configuring the IDL-Java bridge.
• Java 2 Standard Edition (J2SE) 1.4.1 or higher.
• Java^TM API for XML RPC (JAXRPC) 1.1 or higher run-time libraries.
• The SSC Web services SDK.

Mac OS X Note

The IDL-Java Bridge in IDL 6.1 on MacOS X 10.3 is hard-coded to point to Apple's Java 1.3.1 JVM.  Our web services libraries require routines in Java 1.4.  To use these on MacOS X 10.3, you may redirect Java calls to the Java 1.4 library with the following commands, at the risk of breaking other applications that require Java 1.3.1 and breaking updates to 1.3.1.  This requires using the Terminal program and giving an Administrator account password.  You are urged to add your name to RSI's feature request to allow for selection of a different VM on Mac OS X (CR#40370). cd /System/Library/Frameworks/JavaVM.framework/Versions/ sudo mv    1.3.1  1.3.1_keep sudo ln -s 1.4.2  1.3.1 # makes a symbolic link to the newer Java Reverse this by doing: cd /System/Library/Frameworks/JavaVM.framework/Versions/ sudo rm 1.3.1 sudo mv 1.3.1_keep 1.3.1

Example

The example IDL program is contained in the file WsExample.pro. In order to execute the program, save the WsExample.pro file to your computer where IDL is installed.

Instructions

The following instructions describe how to execute the example IDL program:

1. Follow the procedures for configuring the IDL-Java bridge provided with the IDL software.
   • The installation of IDL may automatically take care of all configuration issues but it is worth verifying the configuration and verifying that at least one of IDL-Java bridge examples provided with IDL functions correctly. Refer to Chapter 4: Using Java Objects in IDL in the What's New in IDL 6.0 document or Chaper 8: Using Java Objects in IDL in the External Development Guide.
2. Include the JAXRPC 1.1 jar files and the sscWebServices-client.jar file in your CLASSPATH. The specific procedure for accomplishing this varies depending upon the development environment (e.g., Unix or Microsoft windows) and the developer's preference (i.e., global environement variables or the idljavabrc configuration file).
   • The JAXRPC jar files are available in the Java Web Services Developer Pack (Java WSDP) version 1.3 or higher.
   • The sscWebServices-client.jar file is available for download in the SSC Web services SDK.
3. Start the IDL environment.
4. Compile the WsExample.pro program.
5. Execute the WsExample procedure and compare the output with what you expected from examining the IDL source code.