Skip to main content
Version: OpCon

SMAGetServiceStatus

The SMAGetServiceStatus utility (SMAGetServiceStatus.exe) monitors the status of windows services. The utility is useful for notifications and recovery actions.

Syntax

Use the following syntax for the SMAGetServiceStatus.exe program in the <Target Directory>\OpConxps\Utilities\:

SMAGetServiceStatus.exe "<Service Display Name>"

Parameters

The following describes the command-line parameters:

SMAGetServiceStatus.exe: The name of the command.

<Service Display Name>: The "Display Name" for a service (in the Properties > General tab) in the Services window. For more details, refer to Getting Service Display Names.

Getting Service Display Names

To perform the procedure:

  1. Use menu path: Start > Control Panel > Administrative Tools > Services.
  2. Scroll through the Service list and select the desired Service.
  3. Right-click on the Service Name and select Properties.
  4. Verify that the General tab is selected.
  5. View the Display name.
  6. Repeat Steps 2 - 5 for additional service names.
  7. Click Close ☒.

Example

Example

Settings for a job monitoring SMA Microsoft Resource Monitor. If SMA Microsoft Resource Monitor is stopped, OpCon notifies the administrator by way of email.

  1. In the Job Details screen, the Command Line is:

     "<Target Directory>\OpConxps\Utilities\SMAGetServiceStatus.exe" "SMA Microsoft Resource Monitor"
  2. In the Job Details screen, the Exit Code is EQ -2.

  3. In the Events screen:

    • The status is 'Failed'.
    • The Event is $NOTIFY:EMAIL,Admin@Company.com, SMA Microsoft Resource Monitor, SMA Microsoft Resource Monitor is Down.
  4. If desired, create other events for notification actions within ENS manager.

Scheduling

A job should be added to the SMAUtility schedule to run the SMAGetServiceStatus utility at regular intervals each day (e.g., Once per hour, or once every 15 minutes). For additional information, refer to SMAUtility Schedule in the Concepts online help.

Job Details

  • The Command Line is:
  • The Working Directory is:

Exit Values

The SMAGetServiceStatus.exe program uses the following exit values:

CodeValue
RUNNING0
NO_SERVICE_SPECIFIED_ON_COMMAND_LINE-1
STOPPED-2
START_PENDING-3
STOP_PENDING-4
CONTINUE_PENDING-5
PAUSE_PENDING-6
SERVICE_PAUSED-7
PATH_NOT_FOUND3
ACCESS_DENIED5
INVALID_HANDLE6
INVALID_PARAMETER87
SERVICE_IS_PAUSED928
DEPENDENT_SERVICES_RUNNING1051
INVALID_SERVICE_CONTROL1052
SERVICE_REQUEST_TIMEOUT1053
NO_THREAD1054
SERVICE_DATABASE_LOCKED1055
SERVICE_ALREADY_RUNNING1056
SERVICE_DISABLED1058
SERVICE_DOES_NOT_EXIST1060
SERVICE_CANNOT_ACCEPT_CTRL1061
SERVICE_NOT_ACTIVE1062
SERVICE_SPECIFIC_ERROR1066
SERVICE_DEPENDENCY_FAIL1068
SERVICE_LOGON_FAILED1069
SERVICE_START_HANG1070
SERVICE_MARKED_FOR_DELETE1072
SERVICE_EXISTS1073
SERVICE_DEPENDENCY_DELETED1075
SERVICE_NEVER_STARTED1077
SERVICE_NOT_IN_EXE1083
SHUTDOWN_IN_PROGRESS1115
SERVICE_NOT_FOUND1243