[Contents] [Prev] [Next] [Index] [Report an Error]

# Running Methods and Scripts for Dynamic Service Activator Services (SRC CLI)

To run a method or script for the Dynamic Service Activator Web service interface:

- Run the test dsa dsa-service command.
  `
  user@host> test dsa dsa-service (subscriber-login | subscriber-logout | subscriber-read-subscription | subscriber-activate-service | subscriber-deactivate-service | subscriber-modify-service | invoke-script | invoke-gateway-extension| subscribers-read | subscribers-read-subscriber)
  `

  where:

  - subscriber-login—Logs in subscribers.
  - subscriber-logout—Logs out subscribers.
  - subscriber-read-subscription—Determines whether a subscriber accesses services through the SRC owner’s network and obtains all of that subscriber’s subscriptions.
  - subscriber-activate-service—Activates subscribers’ subscriptions to services.
  - subscriber-deactivate-service—Deactivates subscribers’ subscriptions to services.
  - subscriber-modify-service—Modifies subscriptions.
  - invoke-script—Manages all operations involved with invoking scripts.
  - invoke-gateway-extension—Invokes a servlet that has been created and deployed in the Web Services Gateway Web application server.
  - subscribers-read—Reads attributes for the services, subscribers, and subscriptions of all subscriber sessions.
  - subscribers-read-subscriber—Reads attributes for the subscriber session.

- Testing Subscriber Logins and Logouts (SRC CLI)
- Testing Subscriber Access to Subscriptions (SRC CLI)
- Testing Subscription Activations and Deactivations (SRC CLI)
- Testing Subscription Modifications (SRC CLI)
- Testing Script Invocations (SRC CLI)
- Testing Gateway Extension Invocations (SRC CLI)
- Testing Access to Attributes for Subscriber Sessions (SRC CLI)
- Example: Testing Subscriber Access to Subscriptions

## Testing Subscriber Logins and Logouts (SRC CLI)

These methods support only subscribers who are identified by their IP addresses. These methods do not support subscribers who are identified by the names they use to log in or by their DNs.

Use the following commands to test the methods that log in and log out subscribers:

`

test dsa dsa-service subscriber-login <subscriber-uri subscriber-uri> <subscriber-id subscriber-id> <subscriber-password subscriber-password> <client-id client-id> <client-password client-password>

`
`

test dsa dsa-service subscriber-logout <subscriber-uri subscriber-uri> <client-id client-id> <client-password client-password>

`

## Testing Subscriber Access to Subscriptions (SRC CLI)

Use the following command to test the method that determines whether a subscriber accesses services through the SRC owner’s network and obtains all of that subscriber’s subscriptions:

`

test dsa dsa-service subscriber-read-subscription <subscriber-uri subscriber-uri> <attributes attributes> <filter filter> <client-id client-id> <client-password client-password>

`

## Testing Subscription Activations and Deactivations (SRC CLI)

Use the following commands to test the methods that activate and deactivate subscribers’ subscriptions to services:

`

test dsa dsa-service subscriber-activate-service <subscriber-uri subscriber-uri> service-name service-name <service-session service-session> <accounting-tag accounting-tag> <downstream-bandwidth downstream-bandwidth> <upstream-bandwidth upstream-bandwidth> <session-timeout session-timeout> <subscription-user subscription-user> <subscription-password subscription-password> <substitutions substitutions> <client-id client-id> <client-password client-password>

`
`

test dsa dsa-service subscriber-deactivate-service <subscriber-uri subscriber-uri> service-name service-name <service-session service-session> <client-id client-id> <client-password client-password>

`

## Testing Subscription Modifications (SRC CLI)

Use the following command to test the method that modifies subscribers’ subscriptions to services:

`

test dsa dsa-service subscriber-modify-service <subscriber-uri subscriber-uri> service-name service-name <service-session service-session> <accounting-tag accounting-tag> <downstream-bandwidth downstream-bandwidth> <upstream-bandwidth upstream-bandwidth> <session-timeout session-timeout> <subscription-user subscription-user> <subscription-password subscription-password> <substitutions substitutions> <client-id client-id> <client-password client-password>

`

## Testing Script Invocations (SRC CLI)

Use the following command to test the method that manages all operations involved with invoking scripts:

`

test dsa dsa-service invoke-script sae-script-name sae-script-name sae-script-arguments sae-script-arguments <client-id client-id> <client-password client-password>

`

This method retrieves requests to invoke scripts from the gateway client, authenticates the gateway client, verifies the arguments supplied by the gateway client, communicates with other SRC components, and returns values to the gateway client.

## Testing Gateway Extension Invocations (SRC CLI)

Use the following command to test the method that invokes a servlet that has been created and deployed in the Web Services Gateway Web application server:

`

test dsa dsa-service invoke-gateway-extension gateway-extension-name gateway-extension-name gateway-extension-arguments gateway-extension-arguments <client-id client-id> <client-password client-password>

`

The servlet can be a standalone application, or it can be part of a WAR or EAR file. When deployed, servlets invoked with this method should be accessible only from the local host.

## Testing Access to Attributes for Subscriber Sessions (SRC CLI)

Use the following command to test the method that reads attributes for the services, subscribers, and subscriptions of all subscriber sessions:

`

test dsa dsa-service subscribers-read <subscriber-uri subscriber-uri> <subscription-attributes subscription-attributes> <subscription-filter subscription-filter> <service-attributes service-attributes> <service-filter service-filter> <subscriber-attributes subscriber-attributes> <client-id client-id> <client-password client-password>

`

Use the following command to test the method that reads attributes for a subscriber session:

`

test dsa dsa-service subscribers-read-subscriber <subscriber-uri subscriber-uri> <subscriber-attributes subscriber-attributes> <client-id client-id> <client-password client-password>

`

## Example: Testing Subscriber Access to Subscriptions

To view a list of the Dynamic Service Activator client’s subscriptions:

1. Issue the test dsa dsa-service subscriber-read-subscription command.
2. Enter the required information (such as client ID, client password, and subscriber address). The entered data must match the data you configured.

   For example, this information is provided for Fred:

   `
   user@host> test dsa dsa-service subscriber-read-subscription client-id Fred client-password secret subscriber-address 10.19.1.6 subscriber-type ip attributes "serviceName"

       The Subscriber_readSubscription method was successfully performed for
       subURI: ip:ipAddress=10.19.1.6&timestamp=1216221624715
       serviceName: CoAService

   `

#### Related Topics

- Testing the Web Application Gateway Client
- Sample Data for Dynamic Service Activator
- Configuring the Test Environment for Dynamic Service Activator Services
- Running Methods for PCMM Services (SRC CLI)

[Contents] [Prev] [Next] [Index] [Report an Error]