Predefined PC monitoring commands

Category: Content

Command

Description

Parameters

PCMONTAG

Populates the window title with the command line arguments when trigger criteria are met.

The new window title appears in Application Analysis reports and is used for evaluating window modules.

The original window title is used for evaluating triggers.

Logs to the pc_log table.

Syntax: %FORMAT<OptionString>

The OptionString can contain one or more of the following values:

  • %USER

  • %TRIGNAME

  • %DATE

  • %TIME

  • %COMPUTER

  • %WINTEXT

Example: %FORMAT“<%WINTEXT %USER %DATE %TIME >”

The example displays the screen with a window title that contains the original title, the user name, date, and time. Order Form John Apple Feb.12 13:44

PCMONADDREC

Add to Usage Data

Enters application usage data into the DPA database for reporting purposes.

Enter an application name and a window title to display in the reports.

Syntax: %FORMAT <APP> <WINTEXT>

Optional: Use any screen control passback value as the parameters.

Examples:

  • %FORMAT <App> <FORMNAME>

  • %FORMAT <APP> AgentID: <AgentID>

Category: Guidance

Command

Description

Parameters

PCMONPOPDATA

Execute Datapop Script

Triggers a Data Guidance script.

Script must be selected from the drop-down list

Syntax: /sScriptName Example: /sMyGuidanceScript

PCMONPOSTURL

Post URL

Sends an HTTP POST request to the supplied URL. This command ignores any return from the POST.

Use to send information from the desktop to a third-party web page.

Syntax: URLSTRING

Optional: %FORMAT

Example: URL?accNum=<TriggerVariable1>&CustID=<Passback1>

The URLSTRING can be any valid URL and can contain passback values or trigger variables as query arguments. No browser window is opened with this request.

Category: Other

Command

Description

Parameters

PCMONSETUSER

Set User Name

Changes the logged-in user name when the Window Title criteria is met.

Ensure the new user name has DPA privileges.

Syntax:<NewUserName>

 

Category: Notify

Command

Description

Parameters

PCMONWFOALERT

Notify WFO Alerts

Notify Alert Rules

Triggers a DPA alert that acts as a source event for the WFO notification and alerts mechanism.

There needs to be at least one corresponding WFO alert rule configured to work with the DPA alert.

Use Cases:

  • The DPA trigger evokes a desktop message alert to the fraud protection and compliance supervisor

  • The DPA trigger evokes an email alert to the agent’s supervisor

  • The DPA trigger based on a Guidance prompt impacts an analytics rule that provides feedback to the Guidance rule.

Syntax:

Automatically sends the Trigger Display Name as the alert title to WFO.

Additional parameters and trigger variable values are sent to WFO within the body of the DPA alert.

The corresponding WFO alert can be configured to include these trigger variable values.

Example:

<USER><WINTEXT><CustID><CustName>

 

Category: Process

Command

Description

Parameters

PCMONLOGONLY

Process Trigger

Logs data without executing any command.

Use for step or process definition to know a condition has been met.

Syntax: N/A

Optional: %TRIGVAL

Optional parameters are stored in the trigger passback field for display in trigger reports.

Category: Security

Command

Description

Parameters

PCMONKILLPROC

Kill Current Window

Kill command will terminate the process behind the current window.

No arguments are needed for this command.

PCMONRUNSCRIPT

Run Python Script

Executes the Python script.

Script must be selected from the drop-down list

Syntax:

/sScriptName

Optional:

  • /etimeoutInSeconds

  • /h%WINDOWHANDLE

  • /t%TRIGVAL

Example: e10

PCMONSTARTLOG

Start Logging

Starts the capture of application usage data.

No parameters are required

PCMONSTOPLOG

Stop Logging

Stops the capture of application usage data. Data capture restart when a PCMONSTARTLOG trigger is fired, machine restart, or user logs in again.

NOTE: Triggers continue to be fire.

No parameters are required