op_dist_qwait_mg1_handle_create()
摘要
返回一个句柄,用于针对特定队列创建背景延迟的 M/G/1 估计。
语法
op_dist_qwait_mg1_handle_create (est_start_time, est_job_work_proc, long_intrvl_work_proc, pre_existing_work, long_intrvl_ia_num, long_intrvl_single_job_num)
| 参数 | 类型 | 说明 |
|---|---|---|
est_start_time |
double |
队列开始处理工作的时间 [通常将该时间设为 0,以反映仿真的开始。关于“工作”的定义,参见详情部分。] |
est_job_work_proc |
Procedure |
用于估计单个作业延迟的回调函数 [该过程的原型参见详情部分。] |
long_intrvl_work_proc |
Procedure |
用于估计区间延迟的回调函数 [该过程的原型参见详情部分。] |
pre_existing_work |
double |
在 est_start_time 时刻队列中已有的工作量 [关于“工作”的定义,参见详情部分。] |
long_intrvl_ia_num |
int |
时间因子 [当显式建模的作业之间的秒数超过该时间因子乘以平均估计到达间隔时间时,排队延迟的估计将从逐作业方式切换为按区间方式。] |
long_intrvl_single_job_num |
int |
时间因子 [按区间估计延迟时,用该因子决定何时切换回逐作业估计。当估计区间的结束时间落在该时间因子乘以平均估计作业到达间隔时间的范围内时,即发生切换。] |
返回类型
Qwait_Handle
可用于调用内核过程 op_dist_qwait_est() 的队列估计句柄。
示例
/* Create qwait handle */
bgutil_routed_state_ptr->qwait_handle = op_dist_qwait_mg1_handle_create (0.0,
oms_bgutil_single_job_work_constant, oms_bgutil_long_interval_work_in_queue,
0.0, 150, 100);
详情
M/G/1 队列估计是指包含三个参数的估计,其中 M 表示指数到达间隔时间,G 表示一般的作业大小,1 表示一个队列对应一个服务器。排队延迟的估计有两种可能的模式:逐作业估计和按区间估计。本内核过程指定两个回调函数,每种模式各一个。一个作业(job)是队列必须处理的一个或多个关联数据包。工作(work)是清空队列所需的秒数。
两个回调函数具有如下原型:
double
est_job_work_proc (void* job_work_proc_state, double start_service_time)
该过程返回一个 double,即处理该作业所需的秒数。上面的第一个参数指向一个任意的状态指针,该状态指针由你在调用 op_dist_qwait_est() 时指定。第二个参数是队列开始处理该作业的时间。
double
long_intrvl_work_proc (void* job_work_proc_state, double start_time,
double end_time, double work_in_queue)
该过程返回一个 double,表示指定区间结束时队列中的工作量。上面的第一个参数指向一个任意的状态指针。第二个参数是估计区间开始时的仿真时间,第三个参数是估计区间结束时的仿真时间。最后一个参数是估计区间开始时队列中的工作量。
用途
提供一种机制,用于建立估计队列背景延迟时所使用的句柄。该句柄指定用于实际估计的回调函数,以及支配这些回调函数使用方式的参数。
错误
- 可恢复错误:非法的负参数 est_start_time(
<time>)。 - 可恢复错误:非法的负参数 pre_existing_work(
<work>)。 - 可恢复错误:非法的负参数 long_interval_ia_num(
<interval>)。 - 可恢复错误:非法的负参数 long_interval_single_job_num(
<job>)。
参考
- 使用内核过程 op_dist_qwait_estimate() 估计队列中某个区间的背景工作量
- 使用内核过程 op_dist_qwait_gg1_handle_create() 获取用于创建 G/G/1 估计的句柄