# POS Cashier Display Message

## Revision History

<table><thead><tr><th width="157" valign="top">Date</th><th valign="top">Description</th></tr></thead><tbody><tr><td valign="top">06/08/2016</td><td valign="top">Initial Documentation Release</td></tr><tr><td valign="top">03/27/2023</td><td valign="top">Updated UI, removed Sapphire sections and updated branding.</td></tr></tbody></table>

## Using This Feature Reference

This Feature Reference provides detailed information on how to configure and use the POS Cashier Daily Message feature on the Verifone Commander Site Controller.

This feature document contains the subsections listed below:

* Overview - This section contains a brief description, requirements and the supported hardware configurations for the POS Cashier Daily Message feature on the Commander Site Controller.
* Configuring - This section contains information on how to implement and configure the POS Cashier Daily Message feature on the Commander Site Controller.
* Using - This section describes use of the POS Cashier Daily Message.
* Troubleshooting - This section provides basic troubleshooting information.

## Overview

### Feature Description <a href="#feature_description" id="feature_description"></a>

The POS Cashier Daily Message reference provides information for sites with a Verifone Commander to set up the client site to display custom text messages on the POS Cashier Display.

When the message server IP and URL are configured, POS terminals will poll the server while in sales mode. The contents of the daily message file are displayed on the POS terminal screen. Changes to the daily message file content will automatically be updated, causing the POS to display the new text. An empty file results in no text being displayed, allowing the retailer to clear the display back to the default. Polling ceases and the messages are cleared when the cashier exits sales mode on the POS terminal and returns to the login screen.

### Verifone Hardware Requirements <a href="#verifone_hardware_requirements" id="verifone_hardware_requirements"></a>

Verifone Commander and C18

### Verifone Software Requirements <a href="#verifone_software_requirements" id="verifone_software_requirements"></a>

Commander Site Controller base 39 and higher.

### Message Server Requirements <a href="#message_server_requirements" id="message_server_requirements"></a>

The client site must provide access to a managed web server to host the daily message file. The message server must be accessible by each POS to poll for the daily message data.

The message server must be outside of the Verifone Zone POS LAN, although the server may be onsite or hosted offsite. A router should be used to allow the POS terminals access to the server.

Setup, management and communications to the message server are the sole responsibility of the client.

## Configuration

### System Properties Menu Access

The following steps are required to edit role permissions, allowing the local user Manager to successfully enable communications to the message server.

{% stepper %}
{% step %}
**Configuration Client**

Log into the Verifone Commander Configuration Client as Manager.

<figure><img src="/files/zxinmowP5QhGVhY7LIfi" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Security**&#x20;

Navigate the Configuration Client menu and select Security > Manage Users.

<figure><img src="/files/m0epHPjNGKEHK5gz140o" alt=""><figcaption></figcaption></figure>

The User Administration window is displayed.

<figure><img src="/files/8vcF6gbNXOu7ji7gIvWP" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Configure Roles**

Click and select the Configure Roles tab.
{% endstep %}

{% step %}
**Manager Role**

Click and select the Manager role.
{% endstep %}

{% step %}
**Edit**&#x20;

Click **\[Edit]**. The Functions list is displayed with items listed alphabetically.

<figure><img src="/files/rX29ba0EBHEZOwyDa2rk" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}
**usapphireprop Property**

Scroll down the Functions list and locate **usapphireprop - Update Controller System Properties**.

<figure><img src="/files/2TwWTrBvePr0LZGgruKB" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Activate**

Click the checkbox next to **usapphireprop** to activate the function.
{% endstep %}

{% step %}
**vsapphireprop Property**

Scroll down the Functions list and locate **vsapphireprop - View Controller System Properties.**

<figure><img src="/files/Bxgq0s7e4JoI0lsE5qEF" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Activate**

Click the checkbox next to **vsapphireprop** to activate the function.

<figure><img src="/files/zIEPxMIEwzl5HQWKX8HI" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Done**

Click **\[Done]**.
{% endstep %}

{% step %}
**Save**

Click **\[Save]**.

<figure><img src="/files/U8z7EYx3lw7RXC9cd3OP" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Log Out**

Log out of the Commander Configuration Client.

<figure><img src="/files/Q8YSjzy3HOoxCc96Mp8I" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### Edit System Property Values <a href="#edit_system_property_values" id="edit_system_property_values"></a>

The following steps are required to edit System Properties, enabling communications to the message server.

{% stepper %}
{% step %}
**Manager Login**

Log into the Verifone Commander Configuration Client as **Manager***.*

<figure><img src="/files/FXx7gvaoHyLWkE4n158J" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**System Properties**&#x20;

Navigate the Configuration Client menu and select **Initial Setup > System Properties***.*

<figure><img src="/files/eLAitGtVuzAcIFDXzjz5" alt=""><figcaption></figcaption></figure>

The System Properties list is displayed with items listed alphabetically.
{% endstep %}

{% step %}
**Daily Message Properties**

Scroll the System Properties list and locate the Daily Message properties’ fields.

<figure><img src="/files/6FJC18VRRJiJISKuDwUo" alt=""><figcaption></figcaption></figure>

The following properties are associated with the POS Cashier Daily Message:

