SYS_SERVER_ALIVE

Use the SYS_SERVER_ALIVE script function to check if a particular server process is active.

Tip: Use the :ON_ERROR script statement to define action to take if the server process is not active. For more information, see Script Elements for Error Handling.

Important Considerations

  • This script statement writes all open transactions of the script to the AE database. For more information, see Script Processing.
  • Syntax

    SYS_SERVER_ALIVE (Server process)

    Parameters

    Parameter Description Format
    Server process Name of the server process that you want to check. Script literal or script variable

    Return Codes

    The script function has the following return codes:

    • Y: The server process is active.
    • N: The server process is inactive.
    • 20349: The server process does not exist.

    Examples

    The following script checks if a work process called AE#WP005 is active. If the work process is not active, the system sends a message to an administrator:

    :IF SYS_SERVER_ALIVE("AE#WP005") = "N"

      :SEND_MSG "ADMIN""AE""Work process AE#WP005 is not active!"

    :ENDIF

    See also: