rspec/rules/S4584/plsql/rule.adoc

== Why is this an issue?

``++CREATE_TIMER++`` is generating network traffic each time the timer is fired. It's probably totally fine for a timer being executed every hour but generally, this is used to provide clocks components that are going to generate network traffic every second or more.

It is recommended by Oracle to examine timers and replace them with JavaBeans.


=== Noncompliant code example

[source,sql]
----
BEGIN
  timer := CREATE_TIMER('foo', 1000, REPEAR)
ENDl
----


== Resources

* https://docs.oracle.com/cd/A97335_02/apps.102/a86202/chap11.htm[11.3.4 Other Techniques to Improve Performance]


ifdef::env-github,rspecator-view[]

'''
== Implementation Specification
(visible only on this page)

=== Message

Replace "CREATE_TIMER" by a JavaBean timer executed on Oracle Forms client side.


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?`

Restructure one-lang rspecs 2021-04-28 16:49:39 +02:00			``++CREATE_TIMER++`` is generating network traffic each time the timer is fired. It's probably totally fine for a timer being executed every hour but generally, this is used to provide clocks components that are going to generate network traffic every second or more.

			`It is recommended by Oracle to examine timers and replace them with JavaBeans.`

Fix the missing default metadata fields 2021-04-28 18:08:03 +02:00
migrate rule descriptions to new education format 2023-05-03 11:06:20 +02:00			`=== Noncompliant code example`
Restructure one-lang rspecs 2021-04-28 16:49:39 +02:00
RULEAPI-661: Add syntax coloring 2022-02-04 17:28:24 +01:00			`[source,sql]`
Restructure one-lang rspecs 2021-04-28 16:49:39 +02:00			`----`
			`BEGIN`
			`timer := CREATE_TIMER('foo', 1000, REPEAR)`
			`ENDl`
			`----`

Fix the missing default metadata fields 2021-04-28 18:08:03 +02:00
migrate rule descriptions to new education format 2023-05-03 11:06:20 +02:00			`== Resources`
Restructure one-lang rspecs 2021-04-28 16:49:39 +02:00
			`* https://docs.oracle.com/cd/A97335_02/apps.102/a86202/chap11.htm[11.3.4 Other Techniques to Improve Performance]`
Fix the missing default metadata fields 2021-04-28 18:08:03 +02:00

RULEAPI-666: Migrate the "List of parameters", "Highlighting" and "Message" fields from jira RSPEC (#346) 2021-09-20 15:38:42 +02:00			`ifdef::env-github,rspecator-view[]`

			`'''`
			`== Implementation Specification`
			`(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			`=== Message`

			`Replace "CREATE_TIMER" by a JavaBean timer executed on Oracle Forms client side.`

RULEAPI-666: Migrate the "List of parameters", "Highlighting" and "Message" fields from jira RSPEC (#346) 2021-09-20 15:38:42 +02:00
			`endif::env-github,rspecator-view[]`