| -Channel |
-Channel <MQChannel[]>
|
Specifies the channel objects to modify.
|
| -PassThru |
-PassThru
|
If specified, the modified channel object is passed through the pipeline for use by a later command.
|
| -Force |
-Force
|
Forces the cmdlet to try and create the channel, regardless of current ConfirmPreference value.
|
| -BatchHeartbeat |
-BatchHeartbeat <Int32[]>
|
Specifies the batch heartbeat interval for the new channel.
Batch heartbeating allows sender-type channels to determine whether the remote channel instance is still active, before going in-doubt. The value can be between 0 and 999999. A value of 0 indicates that batch heartbeating is not to be used. Batch heartbeat is measured in milliseconds.
|
| -BatchInterval |
-BatchInterval <Int32[]>
|
Specifies the Batch interval for the new channel.
This is the approximate time in milliseconds that a channel will keep a batch open, if fewer than BatchSize messages have been transmitted in the current batch.
|
| -BatchSize |
-BatchSize <Int32[]>
|
Specifies the Batch size for the new channel.
The maximum number of messages that should be sent down a channel before a checkpoint is taken. The batch size which is actually used is the lowest of the following:
- The BatchSize of the sending channel
- The BatchSize of the receiving channel
- The maximum number of uncommitted messages at the sending queue manager
- The maximum number of uncommitted messages at the receiving queue manager
The maximum number of uncommitted messages is specified by the MaxUncommittedMsgs parameter of Queue Manager.
|
| -Description |
-Description <String[]>
|
Specifies a description for the new channel definition.
|
| -ChannelMonitoring |
-ChannelMonitoring <MQC+ChannelMonitoringTypes[]>
|
Specifies whether online monitoring data is to be collected for the new channel and, if so, the rate at which the data is collected.
|
| -ChannelStatistics |
-ChannelStatistics <MQC+ChannelStatisticsTypes[]>
|
Specifies whether statistics data is to be collected for the new channel and, if so, the rate at which the data is collected.
|
| -ClusterName |
-ClusterName <String[]>
|
Specifies the name of the cluster to which the channel belongs.
|
| -ClusterNamelist |
-ClusterNamelist <String[]>
|
Specifies the name of the namelist that specifies a list of clusters to which the channel belongs.
|
| -ClusterWorkloadPriority |
-ClusterWorkloadPriority <Int32[]>
|
Specifies the channel priority for the purposes of cluster workload distribution.
|
| -ClusterWorkloadRank |
-ClusterWorkloadRank <Int32[]>
|
Specifies the channel rank for the purposes of cluster workload distribution.
|
| -ClusterWorkloadWeight |
-ClusterWorkloadWeight <Int32[]>
|
Specifies the channel weighting for the purposes of cluster workload distribution.
|
| -ConnectionName |
-ConnectionName <String[]>
|
Specifies the name of the machine as required for the channel's TransportType.
|
| -DataConversion |
-DataConversion <MQC+DataConversionTypes[]>
|
Specifies whether sender should convert application data.
|
| -DisconnectInterval |
-DisconnectInterval <Int32[]>
|
Specifies the maximum number of seconds that the channel waits for messages to be put on a transmission queue before terminating the channel. A value of zero causes the message channel agent to wait indefinitely.
|
| -HeaderCompression |
-HeaderCompression <MQC+HeaderCompressionTypes[]>
|
Specifies the list of header data compression techniques supported by the channel. For sender, server, cluster-sender, cluster-receiver, and client-connection channels, the values specified are in order of preference with the first compression technique supported by the remote end of the channel being used.
The channel's mutually supported compression techniques are passed to the sending channel's message exit where the compression technique used can be altered on a per message basis. Compression alters the data passed to send and receive exits.
|
| -HeartbeatInterval |
-HeartbeatInterval <Int32[]>
|
Specifies the heartbeat interval for the channel definition.
The interpretation of this parameter depends on the channel type, as follows:
For a channel type of Sender, Server, Receiver, Requester, ClusterSender, or ClusterReceiver, this is the time in seconds between heartbeat flows passed from the sending MCA when there are no messages on the transmission queue. This gives the receiving MCA the opportunity to quiesce the channel. To be useful, HeartbeatInterval should be significantly less than DisconnectInterval. However, the only check is that the value is within the permitted range.
For a channel type of ClientConnection or ServerConnection, this is the time in seconds between heartbeat flows passed from the server MCA when that MCA has issued an MQGET call with the MQGMO_WAIT option on behalf of a client application. This allows the server MCA to handle situations where the client connection fails during an MQGET with MQGMO_WAIT.
The value must be in the range 0 through 999 999. A value of 0 means that no heartbeat exchange occurs. The value that is actually used is the larger of the values specified at the sending side and receiving side.
|
| -KeepAliveInterval |
-KeepAliveInterval <Int32[]>
|
Specifies the value passed to the communications stack for KeepAlive timing for the channel.
|
| -LocalAddress |
-LocalAddress <String[]>
|
Specifies the local communications address for the channel.
|
| -LongRetryCount |
-LongRetryCount <Int32[]>
|
Specifies the long retry count for the channel.
When a sender or server channel is attempting to connect to the remote machine, and the count specified by ShortRetryCount has been exhausted, this specifies the maximum number of further attempts that are made to connect to the remote machine, at intervals specified by LongRetryInterval.
If this count is also exhausted without success, an error is logged to the operator, and the channel is stopped. The channel must subsequently be restarted with a command (it is not started automatically by the channel initiator), and it then makes only one attempt to connect, as it is assumed that the problem has now been cleared by the administrator. The retry sequence is not carried out again until after the channel has successfully connected.
|
| -LongRetryInterval |
-LongRetryInterval <Int32[]>
|
Specifies the long retry wait interval for a sender or server channel that is started automatically by the channel initiator. It defines the interval in seconds between attempts to establish a connection to the remote machine, after the count specified by ShortRetryCount has been exhausted.
The time is approximate; zero means that another connection attempt is made as soon as possible.
|
| -MaximumMessageLength |
-MaximumMessageLength <Int32[]>
|
Specifies the maximum message length that can be transmitted on the channel. This is compared with the value for the remote channel and the actual maximum is the lower of the two values.
The value zero means the maximum message length for the queue manager.
|
| -MCAName |
-MCAName <String[]>
|
Specifies the Message channel agent name.
|
| -MCAType |
-MCAType <MQC+MCATypeTypes[]>
|
Specifies the type of the message channel agent program.
|
| -MCAUserIdentifier |
-MCAUserIdentifier <Int32[]>
|
Specifies the Message channel agent user identifier. If this is nonblank, it is the user identifier which is to be used by the message channel agent for authorization to access WebSphere MQ resources, including (if PutAuthority is MQPA_DEFAULT) authorization to put the message to the destination queue for receiver or requester channels. If it is blank, the message channel agent uses its default user identifier.
|
| -MessageCompression |
-MessageCompression <MQC+MessageCompressionTypes[]>
|
Specifies the list of message data compression techniques supported by the channel. For sender, server, cluster-sender, cluster-receiver, and client-connection channels, the values specified are in order of preference with the first compression technique supported by the remote end of the channel being used.
|
| -ModeName |
-ModeName <String[]>
|
Specifies the LU 6.2 mode name for the channel.
|
| -MessageExit |
-MessageExit <String[]>
|
Specifies the message exit name. If a nonblank name is defined, the exit is invoked immediately after a message has been retrieved from the transmission queue. The exit is given the entire application message and message descriptor for modification.
|
| -MessageRetryCount |
-MessageRetryCount <Int32[]>
|
Specifies the number of times that a failing message should be retried.
|
| -MessageRetryExit |
-MessageRetryExit <String[]>
|
Specifies the message retry exit name. If a nonblank name is defined, the exit is invoked prior to performing a wait before retrying a failing message.
|
| -MessageRetryInterval |
-MessageRetryInterval <Int32[]>
|
Specifies the minimum time interval in milliseconds between retries of failing messages.
|
| -MessageRetryUserData |
-MessageRetryUserData <String[]>
|
Specifies user data that is passed to the message retry exit.
|
| -MessageUserData |
-MessageUserData <String[]>
|
Specifies user data that is passed to the message exit.
|
| -NetworkPriority |
-NetworkPriority <Int32[]>
|
Specifies the priority for the network connection. If there are multiple paths available, distributed queuing selects the path with the highest priority.
|
| -NonPersistentMessageSpeed |
-NonPersistentMessageSpeed <MQC+NonPersistentMessageSpeedTypes[]>
|
Specifies the speed at which nonpersistent messages are to be sent.
|
| -Password |
-Password <String[]>
|
Specifies a password for use by the message channel agent when attempting to initiate a secure SNA session with a remote message channel agent.
|
| -PutAuthority |
-PutAuthority <MQC+PutAuthorityTypes[]>
|
Specifies whether the user identifier in the context information associated with a message should be used to establish authority to put the message on the destination queue.
|
| -QueueManagerName |
-QueueManagerName <String[]>
|
Specifies the name of a queue manager to which a client application can request connection.
|
| -QueueSharingGroupDisposition |
-QueueSharingGroupDisposition <MQC+QueueSharingGroupDispositionTypes[]>
|
Specifies the disposition of the object to which you are applying the command.
|
| -ReceiveExit |
-ReceiveExit <String[]>
|
Specifies the receive exit name. If a nonblank name is defined, the exit is invoked before data received from the network is processed. The complete transmission buffer is passed to the exit and the contents of the buffer can be modified as required.
|
| -ReceiveUserData |
-ReceiveUserData <String[]>
|
Specifies user data that is passed to the receive exit.
|
| -SecurityExit |
-SecurityExit <String[]>
|
Specifies the name of a security exit to use.
|
| -SecurityUserData |
-SecurityUserData <String[]>
|
Specifies user data that is passed to the security exit.
|
| -SendExit |
-SendExit <String[]>
|
Specifies a Send exit name to use. If a nonblank name is defined, the exit is invoked immediately before data is sent out on the network. The exit is given the complete transmission buffer before it is transmitted; the contents of the buffer can be modified as required.
|
| -SendUserData |
-SendUserData <String[]>
|
Specifies user data that is passed to the send exit.
|
| -SequenceNumberWrap |
-SequenceNumberWrap <Int32[]>
|
Specifies the maximum message sequence number. When the maximum is reached, sequence numbers wrap to start again at 1.
|
| -ShortRetryCount |
-ShortRetryCount <Int32[]>
|
Specifies the maximum number of attempts that are made by a sender or server channel to establish a connection to the remote machine, at intervals specified by ShortRetryInterval before the (normally longer) LongRetryCount and LongRetryInterval are used.
|
| -ShortRetryInterval |
-ShortRetryInterval <Int32[]>
|
Specifies the short retry wait interval for a sender or server channel that is started automatically by the channel initiator. It defines the interval in seconds between attempts to establish a connection to the remote machine. The time is approximate; zero means that another connection attempt is made as soon as possible.
|
| -SSLCipherSpecification |
-SSLCipherSpecification <String[]>
|
Specify the name of the CipherSpec that you are using.
|
| -SSLClientAuthentication |
-SSLClientAuthentication <MQC+SSLClientAuthTypes[]>
|
Specifies whether WebSphere MQ requires a certificate from the SSL client.
|
| -SSLPeerName |
-SSLPeerName <String[]>
|
Specifies the filter to use to compare with the Distinguished Name of the certificate from the peer queue manager or client at the other end of the channel. (A Distinguished Name is the identifier of the SSL certificate.) If the Distinguished Name in the certificate received from the peer does not match the SSLPEER filter, the channel does not start.
|
| -TransactionProgramName |
-TransactionProgramName <String[]>
|
Specifies the LU 6.2 transaction program name.
|
| -TransportType |
-TransportType <MQC+TransmissionProtocolTypes[]>
|
Specifies the transmission protocol type.
|
| -UserIdentifier |
-UserIdentifier <String[]>
|
Specifies the task user identifier used by the message channel agent when attempting to initiate a secure SNA session with a remote message channel agent.
|
| -TransmissionQueueName |
-TransmissionQueueName <String[]>
|
Specifies the transmission queue name.
|
| -WhatIf |
-WhatIf
|
Describes what would happen if you executed the command without actually executing the command.
|
| -Confirm |
-Confirm
|
Prompts you for confirmation before executing the command.
|