Interface WBEMConfigurationProperties


public interface WBEMConfigurationProperties
The interface WBEMConfigurationProperties contains the names of all configuration properties that are recognized by the CIM Client.
  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final String
    If set to false, the embedded object entity in all requests is in mixed case (EmbeddedObject) per DSP0203.
    static final String
    Tells the XML builder how to sign embedded objects.
    static final String
    Specifies the XML parser for parsing CIM-XML responses.
    The SAX parser is the default choice since it is fast, resource saving and interoperable.
    static final String
    If set to true, the CIM-XML parser will allow empty LOCALNAMESPACEPATH elements in incoming responses.
    static final String
    If set the type of valueless EmbeddedObjects are mapped to CLASS_T.
    static final String
    Specifies the stream to use for tracing CIM-XML communication in the event the application does not set one via the LogAndTraceManager class.
    static final String
    Enables or disables tracing of CIM-XML communication.
    static final String
    A URL string giving the location of the CIM client config file.
    static final String
    If set to true, gzip encoding is enabled.
    static final String
    The Java class name of the authentication module to use for http authentication.
    static final String
    Specifies how often the client will retry to connect to a CIMOM which refused the connection in the first place.

    Type: Integer
    Recognition: Anytime
    Range: 0 ..
    static final String
    Specifies the threshold above which a http document is regarded as valid by the content length retry algorithm.

    Type: Integer
    Recognition: Anytime
    Range: 0 ..
    static final String
    Specifies if the client will discard and request again http documents with less than a given number of bytes.

    Type: Boolean
    Recognition: Anytime
    Range: true, false
    Default: false
    static final String
    The size of the internal http connection pools.
    static final String
    The timeout for http requests.
    static final String
    Specifies if chunking is used for transmitting http messages.

    Type: Boolean
    Recognition: Anytime
    Range: true, false
    Default: true
    static final String
    Specifies if MPOST is used for transmitting http messages.
    static final String
    Specifies the http protocol version to use.
    static final String
    The WWW-Authenticate information to use when sending the first request to a server.
    static final String
    Turn on/off usage of the default user/password, which can be used if the CIMOM requires a "garbage" credential.
    static final String
    The credential of the user for the "garbage" credential.
    static final String
    The name of the user for the "garbage" credential.
    static final String
    The password of the keystore.

    Type: String
    Recognition: On next SSL connection
    Default: none
    static final String
    The file path of the SSL keystore.

    Type: String
    Recognition: On next SSL connection
    Default: none
    static final String
    The type of the keystore.

    Type: String
    Recognition: On next SSL connection
    Range: PKCS12, JKS, ...
    Default: JKS
    static final String
    If set to true, a property will be added to all indications that identifies the sender's IP address.
    static final String
    The number of queued connections that is tolerated before the thread pool creates an additional handler thread.
    static final String
    The default value to use for the CIM_IndicationService DeliveryRetryAttempts property.
    static final String
    The default value to use for the CIM_IndicationService DeliveryRetryInterval property.
    static final String
    If set to true, reliable indication support is enabled and indications are processed accordingly.
    static final String
    The idle time of a worker that is tolerated before the worker is destroyed by the thread pool.
    static final String
    The header timeout for http connections of an indication listener.
    static final String
    The maximum allowable timeouts an http connection of an indication listener can have before the client ignores it.
    static final String
    The timeout for http connections of an indication listener.
    static final String
    The filter to use for tracing of incoming indications at the FINE level.
    static final String
    The size of the thread pool for the connection handlers of the indication for http connections of an indication listener.
    static final String
    The maximum number of queued connections (the fixed capacity of the ArrayBlockingQueue of pending connections incoming to the listener).
    static final String
    The maximum number of queued events (the fixed capacity of the LinkedList of indications awaiting delivery to the listener).
    static final String
    The minimal number of connection handlers of the indication listener that will be kept open by the thread pool regardless of the current load.
    static final String
    The default value to use for the reliable indication handler's initial hash table capacity.
    static final String
    Sets the minimum level for messages to be written to the console logger file.

    Type: Discrete
    Recognition: Startup
    Range: OFF, SEVERE, WARNING, INFO, CONFIG, ALL
    Default: OFF, which disables console logging completely.
    static final String
    Sets the type of the console logger.
    static final String
    Sets the number of log files to cycle through.
    static final String
    Sets the minimum level for messages to be written to the log file.

    Type: Discrete
    Recognition: Startup
    Range: OFF, SEVERE, WARNING, INFO, CONFIG, ALL
    Default: OFF, which disables file logging completely.
    static final String
    A string specifying the location of the log file.
    static final String
    Sets the maximum size in bytes of a single log file.
    static final String
    If set to true, SSL handshakes are performed after an SSL socket is created by the socket factory.
    static final String
    The timeout for socket connect requests.
    static final String
    If set to true, socket connections are attempted with the timeout value defined by sblim.wbem.socketConnectTimeout.
    static final String
    The idle timeout between socket requests after which the socket is automatically reset (closed, then reopened).
    static final String
    The comma-separated list of cipher suites that are to be disabled by the client when connecting via an SSL socket.
    static final String
    Determines if a HTTPS client will attempt to authenticate the server (i.e.
    static final String
    The protocol used for SSLContext.getInstance(String protocol) by a client.
    static final String
    The key manager factory algorithm name.

    Security property: JRE global access via Security.setProperty() and Security.getProperty() !

    Type: String
    Recognition: On next SSL connection
    Range: IbmX509, SunX509, ...
    Default: JRE specific
    static final String
    The comma-separated list of cipher suites that are to be disabled by the listener when connecting via an SSL socket.
    static final String
    Determines how a HTTPS listener will handle authentication of a client (i.e.
    static final String
    The protocol used for SSLContext.getInstance(String protocol) by a listener.
    static final String
    The protocol used for SSLContext.getInstance(String protocol).
    static final String
    The provider to use for creation of SSL server sockets.

    Security property: JRE global access via Security.setProperty() and Security.getProperty() !

    Type: Java class name
    Recognition: On next SSL connection
    Default: Security.getProviders("SSLContext.SSL")
    static final String
    The provider to use for creation of SSL client sockets.

    Security property: JRE global access via Security.setProperty() and Security.getProperty() !

    Type: Java class name
    Recognition: On next SSL connection
    Default: Security.getProviders("SSLContext.SSL")
    static final String
    The trust manager factory algorithm name.

    Security property: JRE global access via Security.setProperty() and Security.getProperty() !

    Type: String
    Recognition: On next SSL connection
    Range: IbmX509, SunX509, ...
    Default: JRE specific
    static final String
    If set to true, numeric key data types in a CIMInstance's CIMObjectPath will be synchronized to match those of the corresponding keys within the CIMInstance's CIMProperty[].
    static final String
    If set to false, SSL handshakes are not synchronized.
    static final String
    Sets the number of log files to cycle through.
    static final String
    Sets the minimum level for messages to be written to the trace file.

    Type: Discrete
    Recognition: Startup
    Range: OFF, SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST, ALL
    Default: OFF, which disables file tracing completely
    static final String
    A string specifying the location of the trace file.
    static final String
    Sets the maximum size in bytes of a single log file.
    static final String
    The password of the truststore.

    Type: String
    Recognition: On next SSL connection
    Default: none
    static final String
    The file path of the SSL truststore.

    Type: String
    Recognition: On next SSL connection
    Default: none
    static final String
    The type of the truststore.

    Type: String
    Recognition: On next SSL connection
    Range: PKCS12, JKS, ...
    Default: JKS
    static final String
    If set to true, numeric string values passed to the java.lang.Double constructor or its parseDouble method will be checked to make sure they are not in the range that hangs Java 6- (see Sun bug 4421494).
  • Field Details

    • CONFIG_URL

      static final String CONFIG_URL
      A URL string giving the location of the CIM client config file.

      By default the SBLIM CIM Client looks for
      • file:sblim-cim-client2.properties
      • file:%USER_HOME%/sblim-cim-client2.properties
      • file:/etc/java/sblim-cim-client2.properties
      The first file found will be used. The default search list is not applied if this property is set, even if the given URL does not exist.
      See Also:
    • LOG_FILE_LEVEL

      static final String LOG_FILE_LEVEL
      Sets the minimum level for messages to be written to the log file.

      Type: Discrete
      Recognition: Startup
      Range: OFF, SEVERE, WARNING, INFO, CONFIG, ALL
      Default: OFF, which disables file logging completely.
      See Also:
    • LOG_FILE_LOCATION

      static final String LOG_FILE_LOCATION
      A string specifying the location of the log file. The string may include the following special components that will be replaced at runtime:
        / the local pathname separator
        %t the system temporary directory
        %h the value of the "user.home" system property
        %g the generation number to distinguish rotated logs
        %u a unique number to resolve conflicts
        %% translates to a single percent sign "%"
      Thus for example a pattern of %t/java%g.log with a count of 2 would typically cause log files to be written on Unix to /var/tmp/java2.log

      Type: String
      Recognition: Startup
      Default: %t/cimclient_log_%g.txt.
      See Also:
    • LOG_FILE_SIZE_LIMIT

      static final String LOG_FILE_SIZE_LIMIT
      Sets the maximum size in bytes of a single log file. When the limit is reached a new file is created. A limit of zero will create a new log file for every log record !

      Type: Integer
      Recognition: Startup
      Range: 0 .. Integer.MAX_VALUE
      Default: 100.000
      See Also:
    • LOG_FILE_COUNT

      static final String LOG_FILE_COUNT
      Sets the number of log files to cycle through. When the number is exceeded the oldest file is dropped.

      Type: Integer
      Recognition: Startup
      Range: 1 .. Integer.MAX_VALUE
      Default: 5
      See Also:
    • LOG_CONSOLE_LEVEL

      static final String LOG_CONSOLE_LEVEL
      Sets the minimum level for messages to be written to the console logger file.

      Type: Discrete
      Recognition: Startup
      Range: OFF, SEVERE, WARNING, INFO, CONFIG, ALL
      Default: OFF, which disables console logging completely.
      See Also:
    • LOG_CONSOLE_TYPE

      static final String LOG_CONSOLE_TYPE
      Sets the type of the console logger. Maybe either message log or trace log.

      Type: Discrete
      Recognition: Startup
      Range: MESSAGE, TRACE
      Default: MESSAGE.
      See Also:
    • TRACE_FILE_LEVEL

      static final String TRACE_FILE_LEVEL
      Sets the minimum level for messages to be written to the trace file.

      Type: Discrete
      Recognition: Startup
      Range: OFF, SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST, ALL
      Default: OFF, which disables file tracing completely
      See Also:
    • TRACE_FILE_LOCATION

      static final String TRACE_FILE_LOCATION
      A string specifying the location of the trace file. The string may include the following special components that will be replaced at runtime:
        / the local pathname separator
        %t the system temporary directory
        %h the value of the "user.home" system property
        %g the generation number to distinguish rotated logs
        %u a unique number to resolve conflicts
        %% translates to a single percent sign "%"
      Thus for example a pattern of %t/java%g.log with a count of 2 would typically cause log files to be written on Unix to /var/tmp/java2.log

      Type: String
      Recognition: Startup
      Default: %t/cimclient_trace_%g.txt
      See Also:
    • TRACE_FILE_SIZE_LIMIT

      static final String TRACE_FILE_SIZE_LIMIT
      Sets the maximum size in bytes of a single log file. When the limit is reached a new file is created. A limit of zero creates a new file for each trace record !

      Type: Integer
      Recognition: Startup
      Range: 0 .. Integer.MAX_VALUE
      Default: 1.000.000
      See Also:
    • TRACE_FILE_COUNT

      static final String TRACE_FILE_COUNT
      Sets the number of log files to cycle through. When the number is exceeded the oldest file is dropped.

      Type: Integer
      Recognition: Startup
      Range: 1 .. Integer.MAX_VALUE
      Default: 5
      See Also:
    • HTTP_TIMEOUT

      static final String HTTP_TIMEOUT
      The timeout for http requests. A timeout of zero is interpreted as infinite timeout.

      Type: Integer
      Unit: Milliseconds
      Recognition: Anytime
      Range: 0 .. Integer.MAX_VALUE
      Default: 0
      See Also:
    • HTTP_POOL_SIZE

      static final String HTTP_POOL_SIZE
      The size of the internal http connection pools. Each WBEMClient instance has it's own http connection pool. A positive value defines the number of connections, zero that no connection will be reused, and -1 all connections will be reused (when it's possible).

      Type: Integer
      Recognition: Anytime
      Range: -1, 0, 1 .. Integer.MAX_VALUE
      Default: 16
      See Also:
    • HTTP_AUTHENTICATION_MODULE

      static final String HTTP_AUTHENTICATION_MODULE
      The Java class name of the authentication module to use for http authentication.

      Type: String
      Recognition: On next authentication
      Range: org.sblim.cimclient.internal.http.WwwAuthInfo, org.sblim.cimclient.internal.http.PegasusLocalAuthInfo or any self-written subclass of org.sblim.cimclient.internal.http.AuthorizationInfo
      Default: org.sblim.cimclient.internal.http.WwwAuthInfo
      See Also:
    • HTTP_WWW_AUTHENTICATE_INFO

      static final String HTTP_WWW_AUTHENTICATE_INFO
      The WWW-Authenticate information to use when sending the first request to a server.

      Note: This string must exactly match what the server returns in the
      WWW-Authenticate field of an HTTP 401 response when authentication
      fails. The following two strings are examples:

       Basic realm="Secure Area"
       Digest realm="testrealm@host.com",qop="auth,auth-int",nonce="dcd98b7102dd2f0e8b11d0f600bfb0c093",opaque="5ccc069c403ebaf9f0171e9517f40e41"
       
      Type: String
      Recognition: On next authentication
      Range: Basic, Digest
      Default: none
      See Also:
    • HTTP_USE_MPOST

      static final String HTTP_USE_MPOST
      Specifies if MPOST is used for transmitting http messages. If false, POST is used.

      Type: Boolean
      Recognition: Anytime
      Range: true, false
      Default: true
      See Also:
    • HTTP_USE_CHUNKING

      static final String HTTP_USE_CHUNKING
      Specifies if chunking is used for transmitting http messages.

      Type: Boolean
      Recognition: Anytime
      Range: true, false
      Default: true
      See Also:
    • HTTP_VERSION

      static final String HTTP_VERSION
      Specifies the http protocol version to use. This option is useful if the protocol negotiation fails.

      Type: String
      Recognition: Anytime
      Range: 1.0, 1.1
      Default: 1.1
      See Also:
    • HTTP_CONNECTION_RETRIES

      static final String HTTP_CONNECTION_RETRIES
      Specifies how often the client will retry to connect to a CIMOM which refused the connection in the first place.

      Type: Integer
      Recognition: Anytime
      Range: 0 .. Integer.MAX_VALUE
      Default: 0
      See Also:
    • HTTP_ENABLE_CONTENT_LENGTH_RETRY

      static final String HTTP_ENABLE_CONTENT_LENGTH_RETRY
      Specifies if the client will discard and request again http documents with less than a given number of bytes.

      Type: Boolean
      Recognition: Anytime
      Range: true, false
      Default: false
      See Also:
    • HTTP_CONTENT_LENGTH_THRESHOLD

      static final String HTTP_CONTENT_LENGTH_THRESHOLD
      Specifies the threshold above which a http document is regarded as valid by the content length retry algorithm.

      Type: Integer
      Recognition: Anytime
      Range: 0 .. Integer.MAX_VALUE
      Default: 50
      See Also:
    • KEYSTORE_PATH

      static final String KEYSTORE_PATH
      The file path of the SSL keystore.

      Type: String
      Recognition: On next SSL connection
      Default: none
      See Also:
    • KEYSTORE_TYPE

      static final String KEYSTORE_TYPE
      The type of the keystore.

      Type: String
      Recognition: On next SSL connection
      Range: PKCS12, JKS, ...
      Default: JKS
      See Also:
    • KEYSTORE_PASSWORD

      static final String KEYSTORE_PASSWORD
      The password of the keystore.

      Type: String
      Recognition: On next SSL connection
      Default: none
      See Also:
    • TRUSTSTORE_PATH

      static final String TRUSTSTORE_PATH
      The file path of the SSL truststore.

      Type: String
      Recognition: On next SSL connection
      Default: none
      See Also:
    • TRUSTSTORE_TYPE

      static final String TRUSTSTORE_TYPE
      The type of the truststore.

      Type: String
      Recognition: On next SSL connection
      Range: PKCS12, JKS, ...
      Default: JKS
      See Also:
    • TRUSTSTORE_PASSWORD

      static final String TRUSTSTORE_PASSWORD
      The password of the truststore.

      Type: String
      Recognition: On next SSL connection
      Default: none
      See Also:
    • SSL_SOCKET_PROVIDER

      static final String SSL_SOCKET_PROVIDER
      The provider to use for creation of SSL client sockets.

      Security property: JRE global access via Security.setProperty() and Security.getProperty() !

      Type: Java class name
      Recognition: On next SSL connection
      Default: Security.getProviders("SSLContext.SSL")
      See Also:
    • SSL_SERVER_SOCKET_PROVIDER

      static final String SSL_SERVER_SOCKET_PROVIDER
      The provider to use for creation of SSL server sockets.

      Security property: JRE global access via Security.setProperty() and Security.getProperty() !

      Type: Java class name
      Recognition: On next SSL connection
      Default: Security.getProviders("SSLContext.SSL")
      See Also:
    • SSL_PROTOCOL

      static final String SSL_PROTOCOL
      The protocol used for SSLContext.getInstance(String protocol). For IBMJSSE2 provider it can be "SSL_TLS".

      Security property: JRE global access via Security.setProperty() and Security.getProperty()
      Recognition: On next SSL connection
      Default: "SSL"
      See Also:
    • SSL_CLIENT_PROTOCOL

      static final String SSL_CLIENT_PROTOCOL
      The protocol used for SSLContext.getInstance(String protocol) by a client. This property overrides any value set via the ssl.Protocol property.

      Recognition: On next SSL connection
      Default: none
      See Also:
    • SSL_LISTENER_PROTOCOL

      static final String SSL_LISTENER_PROTOCOL
      The protocol used for SSLContext.getInstance(String protocol) by a listener. This property overrides any value set via the ssl.Protocol property.

      Recognition: On next SSL connection
      Default: none
      See Also:
    • SSL_KEYMANAGER_ALGORITHM

      static final String SSL_KEYMANAGER_ALGORITHM
      The key manager factory algorithm name.

      Security property: JRE global access via Security.setProperty() and Security.getProperty() !

      Type: String
      Recognition: On next SSL connection
      Range: IbmX509, SunX509, ...
      Default: JRE specific
      See Also:
    • SSL_TRUSTMANAGER_ALGORITHM

      static final String SSL_TRUSTMANAGER_ALGORITHM
      The trust manager factory algorithm name.

      Security property: JRE global access via Security.setProperty() and Security.getProperty() !

      Type: String
      Recognition: On next SSL connection
      Range: IbmX509, SunX509, ...
      Default: JRE specific
      See Also:
    • SSL_CLIENT_PEER_VERIFICATION

      static final String SSL_CLIENT_PEER_VERIFICATION
      Determines if a HTTPS client will attempt to authenticate the server (i.e. CIMOM) by verifying the server certificate.

      If false, do not attempt verification. If true, the client will attempt to verify the server certificate against the contents of the truststore; in this case a valid path must be defined in "javax.net.ssl.trustStore" or no connection will be permitted.

      Type: Boolean
      Recognition: On initialization of a new client
      Default: false
      See Also:
    • SSL_LISTENER_PEER_VERIFICATION

      static final String SSL_LISTENER_PEER_VERIFICATION
      Determines how a HTTPS listener will handle authentication of a client (i.e. indication sender):
        ignore do not examine the client certificate
        accept examine client certificate if presented; do not fail if not presented
        require examine client certificate; fail if not presented
      If set to "ignore", do not attempt verification. If set to "accept" or "require", the listener will attempt to verify the sender against the contents of the truststore; in this case a valid path must be defined in "javax.net.ssl.trustStore" or no connection will be permitted.

      Type: String
      Recognition: On next call to addListener()
      Default: ignore
      See Also:
    • SSL_CLIENT_CIPHER_SUITES_TO_DISABLE

      static final String SSL_CLIENT_CIPHER_SUITES_TO_DISABLE
      The comma-separated list of cipher suites that are to be disabled by the client when connecting via an SSL socket. In general, this is the list of cipher suites considered "too weak" for use in a particular environment.

      Type: String
      Recognition: On initialization of a new client
      Default: none
      See Also:
    • SSL_LISTENER_CIPHER_SUITES_TO_DISABLE

      static final String SSL_LISTENER_CIPHER_SUITES_TO_DISABLE
      The comma-separated list of cipher suites that are to be disabled by the listener when connecting via an SSL socket. In general, this is the list of cipher suites considered "too weak" for use in a particular environment.

      Type: String
      Recognition: On next call to addListener()
      Default: none
      See Also:
    • CIMXML_PARSER

      static final String CIMXML_PARSER
      Specifies the XML parser for parsing CIM-XML responses.
      The SAX parser is the default choice since it is fast, resource saving and interoperable. The streaming algorithm of the PULL parser uses the fewest possible resources but at the prize to keep the CIMOMs response open for a long time. That works with many but not all CIMOMs. The DOM parser is slow and resource hungry but nice to debug.

      Type: Discrete
      Recognition: Anytime
      Range: DOM, PULL, SAX
      Default: SAX
      See Also:
    • CIMXML_TRACING

      static final String CIMXML_TRACING
      Enables or disables tracing of CIM-XML communication. The trace is sent to an output stream the application has to set via the LogAndTraceManager class.

      Type: Boolean
      Recognition: Anytime
      Range: true, false
      Default: false
      See Also:
    • CIMXML_TRACE_STREAM

      static final String CIMXML_TRACE_STREAM
      Specifies the stream to use for tracing CIM-XML communication in the event the application does not set one via the LogAndTraceManager class. This stream can either be standard output (System.out), standard error output (System.err) or a filename to be opened by the client. Note: This property has no effect unless sblim.wbem.cimxmlTracing is set to true. Note: This property has no effect if the application already set the stream prior to client initialization. If the application sets the stream after client initialization, the stream specified by this property is overridden. Note: If a filename is specified, it is opened and all CIM-XML communication is written to it - no checks are made for an existing file or for filling up the disk. USE WITH CAUTION. Type: String
      Recognition: Startup
      Range: System.out, System.err, filename
      Default: none
      See Also:
    • CIMXML_EMBOBJBUILDER

      static final String CIMXML_EMBOBJBUILDER
       Tells the XML builder how to sign embedded objects. This is necessary due to
       the non-consequent handling of embedded objects on different CIMOMs.
       "AttribOnly"       - only the EmbeddedObject="instance/object" is used
                            (should be good for Pegasus)
       "EmbObjQuali"      - on qualified CIM-XML elements the EmbeddedObject qualifier is used
                            for embedded classes and instances
       "EmbObjAndEmbInstQuali" -
                            on qualified CIM-XML elements the EmbeddedObject qualifier is used
                            for embedded classes and the EmbeddedInstance="className" qualifier
                            is used for embedded instances 
       Type: String
       Recognition: Anytime
       Range: AttribOnly, EmbObjQuali, EmbObjAndEmbInstQuali
       Default: AttribOnly
       
      See Also:
    • CIMXML_PARSER_STRICT_EMBOBJ_TYPES

      static final String CIMXML_PARSER_STRICT_EMBOBJ_TYPES
       If set the type of valueless EmbeddedObjects are mapped to CLASS_T. It should work well
       with OpenPegasus-2.7.0.
       If unset no type mapping is done for valuless EmbeddedObjects.  
       
       Type: Boolean
       Default: true
       
      See Also:
    • CIMXML_BUILDER_UPPERCASE_EMBOBJ_ENTITIES

      static final String CIMXML_BUILDER_UPPERCASE_EMBOBJ_ENTITIES
       If set to false, the embedded object entity in all requests is in mixed case
       (EmbeddedObject) per DSP0203.  If set to true, the embedded object entity is in
       upper case (EMBEDDEDOBJECT) - this works with some older CIMOMs, such as OpenPegasus 
       2.6.1 and 2.7.0.
       
       <!ENTITY % EmbeddedObject "EmbeddedObject (object|instance) #IMPLIED">
       
       Type: Boolean
       Recognition: Startup
       Range: true, false
       Default: true
       
      See Also:
    • PERFORM_SSL_HANDSHAKE

      static final String PERFORM_SSL_HANDSHAKE
       If set to true, SSL handshakes are performed after an SSL socket is created by the
       socket factory.  If set to false, handshakes are not performed, which is useful if
       if the handshake has already taken place.
       
       Type: Boolean
       Recognition: Anytime
       Default: true
       
      See Also:
    • SYNCHRONIZED_SSL_HANDSHAKE

      static final String SYNCHRONIZED_SSL_HANDSHAKE
       If set to false, SSL handshakes are not synchronized.  If set to true, SSL handshakes
       are synchronized as a workaround for an IBMJSSE1 problem with thread-safe handshakes.
       
       Note: This property has no affect unless sblim.wbem.performSslHandshake is set to 
       true.
       
       Type: Boolean
       Recognition: Anytime
       Default: false
       
      See Also:
    • SOCKET_CONNECT_WITH_TIMEOUT

      static final String SOCKET_CONNECT_WITH_TIMEOUT
       If set to true, socket connections are attempted with the timeout value defined by 
       sblim.wbem.socketConnectTimeout.  If set to false, socket connections are attempted
       without a timeout.  Using a timeout for socket connections is the preferred method
       but may introduce intermittent, significant performance impacts during the connection 
       process in Java 5+ (see Sun bug 5092063).   
       
       Type: Boolean
       Recognition: Anytime
       Default: true
       
      See Also:
    • SOCKET_CONNECT_TIMEOUT

      static final String SOCKET_CONNECT_TIMEOUT
       The timeout for socket connect requests. A timeout of zero is interpreted
       as infinite timeout.
       
       Note: This property has no effect unless socket connection with timeout is
       enabled (see the sblim.wbem.socketConnectWithTimeout property).
       
       Type: Integer
       Unit: Milliseconds
       Recognition: Anytime
       Range: 0 .. Integer.MAX_VALUE
       Default: 0
       
      See Also:
    • SOCKET_IDLE_TIMEOUT

      static final String SOCKET_IDLE_TIMEOUT
      The idle timeout between socket requests after which the socket is automatically reset (closed, then reopened). A timeout of zero is interpreted as infinite timeout.
      Type: Integer
      Unit: Milliseconds
      Recognition: Anytime
      Range: 0 .. Integer.MAX_VALUE
      Default: 0
      See Also:
    • KEY_CREDENTIALS_DEFAULT_ENABLED

      static final String KEY_CREDENTIALS_DEFAULT_ENABLED
       Turn on/off usage of the default user/password, which can be used
       if the CIMOM requires a "garbage" credential.  If set to false,
       user-supplied credentials will be applied.  If set to true,
       default credentials will be applied when both the user-supplied
       principal and credential are null/empty.
       
       Type: Boolean
       Recognition: Startup
       Default: false
       
      See Also:
    • KEY_DEFAULT_PRINCIPAL

      static final String KEY_DEFAULT_PRINCIPAL
       The name of the user for the "garbage" credential.
       
       Note: This property has no effect unless default authorization is
       enabled (see the sblim.wbem.default.authorization.enabled property)
       AND both the user-supplied principal and credential are null/empty.
       
       Type: String
       Recognition: Startup
       Default: "default"
       
      See Also:
    • KEY_DEFAULT_CREDENTIAL

      static final String KEY_DEFAULT_CREDENTIAL
       The credential of the user for the "garbage" credential.
       
       Note: This property has no effect unless default authorization is
       enabled (see the sblim.wbem.default.authorization.enabled property)
       AND both the user-supplied principal and credential are null/empty.
       
       Type: String
       Recognition: Startup
       Default: "default"
       
      See Also:
    • LISTENER_HTTP_TIMEOUT

      static final String LISTENER_HTTP_TIMEOUT
      The timeout for http connections of an indication listener. A timeout of zero is interpreted as infinite timeout.

      Type: Integer
      Unit: Milliseconds
      Recognition: On next creation of a WBEMListener
      Range: 0 .. Integer.MAX_VALUE
      Default: 10000
      See Also:
    • LISTENER_HTTP_HEADER_TIMEOUT

      static final String LISTENER_HTTP_HEADER_TIMEOUT
      The header timeout for http connections of an indication listener. The header timeout is defined as the maximum amount of time allowed to read in the entire http header. A timeout of zero is interpreted as infinite timeout.

      Note: One form of DoS attack sends periodic http header lines in an attempt to keep the socket open indefinitely. This timeout can be used to thwart such an attempt.

      Type: Integer
      Unit: Milliseconds
      Recognition: On next creation of a WBEMListener
      Range: 0 .. Integer.MAX_VALUE
      Default: 30000
      See Also:
    • LISTENER_HTTP_MAX_ALLOWED_TIMEOUTS

      static final String LISTENER_HTTP_MAX_ALLOWED_TIMEOUTS
      The maximum allowable timeouts an http connection of an indication listener can have before the client ignores it. In other words, the number of times an IP exceeds sblim.wbem.listenerHttpTimeout and sblim.wbem.listenerHttpHeaderTimeout before it is blocked. A value of zero is interpreted as unlimited timeouts.

      Type: Integer
      Recognition: On next creation of a WBEMListener
      Range: 0 .. Integer.MAX_VALUE
      Default: 0
      See Also:
    • LISTENER_MAX_POOL_SIZE

      static final String LISTENER_MAX_POOL_SIZE
      The size of the thread pool for the connection handlers of the indication for http connections of an indication listener. This is the maximum number of handler threads the pool might create on heavy load.
      A value of -1 is interpreted as infinity.
      Type: Integer
      Unit: Count
      Recognition: On next creation of a WBEMListener
      Range: -1 .. Integer.MAX_VALUE
      Default: 8
      See Also:
    • LISTENER_MIN_POOL_SIZE

      static final String LISTENER_MIN_POOL_SIZE
      The minimal number of connection handlers of the indication listener that will be kept open by the thread pool regardless of the current load.
      Type: Integer
      Unit: Count
      Recognition: On next creation of a WBEMListener
      Range: 0 .. Integer.MAX_VALUE
      Default: 2
      See Also:
    • LISTENER_MAX_QUEUE_SIZE

      static final String LISTENER_MAX_QUEUE_SIZE
      The maximum number of queued connections (the fixed capacity of the ArrayBlockingQueue of pending connections incoming to the listener). Whereas increasing this number will result in a correspondingly greater memory usage, making the number too small can result in HTTP 503 "Service temporarily overloaded" returned to server if there is no room in queue for an incoming connection.
      Type: Integer
      Unit: Count
      Recognition: On next creation of a WBEMListener
      Range: 1 .. Integer.MAX_VALUE
      Default: 32
      See Also:
    • LISTENER_BACKLOG

      static final String LISTENER_BACKLOG
      The number of queued connections that is tolerated before the thread pool creates an additional handler thread. Increasing this value leads to a less "nervous" creation/destruction of handlers. However it makes the listener more vulnerable to frozen connections.

      Type: Integer
      Unit: Count
      Recognition: On next creation of a WBEMListener
      Range: 0 .. Integer.MAX_VALUE
      Default: 2
      See Also:
    • LISTENER_HANDLER_MAX_IDLE

      static final String LISTENER_HANDLER_MAX_IDLE
      The idle time of a worker that is tolerated before the worker is destroyed by the thread pool. By setting the minimal pool size >0 you can protect a given number of worker from destruction.

      Type: Long
      Unit: Milliseconds
      Recognition: On next creation of a WBEMListener
      Range: 0 .. Long.MAX_VALUE
      Default: 30000
      See Also:
    • LISTENER_MAX_QUEUED_EVENTS

      static final String LISTENER_MAX_QUEUED_EVENTS
      The maximum number of queued events (the fixed capacity of the LinkedList of indications awaiting delivery to the listener). When the maximum is reached, the oldest indications are discarded to make room for the newest ones. A value of 0 is interpreted as infinity.
      Type: Integer
      Unit: Count
      Recognition: On next creation of a WBEMListener
      Range: 0 .. Integer.MAX_VALUE
      Default: 0
      See Also:
    • LISTENER_ENABLE_RELIABLE_INDICATIONS

      static final String LISTENER_ENABLE_RELIABLE_INDICATIONS
       If set to true, reliable indication support is enabled and indications
       are processed accordingly.  If set to false, reliable indication 
       support is disabled and indications are passed directly to listener.
       
       If reliable indication support is enabled, incoming indications are
       handled as documented in DSP1054 which includes queuing unexpected 
       indications, caching all indications for the duration of their sequence 
       identifier lifetime, and logging missing, duplicate and out-of-order 
       indications.
       
       The sequence identifier lifetime is defined as:
         DeliveryRetryAttempts * DeliveryRetryInterval * 10
       These values can be set by the sblim.wbem.listenerDeliveryRetryAttempts
       and sblim.wbem.listenerDeliveryRetryInterval properties below.
       
       Unexpected indications are queued in either a linked list or a hash
       table based on the sblim.wbem.listenerReliableIndicationHashtableCapacity
       property below.  The linked list is better suited for a small number of 
       listener destinations per WBEMListener while the hash table is better 
       suited for a large number.
       
       Type: Boolean
       Recognition: On next creation of a WBEMListener
       Default: false
       
      See Also:
    • LISTENER_DELIVERY_RETRY_ATTEMPTS

      static final String LISTENER_DELIVERY_RETRY_ATTEMPTS
       The default value to use for the CIM_IndicationService DeliveryRetryAttempts
       property.  See DSP1054 for details on reliable indications.
       
       Note: This property has no effect unless reliable indication support is
       enabled.  See the sblim.wbem.listenerEnableReliableIndications property.
       
       Type: Long
       Unit: Count
       Recognition: On next creation of a WBEMListener
       Range: 1 .. 1000
       Default: 3
       
      See Also:
    • LISTENER_DELIVERY_RETRY_INTERVAL

      static final String LISTENER_DELIVERY_RETRY_INTERVAL
       The default value to use for the CIM_IndicationService DeliveryRetryInterval
       property.  See DSP1054 for details on reliable indications.
       
       Note: This property has no effect unless reliable indication support is
       enabled.  See the sblim.wbem.listenerEnableReliableIndications property.
       
       Type: Long
       Unit: Seconds
       Recognition: On next creation of a WBEMListener
       Range: 1 .. 86400
       Default: 20
       
      See Also:
    • LISTENER_RELIABLE_INDICATION_HASHTABLE_CAPACITY

      static final String LISTENER_RELIABLE_INDICATION_HASHTABLE_CAPACITY
       The default value to use for the reliable indication handler's initial
       hash table capacity.  A value of 0 indicates use a linked list instead.
       Linked lists are better suited for a small number of listener destinations
       per WBEMListener while hash tables are better suited for a large number.
       
       Note: This property has no effect unless reliable indication support is
       enabled.  See the sblim.wbem.listenerEnableReliableIndications property.
       
       Type: Integer
       Unit: Count
       Recognition: On next creation of a WBEMListener
       Range: 0 .. 25000
       Default: 0
       
      See Also:
    • LISTENER_INDICATION_TRACE_FILTER

      static final String LISTENER_INDICATION_TRACE_FILTER
       The filter to use for tracing of incoming indications at the FINE level.
       
       If string is empty, no tracing of incoming indications will occur.  If
       string is not empty, it identifies one or more properties to be included
       in the trace of all incoming indications.  An optional class can be used
       to filter the output to include only those indications that contain the
       substring.  For example, to trace the SequenceContext and SequenceNumber
       properties of all alerts, use the following:
       
          alert:sequencecontext,sequencenumber
       
       To trace the IndicationTime of all indications, use the following:
       
          indicationtime
       
       Note: This property has no effect unless tracing is enabled.  See the
       sblim.wbem.traceFileLevel property.
       
       Type: String
       Recognition: On next creation of WBEMListener
       Format: [class:]property[,property]*
       
      See Also:
    • LISTENER_ADD_SENDER_IP_ADDRESS

      static final String LISTENER_ADD_SENDER_IP_ADDRESS
       If set to true, a property will be added to all indications that identifies
       the sender's IP address.  If set to false, the property will not be added.
       
       The property is a CIMProperty with:
         name = "SBLIMJCC_SenderIPAddress"
         data type = CIMDataType.STRING_T
         value = String returned by InetAddress.getHostAddress() (i.e. 1.2.3.4)
       
       Type: Boolean
       Recognition: On next creation of a WBEMListener
       Default: false
       
      See Also:
    • VERIFY_JAVA_LANG_DOUBLE_STRINGS

      static final String VERIFY_JAVA_LANG_DOUBLE_STRINGS
       If set to true, numeric string values passed to the java.lang.Double
       constructor or its parseDouble method will be checked to make sure they
       are not in the range that hangs Java 6- (see Sun bug 4421494).  If
       set to false, the string values will not be checked.
       
       Note: This property should only be set to true if running on Java 5 or
       Java 6 prior to update 24.
       
       Type: Boolean
       Recognition: Startup
       Default: true
       
      See Also:
    • SYNCHRONIZE_NUMERIC_KEY_DATA_TYPES

      static final String SYNCHRONIZE_NUMERIC_KEY_DATA_TYPES
       If set to true, numeric key data types in a CIMInstance's CIMObjectPath
       will be synchronized to match those of the corresponding keys within
       the CIMInstance's CIMProperty[].  If set to false, the numeric key data
       types will not be synchronized. 
       
       Note: Only numeric key data types in CIMInstances from CIMOM responses
       are synchronized, application calls to the CIMInstance constructor are
       not affected.
       
       Type: Boolean
       Recognition: Startup
       Default: false
       
      See Also:
    • ENABLE_GZIP_ENCODING

      static final String ENABLE_GZIP_ENCODING
       If set to true, gzip encoding is enabled.  If set to false, gzip encoding
       is not enabled.  When enabled, outgoing requests include the HTTP header
       "Accept-Encoding: gzip" to indicate to the CIMOM that the client handles
       message bodies compressed with gzip.  If the incoming response includes
       "Content-Encoding: gzip" the message body will be decompressed with gzip
       before being processed.
       
       Note: This property does not affect indications or outgoing requests.
       
       Type: Boolean
       Recognition: Anytime
       Default: false
       
      See Also:
    • CIMXML_PARSER_ALLOW_EMPTY_LOCALNAMESPACEPATH

      static final String CIMXML_PARSER_ALLOW_EMPTY_LOCALNAMESPACEPATH
       If set to true, the CIM-XML parser will allow empty LOCALNAMESPACEPATH
       elements in incoming responses.  If set to false, the parser will not
       allow empty LOCALNAMESPACEPATH elements.
       
       Note: Some older CIMOMs sent empty LOCALNAMESPACEPATHs, relying on the
       client to provide the local namespace path.  This is a violation of
       DSP0201, which dictates that LOCALNAMESPACEPATH must contain at least
       one NAMESPACE child.  By default, this property is set to false so the
       client can adhere to the CIM-XML specifications.  Set this property to
       true if "LOCALNAMESPACEPATH requires NAMESPACE" exceptions occur while
       interacting with one of these older CIMOMs.
       
       Type: Boolean
       Recognition: Anytime
       Default: false
       
      See Also: