restart-control-shell

Purpose
Restart the agenda shell named instance-name.

Package   :agenda-shell

Module   :agenda-shell

Arguments and values

Returns
One of the following sets of multiple values:

• :quiescence—If the control-shell scheduling loop is terminated due to quiescence (that is, no more executable KSAs remain in the queue of pending KSAs)
• :stop and (optionally) associated reasons, as multiple values—If one of the following conditions occurs:
  • The exit-control-shell function is called.
  • A precondition function or KS-execution function returns :stop and, optionally, associated reasons.
• Result-values—If the control-shell is terminated by calling exit-control-shell.

Events
A control-shell-restarted-event is signaled.

Errors
The idle-loop process has not been started on CMUCL. Multiprocessing has not been started on LispWorks.

See also
    abort-ks-execution
    control-shell-running-p
    current-control-shell
    exit-control-shell
    run-polling-functions
    start-control-shell

Example
Restart the Agenda Shell (in this case, without any KSs defined):

  > (restart-control-shell)
  ;; Control shell 1 restarting after cycle 2
  ;; No executable KSAs remain, exiting control shell
  ;; Control shell 1 exited: 4 cycles completed
  ;; Run time: 0 seconds
  ;; Elapsed time: 0 seconds
  :quiescence
  >

Note
When a non-nil :run-polling-functions value is supplied to start-control-shell (the default on Common Lisp implementations without threads), run-polling-functions is called at the beginning of every control-shell-cycle and at one-half-second intervals when the Agenda Shell is hibernating due to quiescence.

restart-control-shell