rspec/rules/S4880/cobol/rule.adoc

== Why is this an issue?

The rule S1279 ("DISPLAY" should not be used) is fully preventing the usage of the ``++DISPLAY++`` statement whereas in same cases it may be useful to output some data to SYSOUT. However, the output of a call to ``++DISPLAY UPON CONSOLE++`` is unlikely to be viewed by someone because the output is displayed on the console and nowadays no one is in front of the console to see if something is happening.


=== Noncompliant code example

[source,cobol]
----
PROCEDURE DIVISION.
   ...
   DISPLAY "Error Occurred!!!" UPON CONSOLE *> Noncompliant
   ...
----


ifdef::env-github,rspecator-view[]
'''
== Comments And Links
(visible only on this page)

=== duplicates: S1279

=== on 27 Sep 2018, 15:25:56 Pierre-Yves Nicolas wrote:
RSPEC-1279 has a parameter named "checkOnlyDisplayUponConsole".

=== on 23 Nov 2018, 13:57:23 Alexandre Gigleux wrote:
This is a duplicate of RSPEC-1279. By default RSPEC-1279 is containing a parameter ``++checkOnlyDisplayUponConsole++`` that is ON and prevent the use of "DISPLAY UPON CONSOLE".

endif::env-github,rspecator-view[]
migrate rule descriptions to new education format 2023-05-03 11:06:20 +02:00			`== Why is this an issue?`

RULEAPI-617: Add Jira closed RSPECs in Github repository 2021-06-08 14:23:48 +02:00			The rule S1279 ("DISPLAY" should not be used) is fully preventing the usage of the ``++DISPLAY++`` statement whereas in same cases it may be useful to output some data to SYSOUT. However, the output of a call to ``++DISPLAY UPON CONSOLE++`` is unlikely to be viewed by someone because the output is displayed on the console and nowadays no one is in front of the console to see if something is happening.


migrate rule descriptions to new education format 2023-05-03 11:06:20 +02:00			`=== Noncompliant code example`
RULEAPI-617: Add Jira closed RSPECs in Github repository 2021-06-08 14:23:48 +02:00
RULEAPI-661: Add syntax coloring 2022-02-04 17:28:24 +01:00			`[source,cobol]`
RULEAPI-617: Add Jira closed RSPECs in Github repository 2021-06-08 14:23:48 +02:00			`----`
			`PROCEDURE DIVISION.`
			`...`
			`DISPLAY "Error Occurred!!!" UPON CONSOLE *> Noncompliant`
			`...`
			`----`



			`ifdef::env-github,rspecator-view[]`
RULEAPI-576: add a horizontal rule between rule description and comments 2021-06-08 15:52:13 +02:00			`'''`
RULEAPI-617: Add Jira closed RSPECs in Github repository 2021-06-08 14:23:48 +02:00			`== Comments And Links`
			`(visible only on this page)`

Inline adoc when include has no additional value (#1940) 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. 2023-05-25 14:18:12 +02:00			`=== duplicates: S1279`

			`=== on 27 Sep 2018, 15:25:56 Pierre-Yves Nicolas wrote:`
			`RSPEC-1279 has a parameter named "checkOnlyDisplayUponConsole".`

			`=== on 23 Nov 2018, 13:57:23 Alexandre Gigleux wrote:`
			This is a duplicate of RSPEC-1279. By default RSPEC-1279 is containing a parameter ``++checkOnlyDisplayUponConsole++`` that is ON and prevent the use of "DISPLAY UPON CONSOLE".

RULEAPI-617: Add Jira closed RSPECs in Github repository 2021-06-08 14:23:48 +02:00			`endif::env-github,rspecator-view[]`