dmgetsubscriptionstatus: Get subscription status

Use this command to retrieve information indicating the current state of subscriptions and to send the results to standard output.

Syntax

dmgetsubscriptionstatus -I <instance_name> [-p] <-A|-s <subscription_name> ...> [-L <locale>]

Parameters

-I <instance_name>

Specifies the name of the IBM InfoSphere CDC instance. Alternatively, you can specify the TSINSTANCE environment variable in place of this value.

-p

Specifies that IBM InfoSphere CDC sends state information to standard output.

-A

Specifies that IBM InfoSphere CDC retrieves state information for all subscriptions.

-s <subscription_name>

Specifies the name of the subscription for which state information is retrieved. List the subscriptions if you specify more than one.

-L <locale>

The name of the locale used for the IBM InfoSphere CDC instance. The default is your machine’s locale.

Result

This command returns one of the following:

▪0—If the specified subscriptions have a state of Inactive.

▪1—If any of the specified subscriptions have a state other than Inactive.

▪A negative value—If an error has occurred while retrieving status information.

Examples

dmgetsubscriptionstatus -I myinstance -p -A

IBM InfoSphere CDC retrieves state information for all subscriptions and sends the results to standard output for the specified instance.