modifySIBWMQServer command

Use the modifySIBWMQServer command to modify a IBM MQ server.

You can modify a IBM MQ server by using the wsadmin tool as described in this topic, or by using the administrative console as described in Modifying an IBM MQ server definition.

如果要執行這個指令,請使用 wsadmin Scripting 用戶端AdminTask 物件

[IBM i][IBM i]wsadmin Scripting 用戶端是從 Qshell 執行. [IBM i]如需相關資訊,請參閱利用 wsadmin Script 配置 Qshell 來執行 WebSphere Script.

服務整合匯流排指令有指令行說明:
  • 如需 Jython 中可用的服務整合匯流排指令清單,以及每個指令的簡要說明,請在 wsadmin 提示下,輸入下列指令:

    print AdminTask.help('SIBAdminCommands')

  • 如需給定指令的概觀說明,請在 wsadmin 提示下,輸入下列指令:

    print AdminTask.help('command_name')

使用指令之後,請利用下列指令,儲存對主要配置所做的變更:

AdminConfig.save()

Purpose

IBM MQ 伺服器代表 IBM MQ 佇列管理程式或(若為 IBM MQ for z/OS)佇列共用群組。 This command modifies a IBM MQ server. It is not possible to modify the name or type attributes by using this command.

Note: When modifying a IBM MQ server, it is important to understand the significance of the name and serverName attributes. For example, if a WebSphere Application Server administrator creates a IBM MQ server called "My European Area Server" that represents a IBM MQ queue manager with the serverName QM1, it would then be possible for the administrator to create a second IBM MQ server called "My UK Country Server", which also represents the same queue manager.

Target object

A selected IBM MQ server.

Required parameters

-name
The name of the IBM MQ server. The name is specified when creating the IBM MQ server definition.

Conditional parameters

None

Optional parameters

-serverName
Name of the queue manager or queue-sharing group. This is the name by which the queue manager or queue-sharing group is identified. The value is allocated by IBM MQ administration to that IBM MQ resource. The administrator always uses the name that is allocated by IBM MQ administration.
-host
New value for the host attribute. This value is the name or the IP address of the host to which a connection is established when communicating with a queue manager or queue-sharing group that this IBM MQ server represents. The value is a string and must be one of the following:
  • Symbolic host name
  • IPv4 address
  • IPv6 address
-bindingsMode
New value for the bindingsMode attribute. This value determines whether bindings transport mode connections are used when connecting to a queue manager or queue-sharing group. Bindings mode connection is possible if the application server and the queue manager are on the same node, but connection is only allowed to a single queue manager, even if multiple queue managers exist on the same node. This parameter has two possible values:
TRUE
Bindings mode is used if available. If you select this option and bindings mode is not available, the connections mechanism defaults to client transport mode.
FALSE
Client mode is always used.
The default is TRUE.
-port
New value for the IBM MQ port attribute. This value is the TCP/IP port number on which the queue manager or queue-sharing group that this IBM MQ server represents listens. The default value is 1414.
-channel
New value for the IBM MQ channel attribute. This value is the IBM MQ client channel name to use when connecting to the queue manager or queue sharing group that this IBM MQ server represents. This name is allocated by IBM MQ administration to the IBM MQ object, and must always be used by the WebSphere Application Server administrator. The default value is SYSTEM.DEF.SVRCONN.
-description
New value for the description attribute. This value is a short description of the IBM MQ server, and is used for administrative purposes only.
-securityAuthAlias
New value for the securityAuthorizationAlias attribute. This value is the authentication alias to use when connecting to a queue manager or queue-sharing group. This parameter is not the same as the discovery authentication alias.
-transportChain
New value for the transportChain attribute. This value is the outbound transport chain to use when establishing a connection with IBM MQ. The default value is OutboundBasicWMQClient.
-trustUserIds
New value for the trustUserIds attribute. Determines whether user IDs received in messages from IBM MQ are propagated into the message or not (that is, whether user IDs received as part of message data are used in the service integration bus). The application user ID is always set from the jsAppUserId RFH2 value. If this is not present (either because the key/value pair is not present in the RFH2 header, or because the message does not have a RFH2 header), this field is not set. If you set this value to FALSE, the user ID is overwritten with the IBM MQ server name. This parameter has two possible values:
TRUE
User IDs are propagated into messages.
FALSE
User IDs are not propagated into messages.
The default is TRUE.
-allowDiscovery
New value for the allowDiscovery attribute. This value determines whether automated discovery of IBM MQ resources is performed. This parameter has two possible values:
TRUE
Automatic resource discovery is enabled.
FALSE
Automatic resource discovery is disabled.
The default is TRUE.
-discoveryAuthAlias
New value for the discoveryAuthAlias attribute. This value is the authentication alias to use when establishing a resource discovery connection to a queue manager or queue-sharing group, and is not the same as the security authentication alias parameter.
-replyToQueue
New value for the replyToQueue attribute. This value is the reply-to queue to use for resource discovery, is the name allocated by IBM MQ administration to the IBM MQ object, and must be the name of a model queue for a temporary dynamic queue. WebSphere Application Server administration must always use the name that is agreed with IBM MQ administration. The default is SYSTEM.DEFAULT.MODEL.QUEUE.

Example

  • Using Jython:
    wsadmin>AdminTask.modifySIBWMQServer(["-name", "Finance dept QM",
     "-allowDiscovery", "false"] )
  • Using Jacl:
    wsadmin>$AdminTask modifySIBWMQServer {-name "Finance dept QM"
     -allowDiscovery false}

指出主題類型的圖示 參照主題



時間戳記圖示 前次更新: July 9, 2016 11:12
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rjfp_cli_mqserver_mod
檔名:rjfp_cli_mqserver_mod.html