You can programmatically enable and disable subscriptions through the use of scripts provided by the Assure Unified Interface, available for each platform where the Assure UI server runs. The scripts can be used within user-provided programs or scripts to automate the enabling or disabling of subscriptions.
Requirements:
The user that calls or runs the scripts must be a user known to the Assure UI server, and must have the proper credentials (user ID and password) to access the platform on which the Assure UI server resides. Once the user is authenticated on the platform, the user will be able to use the scripts.
When the Assure UI server is on an IBM i platform, the script must be run from QSHELL.
The location of the scripts is as follows:
On IBM i: /visionsolutions/http/vsisvr/httpsvr/bin
On Windows: c:\program files\visionsolutions\http\vsisvr\httpsvr\bin
The name of the script is manageSubscriptions. When the script is called with the -e parameter, subscriptions that match the other filtering parameters are enabled. When the script is called with the -d parameter, subscriptions that match the other filtering parameters are disabled.
The following table displays the other parameters that may be entered.
Parameter |
Description |
---|---|
-o |
Specifies the user who owns subscriptions that will be enabled or disabled. |
-p |
Specifies the product for which subscriptions will be enabled or disabled. |
-i |
Specifies the instance name for which subscriptions will be enabled or disabled. |
-s |
Specifies the subscription name for which subscriptions will be enabled or disabled. |
To enable subscriptions, enter the -e parameter.
Examples:
This command will enable all subscriptions for a specific subscription owner for a specific instance:
manageSubscriptions -e -o ownername -i instancename
This command will enable a specific subscription for a specific subscription owner:
manageSubscriptions -e -o ownername -s subscriptionname
To disable subscriptions, enter the -d parameter.
Examples:
This command will disable all subscriptions for a specific subscription owner:
manageSubscriptions -d -o ownername
This command will disable all MIMIX subscriptions for all subscription owners:
manageSubscriptions -d -p MIMIX