C-LANG Statements › PROCESS Statement—Specify the Process to be Monitored (Process Monitoring Jobs)

PROCESS Statement—Specify the Process to be Monitored (Process Monitoring Jobs)

The PROCESS statement specifies the name of the process to be monitored.

Supported Job Type

This statement is required for the Process Monitoring job type.

Syntax

This statement has the following format:

PROCESS process_name

process_name

Specifies the name of the process to be monitored.

Limits: Up to 256 characters; case-sensitive

UNIX: Specify a PID or process name.

Windows: Specify a full path or process name.

i5/OS:

Specify the following format:

jobnumber/username/jobname

jobnumber

Specifies the six-digit job number or *ALL.

username

Specifies the user ID the job runs under. The value can be a generic name or *ALL.

Limits: Up to 10 characters

jobname

Specifies the job name on the i5/OS system. The value can be a generic name or *ALL.

Limits: Up to 10 characters

Notes:

• Enclose values that contain delimiters (such as spaces) in double quotation marks.
• If you have multiple processes on a system with the same process name, the job completes successfully as follows:
  • STATUS RUNNING NOW—The job completes successfully if at least one of the processes with the specified name is running.
  • STATUS RUNNING WAIT—The job completes successfully when at least one of the processes with the specified name starts running.
  • STATUS STOPPED NOW—The job completes successfully if all of the processes with the specified name are stopped.
  • STATUS STOPPED WAIT—The job completes successfully when all of the processes with the specified name stops running.

i5/OS Notes:

• If you specify only the PID or process name, the agent searches the active UNIX workload for a matching PID or process name.
• You can use generic names to specify the process name. A generic name starts with characters that are part of a valid name and ends with an asterisk (*). The asterisk denotes any number of characters and can only be placed at the end of a generic name. A name cannot contain only a single asterisk and no other characters. To specify all possible names, use the special value *ALL.

Example: Monitor the Agent Process on UNIX Using a Process Name

This example monitors the cybAgent process on a UNIX computer. The job checks the process status immediately and completes successfully if the process is running.

AGENT UNIXAGENT
PROCESS cybAgent
STATUS RUNNING NOW

Example: Monitor the Agent Process on UNIX Using a PID

Suppose that the UNIXAGENT computer runs multiple agents. To monitor a specific agent process, specify the PID of that agent process. The job checks the process status immediately and completes successfully if the process is running. If the process is not running, the job fails.

AGENT UNIXAGENT
PROCESS 2568
STATUS RUNNING NOW

Example: Monitor the Agent Process on Windows

This example monitors the cybAgent.exe process on a Windows computer. The job checks the process status immediately and completes successfully if the process is running. If the process is not running, the job fails.

AGENT WINAGENT
PROCESS cybAgent.exe
STATUS RUNNING NOW

Example: Monitor the Agent Process on Windows Using a Full Path

Suppose that the WINAGENT computer runs multiple agents. To monitor the cybAgent.exe process, the full path to that process is specified. The job checks the process status immediately and completes successfully if the process is running. If the process is not running, the job fails. The text string is enclosed in single quotes because it contains a space.

AGENT WINAGENT
PROCESS 'c:\Program files\agentdir\cybAgent.exe'
STATUS RUNNING NOW

Example: Monitor the Agent Process on i5/OS

This example monitors the CYBAGENT process on an i5/OS computer. The job checks the process status immediately and completes successfully if the process is running. If the process is not running, the job fails.

PROCESS 123456/CYBESPU/CYBAGENT
STATUS RUNNING NOW

Example: Monitor i5/OS Processes That Have Similar Names

This example monitors all processes running on an i5/OS computer under the JDOE user profile and whose names start with CALC. When all of these processes stop running, the job completes successfully.

AGENT I5AG
PROCESS *ALL/JDOE/CALC*
STATUS STOPPED WAIT