pgm‑name

Identifies the highest‑level program in the application to disable. Any user executing the commands SELECT SYSTEM sys‑ID; RUN pgm‑ name ... is affected by the DISABLE command. Only the PROD version of that application is disabled. For users currently running an application that was disabled, the user's run is aborted the first time he presses the Enter key or a PF key or the application transmits a panel after the time specified in the DISABLE command.

When a run is disabled, the TERMINATION PANEL displays (either the user‑specified panel or the default panel).

hh:mm

Specifies when the disable takes effect. The hh:mm parameter is specified in 24‑hour clock format, for example, 1 PM is 13:00. If the TOMORROW option is not specified, the time must be greater than the current time.

Note: You can specify a semicolon (;), comma (,) period (.) or HHMM instead of the colon (:).

TERMINATION clause

Specifies the panel sent to the user upon termination of a run due to a DISABLE command. After sending the panel, the next time that user presses Enter or a PF key, the user is signed off of CA Ideal or returned to the CA Ideal main Menu, depending on the user's current setting of the SET RUN QUITIDEAL option. If no TERMINATION PANEL is specified, a default panel is sent that says:

“The current application has been disabled by site management. Please press ENTER to continue.”

If specified, the TERMINATION clause must specify the panel name, the CA Ideal system it is defined in, and its numeric version number. The specified panel can have help, prefix, and suffix panels defined to it. The advantage of a user specified panel is that instructions can display telling the user when to sign back on.

'msg‑text'

A message that displays in the message line for any user running the application. The maximum length of the message is as many characters as fit on the command line, on the line of a member being executed, or in the prompting field for the command.

If a user starts running the program before the “DISABLE time”, this message is sent at each transaction boundary (when he presses a PF key or the Enter key or when a panel is transmitted) to notify the user to sign off the application. If no WARNING MESSAGE is specified, the message sent is:

This application will terminate at mm:dd hh:ss. Current time is hh:ss.

Users executing a RUN command after the DISABLE command is executed, but before the “DISABLE time” arrives, are allowed to start running, but get this warning message. The warning message can be overwritten by system messages or messages sent through the NOTIFY statement.