This information is for a release that is no longer supported by the Globus Toolkit. The currently supported versions of the Globus Toolkit are 4.2 (recommended) and 4.0.

WS Information Services : Developer's Guide

Overview
API: Aggregator | Service Data Providers
WS Service Data Providers
Web Service Data Browser
Querying Service Data (Xpath)
>Querying Service Data (ogsi-find-service-data)
Querying Examples
GLUE schema
Migrating from Pre-WS to WS: Porting Guide

Querying Service Data with ogsi-find-service-data

The ogsi-find-service-data command provides a command-line interface for querying the service data available to you from any Grid service:

  • By specifying a Grid service and one or more Service Data Element (SDE) names.
  • By specifying an XPath expression in addition to the above.

You can specify the ogsi-find-service-data command output as raw XML or as an easy-to-read outline format.

Note: ogsi-find-service-data is a client-side command; the services with which you are communicating can be on any machine.

Queries are handled through the host service's GridServicePortType findServiceDataoperation. 

ogsi-find-service-data

Note: Remember to set your environment before running a GT3.2 command.

The syntax of the ogsi-find-service-data command is as follows:

ogsi-find-service-data [options]

where:  
-service gsh Specifies the Grid Service Handle (GSH) of the service to be queried. If no handle is specified, then the following default is used:

http://localhost:8080/ogsa/services/base/registry/ContainerRegistryService
-querytype qtype

Specifies the type of query to be made, where qtype can be either name or xpath, as follows.  The default is –querytype name.

name

Performs an OGSI queryByServiceDataNames query and returns all matching SDEs.  One or more SDE names can be requested with the –sde option as follows:

-sde name

Specifies an SDE name to be queried.  Multiple SDE names can be specified by repeating the –sde parameter several times.  For example:

ogsi-find-service-data -sde gsdl:interface -sde gsdl:gridServiceHandle

xpath

Initiates a GT3.2 queryByServiceDataXPath query.  Either or both of the following options can be used with the xpath query type:

-sde name

Specifies an SDE name to be queried (same as used with the name query type described above). Only one SDE name can be specified in this case.

-xpath expr

Specifies an XPath expression to be used for the query.

-ns ‘string=namespace'

Specifies namespace-to-abbreviation mappings for use with the –sde and –xpath parameters.

The string is an abbreviation used to represent a namespace specified by a URI.

The –ns option can be used multiple times within a single ogsi-find-service-data command.

By default, the namespace mappings are defined as follows:

gsdl=http://www.gridforum.org/namespaces/2003/03/OGSI
-output format

Specifies the format of the output from the query operation.

The default format is raw, which prints the raw XML returned from the query to stdout.

servicegroup

Prints the GSHs of all services available in your GT3.2 configuration, in a non-XML, human friendly format. 

To see full details of the services, use the raw output mode instead.  As defined in the OGSI Specification, a service group is an abstract service that represents a group of other services.

registry

Same as the servicegroup parameter, but includes a comment line with a service description for each GSH printed.

pretty

Prints an easy-to-read outline of the returned service data, with namespaces stripped out.

anyname.xslt

Feeds the query result through the specified XSLT style sheet, which will be taken from $GLOBUS_LOCATION/libexec

-verbose

Prints detailed progress information for use in debugging.

-help

Prints a summary of the ogsi-find-service-data command syntax.