modifySIBDestination command
Use the modifySIBDestination command to change properties of a bus destination for a service integration bus.
Para executar o comando, utilize o objeto AdminTask do cliente de script wsadmin.
O cliente de script wsadmin é executado do Qshell.
Para obter informações adicionais, consulte Configurando o Qshell para Executar Scripts do WebSphere Usando o Script wsadmin.
- Para obter uma lista dos comandos de barramento de integração de
serviços disponíveis no Jython e uma breve descrição de cada comando, digite o seguinte
comando no prompt wsadmin:
print AdminTask.help('SIBAdminCommands')
- Para obter ajuda de visão geral sobre um determinado comando, digite o seguinte comando no prompt wsadmin:
print AdminTask.help('command_name')
AdminConfig.save()
Purpose
The modifySIBDestination changes properties of a bus destination for a service integration bus.
Target object
A bus destination.
Required parameters
- -bus
- The name of the service integration bus on which the bus destination is configured. You can use the listSIBuses command to list the names of existing buses.
- -name
- The identifier by which this destination is known for administrative purposes.
Conditional parameters
None.
Optional parameters
- -description
- Specify a description for the bus destination, for administrative purposes.
- -reliability
- Specify the default reliability level to assign to a message produced
to this destination when an explicit reliability has not been set
by the producer application. A integração de serviços suporta cinco níveis de confiabilidade (também conhecidos como opções de entrega ou qualidades de serviço):
- BEST_EFFORT_NONPERSISTENT
- As mensagens são descartadas quando um mecanismo do sistema de mensagens para ou falha. As mensagens também podem ser descartadas se uma conexão usada para enviá-las torna-se disponível ou como um resultado de recursos do sistema restrito.
- EXPRESS_NONPERSISTENT
- As mensagens são descartadas quando um mecanismo do sistema de mensagens para ou falha. As mensagens também poderão ser descartadas se uma conexão utilizada para enviá-las ficar indisponível.
- RELIABLE_NONPERSISTENT
- As mensagens são descartadas quando um mecanismo do sistema de mensagens para ou falha.
- RELIABLE_PERSISTENT
- As mensagens podem ser descartadas quando um mecanismo do sistema de mensagens falha.
- ASSURED_PERSISTENT
- As mensagens não são descartadas.
Note: Os níveis mais altos de confiabilidade têm maior impacto sobre o desempenho.Para obter mais informações sobre níveis de confiabilidade de integração de serviços, consulteNíveis de Confiabilidade da Mensagem - Modo de Entrega de JMS e Qualidade da Integração de Serviço do Serviço.
- -overrideOfQOSByProducerAllowed TRUE | FALSE
- Controla a qualidade de serviço para os fluxos de mensagens entre os produtores e o destino. Selecione essa opção para utilizar a qualidade de serviço especificada pelos produtores, em vez da qualidade definida para o destino.
- -defaultPriority number
- -maxFailedDeliveries number
- Specify a value in the range 0 through 2147483647. A value of 0 (zero) means that if a message cannot be delivered on the first attempt, it is either forwarded to the exception destination or discarded, as defined by the -exceptionDestination parameter.
- -exceptionDestination value
- Por padrão, todas as mensagens que não puderem ser entregues para este destino serão roteadas
novamente para o destino de exceção padrão do sistema para o mecanismo do sistema de mensagens para o qual este destino
está designado (_SYSTEM.Exception.Destination.messaging_engine_name). Use este padrão para substituir o valor padrão. É possível configurar um destino de exceção específico para esse destino, ou especificar que mensagens que não podem ser entregues não sejam roteadas novamente para um destino de exceção, inserindo uma cadeia vazia ("") e, nesse caso, a contagem máxima de entregas com falha não terá efeito. Note: Uma mensagem que não pode ser entregue pode bloquear o processamento de outras mensagens que estão aguardando entrega para o mesmo destino.
- É possível usar essa opção e não especificar nenhum destino de exceção para preservar a ordem da mensagem.
- -sendAllowed TRUE | FALSE
- Clear this option (setting it to FALSE) to stop
producers from being able to send messages to this destination.
- For a queue point of a non-mediated destination, or a mediation point of a mediated destination, if you clear this option then new messages (from attached producers or forwarded from another destination) are redirected to any available message point. If no message points are available, then messages that have already been accepted onto the bus, and new messages from attached producers, are preserved by the bus until a message point becomes available. The only exception to this is the case of a destination with only one message point (queue point or mediation point depending on whether the destination is mediated or non-mediated), where the producer is attached to the same messaging engine. In this case, an exception message is generated on each send call. The exception message indicates that the only extant localization has been disabled for send. The producer remains open as usual, and any more send calls succeed if the Send allowed property of the localization is reselected (reset to TRUE).
- For a queue point of a mediated destination, if you clear this option then messages from mediation instances are redirected to any available message point. If no message points are available, then the messages are preserved by the bus until a message point becomes available. For any mediation instance (that is, on any server that has a mediation point), if the same server hosts a queue point, and that queue point is the only queue point for the destination, then the mediation changes to the "stopped on error" state.
- -receiveAllowed TRUE | FALSE
- For the message point, if you clear this option then any open consumers change state and an exception is generated if the consumer requests a message. Messages can continue to be sent, and accumulate on the message point.
- -receiveExclusive TRUE | FALSE
- Select this option (setting it to true) to allow only one consumer to attach to a destination. If you select this option, only a single consumer can be attached to each queue point of a queue destination at any one time. Subsequent consumers attempting to attach to a queue point with a consumer already attached are rejected.
- -maintainStrictMessageOrder TRUE | FALSE
- Select this option (setting it to TRUE) to maintain the order in which a producer sends messages to the destination.
- At run time, this property has priority over other configuration
property values. For information about the configuration properties
that are overridden at run time, see Ordenação de Mensagens Rigorosa para Destinos de Barramento.Note: If the strict message ordering is enabled on an existing topic destination, any existing durable subscriptions along with the messages associated become invalid. When the strict message ordering is enabled and the environment is restarted, the existing durable subscriptions are deleted and re-created; the messages that are associated with the durable subscriptions are also deleted.
- -topicAccessCheckRequired
- Include this option if authorization checks are required for access to topics.
- -replyDestination
- This property is intended for use with mediations on reply messages. For more information about the use of this property, see Configurando um Caminho de Roteamento Reverso de Destino.
- -replyDestinationBus
- The name of the bus on which the reply destination is configured. This property is intended for use with mediations on reply messages. For more information about the use of this property, see Configurando um Caminho de Roteamento Reverso de Destino.
- -delegateAuthorizationCheckToTarget
- Include this option if you want the authorization check to be performed on the target destination.
- -auditAllowed TRUE | FALSE
- Clear this option (setting it to FALSE) to prevent the bus from auditing topic level authorization checks when the bus and application server have auditing enabled. The default value is TRUE. You must have Audit Administrator privileges to use this parameter. The parameter is ignored if it is used in the creation of other types of destination.
- -defaultForwardRoutingPath
- The value to which a message forward routing path is set if the message contains no forward routing path. This identifies a sequential list of intermediary bus destinations that messages must pass through to reach a target bus destination. The format of the field is a list of bus destinations specified as bus_name:destination_name.
- -queuePoints
- A list of the queue points used by users of the alias destination.
If no specific queue points are supplied, all queue points can be
used. The target destination must be a queue destination in the same
bus as the alias destination definition. The target destination must
also be a queue destination with multiple queue points.
A queue point is specified in the following form: destination_name@messaging_engine_name
- -useAllQueuePoints TRUE | FALSE
- If you set this option to TRUE all available queue points are used whereas, if you set this option to FALSE, only those queue points in the list specified by the -queuePoints option are used.
- -mediationPoints
- A list of the mediation points used by users of the alias destination.
If no specific mediation points are supplied, all mediation points
can be used. The target destination must be a mediated queue destination
in the same bus as the alias destination definition. The target destination
must also be a queue destination with multiple mediation points.
A mediation point is specified in the following form: destination_name@messaging_engine_name
- -useAllMediationPoints TRUE | FALSE
- If you set this option to TRUE all available queue points are used whereas, if you set this option to FALSE, only those queue points in the list specified by the -mediationPoints option are used.
- -persistRedeliveryCount TRUE | FALSE
- Select this option (setting it to TRUE) to persist
the failed delivery counts of JMS messages in the message store. The
value for the option is set to FALSE by default.Important: Although the property is selected, the property will not be effective until the database tables are upgraded using the sibDBUpgrade command for WebSphere® Application Server Versão 9.0 and later.
Example
- Using Jython:
wsadmin>AdminTask.showSIBDestination(["-bus", "abus", "-name", "myqueue"]) "{receiveExclusive=false, defaultForwardRoutingPath=[], defaultPriority=0, exceptionDestination=_SYSTEM.Exception.Destination.node01.aserver-abus, uuid=97CC75AC71E5932CAB3417AC, overrideOfQOSByProducerAllowed=true, sendAllowed=true, maxFailedDeliveries=5, maxReliability=ASSURED_PERSISTENT, reliability=ASSURED_PERSISTENT, receiveAllowed=true, identifier=myqueue}" wsadmin>AdminTask.modifySIBDestination(["-bus", "abus", "-name", "myqueue", "-receiveAllowed", "FALSE"]) wsadmin>AdminTask.showSIBDestination(["-bus", "abus", "-name", "myqueue"]) "{receiveExclusive=false, defaultForwardRoutingPath=[], defaultPriority=0, exceptionDestination=_SYSTEM.Exception.Destination.node01.aserver-abus, uuid=97CC75AC71E5932CAB3417AC, overrideOfQOSByProducerAllowed=true, sendAllowed=true, maxFailedDeliveries=5, maxReliability=ASSURED_PERSISTENT, reliability=ASSURED_PERSISTENT, receiveAllowed=false, identifier=myqueue}"
- Using Jacl:
wsadmin>$AdminTask showSIBDestination {-bus abus -name myqueue} {receiveExclusive=false, defaultForwardRoutingPath=[], defaultPriority=0, exceptionDestination=_SYSTEM.Exception.Destination.node01.aserver-abus, uuid=97CC75AC71E5932CAB3417AC, overrideOfQOSByProducerAllowed=true, sendAllowed=true, maxFailedDeliveries=5, maxReliability=ASSURED_PERSISTENT, reliability=ASSURED_PERSISTENT, receiveAllowed=true, identifier=myqueue} wsadmin>$AdminTask modifySIBDestination {-bus abus -name myqueue -receiveAllowed FALSE} (cells/9994GKCCell01/buses/abus|sib-destinations.xml#SIBQueue_1098215169998) wsadmin>$AdminTask showSIBDestination {-bus abus -name myqueue} {receiveExclusive=false, defaultForwardRoutingPath=[], defaultPriority=0, exceptionDestination=_SYSTEM.Exception.Destination.node01.aserver-abus, uuid=97CC75AC71E5932CAB3417AC, overrideOfQOSByProducerAllowed=true, sendAllowed=true, maxFailedDeliveries=5, maxReliability=ASSURED_PERSISTENT, reliability=ASSURED_PERSISTENT, receiveAllowed=false, identifier=myqueue}
Example: Modify a destination alias "MyAlias2" to use a subset of the available queue points and mediation points:
- Using Jython:
cluster=AdminConfig.list("ServerCluster").splitlines()[0] Qp1=AdminConfig.list("SIBQueueLocalizationPoint" , cluster).splitlines()[0] Mp1=AdminConfig.list("SIBMediationLocalizationPoint").splitlines()[0] AdminTask.modifySIBDestination(["-bus" , "bus1" , "-name" , "MyAlias2", "-queuePoints", [[Qp1]], "-mediationPoints" , [[Mp1]]])
- Using Jacl:
set cluster [ lindex [ $AdminConfig list ServerCluster ] 1 ] set Qp1 [ lindex [ $AdminConfig list SIBQueueLocalizationPoint $cluster ] 0 ] set Mp1 [ lindex [ $AdminConfig list SIBMediationLocalizationPoint ] 0 ] $AdminTask modifySIBDestination {-bus bus1 -name MyAlias2 -queuePoints [[$Qp1]]-mediationPoints [[$Mp1]]}
Example: Modify a destination alias to remove any limitation on the queue points used:
- Using Jython:
AdminTask.modifySIBDestination(["-bus" , "bus1" , "-name" , "MyAlias2", "-queuePoints", [[]]])
- Using Jacl:
$AdminTask modifySIBDestination {-bus bus1 -name MyAlias2 -useAllQueuePoints=true -useAllMediationPoints=true}