The fhb_S_Timer_enqueue command allows you to record throughput measurements of your FSI Hot Backup system on multiple records.
To measure throughput on a single record, see fhb_S_Timer command.
The Primary and Secondary FSI Hot Backup servers must be configured and operational for throughput measurement to occur.
Before you can log throughput measurement reports using the fhb_S_Timer_enqueue command, you must first create the records file that will hold these statistics. See fhb_S_Timer command for information on creating and managing this records file.
fhb_S_Timer_enqueue QueueNums Passes SleepSeconds
| Parameter | Description |
|---|---|
| QueueNums | Specifies the destination helper queue numbers in the form Q1,Q2,... Qn-m. where Q1,Q2 are individual queue numbers and Qn-m are a range of queue numbers (for example, 1-3 refers to queues 1, 2 and 3). This form allows you to specify individual queue numbers in a comma separated string (for example, 1,2 specifies queues 1 and 2), a range of queue numbers (for example, 5-7 specifies queues 5 through 7) or a combination of individual queue numbers and a range of queues (for example, 1,2,5-7 specifies queues 1 and 2 as well as queues 5 through 7). |
| Passes | (Optional) Specifies the number of times each specified helper queue will be sent a timer record. If not specified, only 1 pass occurs. |
| SleepSeconds | (Optional) Specifies how many seconds to sleep between each pass (only applies when multiple passes are specified). If not specified, the default is 60 seconds. |
The example below illustrates enqueueing three records destined to be processed by helper queues 1, 2 and 3 respectively, one pass only.
fhb_S_Timer_enqueue 1-3
The example below illustrates enqueueing two records, one destined to be processed by helper queue 1 and the other by helper queue 3. The program will then sleep for 60 seconds and repeat the process.
fhb_S_Timer_enqueue 1,3 2
The example below illustrates enqueueing five records, one each destined to be processed by helper queues 1, 3, 5, 6 and 7 respectively. The program will then sleep for 300 seconds, repeat the process, sleep for another 300 seconds and repeat the process one more time.
fhb_S_Timer_enqueue 1,3,5-7 3 300
The example below illustrates starting the utility as a phantom process and return to TCL immediately. The phantom process will enqueue three records destined to be processed by helper queues 1, 2 and 3 respectively, then sleep for 15 minutes. This process will be repeated 200 times before the phantom process terminates.
z fhb_S_Timer_enqueue 1-3 200 900