Commande createWSNAdministeredSubscriber
La commande createWSNAdministeredSubscriber permet de créer un abonné administré.
Vous pouvez créer un abonné administré par WS-Notification à l'aide de l'outil wsadmin, comme décrit dans cette rubrique, ou de la console d'administration, comme décrit dans Création d'un abonné administré WS-Notification.
Vous n'avez pas à définir d'abonné géré pour tous les noeuds finaux exposés par le service WS-Notification sur lequel il est défini, car cela pourrait engendrer une boucle sans fin de messages via le courtier de notification.
Pour exécuter la commande, utilisez l'objet AdminTask du client de scriptage wsadmin.
Le client de scriptage wsadmin est exécuté à partir de Qshell.
Pour plus d'informations, voir Configuration de Qshell pour exécuter des scripts WebSphere à l'aide de l'outil de scriptage wsadmin.
- Pour obtenir une liste des commandes WS-Notification disponibles et une brève description de chacune d'elles, entrez la commande suivante à l'invite wsadmin :
print AdminTask.help('WSNotificationCommands')
- Pour obtenir une aide générale sur une commande donnée,
entrez la commande suivante à l'invite wsadmin :
print AdminTask.help('nom_commande')
AdminConfig.save()
Rôle
Cette commande permet d'ajouter un nouvel abonné administré WS-Notification au point de service WS-Notification cible.
Objet cible
WSNServicePoint
Paramètres requis
- -endpoint
- Il s'agit de la référence de noeud final (adresse Web) d'une application émettrice ou de courtier de notifications. Exemple : http://remoteproducer.com.
- -topic
- Ceci décrit la classe de messages de notification remis au point de service WS-Notification. Par exemple, stock/IBM. Cette propriété peut inclure des caractères génériques s'ils sont pris en charge par le dialecte de sujet sélectionné.
- -dialect
- Il s'agit du nom du dialecte de sujet choisi tel qu'il est défini par la spécification WS-Topics.. Les valeurs de ce paramètre sont SIMPLE, CONCRET et COMPLET. Pour plus d'informations, voir Spécification WS-Topics.
Paramètres conditionnels
Aucun.
Paramètres optionnels
- -topicNamespace
- Vous pouvez ignorer cette zone si le sujet se trouve dans l'espace de nom de sujet adéquat.
- -remoteSubscriptionTimeout
- Ce délai d'attente réduit la possibilité d'abonnements orphelins dans le service Web distant si le serveur local n'est pas installé. Cette zone n'indique pas l'heure à laquelle l'abonnement distant doit expirer. Définissez un délai supérieur à la durée de mise hors ligne du serveur pour que le flux des messages du service Web distant ne soit pas interrompu. Quand le serveur est en cours de fonctionnement, il renouvelle occasionnellement le temps de résiliation de l'abonnement à distance (avec le délai indiqué) afin de l'empêcher d'expirer au cours de l'opération normale. S'il n'est pas indiqué, le délai est défini par défaut à 24 (heures).
Exemple
- Avec Jython :
newAdminSub = AdminTask.createWSNAdministeredSubscriber(newServicePoint, ["-endpoint", "http://myremotehost:9080/producerEP", "-dialect", "SIMPLE", "-topic", "stock", "-topicNamespace", "http://example.org/mynamespace", "-remoteSubscriptionTimeout", 48] )
- A l'aide de Jacl :
set newAdminSub [ $AdminTask createWSNAdministeredSubscriber $newServicePoint { -endpoint http://myremotehost:9080/producerEP -dialect SIMPLE -topic stock -topicNamespace http://example.org/mynamespace -remoteSubscriptionTimeout 48 } ]