16f6c0aecf
Inline adoc files when they are included exactly once. Also fix language tags because this inlining gives us better information on what language the code is written in.
39 lines
953 B
Plaintext
39 lines
953 B
Plaintext
== Why is this an issue?
|
|
|
|
Changing procedural copybooks may potentially cause issues where many programs are pulled into a package for recompile and then a potential for bind issues during turnover. Having to edit procedural copybooks frequently causes delays in program maintenance as developers have to wait for another developer to complete their work. This also causes double work when programs get out of sync and a recent change could potentially be lost in a program.
|
|
|
|
|
|
=== Noncompliant code example
|
|
|
|
[source,cobol]
|
|
----
|
|
PROCEDURE DIVISION.
|
|
...
|
|
COPY MY_COPYBOOK. <- Noncompliant
|
|
...
|
|
----
|
|
|
|
|
|
=== Compliant solution
|
|
|
|
[source,cobol]
|
|
----
|
|
PROCEDURE DIVISION.
|
|
...
|
|
CALL MY_MACRO. <- Compliant
|
|
...
|
|
----
|
|
|
|
ifdef::env-github,rspecator-view[]
|
|
|
|
'''
|
|
== Implementation Specification
|
|
(visible only on this page)
|
|
|
|
=== Message
|
|
|
|
Logic contained in this copybook should move into a COBOL macro program.
|
|
|
|
|
|
endif::env-github,rspecator-view[]
|