MarkVision Messenger. Lexmark MARKVISION PROFESSIONAL
Reklaam
Reklaam
5
MarkVision Messenger
MarkVision Messenger is a utility that lets you create Actions. An Action defines a command to execute whenever an event occurs across a set of devices. Device Status Events are conditions signaled by messages like Paper Tray Missing or Toner Low. Folder Events are signaled when devices enter and/or exit a particular folder.
During the installation of MarkVision Professional, you are asked to select the components to install.
To install MarkVision Messenger, check MarkVision Messenger.
If the MarkVision Server is your default Web server, you can access MarkVision Messenger from any browser by entering: http://yourserver/messenger
Where your server is the TCP/IP hostname or address of the workstation on which you installed the
MarkVision Server. For example, if you installed the MarkVision Server and MarkVision Messenger on a workstation with an address of nexus.dev.yourcompany.com, you would enter: http://nexus.dev.yourcompany.com/messenger
Notes:
•
MarkVision Messenger requires at least one MarkVision Server to be running on your network.
•
If MarkVision Professional is not your default Web server, you will need to add the 9180 port number to the Messenger URL: http://yourserver:9180/messenger
Installing MarkVision Messenger
MarkVision Messenger requires at least one MarkVision Server to be running on your network. If you choose, you can run MarkVision Messenger multiple times on the same workstation. However, each instance of the client must use a different configuration directory.
How does MarkVision Messenger work?
MarkVision Messenger communicates with the MarkVision Server to let you create and configure automated responses to printer events. These responses are called Actions. When you create an
Action, you must specify three things:
MarkVision Messenger
79
•
The type of event your Action will monitor
•
The devices your Action will monitor
•
The type of command your Action will execute
With MarkVision Messenger, you can create Actions to automate many printer administration tasks.
For example, you can configure Actions to:
•
Keep a log of printer paper jams
•
E-mail someone when a specific device condition occurs
•
Order supplies for a specific device when messages, such as Toner Low, occur
Event Types
Your Action can be triggered by two types of events:
Device Status Alerts
A Device Status Alert is a notification that something has changed at a printer. For example, when you pull a paper tray out of a printer, the printer tells MarkVision
Messenger that the tray is now missing. This is represented in MarkVision Messenger by an event with name = "Paper Tray Missing" and state = "ACTIVE."
When the tray is put back into place, the printer tells MarkVision Messenger that the tray is no longer missing. This is represented in MarkVision Messenger by an event with name
= "Paper Tray Missing" and state = "CLEARED."
You can configure your Action to respond to an event when its state is "ACTIVE," when its state is "CLEARED," or both. If your Action responds to Device Status Alerts, you will be prompted to choose the specific device status alerts that will trigger your action.
Printer Folder Alerts
A Folder Alert is generated when printers enter and/or exit a specified folder. For example, you could create a folder in MarkVision Professional that contains printers with a Toner Level less than 10%, and create an Action in MarkVision Messenger to notify you when printers enter this folder. If your Action responds to Printer Folder Alerts, you will be prompted to choose a folder.
Device Selection
When choosing the devices your Action will monitor, you have three choices:
All Devices on the MarkVision Server
If your Action will monitor all devices on the MarkVision Server, choose this option.
How does MarkVision Messenger work?
80
Devices in a Specified Folder
If your Action will monitor only a specific folder, choose this option. For example, if you were in charge of devices on the third floor, and had configured a folder on the MarkVision
Server that included these devices, you could limit the number of devices your Action monitors by choosing this folder.
Selected Devices
If your Action will monitor only specific devices, choose this option.
Command types
There are four types of commands that your Action can execute:
Send an SMTP e-mail
Your Action, when triggered, sends an e-mail to addresses you specify. These e-mails are highly customizable from within MarkVision Messenger. For example, an Action, triggered by a Folder
Alerts event, could e-mail an administrator when monitored printers enter a "Low Toner" folder. This e-mail message could be configured to list the model of printer, its IP address, and the time at which it entered the "Low Toner" folder.
Execute a command line on the MarkVision Server
Your Action, when triggered, executes a command line. For example, if you wanted to keep a log of offline devices, you could configure your Action to respond to the "Offline" Device Status Alert. Each time a monitored device becomes offline, specified information is written to a text file. Like the example above, the information MarkVision Messenger writes to this text file is highly customizable.
For example, you could specify that the text file list the device model, page count, and the time at which it went offline.
Execute a command line on a remote host server
Your Action, when triggered, executes a command line on a remote host server. In order to execute command lines on a remote host server, the rexec client must connect to a rexec server on the remote host server.
Furthermore, you can specify whether to perform commands conditionally or repeatedly, and how to execute them. You can have your Action execute its command:
•
Only after a specified delay period.
For example, if your Action sends an e-mail message when a printer goes offline, you can delay the execution of the command for a specified amount of time. This way, if the printer returns online during the delay period, the e-mail will not be sent. See
for more information.
•
After additional conditions have been met.
For example, if your Action is triggered by a Paper Tray Missing event, but you only want to execute the command when the event occurs for Tray 3, you could write a custom filter to
How does MarkVision Messenger work?
81
specify that your Action only respond when Tray 3 is removed from monitored printers. See
Send device status alerts to a Tivoli event server
MarkVision Messenger contains a custom event adapter that integrates with Tivoli's event management console. This event adapter lets administrators use the Tivoli event console to monitor printer events across a range of devices in real time. In order for Tivoli to display printer events, you must first setup the Tivoli event adapter by creating an action in MarkVision Messenger.
What are Actions?
Actions are associations that let you execute event-driven commands. They can be set up to occur automatically, as well as conditionally or repeatedly. You can specify which commands MarkVision
Messenger executes when device status events, such as Paper Tray Missing or Toner Low, occur, or when devices enter and/or exit a specified folder on the MarkVision Server.
See
How does MarkVision Messenger work?
for more information about using Actions.
Simple Filters
By using the Simple Filter you can set your Action to execute its command when a device is added to a folder, removed from a folder, or both. For example:
If you create a folder that contains printers whose page count is greater than 10,000, once a printer's page count exceeds that amount, the printer is added to that folder.
If you create a folder that contains printers with a flash device installed, and someone removes the flash from the printer, it is removed from that folder.
By using the with a delay of: option, you can delay the execution of your Action until a device has been in or out of the folder for a specified amount of time.
Custom filters
Custom filters let you customize and define how your action executes. You can do this by either uploading a previously defined script file or by writing a new one.
MarkVision Messenger provides a very simple scripting language to define filters. The following is a complete list of the statements and conditions you can use to write a custom filter:
Statements:
•
While
(Condition)
•
WaitUntil
(Condition)
•
IfThen
(Condition)
•
{ StatementList }
How does MarkVision Messenger work?
82
•
Distribute
Conditions:
•
And
(Condition_1...Condition_n)
•
Or
(Condition_1...Condition_n)
•
EventDataIs
(key, value)
•
SourceDataIs
(key, value)
•
TimeIsAfter
As an example, let's look at the script representation of the built-in Trigger on Active filter:
IfThen (EventDataIs("state", "ACTIVE"))
Distribute
The effect of the EventDataIs condition is to ask the event for the value of the event.state keyword.
This is the same keyword you can insert into command lines and e-mail messages. The first statement, an
IfThen
, executes the next statement if the condition
EventDataIs ("state",
"ACTIVE")
is true. An
EventDataIs
condition is true if the value of the keyword (
state
) matches the given value (
ACTIVE
). The next statement,
Distribute
, causes the command to execute.
Now, let's look at the script to write when the Trigger on Active filter is set with a delay of 30 seconds:
{
WaitUntil (TimeIsAfter(30))
IfThen(EventDataIs("state", "ACTIVE"))
Distribute
}
The braces ({}) are used to group statements into a list. They were not needed in the previous example because the
IfThen
and following statements were treated like a single statement.
The
WaitUntil
statement causes the script to pause execution until the condition is true. The
TimeIsAfter
condition checks for true only after the specified number of seconds has passed.
Once the 30 seconds has passed, if the event is still Active, the
Distribute
statement executes the command.
The script representation of the built-in Trigger on Either Active or Clear filter is a single
Distribute
statement. Let's say, for example, that you select Paper Tray Missing as the event, but you only want to execute the command when the event occurs for Tray 3. Also, you want to wait 20 minutes before executing the command, and execute the command again at the same 20-minute interval if the condition remains Active. Let's look at the script to write for this filter:
While (And(EventDataIs("state", "ACTIVE"), EventDataIs("location", "Tray 3")))
{
WaitUntil(TimeIsAfter(1200))
How does MarkVision Messenger work?
83
IfThen(EventDataIs("state", "ACTIVE"))
Distribute
}
In this example,
And
was used to build a compound condition. The
While
loop is only entered or repeated if the event is active for Tray 3. The code within the loop is the same as the code for the
Trigger on Active filter, except the
TimeIsAfter
condition is set to wait 1200 seconds (20 minutes).
Trigger on Either Active or Clear filters
Choose the Trigger on Either Active or Clear filter if you want to set your Action to execute each time a condition becomes Active or Cleared.
For example, let's say you want to keep a log of all printer paper jams so you can determine the average time it takes for a jam to be cleared. When a paper jam occurs, the printer generates an event with a state of Active. This satisfies the condition of the filter and executes your Action.
When the paper jam is cleared, the printer generates another event with a state of Clear. This event also satisfies the condition of the filter and executes your Action. You now have two lines in your log file, one with the time at which the paper jam occurred and another with the time it was cleared.
Trigger on Active filters
Choose the Trigger on Active filter if you want to set your Action to execute its command only when a condition becomes Active.
When you pull out a tray, the printer generates a Paper Tray Missing event with a state of Active. This satisfies the condition of the filter and executes your Action, perhaps by sending an e-mail notification.
When you push the tray back into place, the printer generates another Paper Tray Missing event, this time with a state of Clear, which does not satisfy the condition of the filter. Therefore, your Action is not executed and no one is notified when the event is cleared.
You can also choose to delay execution of your Action until the condition has been Active for a specified amount of time. Let's say the e-mail recipient is receiving too many notifications and you want to wait 20 minutes to see if the condition clears. By using the Delay Time option, you can create a filter that won't send the e-mail notification unless the Paper Tray Missing condition has been Active for 20 minutes.
Note: The Delay Time value is limited to 10 characters.
How does MarkVision Messenger work?
84
How do I use MarkVision Messenger?
Use MarkVision Messenger to create Actions that automatically perform printer administration tasks in response to printer events.
Use the following examples for ideas about how you can use MarkVision Messenger to:
•
Keep a log of all printer paper jams
•
Delay event notifications
•
Monitor specific paper trays
•
E-mail or page someone when a specific event occurs
•
Order supplies
Step 1: Preview the steps
To create an Action:
1
From the MarkVision Messenger Home screen, click Create New.
2
Define your Action by completing the following steps in order:
a
Name and describe your Action.
b
Set user access.
c
Select the Event Type that will trigger your action.
d
Select the events or folder that will trigger your Action.
e
Select the devices to monitor for your Action.
f
Select the type of command to execute.
g
Compose the command, and any parameters, for the event(s).
h
Select or create a filter for the events.
i
Verify Action information.
Note: If you no longer want to preview your choices, select Do not display this screen
again.
Step 2: Name your Action
The name you choose associates the Action you create with the name that appears in the Action list on the MarkVision Messenger Home screen.
How do I use MarkVision Messenger?
85
From the Description Information screen:
1
Enter a unique name for you Action in the Name: field.
2
Enter a more detailed description about your action and what it does in the Description: field.
3
Enter instructions associated with your Action in the Notes: field. For example, "Please clear the paper jam."
4
Click when you're ready to continue.
Notes:
The Name: field is limited to 80 characters.
The Description: field is limited to 255 characters.
The Notes: field is limited to 255 characters.
Step 3: Set user access
User access determines who can see, use, and change the Action you create.
From the Access screen:
1
Select Public to make your Action available to all users.
2
Select Private to make your Action available only to you.
3
Click when you're ready to continue.
Notes:
•
This screen only appears if user accounts have been created in MarkVision Professional.
•
A private Action does not require a special access password from within MarkVision
Messenger. However, since it is associated with the username used to create it, the Action is only accessible to that specific user.
Step 4: Select the Event Type
You must tell MarkVision Messenger which type of event your Action will monitor.
From the Event Type screen, you can:
•
Choose to monitor Printer Status Alerts.
•
Choose to monitor Printer Folder Alerts.
Click when you're ready to continue.
For more on Event Types, see
How does MarkVision Messenger work?
How do I use MarkVision Messenger?
86
Step 5: Select specific events or folder
Depending on the Event Type you have chosen, you must now tell MarkVision Messenger either the
Device Status Alerts your Action will monitor, or the folder whose events your Action will monitor.
If your Action is triggered by a Printer Folder Alert
1
Select a folder.
2
Click when you're ready to continue.
If your Action is triggered by a Device Status Alert
From the Events screen you can:
•
Add an event to the Selected Events: list:
1
Choose whether to sort events by Type or Severity.
2
Select an event category.
3
Add events to the Selected Events: list by:
–
Selecting an event, and then clicking .
–
Selecting [All events], for example [All Input Alerts], and then clicking .
–
Clicking to add all category events.
4
Click when you're ready to continue.
• Remove an event from the Selected Events: list
Select the event you want to remove, and then:
–
Click to delete the event from the list.
–
Click to delete all events from the list.
Notes:
•
Selecting [All events] adds all category events to the Selected Events: list, even ones added to the server later.
•
You can select from one or more event categories, one or more events, or a combination of the two.
Step 6: Select devices
You must choose which devices you want to monitor. For your convenience, MarkVision Messenger provides you with a list of all available devices capable of producing the events you selected.
From the Event Sources screen, you can:
How do I use MarkVision Messenger?
87
•
Select All Devices on the MarkVision Server to monitor all devices, even ones added to the server later.
•
Select Devices in a Specified Folder to monitor all devices in a specified folder, even ones added to the folder later.
•
Select Selected Devices to specify which devices to monitor.
If you choose Selected Devices, you can:
•
Click the name of a specific device in the Selected Devices list to select it.
•
Click Select All to select all devices currently in the Selected Devices list.
•
Click Deselect All to remove all devices selections from the Selected Devices list.
Click when you're ready to continue.
Notes:
•
If your Action is triggered by a Folder Event, you may be confused to be asked to choose a folder for a second time. By choosing a folder on this screen, you can narrow the list of printers you are interested in. In MarkVision Professional, printers can occupy more than one folder at a time.
•
For example, if your Action is triggered when printers move into a folder named "Toner Level
< 10%," and you only want to monitor printers in the folder named "Building 7." select the
"Building 7" on this screen. MarkVision Messenger will execute your Action when a printer from the "Building 7" folder enters the "Toner Level < 10%" folder.
Step 7: Select a command
You must tell MarkVision Messenger which type of command your Action will execute.
From the Command Type screen, you can:
•
Choose to execute a command line on the MarkVision Server.
Note: Because command lines are run on the MarkVision Server, you must be logged in as the MarkVision administrator to select this option.
•
Choose to send an e-mail message.
•
Choose to execute a command line on a remote host.
Note: This option requires that a rexec server be present on the remote host.
•
Choose to setup a Tivoli event adapter.
Note: this option is only available if the Device Status Alert option is selected.
Click when you're ready to continue.
How do I use MarkVision Messenger?
88
Step 8: Compose the command
Keywords represent information about your Action, a device, or an event. You can pass this information to your command on the MarkVision Server or a remote host, or choose to embed it in an e-mail message.
To send an e-mail message
1
Enter the recipient's e-mail address in the To: field. Make sure you separate multiple e-mail addresses with a comma.
2
Enter optional e-mail addresses in the Cc: field. Make sure you separate multiple e-mail addresses with a comma.
3
Enter the purpose of your e-mail in the Subject: field.
4
Enter your e-mail message in the Body: field.
5
Add keyword(s) to any text field by:
•
Selecting a keyword from the Keywords: list, and then clicking .
•
Typing the keyword directly into the field.
6
Click when you're ready to continue.
, you will be prompted to enter your
mail server and mail path information.
To execute a command line on a remote host
1
Enter the remote host information in the Hostname:, Username:, and Password: fields.
2
Enter the name of an executable command in the Command Path: field.
3
Add keyword(s) to the Command Line Parameters: field by:
•
Selecting a keyword from the Keywords: list, and then clicking .
•
Typing the keyword directly into the field.
4
Click when you're ready to continue.
To execute a command line on the MarkVision Server
1
Enter the name of an executable command in the Command Path: field.
2
Add keyword(s) to the Command Line Parameters: field by:
•
Selecting a keyword from the Keywords: list, and then clicking .
•
Typing the keyword directly into the field.
3
Click when you're ready to continue.
How do I use MarkVision Messenger?
89
To setup a Tivoli event server
To execute this command, see
Setting up the Tivoli event adapter
Step 9: Select a filter
A filter lets you control commands that execute when events occur. Your filter options depend on the
Event Type.
If your Action is triggered by Device Status Alerts:
•
Choose Trigger on Active to set the command to execute only when a condition becomes
Active. You can also choose to delay execution of the command until the condition has been active for a specified amount of time.
•
Choose Trigger on Either Active or Clear to set the command to execute each time a condition becomes Active or Clear.
•
Choose Custom to customize and define when the command executes. You can do this by either uploading an existing script file or writing a new one.
If your Action is triggered by Printer Folder Alerts:
•
Choose Simple Filter to set the Action to execute when a device is added to the folder, removed from the folder, or both. You can also choose to delay execution of the command until the condition has been active for a specified amount of time.
•
Choose Custom to customize and define when the command executes. You can do this by either uploading an existing script file or writing a new one.
Click when you're ready to continue.
Step 10: Customize a filter
If you choose Custom from the Filter Type screen, you can customize and define how your action executes. Do this by either uploading a previously defined script file or by writing a new one.
•
To upload a previously defined script file:
1
From the Custom Filters screen, enter the name of the script file you want to upload, or click Browse... to locate it.
2
Click Load. The script file appears in the text field.
3
Click when you're ready to continue.
•
To write a new script file:
1
From the Custom Filters screen, type new script information into the text field.
2
Click when you're ready to continue.
How do I use MarkVision Messenger?
90
Notes:
•
Click Tips for more information and sample scripts.
•
When you upload a script file, all information in the text field is erased. Make sure you upload the script file first, and then make changes or enter additional information.
Step 11: Verify Action information
When you're finished, you should verify all Action information for technical accuracy. Carefully review the detailed summary provided in the text field.
When you're ready to continue:
•
Click Yes to enable your Action.
•
Click No to disable your Action.
•
Click to step back through the setup process and make changes.
•
Click to create your Action and return to the MarkVision Messenger Home screen.
•
Click to return to the MarkVision Messenger Home screen without creating an Action.
Note: You cannot alter information directly in the text field. If you want to make changes, click to step back through the setup process and make changes from the appropriate screens.
Modifying an Action
1
From the MarkVision Messenger Home screen, find the Action you want to change.
2
Click Modify.
You are presented with the same series of choices you used to create an Action, but each choice defaults to the current setting for the Action you selected. You may change any or all of your previous settings.
Notes:
•
You cannot modify an Action that is enabled by another user.
•
You cannot modify an Action that another user has selected.
How do I use MarkVision Messenger?
91
Enabling an Action
1
From the MarkVision Messenger Home screen, select the Action you want to enable by clicking the box to the left of the Action name.
2
Click Enable Selected. The status of the selected Action changes to Enabled.
Note: You cannot enable an Action that another user has selected.
Disabling an Action
1
From the MarkVision Messenger Home screen, select the Action you want to disable by clicking the box to the left of the Action name.
2
Click Disable Selected. The status of the selected Action changes to Disabled.
Note: You cannot disable an Action that another user has selected.
Deleting an Action
1
From the MarkVision Messenger Home screen, select the Action you want to delete by clicking the box to the left of the Action name.
2
Click Delete Selected. The selected Action is removed from the Actions list.
Notes:
•
You cannot delete an Action that is enabled by another user.
•
You cannot delete an Action that another user has selected.
Viewing Action information
To display a detailed summary of an Action:
1
From the MarkVision Messenger Home screen, click the name of the Action.
2
Click Done when you are ready to return.
Note: You can only view information for one Action at a time.
You cannot make changes to the Action from the screen. If you want to make changes:
1
From the MarkVision Messenger Home screen, find the Action you want to change.
2
Click Modify.
See
How do I use MarkVision Messenger?
92
Setting or changing user data
User data identifies and provides more information about a specific device or set of devices. It is associated with the action.sourcedata keyword string that can be inserted into the Command Line
Parameters: list. You can associate the same data with one or more devices.
To set or change user data:
1
From the MarkVision Messenger Home screen, click Set User Data. A list of all available devices and current user data is displayed.
2
Enter your device information in the Data: field.
3
Select the devices you want to associate with this data. You can:
•
Click the box to the left of a device name to select it.
•
Click Select All to select all devices.
•
Click Deselect All to remove all device selections.
4
When you're finished:
•
Click Apply to save your changes and refresh the Set User Data screen.
•
Click Done to return to the MarkVision Messenger Home screen.
Notes:
•
User-defined data is user specific and cannot be viewed or altered by another user.
•
The Data: field is limited to 80 characters.
Generating reports
You can create Actions to generate event-specific reports.
For example, you're an account administrator and you want to set up an Action to generate a report containing billing and delivery information for all supplies that have been ordered.
1
From the MarkVision Messenger Home screen, click Create New.
2
Enter your Action information in the setup screens that follow, and then click Next.
3
From the Events screen, select Supplies Alerts from the Categories: list.
4
Select the events you want to monitor and click the (>) button to add them to the Selected
Events: list.
5
Click Next when you are ready to continue.
6
Select the devices you want to monitor, and then click Next.
7
Enter your command information and keywords in the appropriate fields.
8
Click Next, and complete the remaining steps.
How do I use MarkVision Messenger?
93
Keeping a log of paper jams
You can create an Action to keep a log of specific device events.
For example, you may want to keep a log of paper jams to determine the average time it takes for them to be cleared.
To set up an Action to log paper jams:
1
From the MarkVision Messenger Home screen, click Create New.
2
Enter your Action information in the setup screens that follow, and then click .
3
From the Event Type screen, select Printer Device Status Alerts, and then click .
4
From the Events screen, choose [Output Alerts] from the Categories: list.
5
Select Paper Jam as the event, and then click to add it to the Selected Events: list.
6
Click when you're ready to continue.
7
Select the devices you want to monitor, and then click .
8
Select Execute a Command Line on the MarkVision Server, and then click .
Note: Because command lines are run on the MarkVision Server, you must be logged in as the MarkVision administrator to select this option.
9
Enter the name of an executable command in the Command Path: field.
Note: Make sure the command you enter can accept the keywords you insert and write them to the end of a log file.
10
Select the keywords you want to appear in the log file, and then click to add them to the
Command Line Parameters: field.
Note: Make sure you insert the keywords in the correct order.
11
Click when you're ready to continue.
12
From the Select a filter screen, select Trigger on Either Active or Clear.
Note: This creates two lines in the log file: one that logs the time at which paper jams occur, and another that logs the time they are cleared.
13
Click , and then complete the remaining steps.
Delaying Event notifications
You can set up an Action to delay execution of its command until an Event has been active for a specified amount of time.
How do I use MarkVision Messenger?
94
Let's say you created an Action to send an e-mail notification when a Load Paper or Envelope condition occurs. But after a week, the e-mail recipient is receiving too many notifications, and often when he goes to a device, someone else has already loaded more paper. By using the Delay Time option, you can create a filter that will only send a notification if the Load Paper or Envelope condition has been active for an amount of time that you specify.
Likewise, if your Action is triggered by a Folder Alert, you can delay its execution by using the With a
delay of: option.
If you want to create an Action that uses the Delay Time option:
1
From the MarkVision Messenger Home screen, click Create New.
2
Enter your Action information in the setup screens that follow, and then click .
3
Enter the filter information:
If your Action is triggered by Device Status Alerts
•
From the Filter Type screen, choose Trigger on Active.
•
Under Delay Time, specify how long you want the Action to wait to execute its command. For example, type in
20
and select Minute(s) from the drop-down list.
If your Action is triggered by Folder Alerts
From the Filter Type screen, select Simple Filter.
Under with a delay of:, specify how long you want the Action to wait to execute its command. For example, type in
2
, and then select Hour(s) from the drop-down list.
Click OK, and then complete the remaining steps.
Monitoring specific device paper trays
You can use a filter to narrow the Events that trigger your action.
Let's say you configured Tray 2 on all your devices for your company's letterhead and you only want to monitor for Load Paper or Envelope events on Tray 2. For this example, the Trigger on Active or the Trigger on Either Active or Clear filter is not sufficient.
To write a custom filter to monitor specific paper trays:
1
From the MarkVision Messenger Home screen, click Create New.
2
Enter your Action information in the setup screens that follow, and then click .
3
From the Event Type screen, choose Printer Device Status Alerts, and then click .
4
From the Filter Type screen, choose Custom, and then click .
How do I use MarkVision Messenger?
95
5
In the text field, enter a script that only executes the command when the parameter is the paper tray you want to monitor. For example:
IfThen (EventDataIs("location", "Tray2"))
Distribute
6
Click , and then complete the remaining steps.
Sending an e-mail
You can create an Action to automatically send an e-mail to someone when a specific event occurs.
For example, your network administrator must be notified each time an Operator Intervention Alert occurs, but he is rarely at his desk. If your administrator has an alphanumeric pager, you can set up the Action to send an e-mail to his pager and promptly alert him when the event occurs.
To create an Action to send an e-mail:
1
From the MarkVision Messenger Home screen, click Create New.
2
Enter your Action information in the setup screens that follow, and then click .
3
From the Event Type screen, choose Printer Device Status Alerts, and then click .
4
From the Command Type screen, choose Send SMTP E-mail.
Note: If you have not set up your SMTP mail server, you are prompted to enter your mail server and mail path information.
5
Enter the recipient's e-mail address in the To: field. Make sure you separate multiple e-mail addresses with a comma.
6
Enter optional e-mail addresses in the Cc: field. Make sure you separate multiple e-mail addresses with a comma.
7
Enter the purpose of your e-mail in the Subject: field.
8
Enter your e-mail message in the Body: field.
9
Add the appropriate keyword(s) to any text field.
10
Click , and then complete the remaining steps.
Ordering supplies
If you have an automated ordering system on your network, you can set up an Action to automatically order supplies for all devices attached to the server.
For example, you can configure an Action to automatically order toner when the first Supply Low event occurs. You can also use the Delay Time option to tell your command to ignore Supply Low and Supply Empty messages for 10 days after the first event. This lets your Action invoke the
How do I use MarkVision Messenger?
96
automated ordering system to order toner for the printer, and allows time for the new toner to arrive and be installed before more Supply Low and Supply Empty messages are logged.
To create an Action to order supplies:
1
From the MarkVision Messenger Home screen, click Create New.
2
Enter your Action information in the setup screens that follow, and then click .
3
From the Event Type screen, choose Printer Device Status Alerts, and then click .
4
From the Events screen, choose Supplies Alerts from the Categories: list.
5
Select Supply Low and Supply Empty, and then click to add them to the Selected
Events: list.
6
Click Next when you're ready to continue.
7
Select the devices you want to monitor, and then click .
8
Select Execute a Command Line on the MarkVision Server, and then click .
9
Enter the path to the automated ordering system program in the Command Path: field.
10
Select the keywords to pass to the automated ordering system, and then click to add them to the Command Line Parameters: field.
Note: Make sure you insert the keywords in the correct order.
11
Click when you're ready to continue.
12
From the Filter Type screen, choose Trigger on Active.
13
Under the Delay Time option, enter 10, and then select Day(s) from the list box.
14
Click , and then complete the remaining steps.
Setting up a SMTP mail server
MarkVision Messenger lets you set up and store your SMTP parameters to use for all your e-mail messages.
To set up a SMTP mail server:
1
From the MarkVision Messenger Home screen, click SMTP Setup.
2
Enter your mail server information in the SMTP Mail Server: field.
3
Enter your e-mail information in the From: field.
4
Click Done to return to the MarkVision Messenger Home screen.
How do I use MarkVision Messenger?
97
Setting up the Tivoli event adapter
The Tivoli event adapter lets administrators monitor printer events accross a range of devices in real time. In order to send device status alerts to Tivoli, you must create an action in MarkVision
Messenger.
1
Click Create New on the MarkVision Messenger Home screen.
2
Enter a name for the adapter, and if desired, input a description and any notes. Click .
3
Select the type of alert that you want to send an event to the Tivoli event server, and then click .
Note: The Tivoli event adapter will be available in a subsequent section of the wizard only if the type of events selected on this screen are Device Status Alerts.
4
Select the type of event that will trigger the action from the Event scroll box, and then use the arrow buttons to move the event to the Selected Events box. Click .
5
Choose the method of device selection. Click .
6
Select Send Device Status Alerts to a Tivoli Event Server from the dialog box, and then click .
7
Enter your Tivoli configuration settings, and then click .
8
Determine when the action should execute, and then click .
A summary of the action that you have created is displayed. If you are satisfied with the action, click
Yes and then to enable the Tivoli event adapter.
Note: After creating a Tivoli event adapter in MarkVision Messenger, you must then configure the Tivoli server for Messenger alerts. Refer to your Tivoli documentation for details on how to configure your Tivoli server.
How do I use MarkVision Messenger?
98
Laadi alla
Reklaam