Editing Scope and applicability (section)

== 2. System Scope ==

<span id="what-the-system-is"></span>
=== 2.1 What the system is ===

pgcobol is a three-tier batch COBOL application that:

* Generates prime numbers by trial division and stores them in a PostgreSQL database.
* Reads stored primes from the database and produces a formatted line-printer report.

It runs as a command-line batch job on Linux. There is no interactive interface.

<span id="system-boundary"></span>
=== 2.2 System boundary ===

'''Inside scope:'''

* The four COBOL programs: <code>primesmain</code>, <code>primesgen</code>, <code>primes</code>, <code>primesui</code>.
* The five copybooks that define the inter-tier interfaces.
* The PostgreSQL schema <code>primes</code> and its objects.
* The output file <code>primes.prt</code>.
* The console log output.

'''Outside scope:'''

* The GnuCOBOL compiler and GixSQL pre-processor (third-party tools, not modified).
* The PostgreSQL server installation and administration.
* The operating system, file system, and network infrastructure.
* Any job scheduler or wrapper scripts.
* Any downstream processing of <code>primes.prt</code>.

<span id="system-version-covered"></span>
=== 2.3 System version covered ===

This document set describes pgcobol as found in source artifacts dated November–December 2025, compiled under GnuCOBOL 4.0-early-dev.

<span id="what-is-explicitly-not-covered"></span>
=== 2.4 What is explicitly not covered ===

{|
!width="50%"| Excluded topic
!width="50%"| Reason
|-
| Prime numbers beyond 999,999,999
| Hard-coded upper bound in the source
|-
| Even primes (2)
| The algorithm tests odd candidates only; prime 2 is a known seeding gap
|-
| Interactive or web interfaces
| Not implemented
|-
| Concurrent execution
| Single-process batch design; no concurrency controls present
|-
| Encryption or secure credential storage
| Not implemented in this version
|-
| High-availability or disaster recovery
| Not in scope for this version
|}


-----

<span id="document-set-scope"></span>