Ns job - Revision history

Akhassin at 03:13, 21 October 2009

2009-10-21T03:13:07Z

Caveman: /* removed spam */

2005-12-14T14:44:22Z

removed spam

203.92.45.226 at 11:29, 14 December 2005

2005-12-14T11:29:17Z

Dossy at 00:47, 2 December 2005

2005-12-02T00:47:40Z

Dossy at 00:47, 2 December 2005

2005-12-02T00:47:21Z

208.7.106.60 at 22:10, 1 December 2005

2005-12-01T22:10:26Z

208.7.106.60 at 22:07, 1 December 2005

2005-12-01T22:07:02Z

WikiSysop: imported from WiKit id 174

2005-02-28T16:01:15Z

imported from WiKit id 174

New page

Man page: http://aolserver.com/man/4.0/tcl/ns_job.html

----

'''NAME'''

: ns_job - Implement job queues and thread pools for evaluating Tcl scripts

'''SYNOPSIS'''

: '''ns_info''' ''option ?arg arg ...?''

'''DESCRIPTION'''

: '''ns_job''' manages a thread pool and a set of named "queues". Queues have a max number of threads and when the current number of running thread reaches "max" then jobs are queued. New threads are created when there are less than maxthread number of idle threads.

: This command provides a means for queueing Tcl scripts for evaluation by a pool of threads. The legal ''option''s (which may be abbreviated) are:
* '''ns_job create''' ''?-desc description? queueId ?maxthreads?''

: Create a new job queue called ''queueId''. If ''maxthreads'' is not specified, then the default of 4 is used.
* '''ns_job queue''' ''?-detached?'' queueId script

: Add a new job to the queue. If there are less than maxthreads current running then the job will be started. If there are maxthreads currently running then this new job will be queued.

: If ''-detached'', then the job will be cleaned up when it completes; no wait will be necessary.

: The new job's ID is returned.
* '''ns_job wait''' ''?-timeout seconds:microseconds?'' queueId jobId

: Wait for the specified queued or running job to finish. '''ns_job wait''' returns the results of the script.

: An error is thrown if the specified timeout period is reached.
* '''ns_job waitany''' ''?-timeout seconds:microseconds?'' queueId

: Wait for any job on the queue complete.

: An error is thrown if the specified timeout period is reached.
* '''ns_job cancel''' queueId jobId

: Remove the specified job from the queue. If the job is currently running, then the job will be removed from the queue when it completes.

: 1 (true) is returned if the job is currently running and can not be cancelled.
* '''ns_job delete''' queueId

: Request that the specified queue be deleted. The queue will only be deleted when all jobs are removed.
* '''ns_job jobs''' queueId

: Return a list of the job IDs.
* '''ns_job queues'''

: Returns a list of the queue IDs.
* '''ns_job threadlist'''

: Returns a list of the thread pool's fields.

: '''maxthreads''' - Max number of threads for all the queues in the thread pool.

: '''numthreads''' - Number of allocated threads.

: '''numidle''' - Number of currently idle threads.

: '''req stop''' - The thread pools is being stopped. This probably means that the server is shutting down.
* '''ns_job queuelist'''

: Returns a list of the queues. A queue has the following fields:

: '''name''' - Name of the queue.

: '''desc''' - Description of the queue.

: '''maxthreads''' - Max number of threads to run for this queue.

: '''numrunning''' - Number of currently running jobs in this queue.

: '''REQ delete''' - Someone requested this queue be deleted. Queue will not be deleted until all the jobs on the queue are removed.
* '''ns_job joblist''' jobID

: Returns a list the jobs in the specified queue. A job has the following fields:

: '''id''' - Job's ID

: '''state''' - The state of the job. The return values are as follows:

: scheduled - The job is scheduled to run.

: running - The job is currently running.

: done - The job has completed.

: '''results''' - If the job has completed, then this field will contain the results. If the job is running or scheduled to run, then this will contain the script.

: '''code''' - When the job is done, this will contain the return code. Return codes are ''TCL_OK'', ''TCL_ERROR'', ''TCL_RETURN'', ''TCL_BREAK'', ''TCL_CONTINUE''.

: '''type''' - The type of job. A job's return value is ''nondetached'' or ''detached''.

: '''req''' - The job is required. Return values are ''none'', ''wait'', ''cancel''.
* '''ns_job genid'''

: Generate a new unique ID. This new ID can be used as the queue ID without conflicting with any other queue ID.

'''EXAMPLES'''

'''SEE ALSO'''

----

[[Category Documentation]] - [[Category Core Tcl API]]

← Older revision		Revision as of 14:44, 14 December 2005
Line 104:		Line 104:

	[[Category:Core Tcl API]]		[[Category:Core Tcl API]]
−
−	Naukri.com is an Indian career website that serves as an employment exchange forum for employers, placement agencies and job seekers. Started by Info Edge (India) Pvt. Ltd., Naukri.com went commercial in October 1997 and since then it has served more than 25000 companies for recruitments through its database.
−
−	The traffic growth on this website is 20-25 percent every quarter and it is today, the Number 1 Job Portal on traffic rank as per Alexa. So far it has a database of 4.5 million resumes and gets 8500-10000 registrations daily.
−
−	~~For more information log on to http://www.naukri.com~~

← Older revision		Revision as of 11:29, 14 December 2005
Line 104:		Line 104:

	[[Category:Core Tcl API]]		[[Category:Core Tcl API]]
		+
		+	Naukri.com is an Indian career website that serves as an employment exchange forum for employers, placement agencies and job seekers. Started by Info Edge (India) Pvt. Ltd., Naukri.com went commercial in October 1997 and since then it has served more than 25000 companies for recruitments through its database.
		+
		+	The traffic growth on this website is 20-25 percent every quarter and it is today, the Number 1 Job Portal on traffic rank as per Alexa. So far it has a database of 4.5 million resumes and gets 8500-10000 registrations daily.
		+
		+	For more information log on to http://www.naukri.com

← Older revision		Revision as of 00:47, 2 December 2005
Line 6:		Line 6:

	'''SYNOPSIS'''		'''SYNOPSIS'''
−	e	+
	: '''ns_job''' ''option ?arg arg ...?''		: '''ns_job''' ''option ?arg arg ...?''

@@ Line 11: / Line 11: @@
 '''DESCRIPTION'''
-: '''ns_job''' manages a thread pool and a set of named "queues". Queues have a max number of threads and when the current number of running thread reaches "max" then jobs are queued.  New threads are created when there are less than maxthread number of idle threads.
+: '''ns_job''' manages a thread pool and a set of named "queues". Queues have a max number of threads and when the current number of running thread reaches "max" then jobs are queued.  New threads are created when there are less than maxthread number of idle threads.  Queues are process-wide, not virtual-server-specific.
 : This command provides a means for queueing Tcl scripts for evaluation by a pool of threads.  The legal ''option''s (which may be abbreviated) are:

@@ Line 1: / Line 1: @@
-Man page: http://aolserver.com/man/4.0/tcl/ns_job.html
+{{manpage|ns_job}}
 '''NAME'''
@@ Line 8: / Line 6: @@
 '''SYNOPSIS'''
-−
+e
 : '''ns_job''' ''option ?arg arg ...?''
@@ Line 23: / Line 21: @@
 : Add a new job to the queue. If there are less than maxthreads current running then the job will be started. If there are maxthreads currently running then this new job will be queued.
-: If ''-detached'', then the job will be cleaned up when it completes; no wait will be necessary.
+: If ''-detached'', then the job will be claned up when it completes; no wait will be necessary.
 : The new job's ID is returned.
@@ Line 104: / Line 102: @@
 '''SEE ALSO'''
-[[Category Documentation]] - [[Category Core Tcl API]]
+[[Category:Core Tcl API]]

@@ Line 74: / Line 74: @@
 : '''REQ delete''' - Someone requested this queue be deleted. Queue will not be deleted until all the jobs on the queue are removed.
-* '''ns_job joblist''' jobID
+* '''ns_job joblist''' queueId
 : Returns a list the jobs in the specified queue. A job has the following fields: