Editing Flow-Diagrams (section)

== 1. Top-Level Application Flow ==

'''Program:''' <code>primesmain.cbl</code><br />
'''What it shows:''' How <code>primesmain</code> reads the command-line argument, initialises the UI layer, routes to the correct processing path, and shuts down cleanly.

<blockquote>⚠️ The <code>generate</code> branch calls <code>r92-generate-primes</code> but the PERFORM inside that paragraph that drives the sieve is commented out. See [[Technical-Specification#7-known-technical-issues|Technical Specification — Defect T1]].
</blockquote>
<pre class="mermaid">flowchart TD
    A([START]) --&gt; B[ACCEPT commandline-args\nFROM COMMAND-LINE]
    B --&gt; C[MOVE commandline-args TO methods\nMOVE 'primesmain' TO program-name]
    C --&gt; D[r90-start-session\nMOVE 'start' TO ui-methods\nCALL primesui USING primes-ui]

    D --&gt; E{ui-method-ok?}
    E --&gt;|No| F[DISPLAY emergency msg\nUPON scherm\nSTOP RUN]
    E --&gt;|Yes| G[LOG 'UI initialisation succeeded.'\nLOG commandline-args]

    G --&gt; H{EVALUATE\ncommandline-args}

    H --&gt;|'report'| I[LOG 'Primes report generation starts.'\nMOVE 'report' TO methods]
    I --&gt; J[r92-generate-primes\nCALL primesgen USING primes-session]

    H --&gt;|'generate'| K[LOG 'Primes generation starts.'\nMOVE 'generate' TO methods]
    K --&gt; L[&quot;⚠️ r92-generate-primes\n[PERFORM commented out in source]&quot;]

    H --&gt;|other| M[LOG 'Bad parameter'\nCALL primesui 'stop'\nSTOP RUN]

    J --&gt; N[LOG 'Primes run complete, program stops.']
    L --&gt; N
    N --&gt; O[r99-stop-session\nMOVE 'stop' TO ui-methods\nCALL primesui USING primes-ui]
    O --&gt; P([STOP RUN])</pre>
'''Key paragraphs:'''

{|
!width="50%"| Paragraph
!width="50%"| Action
|-
| <code>r90-start-session</code>
| Opens <code>primes.prt</code>; hard-stops if open fails
|-
| <code>r92-generate-primes</code>
| Single CALL to primesgen; passes <code>primes-session</code> by reference
|-
| <code>r99-stop-session</code>
| Flushes print buffer and closes <code>primes.prt</code>
|}


-----

<span id="primesgen-dispatch-flow"></span>