Automating enabling and disabling subscriptions - assure_mimix - Latest

Assure Unified Interface Guide

Product type
Software
Portfolio
Integrate
Product family
Assure
Product
Assure MIMIX™ Software for AIX
Version
Latest
Language
English
Product name
Assure Unified Interface
Title
Assure Unified Interface Guide
Copyright
2021
First publish date
2010
Last updated
2024-02-09
Published on
2024-02-09T05:11:34.582000

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.

Table 10.Parameters for manageSubscriptions script.

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