Special parameters: bg

Startup parameters change the behavior of the Service Manager server. You can always set a startup parameter from the server's operating system command prompt.

Parameter

bg

Description

This parameter causes the Service Manager Server to run RAD processes in background mode (that is, no user interactions or messages are available).

This parameter affects three aspects in the RTE: the DBI (Database Interface) layer, the APPs code, and message sending.

  • In the DBI layer, once this parameter is set, the following db operations will not trigger any error messages to the client any more:
    • delete:

      If DBI is trying to delete a record that was already deleted by others, the message "The record being deleted was already deleted" is not sent.

      If DBI is trying to delete a record that was already modified by others, the message "The record being deleted has been modified since read" is not sent.

    • dbUpdate:

      If DBI is trying to update a record that was already deleted by others, the message "The record being updated has been deleted" is not sent.

      If DBI is trying to update a record that was modified by others, the message "The record being updated has been modified since read" is not sent.

  • When "bg" is set, the following APPs functions will fail with an error as described below:

    • fdisp: "FDISP panels cannot be executed in the background."
    • rio: "RIO panels cannot be executed in the background."
    • wopen: "WOPEN panels cannot be executed in the background."
    • wclose: "WCLOSE panels cannot be executed in the background."
    • wselect: "WSELECT panels cannot be executed in the background."
  • Once "bg" is set, all messages generated by RTE code and APPs code (via APPs function "scmsg") are not sent to the client; instead, they are sent to the log files defined by the parameter "log" (by default, it is sm.log).

Valid if set from

Server's operating system command prompt

Initialization file (sm.ini)

Requires restart of the Service Manager server?

No

Default value

None

Possible values

None

Example usage

Command line: sm -httpPort:13080 -bg

Initialization file: bg

Related topics

System parameters
Enter a parameter in the sm.ini file
Background and scheduled process parameters