fhb_S_Timer_enqueue Command

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.

NOTE

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.

Syntax

fhb_S_Timer_enqueue QueueNums Passes SleepSeconds

Parameter(s)

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.

Example(s)

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