<table data-header-hidden><thead><tr><th width="204" valign="top"></th><th valign="top"></th></tr></thead><tbody><tr><td valign="top">DailyMsg.Poll.Interval</td><td valign="top">The poll interval governs how often the POS will check the message file for new data. The value is stored in seconds and must be greater than zero.</td></tr><tr><td valign="top">DailyMsg.Scroll.Interval</td><td valign="top">In cases where there is too much information to display at once in the daily message area, the scroll interval determines how long each line will be displayed before the message area is updated. The value is stored in seconds.</td></tr><tr><td valign="top">DailyMsg.Server.IP</td><td valign="top">The Message Host address is a numeric, IPV4 octet address.</td></tr><tr><td valign="top">DailyMsg.Server.Port</td><td valign="top">If the Message Host server is using a port other than port 80, set the Server.Port property to the port value.</td></tr><tr><td valign="top">DailyMsg.Server.URL</td><td valign="top">Configure the server URL property with the Message Server’s Address path needed to reach the daily message data. DNS is not used so the URL value will be the path and file name, without the host name.</td></tr></tbody></table>
{% endstep %}

{% step %}
**Edit**

Edit the Daily Message value(s).
{% endstep %}

{% step %}
**Save**

Click **\[Save]**.
{% endstep %}

{% step %}
**Log Out**

Log out of the Verifone Commander Configuration Client.

<figure><img src="/files/yrpeviHnfx1ckiAAR06R" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Refresh**

After the Verifone has been configured with the messaging host information, Logout and Login to all POS terminals to refresh the Cashier Message Display settings.
{% endstep %}
{% endstepper %}

### Revert System Properties Menu Access <a href="#revert_system_properties_menu_access" id="revert_system_properties_menu_access"></a>

The following steps are used to edit role permissions, securing System Properties access.

{% hint style="info" %}
Although optional, reverting permissions to secure access to the System Properties menu is highly recommended.
{% endhint %}

{% stepper %}
{% step %}
**Manager Login**

Log into the Commander Configuration Client as **Manager**.

<figure><img src="/files/USohYS2DUfydANZj4siI" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Manage Users**

Navigate the Configuration Client menu and select **Security > Manage Users**.

<figure><img src="/files/3wapFtfLS0VsmmWyjizk" alt=""><figcaption></figcaption></figure>

The User Administration window is displayed.

<figure><img src="/files/TSxf1x6X0CPhq2xJDeeH" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Configure Roles**

Click and select the **Configure Roles** tab.
{% endstep %}

{% step %}
**Manager Role**

{% endstep %}

{% step %}
**Edit**

Click **\[Edit]**.

The Functions list is displayed with items listed alphabetically.

<figure><img src="/files/7yn6GXFf1K0JurkGYGLm" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**usapphireprop Property**

Scroll down the Functions list and locate usapphireprop - **Update Controller System Properties**.
{% endstep %}

{% step %}
**Deactivate**

Click the checkbox next to **usapphireprop - Update Controller System Properties** to remove the check mark and deactivate this Function.

<figure><img src="/files/i2sMCIZQiZf0z8rpuQUA" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**vsapphireprop Property**

Scroll down the Functions list and locate *vsapphireprop - View Controller System Properties.*

<figure><img src="/files/A76p7lIUN5UI81Eh8v3F" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Deactivate**

Click the checkbox next to vsapphireprop to remove the check mark and de-activate this Function.

<figure><img src="/files/mmTuFKxWglZ8wnYVDIgj" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Done**

Click **\[Done]**.&#x20;
{% endstep %}

{% step %}
**Save**

Click **\[Save]**.

<figure><img src="/files/G0l8Cn7FUjMYh5y4E70P" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Log Out**

Log out of the Verifone Commander Configuration Client.&#x20;

<figure><img src="/files/TahlKGQA1Vt8CmrGhK5Y" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## Using POS Cashier Daily Message

The customer must provide access to a managed web server to host the message file. The message server must be accessible via IP communications to each POS terminal.

After the Verifone Commander has been configured with the messaging server’s information, Logout and Login to all POS terminals to refresh the Cashier Message Display settings.

### Message File

The message file is a plain text file which is stored on the message server in the file location as defined in the DailyMsg.Server.URL path.

A maximum of 30-lines can be included in the message file.

The message display function limits the string length based on the display size of the POS terminal.

The font is proportionally spaced so the exact number of characters varies with the text content, but all lines will be truncated to a maximum of 46 characters.

<figure><img src="/files/dmfavXf88AOXIHQFAu0R" alt=""><figcaption></figcaption></figure>

## Troubleshooting <a href="#troubleshooting" id="troubleshooting"></a>

In the event the Daily Message is not displaying on the POS screen, follow these basic troubleshooting steps:

1. Confirm the message server’s hosted Daily Message file is accessible through a web browser, and contains content.
2. Confirm the setup parameters are entered correctly into the System Properties Daily Message properties’ fields.
3. Logoff and Logon to the POS terminal in sales mode.

In the event the daily message server becomes inaccessible while the POS terminal is in sales mode, the current messages remain unaffected.

If the cashier logs out and back in, the messages will be removed. Effectively, this is no different from cases where the server had never been reachable.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.verifone.com/feature-references/feature-references/pos-cashier-display-message.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.