超时属性摘要
可使用超时属性来控制允许完成各种请求的时间。 其中的一些属性映射至内部变量名。 此处提供内部变量名是为了帮助您进行调试。
配置消息驱动的 Bean 以使其使用侦听器端口或激活规范时的相关计时器属性
对于 WebSphere® Application Server V 7 及更高版本,不推荐使用侦听器端口。 因此,计划将 WebSphere MQ 消息驱动的 bean 部署配置从使用侦听器端口迁移到使用激活规范。 但是,在确定应用程序不必在低于 WebSphere Application Server V 7 的应用程序服务器上工作之前,请不要开始此迁移。 在某些情况下,您将继续使用 WebSphere MQ 消息驱动的 bean 部署和侦听器端口,而在其他情况下,您将使用 WebSphere MQ 消息驱动的 bean 部署和激活规范。
- control_region_mdb_request_timeout
- control_region_mdb_queue_timeout_percent
- server_region_mdb_stalled_thread_dump_action
- control_region_wlm_dispatch_timeout
- control_region_iiop_queue_timeout_percent
- server_region_iiop_stalled_thread_dump_action
按照指示信息配置这些属性时,请记住哪些属性适用于侦听器端口,哪些属性适用于激活规范。
对象请求代理 (ORB) 服务高级设置
- ORB 侦听器存活值
- 在非安全套接字层 (SSL) 环境中,此属性定义提供给 IIOP 侦听器的 SOCK_TCP_KEEPALIVE 选项上 TCP/IP 的值(以秒计)。 此选项的功能是通过轮询客户机 TCP/IP 堆栈,验证空闲会话是否仍然有效。 如果客户机未响应,那么会话关闭。 如果与客户机的连接中断,导致服务器未接收到通知,那么会话在服务器端保持活动。 使用此选项清除这些不必要的会话。
- 如果未设置该属性,那么不设置 TCP/IP 选项。
- 设置 SOCK_TCP_KEEPALIVE 选项生成有关空闲会话的网络流量(这可能是不需要的)。
缺省值为
0。要指定此属性,请在管理控制台中单击 。
- ORB SSL 侦听器存活值
- 在 SSL 环境中,此属性定义提供给 IIOP 侦听器的 SOCK_TCP_KEEPALIVE 选项上 TCP/IP 的值(以秒计)。 此选项的功能是通过轮询客户机 TCP/IP 堆栈,验证空闲会话是否仍然有效。 如果客户机未响应,那么会话关闭。 如果与客户机的连接中断,导致服务器未接收到通知,那么会话在服务器端保持活动。 使用此选项清除这些不必要的会话。
- 如果未设置该属性,那么不设置 TCP/IP 选项。
- 设置 SOCK_TCP_KEEPALIVE 选项生成有关空闲会话的网络流量(这可能是不需要的)。
缺省值为
0。要指定此属性,请在管理控制台中单击 。
- WLM 超时
- 指定时间(以秒计),工作负载管理 (WLM) 在这段时间内等待 IIOP 请求完成。 此时间限制包含:
- IIOP 请求在 WLM 队列上等待被分派到服务方的时间
- 服务方中运行的应用程序组件处理请求和生成响应的时间
注意: 此设置不适用于 HTTP或可扩展消息支持;对于此类工作, ConnectionResponseTimeout自定义属性指定的值控制着将工作分派给仆人的时间。缺省值为
300秒。要指定此属性,请在管理控制台中单击 。
对于内部变量名称 (用于调试目的) ,请在 was.env 文件或 JES 作业日志中找到内部变量名称 control_region_wlm_dispatch_timeout。
示例:
WLM timeout=600使用 control_region_iiop_queue_timeout_percent 服务器定制属性指定 WLM 超时的百分比作为请求可在 WLM 队列中保留的时间。
- 请求超时
- 指定客户机等待对客户机请求的响应的最大时间长度(以秒计)。 对此字段指定的值是一种服务器范围设置,影响对此服务器所作的所有出站 RMI/IIOP 企业 Bean 调用。
因为通过耦合工具运行的综合系统 (sysplex) TCP/IP 并不总是通知客户机套接字的另一端何时关闭,所以客户机可能无限期地等待响应,除非您设置此属性。 设置 Request timeout 属性可确保客户机在指定时间内获取响应,即使响应是 COMM_FAILURE 异常也是如此。
缺省值为
0(无限制)。 未设置超时值。要指定此属性,请在管理控制台中单击 。
如果您使用命令行脚本编制,那么此系统属性的全名是 com.ibm.CORBA.RequestTimeout。
示例:指定
Request timeout=2会将时间限制设置为 2 秒。
事务服务超时属性
- 事务生存期超时总计
- 指定最长时间(以秒计),如果应用程序事务未通过 UserTransaction.setTransactionTimeout() 方法设置它自己的超时值,那么 J2EE 服务器在这段时间内等待源自此服务器中的应用程序事务完成。如果在指定时间内没有落实或回滚应用程序事务,那么应用程序事务将标记为回滚,并允许继续运行大约 4 分钟的一段宽限期。 如果应用程序事务在宽限期内落实或回滚,那么事务结果将始终被回滚。 如果在宽限期后应用程序事务未完成,那么控制器将异常终止运行应用程序组件的服务方,且报告 ABEND EC3 RSN=04130002 或 04130005。避免麻烦: 只有总事务生存期超时和最大事务超时具有宽限期。
将此值设置为 0 表示超时值不适用,将改为使用最长事务超时值。
缺省值为
120秒。要指定此属性,请在管理控制台中单击 。
对于内部变量名称(用于调试目的),找到transaction_defaultTimeout在里面was.env文件或 JES 作业日志文件。
- 最大事务超时
- 指定最长时间(以秒计),J2EE 服务器在这段时间内等待传播到此服务器中的应用程序事务完成。 如果在此服务器中启动的事务的关联应用程序未设置事务超时,并且总事务生存期超时设置为
0,那么此值还适用于这些事务。此值限制了所有其他计时器值的上限。 如果应用程序使用 UserTransaction.setTransactionTimeout() 方法指定更长时间,那么 J2EE 服务器会将该应用程序设置更改为对最长事务超时属性指定的值。
将此值设置为 0 表示超时值不适用,并且受此超时值影响的任何事务将永不超时。
缺省值为
300秒。要指定此属性,请在管理控制台中单击 。
对于内部变量名称(用于调试目的),找到内部变量名称,transaction_maximumTimeout,在里面was.env文件或 JES 作业日志。
- transaction_recoveryTimeout
- 指定时间(以分钟计),此控制器将使用这段时间尝试解决不确定事务,然后再向控制台发送“将应答写到操作程序”(WTOR)消息,询问该控制器是否应该执行以下操作:
- 停止尝试解决不确定事务。
- 将与事务相关的信息写到作业日志或硬副本日志并终止。
如果操作员的应答是应该继续恢复,那么控制器将在指定时间内尝试恢复,然后再重新发出 WTOR 消息。 解决所有事务后,控制器区域将终止。 此属性仅适用于对等重新启动和恢复方式下的控制器。
缺省值为
15分钟。要指定此属性,请在管理控制台中单击 ,从可用节点和单元的列表中选择相应的节点或单元,然后单击 新建。 在名称字段中添加 transaction_recoveryTimeout 属性,并在值字段中指定不同的值。
对于内部变量名称(用于调试目的),找到transaction_recoveryTimeout在里面was.env文件或 JES 作业日志。
示例:
transaction_recoveryTimeout=7
服务器定制属性
- control_region_mdb_request_timeout
- 指定时间(以秒计),服务器在这段时间内等待消息驱动的 Bean (MDB) 请求接收响应。 如果在指定的时间内未接收到响应,那么服务方可能会异常终止并发出 EC3 ABEND, RSN=04130008。 如果需要禁用此功能,那么可以将此值设置为 0。
缺省值为
120。要指定此属性,请在管理控制台中单击 ,从可用节点和单元的列表中选择相应的节点或单元,然后单击 新建。 在名称字段中添加 control_region_mdb_request_timeout 属性,并在值字段中指定不同的值。
对于内部变量名称 (用于调试目的) ,请在 was.env 文件或 JES 作业日志中找到 control_region_mdb_request_timeout。 请参阅应用程序服务器 z/OS® 定制属性文档以获取其他信息。
示例:
control_region_mdb_request_timeout=180使用 control_region_mdb_queue_timeout_percent 服务器定制属性名指定对 control_region_mdb_request_timeout 属性指定的值的百分比指定为 MDB 请求可在 WLM 队列中保留的时间。 control_region_mdb_request_timeout 定制属性指定该请求在 WLM 队列中以及分派期间花费的总时间长度。 control_region_mdb_queue_timeout_percent 属性仅适用于请求在 WLM 队列中花费的时间长度。
- control_region_timeout_save_last_servant
- 设置为
1时,此属性表明:如果 wlm_minimumSRCount 定制属性设置为一个大于 1 的值,那么最后的可用服务方不会因为超时情况而异常终止。 在新的服务方区域开始接受工作请求后,最后的可用服务方可以被异常终止。 此设置使工作请求能够在不被中断的情况下继续处理。 但是,如果将此属性设置为1,在以下情况下会导致系统资源丢失:被分派的服务方线程在超时后仍继续循环或变为不活动,使指定给此服务方的服务方线程无法被释放。此属性可设置为
0或1。如果将 wlm_dynapplenv_single_server 属性设置为 1,那么将忽略此属性的设置。
缺省值为
0。要指定此属性,请在管理控制台中单击 ,从可用节点和单元的列表中选择相应的节点或单元,然后单击 新建。 在 名称 字段中添加 control_region_timeout_save_last_service 属性,并在 值 字段中指定
1。对于内部变量名 (用于调试目的) ,请在 was.env 文件或 JES 作业日志中找到 control_region_timeout_save_last_services。
- protocol_http_timeout_output_recovery
- 控制对 HTTP 传输上接收的请求的超时执行的恢复操作。 指定
SERVANT时允许在发生超时的情况下终止服务方。 在达到超时值时,如果 HTTP 请求仍在服务方中等待分派,那么服务方将终止并发出 ABEND EC3 RSN=04130007。 然后将清除 HTTP 请求和套接字。SESSION的设置只清除 HTTP 请求和套接字。 不尝试中断服务方中已分派 HTTP 请求的处理。 如果已分派的 HTTP 请求循环或变为不活动,那么使用此会话设置时会导致资源丢失。缺省值为
SERVANT。要指定此属性,请在管理控制台中单击 ,从可用节点和单元的列表中选择相应的节点或单元,然后单击 新建。 在名称字段中添加 protocol_http_timeout_output_recovery 属性,并在值字段中指定不同的值。
对于内部变量名 (用于调试目的) ,请在 was.env 文件或 JES 作业日志中找到 protocol_http_timeout_output_recovery。
示例:
protocol_http_timeout_output_recovery=SERVANT - protocol_https_timeout_output_recovery
- 控制对 HTTPS 传输上接收的请求的超时采取的恢复操作。 指定
SERVANT时允许在发生超时的情况下终止服务方。 在达到超时值时,如果 HTTP 请求仍在服务方中等待分派,那么服务方将终止并发出 ABEND EC3 RSN=04130007。 然后将清除 HTTPS 请求和套接字。SESSION的设置只清除 HTTPS 请求和套接字。 不尝试中断服务方中已分派 HTTPS 请求的处理。 如果已分派的 HTTPS 请求循环或变为不活动,那么使用此会话设置时会导致资源丢失。缺省值为
SERVANT。要指定此属性,请在管理控制台中单击 ,从可用节点和单元的列表中选择相应的节点或单元,然后单击 新建。 在名称字段中添加 protocol_https_timeout_output_recovery 属性,并在值字段中指定不同的值。
对于内部变量名 (用于调试目的) ,请在 was.env 文件或 JES 作业日志中找到 protocol_https_timeout_output_recovery。
示例:
protocol_https_timeout_output_recovery=SESSION - protocol_sip_timeout_output
- 指定时间(以秒计),服务器在这段时间内等待消息驱动的 Bean (MDB) 请求(通过 SIP 传输通道发送)接收响应。 如果在指定的时间内未接收到响应,那么服务方可能会异常终止并发出 ABEND EC3 RSN=04130008。 如果需要禁用此功能,那么可以将此值设置为 0。
缺省值为
120。要指定此属性,请在管理控制台中单击 ,从可用节点和单元的列表中选择相应的节点或单元,然后单击 新建。 在 名称 字段中添加 protocol_sip_timeout_output 属性,并在 值 字段中指定其他值。
对于内部变量名称 (用于调试目的) ,请在 was.env 文件或 JES 作业日志中找到 protocol_sip_timeout_output。
示例:
protocol_sip_timeout_output=180使用 control_region_sip_queue_timeout_percent 服务器定制属性名指定对 protocol_sip_timeout_output 属性指定的值的百分比作为请求可在 WLM 队列中保留的时间。
- protocol_sips_timeout_output
- 指定时间(以秒计),服务器在这段时间内等待消息驱动的 Bean (MDB) 请求接收响应。 如果在指定的时间内未接收到响应,那么服务方可能会异常终止并发出 ABEND EC3 RSN=04130008。 将此值设置为 0 以禁用该功能。
缺省值为
120。要指定此属性,请在管理控制台中单击 ,从可用节点和单元的列表中选择相应的节点或单元,然后单击 新建。 在 名称 字段中添加 protocol_sips_timeout_output 属性,并在 值 字段中指定其他值。
对于内部变量名 (用于调试目的) ,请在 was.env 文件或 JES 作业日志中找到 protocol_sips_timeout_output。
示例:
protocol_sips_timeout_output=180使用 control_region_sips_queue_timeout_percent 服务器定制属性名指定对 protocol_sips_timeout_output 属性指定的值的百分比作为请求可在 WLM 队列中保留的时间。
- protocol_sip_timeout_output_recovery
- 控制通过 SIP 接收的请求的超时执行的恢复操作。 指定
SERVANT时允许在发生超时的情况下终止服务方。 在达到超时值时,如果 SIP 请求仍在服务方中等待分派,那么服务方将终止并发出 ABEND EC3 RSN=04130007。 然后将清除该 SIP 请求和套接字。 设置SESSION将只清除该 SIP 请求和套接字。 不尝试中断服务方中已分派 SIP 请求的处理。 如果已分派的 SIP 请求循环或变为不活动,那么使用此会话设置可能导致资源丢失。缺省值为
SERVANT。要指定此属性,请在管理控制台中单击 ,从可用节点和单元的列表中选择相应的节点或单元,然后单击 新建。 在名称字段中添加 protocol_sip_timeout_output_recovery 属性,并在值字段中指定不同的值。
对于内部变量名 (用于调试目的) ,请在 was.env 文件或 JES 作业日志中找到 protocol_sip_timeout_output_recovery。
示例:
protocol_sip_timeout_output_recovery=SERVANT - protocol_sips_timeout_output_recovery
- 控制通过 SIPS 接收的请求的超时执行的恢复操作。 指定
SERVANT时允许在发生超时的情况下终止服务方。 在达到超时值时,如果 SIPS 请求仍在服务方中等待分派,那么服务方将终止并发出 ABEND EC3 RSN=04130007。 然后将清除该 SIPS 请求和套接字。 设置SESSION将只清除该 SIPS 请求和套接字。 不尝试中断服务方中已分派 SIPS 请求的处理。 如果已分派的 SIPS 请求循环或变为不活动,那么使用此会话设置可能导致资源丢失。缺省值为
SERVANT。要指定此属性,请在管理控制台中单击 ,从可用节点和单元的列表中选择相应的节点或单元,然后单击 新建。 在名称字段中添加 protocol_sips_timeout_output_recovery 属性,并在值字段中指定不同的值。
对于内部变量名称 (用于调试目的) ,请在 was.env 文件或 JES 作业日志中找到protocol_sips_timeout_output_recovery。
示例:
protocol_sips_timeout_output_recovery=SERVANT - server_region_request_cputimeused_limit
- 指定应用程序请求可以使用的 CPU 时间量(以毫秒计)。
此属性有助于防止单个应用程序请求独占可用的 CPU 时间,因为它使您可以限制单个请求可使用的 CPU 时间量。 分派请求时将调用 CPU 监视器。 如果请求超出了所指定的 CPU 时间量,那么控制器将认为该请求无响应。 然后,控制器会发出消息 BBOO0327,以让正在请求的应用程序知道该请求无响应。
当所用的 CPU 时间量超过指定数量时,监视请求所用 CPU 时间量的监视器通常会向分派的线程发出信号。 但是,在某些情况下,此信号无法传递,而请求将保持暂挂。 例如,如果线程变为原生线程并调用 PC 例程,那么信号将保持暂挂,直到 PC 例程返回。
当信号在分派线程上传递后,与已分派请求相关联的 WLM 相关可调度单元组将停顿。 这种情况将降低此请求的分派优先级,并且现在此请求只应在系统工作负载较轻时获取 CPU 资源。
- server_region_stalled_thread_threshold_percent
- 指定在控制器终止服务方之前,可变为无响应的线程数的百分比。 当指定缺省值 0 时,一旦控制器确定至少有一个线程无响应,它就将立即终止服务方。
缺省值为
0。要指定此属性,请在管理控制台中单击 ,从可用节点和单元的列表中选择相应的节点或单元,然后单击 新建。 在名称字段中添加 server_region_stalled_thread_threshold_percent 属性,并在值字段中指定不同的值。
对于内部变量名 (用于调试目的) ,请在 was.env 文件或 JES 作业日志中找到 server_region_stalled_thread_threshold_percent。
示例:
server_region_stalled_thread_threshold_percent=5
Java 虚拟机 (JVM) 定制属性
可以通过单击 来设置以下 2 JVM 属性。
- com.ibm.ws390.interrupt.disableBBOJ0122I
- 如果此属性设置为 1 ,那么消息BBOJ0122I已禁止。
数据类型为
Boolean。缺省值为
0。它不由守护程序使用。 它仅适用于服务方区域。
- com.ibm.ws390.interrupt.applyDumpActionPreInterrupt
- 指定尝试执行所分派的请求前需要收集文档。 如果此属性设置为 1,那么在执行任何促使所分派请求完成的活动之前(例如,在对任何
InterruptObject 驱动 interrupt() 之前),将收集 stalled_thread_dump_action
所指定的文档。 stalled_thread_dump_action 用于定义在认为请求已挂起并且任何使其完成的尝试失败时要收集的文档。
数据类型为
Boolean。缺省值为
0。它不由守护程序使用。 它仅适用于服务方区域。
安全套接字层配置指令表
- V3 超时
- 指定时间(以秒计),浏览器可以在这段时间内复用系统 SSL V3 会话标识(而无需与服务器重新协商加密密钥)。 为一台服务器定义的指令表需要同一个 V3 超时值。
缺省值为
100。要指定此属性,请在管理控制台中单击 。
对于内部变量名称 (用于调试目的) ,当您定义 SSL 指令表时,会在内部设置以下 SSL 配置指令表超时变量:- com_ibm_HTTP_claim_ssl_sys_v3_timeout
- com_ibm_DAEMON_claim_ssl_sys_v3_timeout
TCP 传输通道超时属性
- 不活动超时属性
- 以秒为单位指定时间量,TCP 传输通道在这段时间内等待套接字上的读或写请求完成。避免麻烦: 为此属性指定的值可能被为计时器层次结构中高于此通道的通道建立的等待时间覆盖。 例如,为 HTTP 传输通道建立的等待时间会覆盖为每个操作(除了在新的套接字上启动读操作)的该属性指定的值。
缺省值为
0秒。要指定此属性,请在管理控制台中单击 。
HTTP 传输通道超时属性
- ConnectionResponseTimeout
- 指定最长时间(以秒计),J2EE 服务器在这段时间内等待应用程序组件响应 HTTP 请求。 为服务器上的每个 HTTP 传输定义设置此属性。 必须为 SSL 传输和非 SSL 传输设置此属性。 如果在指定的时间内未接收到响应,那么服务方可能会失败并发出 ABEND EC3 和 RSN=04130007。 如果设置此计时器,将阻止客户机应用程序等待来自可能已死锁、正在循环或正遇到其他某个处理问题(导致应用程序组件停止处理请求)的应用程序组件的响应。
缺省值为
120秒。要指定此属性,请在管理控制台中单击 ,然后在 "Web 容器设置" 下单击 。
内部变量名(用于调试目的):如果您在对启用了 SSL 的传输中的问题进行调试,那么在 was.env 文件或 JES 作业日志中查找内部变量名 protocol_https_timeout_output。 如果要调试非 SSL 传输中的问题,请在 was.env 文件或 JES 作业日志中找到内部变量名称 protocol_http_timeout_output。
使用 control_region_http_queue_timeout_percent 和 control_region_https_queue_timeout_percent 服务器定制属性指定 ConnectionResponseTimeout 属性的百分比作为请求可在 WLM 队列中保留的时间。
- 持久超时属性
- 以秒为单位指定时间量,HTTP 传输通道在这段时间内允许套接字在请求之间保持空闲。
缺省值为
30秒。要指定此属性,请在管理控制台中单击 。
- 读超时属性
- 指定时间(以秒计),发生第一次读请求之后,HTTP 传输通道在这段时间内等待套接字上的读请求完成。 正在完成的读取可能是 HTTP 主体(如 POST),也可能是头的一部分(如果这些头并非全部都是套接字上第一个读请求的一部分)。
缺省值为
60秒。要指定此属性,请在管理控制台中单击 。
- 写超时属性
- 指定时间(以秒计),HTTP 传输通道在这段时间内在套接字上等待提交响应数据的每个部分。 通常,在响应落后于新请求的情况下,将发生此超时。 当客户机有低数据率或服务器的网络接口卡 (NIC) 填满了 I/O 时,将发生这种情况。
缺省值为
60秒。要指定此属性,请在管理控制台中单击 。
HTTP 传输超时变量
- ConnectionIOTimeOut
- 指定最长时间(以秒计),J2EE 服务器在这段时间内等待完成的 HTTP 请求到达。 为服务器上的每个 HTTP 传输定义设置此属性。 必须为 SSL 传输和非 SSL 传输设置此属性。 J2EE 服务器在连接建立后启动计时器,并且如果完成的请求没有在指定的最大时间内到达会取消连接。 指定值 0 将禁用超时功能。
缺省值为
10秒。要指定此属性,请在管理控制台中单击 ,然后在 "Web 容器设置" 下单击 。
- ConnectionResponseTimeout
- 指定最长时间(以秒计),J2EE 服务器在这段时间内等待应用程序组件响应 HTTP 请求。 为服务器上的每个 HTTP 传输定义设置此属性。 必须为 SSL 传输和非 SSL 传输设置此属性。 如果在指定的时间内未接收到响应,那么服务方可能会失败并发出 ABEND EC3 和 RSN=04130007。 如果设置此计时器,将阻止客户机应用程序等待来自可能已死锁、正在循环或正遇到其他某个处理问题(导致应用程序组件停止处理请求)的应用程序组件的响应。
缺省值为
120秒。要指定此属性,请在管理控制台中单击 ,然后在 "Web 容器设置" 下单击 。
内部变量名(用于调试目的):如果您在对启用了 SSL 的传输中的问题进行调试,那么在 was.env 文件或 JES 作业日志中查找内部变量名 protocol_https_timeout_output。 如果要调试非 SSL 传输中的问题,请在 was.env 文件或 JES 作业日志中找到内部变量名称 protocol_http_timeout_output。
使用 control_region_http_queue_timeout_percent 和 control_region_https_queue_timeout_percent 服务器定制属性指定 ConnectionResponseTimeout 属性的百分比作为请求可在 WLM 队列中保留的时间。
- ConnectionKeepAliveTimeout
- 指定时间(以秒计),J2EE 服务器在这段时间内等待来自持续连接上的 HTTP 客户机的后续请求。 如果在此时间限制内未从同一客户机接收到另一个请求,那么关闭连接。
缺省值为
30秒。要指定此属性,请在管理控制台中单击 ,然后在 "Web 容器设置" 下单击 。