The library documents itself · Concurrency & distribution
stzWorkerPool
25 own methods · 2 forms written with extensions, listed under their method
the source: base/cluster/stzWorkerPool.ring(opens in a new tab) · All classes · The area reference: Concurrency & distribution
Under each method, its extensions (Q CS XT Z ZZ IB W U): bold and ticked, it exists; struck, it does not. The extensions and what they mean
No method of this class is run on this page: the class reaches files, the network, processes, the clock, chance or sound, and an example run here would only be an example of its effects. Each method carries the explanation the library gives of itself.
Method
Explanation, as the source carries it
init
from (INSTANCE-scoped; seeded standard, custom- izable) -- not a global (a deployment concern)no extension
CatalogQ
the facet catalog (instance-owned)no extension
SetCatalog
Swap in a fully-built custom catalog (build it before adding facets).no extension
DefineFacet
Customize this pool's OWN catalog (delegated so the pool's live copy stays the single source of truth -- the aliasing doctrine).no extension
DefinePolyglotFacet
(no comment in the source: the name reads as a sentence) define polyglot facetno extension
AddFacet
Add a profile for a facet DEFINED IN THIS POOL'S CATALOG: capabilities, provenance and external tool are taken from the catalog.QCSXTZZZIBWU
SeedAllFacets
(no comment in the source: the name reads as a sentence) seed all facetsno extension
AddProfile
ad-hoc profiles (a facet NOT from the catalog)QCSXTZZZIBWU
ProfileQ
(no comment in the source: the name reads as a sentence) profile qno extension
HasProfile
(no comment in the source: the name reads as a sentence) has profileno extension
NumberOfProfiles
(no comment in the source: the name reads as a sentence) number of profilesno extension
Tags
(no comment in the source: the name reads as a sentence) tagsno extension
ProfileFor
The profile whose CAPABILITIES include pcCapability (routing seam for R8.2). Returns the tag, or "" if none.no extension
SetReactorPool
(no comment in the source: the name reads as a sentence) set reactor poolno extension
ReactorPoolQ
(no comment in the source: the name reads as a sentence) reactor pool qno extension
Dispatch
dispatch (admission + load isolation) ------------------------------ Dispatch fWork to the profile tagged pcTag. If the profile can admit (in-flight < budget), run it NOW (acquire -> call -> release) and return [ :admitted = 1, :result = <value>, :tag = pcTag ]. Else QUEUE it and return [ :admitted = 0, :queued = 1, :tag = pcTag ] -- Drain() runs queued work as slots free. A saturated profile queues WITHOUT touching any other profile's budget (load isolation).no extension
Acquire
Reserve a slot WITHOUT running work (lets a caller model a long-running/in-flight job for isolation tests + the R8.3 fleet). Returns TRUE (slot taken) or FALSE (over budget).no extension
Release
(no comment in the source: the name reads as a sentence) releaseno extension
Drain
Run queued work for every profile as slots free. Returns the number of queued items that ran this pass.no extension
InFlight
metricsno extension
QueueDepth
(no comment in the source: the name reads as a sentence) queue depthno extension
ShedCount
(no comment in the source: the name reads as a sentence) shed countno extension
Results
(no comment in the source: the name reads as a sentence) resultsno extension
Metrics
A snapshot the R8.4 autoscaler + the health console read (REAL numbers, not the old random() monitor).no extension
Narrate
(no comment in the source: the name reads as a sentence) narrateno extension