SGA‑OISOpen Interoperability Standard
1.0 Draft
SGA-OIS/Reference

Journal records

What the bay writes down, and when each record is written.

Every record the journal holds carries a kind, and a consumer switches on it — the association to decide what a record means, an auditor to find the ones that matter. The complete list is part of the standard rather than an artifact of one engine: 06 §13.

These are not message types. A message is what crossed a wire; a record is what was written down. Several kinds here — a composed shot, a manifest, a superseded participant — correspond to no single message at all.

kindwritten when
session_startthe journal opens; names the bay, session and bundle
engine_restartedan existing session was reopened after the engine came back
engine_stoppedthe engine closed the journal on purpose
going_awaya planned shutdown, with when to come back
participant_joina device was admitted, with its descriptor hash
participant_leavea device's connection ended
participant_supersededthe same unit reconnected and replaced its own stale connection
admission_denieda device was refused, and why
manifestthe connection matrix in force from this point
provenance_degradeda field's best source got worse or went away
round_starteda round began; names the course
round_endeda round ended; names the card that closed it
rosterwho is playing, label to slot
player_upthe player at the ball changed; names the slot
coursethe course document a card's references resolve against
scorecarda card, for a stated reason
checked_inwho has scanned in at this bay
member_checkina member checked in by meeting the bay over
swing_detecteda shot_id was allocated on first evidence of a swing
shotthe composed shot record
dataone contribution to a field, as the device sent it
shot_declineda device said it would not contribute to this shot
shot_extendeda device asked for more of the correlation window
practice_swinga swing that resolved to no stroke
standing_asserteda standing value was published
standing_retracteda standing value was withdrawn
standing_ambiguoustwo sources disagreed and neither wins
standing_digesta periodic digest of standing state, so a gap is detectable
declared_unsentat a round's end, fields a device declared and never sent
presence_scanone closed presence scan window
installation_unverifiedthis engine cannot demonstrate it is the
facility_changedan operator changed the facility configuration at this
listen_addresswhere this engine is listening, and how it got there
discovery_self_checkwhether this engine could hear its own
second_engine_allowedthis engine ran with the one-engine-per-machine
presence_modecollection was switched on or off, and with what
slot_bounda slot was bound to a check-in
slot_rebinda bound slot moved to a different check-in
slot_releaseda slot's binding ended
requesta request was made, with who asked
request_refuseda request was refused, and why
device_enrolleda device was enrolled at this bay
device_unenrolleda device was removed from this bay
device_renameda device's local name changed
device_policy_rejecteda device policy was refused as unusable
device_noticea notice was raised about a device
update_fetcha firmware transfer was attempted, with bytes and outcome
noticea notice was raised
notice_resolveda notice was answered or expired
policy_notifieda notice policy decided who to tell
fetch_policy_loadedan update budget policy came into force
notice_policy_loadeda notice policy came into force
lapse_policy_loadeda certification lapse policy came into force
certificate_loadeda bay certificate came into force
certification_downgradethe bay's certified tier dropped
certification_lapsedthe bay's certification expired
certification_shortfallthe bay no longer meets its certified tier
event_bay_ineligiblethe bay cannot host a sanctioned event
bundle_loadeda signed standards bundle came into force, naming the
bundle_refuseda bundle did not verify, or was not newer than the one
bundle_helda verified bundle is waiting for the round to end, because
Simulated Golf Association · SGA-OIS · generated from the specification sources