httplistener component parameter values

Select the objects and properties associated with HTTP nodes that you want to change.

To change these properties, you must specify the broker name and -b httplistener. The httplistener component defines properties for the broker that are used for all the HTTPInput and HTTPReply nodes that you deploy to that broker, including a single listener for all HTTP nodes.

Choose the ObjectName from the following options:

The following combinations are valid for the httplistener component:

-o HTTPListener
The following properties and values are valid:
httpDispatchThreads
The value is the number of threads that the broker dedicates to managing HTTP tunneling clients.
  • Value type - integer
  • Initial value -32
httpProtocolTimeout
The value is the number of milliseconds in the HTTP protocol timeout interval. You can change this value to update the amount of time a broker is to wait for the next event during any phase of the HTTP tunneling protocol. A value of 0 causes the broker to wait indefinitely.
  • Value type - integer
  • Initial value -10000
-n maxKeepAliveRequests
The value is the maximum number of HTTP requests that can be pipelined until the connection is closed by the server. Setting the attribute to 1 disables HTTP/1.0 keep-alive, as well as HTTP/1.1 keep-alive and pipelining. Setting the value to -1 allows an unlimited amount of pipelined or keep-alive HTTP requests.
  • Value type - integer
  • Initial value -100
-n maxThreads
The value is the maximum number of request processing threads to be created by this Connector. This value, therefore, determines the maximum number of simultaneous requests that can be handled.
  • Value type - integer
  • Initial value - 200
enableSSLConnector
A Boolean value which can be used to enable or disable the HTTPS (SSL) connector. You must set this value to TRUE to start the HTTP listener listening for inbound SSL connections.
  • Value type - Boolean
  • Initial value - FALSE
-o HTTPConnector
The following properties and values are valid:
address
For servers with more than one IP address, this value specifies which address is used for listening on the specified port. By default, this port is used on all IP addresses associated with the server. If specified, only one address can be used.
  • Value type - string
  • Initial value - null
port
The TCP port number on which this HTTPConnector creates a server socket and awaits incoming connections.
  • Value type - integer
  • Initial value - 7080
-o HTTPSConnector
The properties listed for object name HTTPConnector are also valid for this object name. The following additional properties and values are valid:
algorithm
The certificate encoding algorithm to be used.
  • Value type - string
  • Initial value -
    • Solaris platformHP-UX platform SunX509 on Solaris and HP-UX
    • AIX platformz/OS platformLinux platformWindows platform IbmX509 on other systems (AIX®, Linux®, Windows®, z/OS®)
clientAuth
Set to true if the SSL stack requires a valid certificate chain from the client before accepting a connection. A false value (which is the default) does not require a certificate chain unless the client requests a resource protected by a security constraint that uses CLIENT-CERT authentication.
  • Value type - string
  • Initial value - false
keystoreFile
The path to the keystore file where the server certificate, which is to be loaded, has been stored. By default, the HTTP listener expects a file called .keystore in the home directory of the user who started the broker.
  • Value type - string
  • Initial value - default value (described previously)
keystorePass
The password used to access the server certificate from the specified keystore file.
  • Value type - string
  • Initial value - changeit
keystoreType
The type of keystore file to be used for the server certificate.
  • Value type - string
  • Initial value - JKS
sslProtocol
The version of the SSL protocol to use.
  • Value type - string
  • Initial value - SSLv3
ciphers
A comma separated list of the encryption ciphers that can be used. If not specified (the default), then any available cipher can be used.
  • Value type - string
  • Initial value - null

The properties listed for object name HTTPConnector are also valid for this object name. The valid values for keystoreType, sslProtocol, and ciphers are JSSE-implementation specific, and these values are in the JSSE provider documentation.

See the mqsichangeproperties command for examples of how to change parameters for the httplistener component. Other examples are provided for particular tasks:

Related reference
mqsichangeproperties command
mqsireportproperties command
HTTPInput node
HTTPReply node
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Last updated : 2009-01-07 15:22:34

an09141_