SYS_SERVER_ALIVE

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

Note: The script statement causes all open transactions of the script to be written to the AE database. For more information, see Script Processing.

Syntax

SYS_SERVER_ALIVE (Server process)

Parameters

• SYS_SERVER_ALIVE
  Checks the status of a server process

• Server process
  Name of the server process that you want to check
  Format: 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

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.

Example

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: