C-LANG Statements › PROCESSMONITOR Statement—Specify the SAP Process Status to Monitor

PROCESSMONITOR Statement—Specify the SAP Process Status to Monitor

The PROCESSMONITOR statement specifies the SAP process status to monitor.

Supported Job Type

This statement is required for the SAP Process Monitor job type.

Syntax

This statement has the following format:

PROCESSMONITOR STATUS(WAITING|RUNNING|STOPPED)
     [USER(user)]
     [CLIENT(client)]
     [CONTINUOUS(alertid)]
     [TYPE(DIA|UPD|ENQ|BGD|SPO|UP2)]

STATUS

Specifies the SAP process status to monitor. Options are the following:

• RUNNING
• STOPPED
• WAITING

Note: If you specify WAITING, the CLIENT and USER operands do not apply.

USER(user)

(Optional) Specifies an SAP user name. When a process matches the specified process status, the job the process runs is checked for a match to this user.

Limits: Up to 32 valid SAP characters; case-sensitive; it cannot contain delimiters (such as spaces)

CLIENT(client)

(Optional) Specifies the client monitored for the specified process.

Limits: Up to 3 numeric digits

Example: 800

CONTINUOUS(alertid)

(Optional) Specifies the identifier of an alert to be triggered when the specified process type and status are detected. Defines the job as continuous. To end continuous monitoring, you must complete the job manually or cancel it. If you do not specify this operand, the job completes when the specified process type and status are detected.

alertid

Specifies the alert identifier to be triggered.

Limits: 1-8 alphanumeric characters; the first character must be alphabetic

Note: The alert must have been previously defined to the scheduling manager. Not all scheduling managers support the CONTINUOUS operand.

TYPE

(Optional) Specifies the SAP business process type to monitor. Options are the following:

• BGD—background
• DIA—dialog
• ENQ—lock
• SPO—spool
• UPD—update
• UP2—update2

Note: PROCESS is an alias of PROCESSMONITOR.

Example: Monitor for Jobs Running in the Background

This example monitors for running background jobs and checks for the SAP user named USER14:

SAPJOBNAME PMTEST
AGENT SAPHTAGENT
PROCESSMONITOR USER(USER14) CLIENT(800) CONTINUOUS(alt1) +
  STATUS(RUNNING) TYPE(BGD)