Professional Documents
Culture Documents
Sys Admin Guide Data Collection
Sys Admin Guide Data Collection
Altitude, Altitude Dream, Cambridge Clock, CardSaver, Datakeeper, Datakeeper Central, eForce, Gatekeeper,
Gatekeeper Central, Imagekeeper, Jobkeeper Central, Keep.Trac, Kronos, Kronos Touch ID, the Kronos logo, My
Genies, PeoplePlanner, PeoplePlanner & Design, Schedule Manager & Design, ShiftLogic, ShopTrac, ShopTrac
Pro, StarComm, StarPort, StarSaver, StarTimer, TeleTime, Timekeeper, Timekeeper Central, TimeMaker, Unicru,
Visionware, Workforce Accruals, Workforce Central, Workforce Decisions, Workforce Express, Workforce Genie,
and Workforce TeleTime are registered trademarks of Kronos Incorporated or a related company. Altitude MPP,
Altitude MPPXpress, Altitude Pairing, Altitude PBS, Comm.Mgr, CommLink, DKC/Datalink, eDiagnostics, Experts at
Improving the Performance of People and Business, FasTrack, Hireport, HR and Payroll Answerforce, HyperFind,
Kronos 4500 Touch ID, Kronos 4500, Kronos 4510, Kronos Acquisition, Kronos e-Central, Kronos KnowledgePass,
Kronos TechKnowledgy, KronosWorks, KVC OnDemand, Labor Plus, Momentum Essentials, Momentum Online,
Momentum, MPPXpress, Overall Labor Effectiveness, Schedule Assistant, Smart Scheduler, Smart View, Start
Quality, Start WIP, Starter Series, StartLabor, Timekeeper Decisions, Timekeeper Web, VisionPlus, Winstar Elite,
WIP Plus, Workforce Acquisition, Workforce Activities, Workforce Analytics, Workforce Attendance, Workforce
Central Portal, Workforce Connect, Workforce Employee, Workforce HR, Workforce Leave, Workforce Manager,
Workforce MobileTime, Workforce Operations Planner, Workforce Payroll, Workforce Record Manager, Workforce
Recruiter, Workforce Scheduler with Optimization, Workforce Scheduler, Workforce Smart Scheduler, Workforce Tax
Filing, Workforce Timekeeper, and Workforce View are trademarks of Kronos Incorporated or a related company.
Mozilla.org is a registered trademark of the Mozilla Foundation. All other trademarks or registered trademarks used
herein are the property of their respective owners and are used for identification purposes only.
When using and applying the information generated by Kronos products, customers should ensure that they comply
with the applicable requirements of federal and state law, such as the Fair Labor Standards Act. Nothing in this
Guide shall be construed as an assurance or guaranty that Kronos products comply with any such laws.
4 Kronos Incorporated
Contents
6 Kronos Incorporated
Contents
8 Kronos Incorporated
Contents
10 Kronos Incorporated
Contents
Glossary
Index
12 Kronos Incorporated
About This Guide
This guide is for individuals who configure, use, and troubleshoot the Data
Collection Manager (DCM) system.
This preface contains the following sections:
• “Organization of this guide” on page 14
• “Abbreviations and terms” on page 16
• “Related documents” on page 17
About This Guide
14 Kronos Incorporated
Organization of this guide
• Chapter 11, “Loading Files and Data to and from a Device,” on page 279
explains how to send files, data, and firmware to a device.
• Chapter 12, “Troubleshooting,” on page 301 provides procedures for resolving
problems that occur while using the Data Collection Manager system.
• Chapter 13, “Error Codes and Messages,” on page 327 lists the error codes
and messages.
• Appendix A, “Theory of Operation,” on page 407 describes the DCM
architecture and components and how they interact.
• Appendix B, “Modifying INI File Values,” on page 419 provides the INI file
values that are specific to the Data Collection Manager.
• Appendix C, “Understanding and Accessing Punch/Transaction Data,” on
page 427 provides information about using the records events in the first in,
first out (FIFO) buffer of its random access memory
• Appendix D, “Using DCM with Series 4000 Terminals,” on page 459
provides a list of the Series 4000 features and a comparison of the Series 4000
and Series 400 devices.
• The “Glossary” on page 463 contains a list of terms with their meanings.
Abbreviation Meaning
AFT Arbiter File Transfer
API Application Program Interface
comm channel communication channel
comm type communication type
DHCP Dynamic Host Configuration Protocol
DCM Data Collection Manager system
DLL Dynamic Link Library
DNS Domain Naming System
DSN Data Source Name
DUN Dial-Up Networking
IP Internet Protocol
LAN Local Area Network
LCD Liquid Crystal Display
ODBC Open Database Connectivity
PCMCIA Personal Computer Memory Card Interface Adapter
PPP Point-to-Point Protocol
RAS Remote Access Server
TCP/IP Transmission Control Protocol/Internet Protocol
WFC Workforce Central suite
WTK Workforce Timekeeper
16 Kronos Incorporated
Related documents
Related documents
In addition to this guide, the following documentation is available to help you use
Data Collection Manager:
• The Workforce Central Data Collection Manager Installation Guide provides
step-by-step instructions for installing the DCM system to use with the
Workforce Timekeeper system.
• The Workforce Central Data Collection Manager Database Tables Reference
Guide lists and describes the database tables used by the Data Collection
Manager (DCM) system.
• The Data Collection Manager Online Help installs automatically with DCM.
To browse the contents of the Help file, start a DCM application and select
Help > Help Topics. Browse through the Contents or select the Index tab,
type an entry or scroll through the listed topics, and then click Display to view
a topic.
• The Series 400 Terminal Configuration Guide provides reference and
procedural information about configuring the Series 400 device.
• The Series 400 Terminal Installation Guide provides step-by-step instructions
for installing the Series 400 device.
• The Series 4000 Terminal User’s Guide provides basic concepts of the Series
4000 terminal, instructions for performing functions and transactions, and
maintaining and servicing the device.
• The Series 4000 Terminal Installation Guide provides step-by-step
instructions for installing the Series 4000 terminal and performing basic
configuration. This document is shipped with the Series 4000 terminal.
DCM installations include Release Notes that contain information about new
features, resolved and known issues and solutions, and late-breaking changes. You
can access this file from the DCM menu after DCM is installed.
PDF and HTML versions of the Workforce Central Data Collection Manager
Installation Guide, the Workforce Central System Administrator’s Guide—Data
Collection and the Workforce Central Data Collection Manager Database Tables
Reference Guide are available on the documentation CD.
18 Kronos Incorporated
Chapter 1
Introducing Data Collection Manager
Overview
The Data Collection Manager is a flexible suite of applications and libraries that
enables the flow of data between a host application and data collection devices. A
host application is the Kronos® Workforce Timekeeper™ application for which
employee data is provided and from which employee data is derived. A data
collection device is a piece of hardware that collects time and attendance data,
activities information, or other types of information. The device collects the
information and, through DCM, makes it available for management by host
applications, such as the Workforce Timekeeper application.
DCM communicates by using Ethernet, serial, and modem communication types.
It is fully scalable and can run on a standalone PC, an application server, or across
multiple PCs in an enterprise environment.
Using the DCM applications, you can:
• Configure and test data collection devices.
• View and log transactions, such as functions that occur at the device.
• View messages, such as status and errors generated by the DCM applications.
• Establish connections to different Ethernet, serial, and modem device types.
• Establish secure connections for Ethernet communication between DCM and
Series 4000 version 2.1 devices.
• Store transactions at key transfer points.
• Initialize and update device configuration and application data to devices.
• Collect punches from devices.
• Collect biometric data from the Series 4000 terminal.
The following section describes the DCM applications.
20 Kronos Incorporated
DCM applications
DCM applications
DCM includes the following applications:
• Communication Monitor
• Device Manager
• Device Work Rules
• Event Manager
• Sentinel Service
You need to log on with your user name and password the first time that you
access one of the DCM applications. The DCM applications that require a logon
include Device Manager, Event Manager, Communication Monitor, and Device
Work Rules.
Communication Monitor
The Communication Monitor enables you to monitor device and device groups
and is also a means of transferring data to and from devices. The Communication
Monitor enables you to view system information such as data flow,
communication tests, device status, and error posting.
The Communication Monitor lists:
• Which devices are responding and which are not. This information includes
the date and time that the device responded or did not respond.
• The requests and responses between the devices and applications that manage
the information. This information includes status messages, transactions, and
error messages.
The Communication Monitor enables you to perform the following tasks:
• Initialize and update devices
• Set the date and time on the device
• Test device communications
• Monitor transactions for the system
Device Manager
The Device Manager application enables you to define application connections,
communication channels, devices, and device groups, and to configure system
properties.
The Device Manager main window displays the hierarchy of device groups,
communication channels, devices, and the request status.
Using the Device Manager, you can also:
• Check device status
• Load files, device programs, and collected data
• Enable logs for troubleshooting
• If the environment changes, modify the configuration, and then re-initialize
devices
• Update device firmware
• Start and stop data collection
The Device Manager contains a Device Wizard that leads you through a series of
dialog boxes in which you provide the information required to add or edit devices.
The Device Wizard includes the following features:
• It detects available ports when you configure serial devices.
• It detects installed modems and their applicable modem strings. If you select a
device that uses a modem as the method of communication, the Device
Wizard detects the modem if one is installed with the appropriate Windows
operating system: Windows 2003, Windows XP Professional, or Windows
Vista monitoring PC.
• It enables you to test communication to a device as the final step in adding or
editing the device.
22 Kronos Incorporated
DCM applications
Event Manager
The Event Manager application enables you to configure scheduled actions or
tasks, which are called events. The events are then listed in the Microsoft Task
Scheduler where they are launched at specified times. You can use the Event
Manager to configure events, including:
• Send configuration changes made in Workforce Timekeeper or Device
Manager to devices
• Collect data from modem or other devices configured for batch data
collection
• Send the date and time to devices
• Run programs
• Load Firmware to devices
You can access the Event Manager by selecting Start > Programs > Data
Collection Manager > Event Manager, by selecting Tools > Event Manger
from the Device Manager, or by selecting Tools > Event Manager from the
Communication Monitor.
For events to run successfully, the Microsoft Task Scheduler must be running on
the DCM communication PC. For all events except Disable Sentinel and Enable
Sentinel, the Sentinel Service must be running on the same DCM communication
PC. The Event Manager does not need to be running when an event is launched.
E-mail notification of event errors are set up in the DCM System Settings. For
more information about e-mail notification, see “E-mail notification settings” on
page 129.
If the DCM communication PC is restarted, scheduled events run automatically
without requiring user intervention. Event Manager log messages appear in the
DCM centralized log file. For more information about the centralized log, see
“Log File settings” on page 118. For more information on scheduling events by
using Event Manager, see “Scheduling events” on page 237.
Sentinel Service
The Sentinel Service is a Windows service that runs while the DCM system is in
operation. The Sentinel Service launches and manages the application
connections and communication channel connections. Every DCM
communication PC in the system must have a Sentinel Service running in order to
perform most DCM operations.
The Sentinel Services is configured as an automatic Windows service. This
ensures that the Sentinel Service remains running when you log off the DCM
communication PC, and that the Sentinel Service starts automatically whenever
the DCM communication PC is started
For more information about the Sentinel Service, see “Using the Sentinel” on
page 267.
24 Kronos Incorporated
Accessing the Data Collection Manager applications
Note: Make sure that the server and database are up and running before you open
a DCM application.
When you open the first application, the logon screen appears. This logon requires
you to enter a user name and password.
• Device Work Rule Definitions Report—A device work rule enables you to
associate a work rule with a pay rule. For example, when hospital employees
enter the operating room, they press a soft key and swipe their badges. This
activates the work rule and pay rule assigned to the device work rule. The
employees swipe again when they leave.
The Device Work rule Definitions report shows the device work rule
definitions that are configured in the Data Collection Manager.
• Device Work Rule Profiles Report—Device work rule profiles enable you
to map device work rules to the soft keys on devices.
The Device Work rule Profiles report shows the device work rule profiles that
are defined in the Data Collection Manager.
• Device Assignments Report—The Device Assignments report contains a list
of devices that includes the device ID, device name, the device groups that
each device belongs to, whether or not the device has collection enabled, the
communication channel that the device is assigned to, and whether or not the
device is enabled.
• Device Group and Device Assignments Report—The Device Group and
Associated Assignments report contains a list of device groups, and includes
the associated devices, the communication channel that each device is
assigned to, and whether or not each device is enabled.
For more information about Workforce Timekeeper reports, see the Workforce
Timekeeper documentation.
26 Kronos Incorporated
Steps for configuring the Data Collection Manager
Step Reference
Step Reference
11. If you are using batch collection, use the Event “Collecting Data and Managing
Manager to schedule a Collect Event and any Transactions” on page 221
other required events.
12. Configure Events to periodically update “Collecting Data and Managing
configuration data at devices. Transactions” on page 221
28 Kronos Incorporated
Chapter 2
Defining an Application Connection
This chapter explains how to define and edit the connections between Workforce
Central applications and the Data Collection Manager (DCM) system.
This chapter contains the following sections:
• “Overview” on page 30
• “Application connections” on page 34
Chapter 2 Defining an Application Connection
Overview
DCM uses application connections to send punches to and exchange other
information with the Workforce Timekeeper application via the Workforce
Central application server. DCM provides a default application connection,
Application Connection 1. In most installations, you can use the default
application connection for all DCM communication PCs. Application connections
are associated with devices and DCM communication PCs based on device group
definitions and communication channel assignments. The Sentinel Service on
each DCM communication PC automatically starts the required application
connections based on the devices assigned to communication channels that run on
the DCM communication PC.
A communication PC is the computer where communication channels are set up
to communicate with devices and to collect data. You can have all applications of
the Data Collection Manager (DCM) system on a communication PC. You can
even run the host application on that same PC. Alternatively, you can use one PC
for the communication PC, other PCs for different DCM applications, and still
another PC for the host application. You can have more than one communication
PC in a device network system.
You can specify system settings for connections to additional Workforce Central
application servers. The application server connection defaults to the application
server to which the communication PC is connected.
Note: Multiple connections are available only when bulk processing is enabled in
DCM.
For more information about setting up the server connections, see “Application
server connections” on page 31 and “Application connections” on page 34.
If DCM is connected to multiple communication PCs, you need a share folder and
file-based requests enabled. For more information about setting up a network
share folder for a DCM system with multiple communication PCs, see “Multiple
communication PCs” on page 62. For more information about setting up DCM
file-based requests in that network environment, see “Server Connection settings”
on page 132.
30 Kronos Incorporated
Overview
For more information about device group definitions, see “Creating device
groups” on page 70. For more information about communication channel
assignments, see “Adding a device by using the Device Manager” on page 80.
Caution: Collect all data before changing the information in the application
connection. Do this to avoid routing information to the wrong destination.
To configure the primary default web or application server connection in the user
interface:
1. Select one configuration from the Available Configurations list box.
2. Click Select. The information in the Current Selection area of the screen
changes to reflect the selection.
3. Click OK.
4. Click OK.
5. Restart the system for the changes to take affect.
32 Kronos Incorporated
Overview
You may change the name or the description of the default application connection,
create additional application connections, and delete application connections by
using Device Manager.
If the system handles large loads of collect events and you would like to improve
data processing performance, you can also define multiple server connections
within an application connection on one or more DCM communication PCs. For
more information, see “Server Connection settings” on page 132.
To change the application server connection, see “Editing the Sentinel Service
properties” on page 273.
Application connections
You can edit an application connection description. You can also delete and create
an application connection.
Note: You cannot delete an application connection that is being used by one or
more DCM communication PCs. To delete an application connection, first shut
down data collection on devices assigned to device groups that use the application
connection and edit the device groups to use a different application connection.
34 Kronos Incorporated
Application connections
1. Select Start > Programs > Data Collection Manager > Device Manager. If
no other DCM applications are open (except the Sentinel Service, which runs
in the background on startup), you are required to enter a user name and
password.
2. From the Device Manager main window, select Setup > Application
Connections. The Setup Application Connections dialog box appears.
3. Click New. The New Application Connection dialog box appears.
4. In the New Application Connection dialog box, enter the name and,
optionally, a description, for the new application. The maximum length for an
application name is 40 alphanumeric characters.
5. Click Add. The new application connection appears in the displayed list.
The new application connection is automatically started after you create or
edit a Device Group that uses the new application connection and assign
devices to it. For more information about device group definitions, see
“Creating device groups” on page 70. For more information about
communication channel assignments, see “Adding a device by using the
Device Manager” on page 80.
36 Kronos Incorporated
Chapter 3
Communication Channels
This chapter explains how to configure and use the Data Collection Manager
communication (comm) channels. It includes information about using the Device
Manager to configure communication channels, how to set up connections, and
how to set up a multiple communication PC environment.
This chapter contains the following sections:
• “Overview” on page 38
• “Creating communication channels” on page 39
• “Configuring a modem for a Series 4000 terminal” on page 43
• “Configuring communication channels in the Device Manager” on page 53
• “Multiple communication PCs” on page 62
Chapter 3 Communication Channels
Overview
The Data Collection Manager (DCM) system includes communication channels
that support communication between devices and host applications.
Devices that interact with a host application use on the following three
communication methods:
• Ethernet
• Serial (Series 400 and Series 100 only)
• Modem (dedicated analog only)
Note: You can use both Series 400 and Series 4000 terminals with a modem,
but Series 400 and Series 4000 terminals cannot be configured on the same
modem.
38 Kronos Incorporated
Creating communication channels
Modem channels
You can configure a modem for a Series 4000 or a Series 400 device, but the
configuration is different. To configure a Series 4000 modem, you must create a
dial-up connection in the Windows operating system, which covers some of the
settings that you usually configure in the communication channel for Series 400
devices.
Note: You cannot share a communication channel or modem between Series 4000
terminals and other types of devices.
Each modem works only with one communication channel. If you have only one
modem, only one communication channel is valid for that modem. You can
configure up to four modem communication channels per communication PC, one
per communication port.
The following items are some guidelines for using modems with Kronos modem
devices:
• The modem must be installed with the Windows operating system.
• The DCM communication PC requires a dedicated analog phone line for
communication with Kronos modem devices. Do not share this line with any
other devices, such as a telephone or a fax machine. This analog phone line
can originate from the PBX or directly from the telephone company.
Digital phone lines are not supported when connected to a Kronos device
under any condition. Connecting a digital phone line to a Kronos device might
result in serious damage.
• Modem devices are defined only on the communication PCs that they
communicate with.
• A communication PC cannot be set up with a Series 4000 modem device and
a Series 400 modem device on the same channel.
• All modem devices on a communication PC must be configured to connect at
the same speed that is the lowest device speed. The exception is to connect
modem devices of different speeds to separate modems attached to the PC.
• If you need to dial a number for an outside line, use the letter w in place of a
comma. The w forces the modem to wait for a dial tone before continuing. For
example, 9w 987 9876543.
40 Kronos Incorporated
Creating communication channels
• PBX switch times may not be set appropriately for use with a Kronos modem
device. The two settings that affect modem timing are the S9 and S10 settings.
You can change these settings in the modem initialization string. Refer to the
modem documentation for details.
The following setting is for the required duration, in tenths of a second, of the
remote modems carrier signal before recognition by the dialing modem.
S9=n n=1 to 255
The following setting is for the duration, in tenths of a second, that the modem
waits after loss of carrier before hanging up.
S10=n n=1 to 255
If you require high- and low-speed modem communication on the same PC, you
need to configure the modem devices on two modems on separate communication
channels.
42 Kronos Incorporated
Configuring a modem for a Series 4000 terminal
44 Kronos Incorporated
Configuring a modem for a Series 4000 terminal
DCM Communication PC
Ethernet IP address 1
DCM Applications
IP address 2 IP address 4
example: 192.168.0.1 Modem 1 Modem 2 example: 192.168.1.1
IP address 3 IP address 5
example: 192.168.0.2 example: 192.168.1.2
Modem Modem
PPP Server PPP Server
Recommended IP addresses
Since the IP addresses for the dial-up connections between the communication PC
modem and the devices do not connect to the corporate intranet or the Internet,
you can use the following IP addresses, which are approved for private networks:
If you are using more than one communication PC, do not repeat on subsequent
PCs the IP addresses that are already assigned to dial-up connections, such as IP
addresses 2 through 5 in the illustration. Assign a different subnet to each dial-up
connection.
Example
Communication PC A
Sample IP
Location Connects to Address
IP address 1 Communication PC A corporate intranet, Internet
IP address 2 modem 1 on Communication first group of devices 192.168.0.1
PC A
IP address 3 modems on first group of modem 1 on Communication 192.168.0.2
devices PC A
IP address 4 modem 2 second group of devices 192.168.1.1
IP address 5 modems on second group of modem 2 192.168.1.2
devices
46 Kronos Incorporated
Configuring a modem for a Series 4000 terminal
Communication PC B
Sample IP
Location Connects to Address
IP address 6 Communication PC B corporate intranet, Internet
IP address 7 modem 1 on comm PC B third group of devices 192.168.2.1
IP address 8 modems on third group of modem 1 on 192.168.2.2
devices Communication PC B
IP address 9 modem 2 on communication fourth group of devices 192.168.3.1
PC B
IP address 10 modems on fourth group of modem 2 192.168.3.2
devices
Note: The DCM communication PC also requires a dedicated analog phone line
for communication with Kronos modem devices. A shared analog line may result
in unreliable collections.
Prerequisites
Before you use DCM to configure a modem for a Series 4000 terminal, verify that
the following tasks are accomplished:
• The Series 4000 terminal is installed with a modem cage and a modem.
For information about installing a modem in a Series 4000 terminal, see the
installation instructions that shipped with the Series 4000 terminal.
• Version 1.1 or later of the Series 4000 firmware is installed. This version
includes PCMCIA modem support.
• An IP address is entered physically at each device, using Maintenance mode.
For more information about IP addresses, see “IP addresses for the
communication PC and Series 4000 terminals” on page 43.
• A static IP address is entered at the DCM communication PC for its modem,
which is described on the following pages and dependent on the type of the
operating system.
• DCM 5.0 or later is installed on the communication PC.
• The Remote Access Service (RAS) is installed for the operating system.
The Remote Access Server provides the API for DCM to act as a PPP Client.
The Series 4000 terminal is the PPP server. The RAS stores the dial-up
connection that you define.
• A V.90-compatible modem is installed on the communication PC, according
to the instructions provided with it. The modem can be internal or external.
For Series 400 devices, the modem must be connected to Comm1, Comm2,
Comm3, or Comm4.
You must:
1. Create a dial-up entry for the modem on the communication PC by using the
Microsoft Network and Dial-up Connections application.
2. Use the Device Wizard or the Device Manager to add the device.
3. Use the Device Manager to configure the device.
48 Kronos Incorporated
Configuring a modem for a Series 4000 terminal
2. Under Network Tasks, select Create a new connection. The Welcome to the
New Connection Wizard dialog box appears.
3. Click Next. The Network Connection Type dialog box appears.
4. Select Connect to the network at my workplace and click Next. The
Network Connection dialog box appears.
5. Select Dial-up connection and click Next. The Select a Device dialog box
appears.
6. Select the modem that you plan to use and click Next. The Connection Name
dialog box appears.
7. Type the name for the connection in the Company Name text box. The Phone
Number to Dial dialog box appears.
8. Enter a telephone number in the Phone number text box. You may need to
include a 1 or the area code or both. To verify whether or not you need the
extra numbers, dial the telephone number on the telephone. If you hear a
modem sound, the number that you dialed is correct.
9. Click Next. The Connection Availability dialog box appears.
10. Select Anyone’s use and click Next. The Completing the New Connection
Wizard dialog box appears.
11. Click Finish.
The connection name appears in the RAS phone book file, rasphone.pbk.
DCM selects the following default DunPhonebookPath to the
rasphone.pbk file, where X is the drive on which the operating system is
installed (typically C or D):
X:\Documents and Settings\All Users\Application
Data\Microsoft\Network\Connections\Pbk\rasphone.pbk
12. After you click Finish, the Connect DCM Setup dialog box appears.
13. Click Properties. The DCM Setup Properties dialog box appears.
14. On the General tab, the modems that are defined in the Windows operating
system appear. Verify that the modem that you previously selected is checked.
15. Select the Options tab to adjust the redialing options.
a. From the Redial attempts list, select zero.
b. From the Idle time before hanging up list, select 1 minute.
16. Select the Network tab.
a. From the Type of dial-up server I am calling list, select PPP: Windows
95/98/NT/2000, Internet.
b. From the This connection uses the following items list, select the
Internet Protocol (TCP/IP) check box.
c. Click Properties. The Internet Protocol (TCP/IP) Properties dialog box
appears.
d. Select Use the following IP address.
e. Enter an IP address for the modem of the PPP Client. It is in the DCM
communication PC, and it communicates with the Series 4000 terminals.
Do not use leading zeros. For example, enter 192.168.2.2, not
192.168.002.002. For more information about how to decide which
IP address to use, see “IP addresses for the communication PC and Series
4000 terminals” on page 43.
Do not enter DNS server addresses.
f. Click Advanced. The Advanced TCP/IP Settings dialog box appears.
17. On the General tab,
a. Clear the Use default gateway on remote network check box if it is not
already cleared.
b. Check the User IP header compression check box if it is not already
checked.
18. Click OK three times. You return to the Connect DCM Setup dialog box.
19. Click the Close icon.
50 Kronos Incorporated
Configuring a modem for a Series 4000 terminal
1. From the Windows Start menu, select Settings > Network Connections >
dialup-connection name. The Connection Name Properties window opens.
2. From the Options tab, select 0 for the Redial attempts and 1 minute for Idle
time before hanging up.
3. From the Networking tab, click Properties. The Internet Protocol (TCP/IP)
Properties window opens.
4. Click Use the following IP address.
5. Enter the IP address. This address identifies the PPP Client (CC2) when
connecting with the PPP server on the Series 4000 terminal.
6. Click Advanced. The Advanced TCP/IP Settings window opens.
7. Clear the Use default gateway on remote network check box.
8. Click OK on each of the previous three windows to apply the settings.
52 Kronos Incorporated
Configuring communication channels in the Device Manager
Secure communication
A DCM installation that supports secure communications with the Series 4000
devices requires an Apache or IIS Web server. The Web server setting uses the
default port 80 for standard HTTP communication and port 443 for HTTPS
(secure) communication. In a secure installation, the Web server uses a DCM
proxy module within the Apache or IIS Web server to forward requests to the
DCM Collection Agent.The Web server settings default to the same values.
If the Web server listening port setting must be changed, first edit the IIS or
Apache Web server setting, and then update the Web server setting on the
Communication tab. Stop and restart Sentinel after you make the changes.
If the DCM server runs behind a Network Address Translation (NAT) server, add
the following lines to the krdcm.ini file:
[DCM Host IP Alias Table]
alias_name=outside IP address on NAT server mapped to
the internal DCM server IP address
DeviceID=alias_name
where:
The DeviceID is the six-digit device identifier for each terminal outside the
internal-protected local area network that DCM must communicate with. Add
each device identifier on a different line and set equal to the alias_name. Entries
are not required for devices that communicate with DCM on the inside internal-
protected local area network.
The alias_name can be any text other than the DCM server's HOSTNAME.
Example
[DCM Host IP Alias Table]
NAT=158.228.65.187
111111=NAT
123456=NAT
54 Kronos Incorporated
Configuring communication channels in the Device Manager
Note: If devices that use SSL are assigned to this channel, the devices can
only be assigned to communication PCs that support SSL.
To set the Ethernet timeout values for the DCM communication PC and a device:
1. Close all data collection processes that are running on the DCM
communication PC.
2. Select Setup > Comm Channels.
a. Highlight the appropriate communication channel and click Edit.
b. Increase the Response Timeout. The maximum allowed is 5 seconds.
3. Set the device timeout from the DCM communication PC.
If you are not able to set the timeout value from the PC, go to step 4.
a. Find the device AFT file (device-id.aft).
b. Edit the command string that follows “Set Ethernet timeout” to include
the last number in the command string, which is the actual timeout value.
The following example shows setting the timeout value to five seconds.
---Set Ethernet timeout---
///90#10#5#5#//
c. Download the file to the device or devices.
4. Set the device timeout at the device.
a. Enter Maintenance mode.
56 Kronos Incorporated
Configuring communication channels in the Device Manager
b. Set the value for the Command 90, Procedure 10, Step 5 to the desired
value. Kronos recommends that this value equal the value that is set for
the timeout for the DCM communication PC.
5. Restart data collection processes on the communication PC.
c. From the Model string list, select the modem connected to the
communication PC. The initialization string for that modem appears
automatically in the Initialization string box.
The following modem strings were verified for use with the Data
Collection Manager system on Series 400 devices. Click Advanced and
enter the modem configuration parameters:
58 Kronos Incorporated
Configuring communication channels in the Device Manager
k. Go to Step 10.
9. If you selected Series 4000 from the Dial-up Connection drop-down list on
the Modem tab for Series 4000 terminals, click the Modem tab to specify the
dial-up connection that you configured in Windows.
If the dial-up connection does not appear in the list, see “Configuring a
modem for a Series 4000 terminal” on page 43.
Note: You cannot share a modem between a Series 4000 terminal and other
types of devices.
The following modems were verified for use with the Data Collection
Manager system on Series 4000 terminals. Click Advanced and enter the
modem configuration parameters:
Note: USB modems are supported by DCM only for Series 4000 terminals.
10. Make any changes needed and click OK to return to the Comm Channel
dialog box.
USB modems
Some USB modems may behave differently under different operating systems.
For example, you may not be able to connect to the devices if you are using the
SupraMax External — USB 56K Modem (Part Number 90680023) from
Diamond Multimedia with a server running Microsoft Windows Professional XP.
If you have a USB modem that is not connecting to a Series 4000 terminal,
performing the following steps may correct the problem.
1. From the Start menu, open the Windows Control Panel
Note: Kronos recommends using the most recent drivers for the modem, which
are available on the manufacturer's Web site. Be sure to download and install the
latest patches and services packs for the Microsoft operating system.
60 Kronos Incorporated
Configuring communication channels in the Device Manager
62 Kronos Incorporated
Multiple communication PCs
64 Kronos Incorporated
Chapter 4
Device Group and Global Setup
This chapter explains how to create, edit, and delete device groups and devices.
This chapter contains the following sections:
• “Overview” on page 66
• “Device Manager” on page 69
• “Creating device groups” on page 70
• “Editing device groups” on page 73
• “Copying device groups” on page 74
• “Deleting device groups” on page 75
• “Adding devices” on page 76
• “Editing devices” on page 86
• “Copying devices” on page 88
• “Deleting devices” on page 94
• “Bell schedules” on page 96
• “Gate schedules” on page 98
• “Soft key schedules” on page 101
• “Proximity badge formats” on page 104
• “Smart View transactions” on page 105
• “System Settings” on page 114
Chapter 4 Device Group and Global Setup
Overview
One major function of the Data Collection Manager (DCM) system is to collect
data from devices and send it to a host application. This communication process
involves application connections and communication channels, in addition to the
data collection device and host application. For additional information about
communication channels, including Ethernet, modem and serial connection setup,
see “Communication Channels” on page 37. For more information about data
collection, see “Collecting Data and Managing Transactions” on page 221.
Note: Before you can assign a device to a device group by using the Device
Manager, you must have a communication channel, a device group, and an
application connection for the new device to be assigned. If you create a device by
using the Device Wizard, the communication channel and the device group do not
need to be created first. For more information about using the Device Wizard to
create devices, see “Adding a device by using the Device Wizard” on page 76.
Device
A device is a piece of electronic equipment, such as a Series 4000 terminal and its
associated attributes. Using the DCM system, a device collects data input and
interacts with an application through a communication channel. When defined, a
device is an independent entity until it is grouped.
A device contains specific attributes, which include:
• Model type and description
• IP address or DNS name, if Ethernet
• Telephone number, if modem support
• Baud rate, if serial
• Time zone settings
For more information about the differences between the Series 400 and Series
4000 terminals, see “Using DCM with Series 4000 Terminals” on page 459.
66 Kronos Incorporated
Overview
Device groups
Use device groups to organize data collection and assign employee lists to
devices. For example, a device group can include all devices in a specific building
or for a department. Some examples of device groups are:
• Headquarters (building)
• Accounting (department, division, or function)
• Shop floor (location)
You can create more than one device group. For example, you can create one
device group for all devices in the Accounting Division, another device group for
all devices in the Engineering Division, and a third device group for all devices in
the Sales Division.
You can assign devices to more than one device group. For example, assign the
devices that are in the Accounting, Engineering, and Sales device groups to a
Facility device group. These devices are now part of four device groups:
Accounting, Engineering, Sales, and the Facility groups. If you have more than
one group, you can specify a device group to be a collecting device group or an
assigning device group.
Note: The Series 4000 terminal with Kronos® Touch ID® supports primary and
secondary finger scan templates. The DCM Employee Biometric Data download
option supports up to 4000 templates per device group. Each primary and
secondary template is considered a home employee. If all the home employees are
assigned both primary and secondary templates, the maximum number of home
employees at the Kronos Touch ID device is then 2000.
You create collecting device groups to group sets of devices for collecting
employee transactions and sending them to the host applications for labor
tracking, report generating, wage calculations, and so on.
You assign employees to assigning device groups. You could send the employees’
information to the devices in three buildings in the assigning device group, or just
to the device at the front door of each building. An employee assigned to a
specific device or device group is a home employee. The devices are called the
employees’ home devices. A non-home employee is someone whose employee
configuration is not downloaded to the device.
Employee information downloads only to the device group to which the
employees are assigned in their user employee profile in the host application. You
could define what device group employees belong to based on their labor account
assignment.
Referring to the previous example, you could create the Facility device group to
enable data collection for all devices. The Facility device group becomes the
collecting device group. The Accounting, Engineering, and Sales device groups
become the assigning device groups. All DCM requests route to the device
through the collecting device group. Organizing several devices into one device
group conserves system resources.
68 Kronos Incorporated
Device Manager
Device Manager
The DCM Device Manager enables you to create and manage device groups and
devices. Device Manager also enables you to define application connections and
communication channels. It also supports a Device Wizard that provides a series
of dialog boxes in which you provide the information required to add devices.
The Device Manager also simplifies communications by detecting available serial
ports, installed modems, and Ethernet connections, and then automatically
determines the communication channel that the device is to use.
To access the Device Manager:
1. Select Start > Programs > Data Collection Manager > Device Manager. If
no other DCM applications are open (except the Sentinel Service, which runs
in the background on startup), you are required to enter a user name and
password.
2. If necessary, type the user name and password, and then click OK. The
Device Manager main window opens.
The Device Manager main window displays the configuration. After a
communications channel and a device is assigned to a device group, the device
groups appear on the left and the Request Status panel appears on the right.
Expand the tree view of the hierarchy to view the communication channel and
devices of each device group.
Note: An asterisk (*) preceding the name of a device in the hierarchy indicates
that the device is assigned to collect data for that collecting group.
Use the tree view as a shortcut to perform all functions in the Device Manager
main window. For example, when you select a communication channel, you are
selecting all the devices in that device group that communicate with the
communication channel. Similarly, you can select multiple devices in a
communication channel by using the Control key.
If you have not defined application connections, the default application
connections appear in the drop-down box. You must define at least one
application connection before you create devices and device groups. For
information, see “Defining an Application Connection” on page 29.
Note: Do not give the device group the same name as a communication
channel in the configuration. Do not use names such as Modem1, Serial1,
Ether1, and so on, for device group names. ModemX, SerialX, and EtherX
(where X is any number greater than or equal to 1) are names that the Device
Wizard uses for communication channels.
70 Kronos Incorporated
Creating device groups
Note: After you assign a device and communication channel to the device group,
it appears on the Device Manager main window left panel (tree). A device, a
communication channel, and a device group must be associated together to
complete the device group. If you create a device with the Device Wizard, the
communication channel and the device group do not need to be created first. For
more information about using the Device Wizard to create devices, see “Adding a
device by using the Device Wizard” on page 76.
For more information about creating device groups, search on device group in the
online Help index, or click Help in any of the Device Group dialog boxes.
If you have only one group, it defaults to a collecting group. If you have multiple
groups, you designate one of the groups as the collecting group; the others are
assigning groups.
The following rules apply to device groups:
• You can assign a device to only one collecting device group.
• You can assign a device to many assigning device groups.
• A collecting device group can also be an assigning device group.
• You can create many combinations of assigning device groups, but you can
assign each employee to only one assigning device group.
• Devices in assigning device groups and collecting device groups can use
different types of collection methods.
72 Kronos Incorporated
Editing device groups
74 Kronos Incorporated
Deleting device groups
Adding devices
You can add devices by using the Device Wizard or the Device Manager. The
Device Manager provides the Device Wizard that displays a series of dialog boxes
that enable you to specify device information. DCM selects the communication
channel for the device.
Before you add a Series 4000 terminal that is currently configured for a secure
communication PC to a non-secure communication PC, you must first use Setup
> Device or Setup > Device Wizard to change the Series 4000 terminal
configuration from https (secure) to http (non-secure). For more information
about editing a device, see “Editing devices” on page 86.
Note: Before you can assign a device to a device group, you must have a
communication channel and a device group for the new device to be assigned.
76 Kronos Incorporated
Adding devices
78 Kronos Incorporated
Adding devices
80 Kronos Incorporated
Adding devices
If you are entering an IP address, do not use leading zeros. For example, type
192.168.2.2, not 192.168.002.002. For more information about how
to decide which IP address to use, see “IP addresses for the communication
PC and Series 4000 terminals” on page 43.
Do not enter DNS server addresses.
If you are using a host name, select the Use Host Name check box, and enter
the Host Name in the Communications settings section.
Ethernet devices can use a host name that is known on the network. The host
name must be configured on a Domain Naming System (DNS) server on the
network.
9. If appropriate, enter the phone number of the associated modem from which
the device can be reached in the Phone number text box. You may also need to
set the Device User ID and password in order to load firmware to Series 4000
modem devices.
a. If the Series 4000 device has firmware version 2.0 or greater, and you
have changed the default FTP User ID and password at the Series 4000
device, click Device Password, clear the Use default User ID and
Password check box, and enter the User ID and password.
b. If the Series 4000 terminals has firmware version 1.3.x or earlier, click
Device Password and ensure that the Use default User ID and
Password check box is checked.
To load firmware to Series 4000 modem devices, FTP must be enabled on
Series 4000 terminals, and the FTP user name and password at each Series
4000 terminal must match the FTP user name and password that is specified
for that device in Device Manager > Setup > Device > Edit > Device
Password.
Series 4000 devices with Firmware versions 2.1.0 and later have FTP enabled
by default. You must enter Maintenance mode at the Series 4000 terminal and
use the Telnet/FTP logon transaction to enable FTP. You may also change the
user name and password from their default values. If you change the default
values, you must change the user name and password that is specified for that
device in DCM, as well.
Note: If you disable FTP or change the user name or the password at the
device but not in DCM, you cannot load firmware to this device.
Series 4000 devices with Firmware versions 1.3.x and earlier have FTP
enabled, and you cannot change the default User ID and password. No change
is required in DCM for these devices.
Note: If you change the DCM user name and password, you cannot load
firmware to this device.
Note: User names and passwords that are entered at Series 4000 terminals are
numeric unless the terminal has an alpha-numeric keypad.
10. If you are adding a Series 4000 version 2.1 device, you can select either the
https protocol for a device that supports Secure Sockets Layer (SSL)
technology or the http protocol for a device that does not support SSL.
If you select http and the device supports SSL, security is not available.
If you select https and the device does not support SSL, you cannot initialize
the device when the device firmware version is determined. A message
appears at initialization time that states that incompatible security settings
exist between DCM and the device.
11. Device Enabled is selected by default. Only enabled devices can be used in
communication.
The bright green icon in the Device Manager hierarchical tree indicates that
the device is enabled. A darkened green icon indicates disabled devices.
12. If you are adding a Series 400 device, you can also select the Printer
Attached check box.
13. If you are adding a Series 4000 terminal, specify the language. English is the
default.
14. Select Download Options and Application Options as needed. You can also
select Configuration options.
82 Kronos Incorporated
Adding devices
Note: If you are adding a Series 400 device, an AFT Command 113 must be
sent to the device once every six months to ensure that DST works properly. A
Command 113 is sent whenever an initialize or an update is sent. It is not
included in the generated AFT file, but is logged.
16. When you are finished, click OK to add Assigning a device to a device group
If you created a device using the Device Manager, rather than the Device Wizard,
you must assign the device to a device group. When you assign the device to a
device group, on the Device Manager main window, the hierarchy of device
groups, communication channels, and devices appears on the left; the Request
Status appears on the right. The device that you added appears on the left. If it
does not, select View > Refresh.
The asterisk (*) preceding the name of the device in the hierarchy indicates that
the device is active for data collection, and that the device group it is assigned to is
a collecting device group. Device groups without an asterisk are assigning device
groups.
If the device groups have been created, you can assign devices to device groups
by communication channels.
To add devices to a device group:
1. From the Device Manager main window, select Setup > Assign Devices to
Groups. The Assign Group devices dialog box appears.
2. Select the device group where the device is to be assigned from the Device
Group drop-down list.
3. Select the device to be assigned from the Unassigned devices list, and click
Add. The device moves to the Assigned devices list.
4. Select the Communication Channel that the device is to use from the Assign
Using Comm Channel drop-down list.
Use the communication channel that matches the device’s communication
method. For example, assign an Ethernet device using an Ethernet
communication channel.
If the communication PC supports Secure Sockets Layer (SSL) technology,
that information appears beneath the named communication PC.
Note: If the channel does not support SSL communication, you cannot assign
a device that is configured for SSL communication to that channel.
After assigning a device to one group, you can assign it to a second or third device
group. For example, you assign Device 1 to a device group named Building 2 and
you also assign Device 1 to the Engineering device group. After assigning Device
84 Kronos Incorporated
Adding devices
1 to both device groups, make sure that only one instance of the device is enabled
at a time for data collection.
To assign a device to more than one device group:
1. From the Device Manager main window, select Setup > Assign Devices to
Groups.
2. Select the device, for example Device 1, that you added to device group
Building 2.
3. Select a second device group, for example Engineering, to which to add
Device 1.
4. Select a communication channel that matches the communication method of
the device, for example Ethernet for an Ethernet device.
5. Click Add. The device (Device 1) is assigned to a second device group,
Engineering, as well as Building 2.
A message appears that tells you that the device is enabled for Data Collection
in a particular device group, for example, Building 2, and asks if you want to
enable it in the new group, for example Engineering.
a. Click Yes if you are defining a new collecting device group and click OK
on the Assign Group Devices dialog box.
b. Click No if you are defining an assigning device group and click OK on
the Assign Group Devices dialog box.
c. Click No and Cancel to cancel assigning the device to a another group.
Specify a collecting device group to collect data, such as transactions, from
devices. Specify an assigning device group to collect employee information,
such as schedules, from devices. Both types of device groups assist support
personnel. For more information about collecting and assigning device
groups, see “Device groups” on page 67.
6. Repeat steps 2–5, selecting another device group to which you add the device,
until the device is added to all the required device groups.
7. When you are finished, click OK.
Editing devices
You can edit device information, such as the device name, IP address, or
download and application options by using the Device Manager or the Device
Wizard.
4. Repeat steps 1-3 to edit more devices, or click Close to return to the Device
Manager main window.
86 Kronos Incorporated
Editing devices
5. From the Device Manager main menu, select the target device and select
Communications > Initialize. The Load Configuration options dialog box
appears.
6. Select Device Configuration and click OK.
To use the Device Manger to edit application options, download options, or
configuration options, select a device on the Device Manager main window, and
then select the appropriate option from the Configuration menu.
Copying devices
Use the Copy command when you have set up a device and want other devices to
use that same setup. It copies all entries that are common between the two setups,
such as the configuration, download options, and application options.
You can copy devices by using the Device Manager or the Device Wizard.
Note: If you copy a Series 400 device to a Series 4000 terminal, some supervisor
commands cannot be mapped into equivalent Series 4000 transactions. When the
copy process is complete, a log file is created that describes the function key
configuration that could not be mapped.
88 Kronos Incorporated
Copying devices
8. Select the collecting device group for the target device. Select a group from
the drop-down list or click Add Group to create a new collecting device
group.
9. When you reach the end of the Device Wizard, click Finish to add the device
to the database.
Caution: The Series 4000 terminal can be configured to prompt for labor data
on in-punches by assigning Labor Transfer transactions to one or more default
transactions. However, the functionality provided by Series 4000 default
transactions differs from the Series 400 in-punch processing. The Series 4000
does not generate a punch record in the FIFO before performing a Labor
Transfer. Thus, if a default transaction is configured with a Labor Transfer,
and the employee aborts the Labor Transfer, neither a punch nor a Labor
Transfer record is added to the FIFO. The Series 400 does add a punch record
to the FIFO.
To use the Device Manager to copy a Series 400 device to another Series 400
device or to a Series 4000 terminal, or to copy a Series 4000 terminal to another
Series 4000 terminal:
1. From the Device Manager main window, select Setup > Devices. The
Configure Devices dialog box appears.
2. Select the device to copy and click Copy. The New Device dialog box
appears.
3. Type a unique, six-digit device ID for the new device and click OK. The
Device dialog box appears. The General tab displays the parameters for the
device being copied.
4. If you are copying a Series 400 device, select a target Series 400 device or a
Series 4000 terminal.
90 Kronos Incorporated
Copying devices
5. Change the collection method, the device name, and its description, if you
want.
6. Change the IP address or telephone number for the device. (Mandatory)
7. If you are copying to a Series 4000 terminal, select the Protocol.
8. If appropriate, change the time zone and specify the configuration options, the
download options, and the application options. For more information about
configuration options, see “Configuring Devices” on page 137. For more
information about the download options, click Help in the Download Options
dialog box, or see “Events and download options” on page 250. For more
information about the application options, click Help in the Application
Options dialog box.
9. When you finish making changes, click OK.
10. From the Device Manager main menu, select the target device and select
Communications > Initialize. The Load Configuration options dialog box
appears.
11. Select Device Configuration and click OK.
You can assign the updated device to a different device group. For information
about assigning devices, see “Device groups” on page 67.
Copy To function
You can copy a device to an existing device of the same model. Because the target
devices are already defined. The following configuration settings are not copied
when you use the Copy To function:
• Device ID and description
• Communication type (Ethernet, serial, or modem)
• IP address or telephone number
• Communications channel assignment
• Time zone and setting to automatically adjust time for daylight saving time
• Language
• Communication method and communication PC
• Collection method
• Collecting and assigning groups
Note the following important information about the Copy To process:
• The device ID, communication type, and the communication method for the
target device cannot be changed, and the communication channel assignment
must be the same as the communications type.
• If the device that you copy to is running a different version that you copy
from, some configuration settings for the target device may be lost. For
example, if you copy from a Series 4000 version 2.1 to a Series 4000 version
1.3, some function key settings may be lost on the target device.
• The Series 400 device supports three function key functions for displaying
information about the most recent punch that was performed by the employee.
These functions are:
– Display Last Punch: Displays the employee’s most recent punch.
– Display Elapsed Time: Displays the elapsed time since the employee’s
last punch.
– Display Status: Display the employee’s punch status (IN, OUT, etc.)
In the Series 4000 terminal, the functionality provided by these three separate
functions are combined into one function, View Punch Status. When an
employee performs the View Punch Status transaction at a Series 4000
terminal, the terminal displays all the following information:
– The last punch type, for example Punch, Labor Transfer, Start Work Rule
Transfer, and so on.
– The time and date of the last punch.
– The elapsed time since the last punch.
– For home employees, the current status of the employee (IN, OUT, etc.)
For a Series 400 device, you would need to configure three separate function
keys to provide all the supported functionality for viewing last punch
information. If this Series 400 device is ever converted by using DCM to a
Series 4000 terminal, each of the three function keys will be converted to the
Series 4000 View Punch Status transaction, since that one transaction contain'
the functionality of the three Series 400 device functions. After the
92 Kronos Incorporated
Copying devices
conversion, three Series 4000 soft keys are configured with the same
transaction.
To use the Device Manager to copy a device to another device of the same model:
1. From the Device Manager main window, select Setup > Devices. The
Configure Devices dialog box appears.
2. Select the device to copy and click Copy To.
3. Select the device that is to receive the configuration and click OK.
4. From the Device Manager main menu, select the target device and select
Communications > Initialize. The Load Configuration options dialog box
appears.
5. Select Device Configuration and click OK.
You can assign the updated device to a different device group. For information
about assigning devices, see “Device groups” on page 67.
Deleting devices
Before deleting a device, remove the device from the device group or groups
where it is assigned, and use the Application Options dialog box to unassign all
labor levels from the device. For more information about labor levels, see
“Setting Up Labor Level Information” on page 181.
Note: Collect any punches left in the device before you delete the device.
You can delete a device by using the Device Manager or the Device Wizard.
Note: After the last device is removed from a communication channel, the
communication channel use remains device-specific. A communication channel
with all Series 4000 terminals deleted is then available only for Series 4000
terminals. A communication channel with all other types of devices deleted can
then be used only for non-Series 4000 terminals.
94 Kronos Incorporated
Deleting devices
2. Select the device group where the device is assigned from the Device Groups
drop-down list.
3. In the Assign Group devices dialog box, select the device to delete from the
Assigned devices list, and click Remove. The device moves to the
Unassigned devices list.
4. Repeat steps 2 and 3 as many times as needed to remove the devices from
each device group to which they are assigned.
5. To return to the Device Manager main window, click OK.
6. Select Setup > Devices. The Configure Devices dialog box appears.
7. Select the device ID for the device to be deleted and click Delete.
8. To delete the device, click Yes in response to permanently removing the
device from the DCM database. Click Close.
Bell schedules
You can configure a Series 4000 terminal that is equipped with a bell and power
source to ring a bell at specific times during the day on selected days of the week
to mark events, such as shift or break start and end. You can also configure the
bell to ring as a warning before the scheduled times. A bell schedule consists of
the settings, including the optional warning bell settings, to ring a bell at a specific
time on specific days of the week.
You can create as many schedules as you want, but you can only assign up to 48
schedules for a single device.
Note: You can configure a Series 4000 terminal to activate a bell or a gate, but not
both.
You can configure a soft key at a Series 4000 terminal to enable a Manager to
display all bell schedules assigned to the device, to ring the bell, or to silence the
bell. For more information about bell schedules and soft keys, see “Soft Key tab”
on page 171.
To create a bell schedule:
1. From the Device Manager main window, select Setup > Bell Schedules.
If no bell schedules were created, the Bell Schedule dialog box appears,
where you can create a bell schedule.
If bell schedules were created, click New and the bell schedule dialog box
appears.
2. Enter a unique bell schedule name. For example, Bell - Loading Dock. The
maximum number of valid characters is 50. Do not use the following
characters:
\, /, *, ‘, “, ?, <, >, :, ;, and #
The OK button becomes active when you enter the bell schedule name.
3. To enable the bell to ring for this bell schedule, select the Enable Bell check
box. This allows you to temporarily disable the bell for this schedule at a
future point without requiring you to un-assign this bell schedule from each
Series 4000 terminal. For example, if the bells usually ring on Mondays but
96 Kronos Incorporated
Bell schedules
on Memorial Day the bells are shut off, clear the Enable Bell check box for
the Monday bell schedule and initialize each device with the Device
Configuration Download Option enabled prior to Memorial Day.
4. Specify the time of day, in 24-hour format, that the primary bell is to ring.
5. Specify the duration of the primary bell’s ring. Valid durations are from one to
nine seconds.
6. Select the days that the primary bell is to ring.
7. To specify an optional warning bell:
a. Select the Enable Warning Bell check box.
b. Specify the number of minutes before the primary bell is scheduled to
ring that the warning bell is to ring. Specify the length of time, in seconds
that the warning bell is to ring. Valid durations are from one to nine
seconds. Because both the primary bell and the warning bell ring at the
same volume, you can distinguish a warning bell with a shorter duration
time than the primary bell.
You can create as many bell schedules as you want, and you download up to 48
bell schedules for each device. To assign bell schedules to a specific Series 4000
terminal, refer to “Bell Schedules tab” on page 147. Bell Schedules are sent to
Series 4000 terminals as part of an initialize that includes Device Configuration. If
you add, edit, or delete bell schedules or change which bell schedules are assigned
to a particular Series 400 device, you must initialize the device with the Device
Configuration Download option enabled in order for the changes to take effect at
the device.
Gate schedules
You can configure a gate schedule for a Series 4000 terminal to control gate entry
based on time enforcement rules. Gates can be a door, turnstile, gate, or other
device controlled by an electronic lock. The two types of gate schedules are gate
open schedule and gate off schedule.
• A gate open schedule defines a period of time for specified days of the week
during which the gate remains unlocked so that a user does not have to
perform a transaction at the Series 4000 terminal in order to open the gate.
• A gate off schedule defines a period of time for specified days of the week
during which the gate remains locked, even if an employee performs a
transaction that would otherwise unlock the gate. A manager-only transaction
must be performed at the Series 4000 terminal in order to open the gate during
a gate off schedule.
From the Device Manager, select Setup >Gate Schedules to define Gate open
and off schedules. You may assign up to seven gate open schedules and seven gate
off schedules to a single Series 4000 terminal.
You can configure a Series 4000 terminal soft key to enable a manager to:
• Display all gate schedules assigned to the device by using the assigned View
Gate Times soft key
• Open a gate for a length of time by using the assigned Gate Override -
Duration soft key
• Open a gate for an employee by using the assigned Gate Override -
Employees soft key
For more information about assigning a soft key, see “Soft Key tab” on page 171.
In addition to gate open and off schedules, you can configure the following gate
related functions at Series 4000 terminals:
• For Employee mode transactions, the gate opens only if both of the following
events occur:
– The Series 4000 terminal accepts the transaction.
– The employee ID satisfies the Gate validation rule that is selected on the
Gate Entry tab in the configuration. The two valid gate validation rules
98 Kronos Incorporated
Gate schedules
are accept any valid employee badge format, which includes home and
non-home employees, and accept home employee badges only, in which
case only managers can open the gate for non-home employees.
• For Manager transactions, either of the following transactions opens the gate
and does so without validation:
– Open gate for individual employee by using the assigned Gate Override -
Employee soft key
– Open gate for specified length of time by using the assigned Gate
Override - Duration soft key
You may assign up to seven gate open schedules and seven gate off schedules to a
single Series 4000 terminal.
Note: You can configure a Series 4000 terminal to activate a gate or a bell, but not
both.
check box for the Monday gate schedule and initialize each device with the
Device Configuration Download Option enabled prior to Memorial Day.
5. Specify the time of day that the gate schedule starts. Specify the time in 24-
hour format, from 00:00 to 23:59 inclusive.
6. Specify the length of time that the gate is open if this is a gate open schedule
or is closed if this is a gate off schedule. Specify the time in 24-hour format,
from 00:01 to 23:59 inclusive.
7. Specify the days of the week that the gate schedule is in effect.
8. Click OK.
To assign one or more gate schedules to a specific Series 4000 terminal, see “Gate
Schedules tab” on page 161. Gate schedules are sent to Series 4000 terminals as
part of an initialize that includes Device Configuration. If you add, edit, or delete
gate schedules or change which gate schedules are assigned to a particular Series
4000 terminal, initialize the devices with the Device Configuration Download
option enabled in order for the changes to take effect at the devices.
To add, edit, copy, or delete a gate schedule, from the Device Manager main
menu:
1. Select Setup > Gate Schedules. The Gate Schedules dialog box appears.
2. Select a gate schedule and click Edit, Copy, or Delete.
7. To add another time period to this soft key schedule, click Add and repeat
step 6. For example, you can create a soft key schedule called Breaks and
specify a time period in the morning and a time period in the afternoon for the
same soft key schedule.
8. When finished specifying the soft key schedule, click OK. The Soft Key
Schedules dialog box appears. You can specify another schedule by repeating
step 2.
Note: The Schedule Override Smart View transaction is not supported if the
Smart View application server is a Unix server. The Smart View application server
must be a Windows server to support the Schedule Override Smart View
transaction.
a. Make a copy of each default Smart View definition for each device
language that must be supported.
b. Modify the copy to refer to the appropriate application instance, and
configure the correct Smart View definition for a device based on its
target language.
Note: DCM does not filter the list of choices for Smart View transactions based
on the device’s language during device configuration. All Smart View definitions
are available to all devices. Ensure that you name the new Smart View definitions
appropriately, using the intended target language in the name, because this makes
it easier to select the correct definition when configuring a device.
Note: If you enter a DNS name as part of the URL (for example, http://
mywebserver/transaction.jsp), you must enable DNS support at
Series 4000 terminals to which this Smart View transaction is assigned (refer
to the Series 4000 Terminal Installation Guide for details). Otherwise, you
must enter the IP Address of the web server (for example, http://
155.155.18.32/transaction.jsp)
If the target web server in a Smart View transaction URL is behind a firewall that
performs Network Address Translation (NAT), it may be necessary to perform
additional configuration. There are two scenarios to consider:
1. Series 4000 terminals are configured to support DNS and you are not using
any Workforce Activities Smart Views.
2. Series 4000 terminals are not configured to support DNS or you are using one
or more Workforce Activities Smart Views
Series 4000 terminals are configured to support DNS and you are not using
any Workforce Activities Smart Views
Entries are not required for devices that communicate with DCM on the inside
internal-protected local area network.
The alias_name can be any text other than the DCM server's
HOSTNAME.
[DCM Host IP Alias Table]
NAT=158.228.65.187
111111=NAT
http://158.228.65.140/wfc/URLDispatcherServlet=http://158.228.65.214/wfc/
URLDispatcherServlet
Note: Any edits you make for a Smart View transaction is global. Changes
affect all DCM installations that use the same database server. Changes also
impact any Series 4000 terminals to which that Smart View transaction is
assigned the next time that device is Initialized with the Device Configuration
Download option enabled.
3. Enter the new Smart View name and its Smart View Code.
4. If any other transaction parameters are required to be appended to the URL,
enter them in the Properties text box. Entering Properties is optional.
The syntax for a possible string could be &Key1=value1&Key2=value2&...
where Key1, Key2... are the additional fields required by the Smart View
transaction.
5. Specify the timeout in seconds that the transaction is to wait for a response
while invoking the URL to the server. The minimum is 0 seconds. The
maximum value is 1800 seconds. The default is 30 seconds.
6. If the employee is to swipe or enter the employee badge before selecting the
Smart View soft key, select the Prompt for Employee Badge check box.
7. Click OK.
Note: You can not delete Smart View Transactions that were predefined by
Workforce Timekeeper, Workforce Activities, or other Workforce Timekeeper
applications. If you click Delete when a predefined transaction is selected,
DCM prompts you to return the transaction to its default configuration. If you
click Yes, any edits that were made to this transaction are lost and is returned
to its default configuration. If you click No, no changes are made.
The Soft Key tab’s Assign Soft Key dialog box contains both local and Smart
View transactions.When you download the Device Configuration, all soft key
assignments are sent to the device.
• You may want to change the URL Parameter for the Request For Time Off
Smart View transaction if you want to use a specific Process Manager
template. For example, you could change the URL parameter from
&url=/applications/m8m/
html4500RequestController.jsp&filename=TimeOff&
to
&url=/applications/m8m/html/
4500RequestController.jsp&filename=TimeOff
&templateName=TimeOffRequest_4500AddVacation.template&
to specify a template used solely for vacation requests.
• You may want to change the number of shifts displayed for the Supervisor
Override Smart View transaction from the default value of 3 to a maximum of
14. For example, you could change the URL parameter from
&url=/applications/m8m/html/4500RequestController.jsp&filename=
OverrideSchedules&schedules=3&
to
&url=/applications/m8m/html/4500RequestController.jsp&filename=
OverrideSchedules&schedules=14&.
System Settings
You can specify DCM system settings for the following DCM properties:
• General settings for transaction output files, and parameter file display and
removal
• Log file settings for size, count, and reporting level for the DCM log file that
is applicable across all communication PCs
• Device download retries and reuse
• Communication for phone book path and direct communication path
• Global values for file-based requests and timeframe for totals and accruals
• E-mail notification server and recipients
• The Workforce Central system connection to a Workforce Activities
application server or additional Workforce Timekeeper application servers
when DCM is installed for the Workforce Timekeeper application
All the System Settings, with the exception of those on the Global Values tab,
apply only to the DCM communication PC on which Device Manager is running.
To make changes to system settings other than Global Values, you must run
Device Manager on each DCM communication PC and make the appropriate
System Settings changes. Changes to settings on the Global Values tab affect the
operation of all DCM communication PCs, regardless of which DCM
communication PC is running Device manager when the changes are made.
Some settings are device-specific. For example, you can specify that a parameter
file be automatically deleted after device configuration is extracted for a Series
400 device.
Note: After you change any system setting, disable and enable Sentinel Service
and, if they are running, Communication Monitor and Event Manager. You can
disable and enable Sentinel Service from the Sentinel Service tray icon.
To specify the system settings, from the Device Manager, select Setup > System
Settings. The System Settings dialog box appears.
Note: Click OK only after you are finished configuring all tabs that are to be
changed.
General settings
To specify the general system settings:
1. From the Device Manager, select Setup > System Settings. The System
Settings dialog box appears.
2. Click the General tab.
3. Specify transaction output file rollover size, in KB. This is the file size that will
trigger a rollover. The minimum supported value is 0. The default value is 500.
The maximum supported value is 20000.
During data collection, transaction output files receive punch and transaction
information. These files are located in the DCM/data/trx directory.
When the transaction output file approaches the rollover size, the existing file
is renamed with a timestamp appended to the name and a new file is created.
This function does not delete any files.
For example, trxout file name.out becomes trxout file
name_timestamp.out. The new transaction output file then becomes
ltrxout file name.out.
The following example shows Group1.out as a transaction output file and
Group1_0725200253102.out as a rollover file:
trx\
Group1.out 300K
Group1_0725200253102.out 503K
4. To specify that the Device Manager displays a failed parameter file into a
notepad editor when the configuration upload from a Series 400 device is
complete, select the Show failed parameter file after device configuration
is extracted check box.
When an extract device configuration request is made to the device, DCM
puts the imported configuration parameters into one file and all failed
parameters into another file. These failed parameters are ones that DCM could
not recognize for this device or could not parse to import into the DCM device
configuration table.
5. For all Series 400 devices: to delete the parameter file after executing an
Extract Parameter File operation, select the Remove parameter file after
device configuration is extracted check box. Series 4000 terminals do not
support the Extract Parameter File operation.
To save the file after executing an Extract Parameter File operation, clear the
Remove parameter file after device configuration is extracted check box.
This allows the file to be saved in an ASCII file, data\temp\
device_id_temp.
6. To maintain an active connection to the database if the database has an idle
time disconnect feature, set the Database keep alive interval to a value in
minutes. For example, if you are using an Oracle database, specify a value
that exceeds the SQLNET EXPIRE TIME setting of the Oracle database
server. Batch collect events and DCM communication channels then are not
interrupted.
3. Specify the log file rollover size, in KB. This is the file size that will trigger a
rollover. The minimum supported value is 500. The default value is 500. The
maximum supported value is 20000.
During data collection, log files receive data collection and application
response information. These files are located in the
\DCM\Data\logs\computer name directory.
When a log file approaches the maximum size, the existing file is renamed to
the next available slot in the file names. For example, logname.log
becomes logname_1.log. The new log becomes logname.log. When
the new log file reaches the rollover size, it is renamed to the next available
slot in the file names. For example, logname.log becomes
logname_2.log. The new log becomes logname.log.
This continues until logname_10.log is created. When the new
logname.log reaches maximum size, DCM replaces the oldest log file.
The following example shows where the DCM log file is set to a length of 500
KB and the number of rollovers is 10:
DCM.log 300K
DCM_1.log 502K
DCM_2.log 501K
DCM_3.log 502K
DCM_4.log 502K
DCM_5.log 500k
DCM_6.log 500k
DCM_7.log 501K
DCM_8.log 502K
DCM_9.log 500K
DCM_10.log 501K
4. Specify the maximum number of times the log file can be segmented into new
files. The minimum supported value is 0. The default count is 10. The
maximum supported value is 50.
Communication settings
You can specify the Remote Access Service (RAS) system phone book path for
dial-up networking and specify direct communication to a specified IP address for
a communication PC that has more than one network interface card (NIC).
For more information about the Windows Remote Access Service system phone
book, see “Communication Channels” on page 37.
To specify the communication settings:
1. From the Device Manager main window, select Setup > System Settings.
The System Settings dialog box appears.
2. Click the Communication tab.
3. To enable dial-up networking, click the Enable use of phone book path
check box and enter the full phone book path.
A dial-up entry sets the parameters for all devices assigned to a modem that
you configure, and creates an entry in the Windows Remote Access Service
system phone book (rasphone.pbk). You must create an entry in the
phone book for each modem on the communication PC. DCM must have the
correct path to the phone book or an error occurs.
For Window XP, DCM uses the following path:
\Documents and Settings\All Users\Application
Data\Microsoft\Network\Connections\Pbk\rasphone.pbk
It is possible for PCs to have multiple RAS phone books. You can locate the
phone book by making an entry (see “About dial-up networking” on page 47)
and then searching for rasphone.pbk in Windows Explorer. Verify the date of
the file to make sure it matches the date on which you created the entry, and
then look in the file to locate the entry that you created.
If rasphone.pbk is not located in the default directory, you can enter or
edit the entry of the complete path to the RAS system phone book file in the
Dial-up Networking section of the System Properties tab. For example, on a
Windows 2003 communication PC, DCM uses the default path:
X:\Documents and Settings\All Users\Application
Data\Microsoft\Network\Connections\Pbk\rasphone.pbk
On one machine however, the RAS System phone book is located in:
X:\WINNT\system32\ras\rasphone.pbk
4. If the communication PC has more than one network interface card (NIC),
select the Direct communications to specified IP Address check box and
specify the IP address of the card to bind for DCM communications. The
system defaults to the IP address of the machine that you are using.
5. The Collection Agent uses two listens ports for its HTTP communications.
Port1 8888 and Port2 8889 are the default ports. Port1 is used for FIFO
collection as well as transaction file processing. All remaining DCM HTTP
communications use Port2. Only change the port numbers if you are required
to do so; for example, another application is using the default ports.
If you use IIS and change the Collection Agent 8888 and 8889 ports in Device
Manager, IIS is automatically updated. Stop and restart the Sentinel after you
make the changes.
If you use Apache and change the Collection Agent 8888 and 8889 ports in
Device Manager, Apache is not automatically updated. You must stop and
restart Apache after you make the changes. Also, stop and restart the Sentinel
after you restart Apache.
Note: In a secure installation, the Web server uses a DCM proxy to forward
requests to the DCM Collection Agent.
Configuring the ports used by the IIS Web server on Windows 2003
or Windows XP Professional
To configure an IIS port on Windows 2003 Server or Windows XP Professional,
access the Internet Information Services control panel by selecting Start >
Administrative Tools > Internet Information Services (IIS) Manager. In the
tree view in the left pane of the window, select Internet Information Services >
name of the computer > Web Sites > Default Web Site. Right-click, select
Properties, and on the Web Site tab, specify the new TCP Port and SSL Port
values. Restart IIS.
The IIS proxy components are unaffected when the Web server’s TCP (HTTP)
and SSL ports are changed.
Note: Unlike the other tabs in System Settings, changes to settings on the Global
Values tab affect the operation of all DCM communication PCs, regardless of
which DCM communication PC is running Device Manager when the changes are
made.
Note: When you select the Enable use of file-based requests across
communication PCs check box, DCM looks for that network share for any of
the file-based requests. If you have an environment where each
communication PC is independent and does not need to support the file
requests from one PC to another, do not enable this setting. In this case, each
DCM communication PC uses the local DCM/data directory to store and
retrieve these files.
4. Create a network share folder that is accessible from all communication PCs.
This shared folder does not need to be on one of the communication PCs.
Grant read/write access to all DCM communication PC users to this share. For
example, \\PCNAME\ShareName, where PCNAME is the computer name
where the folder is shared. ShareName can point to any subdirectory on that
PC, such as c:\kronos\dcm\datafiles or c:\dcm\data.
Note: Do not use the following special characters in the shared folder name:
/ * ” ’ ? < > | : ;
– Current Pay Period specifies from the beginning of the current pay
period until the end of the current pay period and the accrued amount until
the end of the current pay period
– As of Today specifies from the beginning of the pay period until today
and the accrued amount until today.
For more information about totals and accruals, see “Totals and Accruals” on page
195.
4. Enter the URL for the Simple Mail Transfer Protocol (SMTP) server. SMTP
protocol is used to send e-mail messages between mail clients and mail
servers, such as mycompanymail.com. The SMTP server port defaults to port
25. The SMTP server timeout defaults to 120 seconds.
5. Specify the e-mail address of each recipient for DCM e-mail notification,
using the semicolon as a separator character.
6. Specify the e-mail sender name that is to appear as the sender of the e-mail
notification.
7. Specify the time interval after which DCM checks for system and device error
and status messages to be sent by e-mail. Specify the interval in hours and
minutes. The minimum length of time to check for messages is five minutes
(00:05) and the maximum length of time to check for messages is twenty-four
hours (24:00). The default is 1 hour. Each time DCM checks for error
conditions, it sends notification if the errors exist, even if the error existed the
last time DCM sent an error notification. For this reason, you should set the
notification interval so that the recipients are not sent notifications faster than
they can respond to them, but often enough that errors are detected and
corrected quickly.
Note: The time interval does not apply to event error notifications, which are
sent when the event completes.
Note: If you disable the Sentinel Service, e-mail notification is also disabled.
The current host name and application instance is listed in the Current
Selection area.
3. Select one of the other available configurations and click Select.
The Current Selection area is updated.
4. Click OK.
Note: Multiple connections are available only when bulk processing is enabled in
DCM.
Caution: The protocol that you select, http or https, must match the protocol
used by the application server and be consistent with other protocol selections
made for that server.
6. Click OK.
7. To add another activities server connection, click Add again.
Caution: The protocol that you select, http or https, must match the protocol
used by the application server and be consistent with other protocol selections
made for that server.
5. Click OK.
What to do next?
After the communication channels, device groups and devices are created, and
devices are assigned to device groups, configure the devices. Device
configuration is described in “Configuring Devices” on page 137.
This chapter explains how to configure devices. It also includes information about
testing and viewing the device configuration.
This chapter contains the following sections:
• “Configuring device parameters” on page 138
• “Loading basic configuration parameters to a device” on page 177
• “Viewing and enabling devices” on page 180
Chapter 5 Configuring Devices
After you configure a device for the first time, use the Initialize command to
download the configuration information to the device. After the device is initialized,
use the Event Manager or the Update command to download changes to the device.
The Update command loads employee information from the host application that
has changed since the last update. For more information about the Event Manager,
see “Collecting Data and Managing Transactions” on page 221.
Initialization
The Initialization process sends configuration parameters to a device. The
configuration includes operating parameters, biometric data, and employee, job,
and labor data.
Initializing a Series 400 device clears any information from the device and
downloads the new information.
Caution: When you initialize a Series 400 device with download options that
include Device Configuration, all information about home employees is erased
from the device. This includes the current punch in or out status of each employee.
Therefore, be very careful about performing an initialize to a Series 400 device.
Kronos recommends that you do not select Device Configuration as one of the
default download options. The default download options are used by many Event
Manager events and can result in employee information being deleted.
If you edit a configuration or add a new device, you must load the configuration to
the particular device by initializing with the Device Configuration Download
Option selected. Home Employee configuration and status information at a Series
400 device, including punch in or punch out status, is erased when device
configuration is sent to a Series 400 device. Therefore, if you are using home
employees at Series 400 devices, do not use Device Configuration as an option for
downloads when you initialize unless you are initializing a new device that
contains no employee information or when no employees are working. You
should also make sure that all home employee information required at the device,
such as employees, schedules, and totals, is sent as part of an initialization that
includes Device Configuration. Initializing without Device Configuration leaves
existing employee lists intact.
If you need to send Device Configuration to a Series 400 device, always select
one or more employee list download options as well. If you are using schedules,
select the download options Employee list with schedules. If you are using totals,
select Employee totals when you initialize. If you use schedules at devices,
initialize only at times when employees are not expected to be working a shift. If
you initialize during a shift when employees are working, their in or out statuses
at the devices are erased, and they may not be able to punch out properly.
Caution: Series 400 serial devices cannot complete initialization with download
options that contain non-English characters.
Series 4000 terminals retain all employee information during all initialization,
unless you select the Clear All Employee Information Load in the Load
Configuration option is selected. Clear All Employee Information does not delete
employee punches from Series 4000 terminals.
Note: If you select Clear All Employee Information, employees who have
punched in may not be able to punch out.
The devices displayed on the hierarchical tree turn yellow to indicate that the
request is submitted. The devices return to green after the actual devices respond.
At the same time, the Status window in the Device Manager main window reflects
the loading of the configuration to the specified devices.
If the Retry pending message appears, you can track the progress and the success
or failure of initialization retry attempts from the Communications Monitor or the
DCM.log file.
Update
An initialized device should be updated regularly to reflect changes made at the
host application, which must be current at the device. The Update command sends
information that has changed since the last update, such as new employee data,
changes to employee schedules, and any changes to the employee records, labor
entry lists, or components of the organizational map. The command retains
existing information from the DCM or the host application database. Update does
not load device configurations.
Caution: Series 400 serial devices cannot complete an update that contains non-
English characters.
Note: The date and time for DCM communication PC, devices, and database
should be synchronized. If the database server time is behind the communication
PC time when biometric data is deleted using the Workforce Timekeeper People
Editor, the biometric data may or may not be deleted from the device when a
device update is performed. Also, Employee badge data may not be updated
immediately when a device update is performed.
Note: AFT commands are for use with Series 400 devices only.
AFT commands are based on the Arbiter File Transfer (AFT) program. This is a
set of communication standards that enable communication between devices and
PCs. Use AFT instead of the device’s keypad commands to enter values for device
procedures on this tab.
Caution: This tab enables you to enter potentially risky commands; for example,
setting time and date, or deleting FIFO records.
Note: To add a new line in an AFT File, use the Control and Enter key
combination, not just the Enter key.
For more information about AFT commands, see the Series 400 Terminal
Configuration Guide.
Reader configuration
Each device has only one type of badge reader. Configure the device to use one of
the following types:
• Bar code
If you are configuring a bar code reader, click Bar code symbologies and
select which symbologies to accept for all bar code readers attached to the
device. Although the Series 4000 terminal can support two remote readers,
use a single set of configuration settings that applies to both remote readers, if
installed.
Bar code symbology is a bar code label that is formatted according to a
standard set of specifications. Some of these symbologies are familiar because
they are found on the packaging of consumer products. Encoding a badge
with a bar code label ensures that different devices can read the same badge.
A device with a bar code reader accepts badges that are encoded with bar code
symbologies for employee punches and labor transfers. You can also attach
external devices, such as lasers and CCD scanners, for reading bar code
symbologies.
• Magnetic stripe
If you are configuring a magnetic stripe reader, click Magnetic stripe tracks
and select which track to accept.
Series 4000 terminals can use a magnetic badge (card) reader instead of a bar
code reader or a proximity badge reader. A device with a magnetic badge
reader accepts badges with a magnetic strip that encodes employee
information for employee punches and labor transfers. The standard and
generic badge formats used for magnetic badges are the same as the standard
and generic formats used for a bar code reader.
• Proximity
Series 4000 terminals can use a magnetic badge (card) reader instead of a bar
code reader or a magnetic stripe badge reader.If you are configuring a
proximity reader, click Proximity formats and specify the proximity badge
format configuration. Click Assign to assign the selected proximity format to
a device, or click Unassign to unassign the selected proximity format from a
device.
If the proximity format that you need is not in the Proximity formats list, you
can import the format by selecting Device Manager > Setup > Proximity
Reader Formats. For more information about importing proximity formats,
see “Proximity badge formats” on page 104.
A device with a proximity badge reader accepts badge transactions that
involve a no-contact read of the badge. That is, the badge is held near the
device, but does not come in contact with it.
If you are configuring a proximity badge:
– The Series 4000 terminal can accept up to five Proximity Badge formats.
One of these formats is always the 2601 standard format that is used for
supervisor and maintenance proximity badges. The total number of user-
defined proximity badge formats that can be accepted by the device
depends on whether or not you assign the 2601 and 31-bit standard
formats for employee badges.
If you assign the 2601 and 31-bit standard formats to the Series 4000
device, you can assign up to two user-defined proximity badge formats. If
more than two user-defined formats are assigned to a device, only the first
two are downloaded to the device at the time of device initialization.
If you do not assign the 2601 and 31-bit standard formats to the Series
4000 device, you can assign up to four user-defined proximity badge
formats. If more than four user-defined formats are assigned to a device,
only the first four are downloaded to the device at the time of device
initialization.
– For Series 4000 terminals, the DCM configuration service sends the bar
code formats for labor badges, even when proximity badges are enabled
for employee, manager, or maintenance badges.
Note: If the 2601 and 31- bit standard proximity badge formats are not
assigned, you can assign up to four user-defined proximity badge formats to
the device. If the 2601 and 31- bit standard proximity badge formats are
assigned, you can assign up to two user-defined proximity badge formats to
the device.
Series 400 devices support external proximity readers as local readers only. You
cannot configure a Series 400 device external proximity reader as a remote reader.
Series 4000 terminals version 2.1 or later support the use of an external proximity
reader that can be used either as a remote reader or as a local reader. Configure an
external proximity reader as a remote reader when it is mounted remotely from the
Series 4000 terminal where users cannot see the Series 4000 terminal display nor
use its keypad—for example, at a doorway for a simple gate entry. Configure an
external proximity reader as a local reader if it is mounted next to the Series 4000
terminal and is used to perform functions that require the user to see the display or
use the keypad.
• When configured as a Remote reader, the external proximity reader performs
only the transactions assigned to the Remote Reader in the Device >
Configuration > Default Transactions tab. The external proximity reader
does not interact with the Series 4000 terminal's display, indicator lights,
keypad, or beeper. Only functions that do not require display or keypad input
can be performed at the external proximity reader when it is configured as a
remote reader.
• When configured as a Local reader, the external proximity reader performs
functions assigned to the Local reader in the Device > Configuration >
Default Transactions tab. It can also be used to provide badge input when it
performs transactions initiated by pressing soft keys at the Series 4000
terminal. The external proximity reader interacts with the Series 4000
terminal display, indicator lights, keypad, and beeper.
Employee badges
Specify the badge type, and if appropriate, the configuration for the standard
badges or both the standard and generic badges.
Select the badge type:
• None specifies that an employee enters a number on the device keypad to punch
in, to punch out, or to perform a labor transfer, instead of swiping a badge.
Note: To allow use of the keypad to enter a badge ID, select the Allow keying
in Badge ID entries check box on the Punch Rules tab.
code, double-click the text box to highlight the spaces and enter the company
location code.
• Standard and generic allows an employee to punch by using either a
standard or a generic badge. A generic badge is any badge that uses a bar code
that is not in the standard badge format. You can set up the device to read
badges that differ from the standard badges.
If you specify generic badges, you must also configure the badge format, by
clicking Edit format on the Badge Reader tab dialog box. The badge
specifies the current format for a generic badge. For example,
xxxDDDDDDDDii defines a 13-character generic badge with an 8-digit data
field. The reader ignores the last 2 characters, which it reads first, going from
right to left.
If you edit the generic badge format:
– Click the Allow any length generic badge check box, or clear the check
box and specify the total number of numeric characters, which can be
from 0 to 32 numeric characters. Do not specify a badge length of 17 or
18 numeric characters because these lengths are reserved for standard
badges.
– Specify the number of numeric characters in the data field, which
represents the ID number.
For generic employee badges, the data field is the employee identification
number. The device recognizes employee ID numbers in the range of 0 to 18
digits for Series 4000 terminals with v2.1 firmware, and 9 digits for all other
devices. Specify the location of the data field by defining the number of
trailing digits in a generic badge for the reader to ignore, starting from the
right, in the Characters to ignore text box. You can enter a value from 0 to 30.
For employee badges, the data field is the employee identification number.
For labor level transfer badges, the data field is the labor level.
Note: The sum of the value in the Number of characters in data field and the
Characters to ignore cannot exceed the value in the Total characters on badge
text box. For example, if the total characters on a badge is 20, the sum of the
Characters to ignore text box and the Number of characters in data field text
box cannot exceed 20.
Click Test to verify entries in the Generic Badge dialog box. If the entries are
valid, the format appears in the Badge Format text box. If the entries are
invalid, an error message appears in the Badge Format text box.
For more information about Badge Reader tab options, click Help.
When you download the badge reader configuration to a device, the following
settings are included in the download operation:
• Bar code, magnetic stripe, and proximity formats for all maintenance badges
• Bar code, magnetic stripe, and proximity formats for all manager badges
• Bar code and magnetic stripe formats for standard employee badges if
standard employee badges are enabled on the Badge Reader tab
• Bar code and magnetic stripe formats for generic employee badges if generic
employee badges are enabled on the Badge Reader tab
• Bar code and magnetic stripe formats for labor badges for standard or generic
labor badges if they are enabled on the Labor Transfer tab
• Bar code and magnetic stripe formats for standard or generic job badges if
they are enabled on the Job Transfer tab
• Proximity formats for employee badges for each proximity badge that is
defined and assigned on the Proximity Card Format Configuration dialog box
Proximity badges support only maintenance, manager, and employee badges.
They do not support labor or job badges.
Because maintenance and manager functions require access to the Series 4000
terminal’s keypad and display, remote readers do not accept maintenance or
manager badges.
Note: Series 4000 terminals can support either an attached Gate or an attached
Bell, but not both.
Note: An attached reader such as a bar code scanner that must be used at the
Series 4000 terminal is considered to be a local reader.
For example, you could configure the default transaction at a remote reader
mounted at the entrance of a building as a Gate Entry to open the front door, and
the default transaction at the Series 4000 terminal mounted in an employee work
area inside the building to punch the employee in or out.
If you are configuring a Series 400 device, select the Perform function key
activity on out-punch check box on the Function Key tab to assign out punch
processing transaction to the device. For more information about the Soft Key tab,
see “Soft Key tab” on page 171.
The five default reader transactions are:
• Home employee default—Performs a specific transaction after a home
employee swipes a badge. The assigned default transaction is performed
instead of a punch. For example, if the Home employee default for remote
readers is assigned to open a gate, the badge read opens the gate without
clocking the employee in or out. You can assign any transaction that can be
assigned to a soft key.
If the transaction assigned to this default is anything other than Punch, the
assignments of the other three Home employee default transactions (shift
start, in during shift, and shift end become unavailable, that is, you cannot
assign default transactions to the Home employee shift start, IN during shift,
or shift end selections. You must assign the Punch function to another soft key
by using the Soft Key tab and home employees must use this soft key to
punch in or out.
• Home employee shift start—Performs a specified transaction after a home
employee swipes a badge that is interpreted by the Series 4000 terminal as an
IN punch to start a shift. This setting is available only if the Home employee
default is set to Punch.
If the specified transaction does not affect the punch status of the employee,
the device produces a record for the punch and then performs the specified
transaction. If the specified transaction does affect the punch status of the
employee, the device does not produce a FIFO record for the punch but does
produce a FIFO record for the specified transaction. For example, if the Home
employee default is set to Punch and the Home employee shift start is set to a
Labor transfer, the Series 4000 terminal records a labor transfer transaction
record when the employee punch starts a shift. If the Home employee default
is set to Punch and the Home employee shift start is set to a View current
schedule, the Series 4000 terminal records a punch transaction record and
then shows the employee's current schedule when the employee punch starts a
shift.
• Home employee IN during shift—Performs a specified transaction after a
home employee swipes a badge (performs a punch) that is interpreted by the
Series 4000 terminal as an IN punch during a shift, such as a return from a
break or a meal. This setting is available only if the Home employee default is
set to Punch. The Series 400 generates transaction records in the same manner
described for the Home employee shift start.
• Home employee shift end—Performs a specified transaction after a home
employee swipes a badge that is interpreted by the Series 4000 terminal as an
OUT punch that ends a shift. This setting is available only if the Home
employee default is set to Punch. You can assign only transactions that do not
affect the employee's IN/Out status, such as View Schedules or Enter Tips.
• Non-home employee default—Performs a specific transaction after a non-
home employees swipe a badge or enters their employee badge ID. The
assigned transaction is always performed. If you select a Non-home employee
default transaction other than Punch, and you want non-home employees to be
able punch in and out, you must assign a Punch function to a soft key by using
the Soft Key tab and non-home employees must press this soft key to punch in
or out.
If you are configuring a local reader home employee default or the local
reader non-home employee default for a Series 4000 version 2.1 or greater
device, the Enter a Punch First check box is available. Select the check box
if the selected transaction is a Smart View transaction or a transaction that
does not generate a punch.
For some selections, such as a Labor Transfer, you may enter more details by
clicking Detail. Detail dialog boxes vary according to the function selected.
For example, if you selected Delayed Labor Transfer, the Job Transfers dialog
box includes a Prompt for job check box. When you have finished, click OK
twice.
Display tab
Use the Display tab to control how information appears on the device screen. You
can enter a device message, enable a beep for keypad entries, specify date and
time formats, and define the length of time to list employee identification text and
to display transaction responses.
To specify the changing message durations, in the General area:
1. In the Error message duration text box, enter the length of time that an error
message appears.Valid values are 1 through 255 in tenths of a second. The
default is 1.
2. In the Transaction response duration text box, enter the length of time that a
confirmation message of success or failure appears. The message usually
includes the employee’s name or badge ID. Valid values are 1 through 1200,
in tenths of a second. The default is 6.
3. In the Non-employee timeout text box, enter the length of time that the device
remains in Manager, Supervisor, or Maintenance mode without any activity
before the device returns to Employee mode. Valid values are 5 through 150,
in seconds and in increments of 5. The default value is 45.
4. In the Data display duration text box, enter the length of time that an
informational message appears. These messages are the result of a view
transaction, such as View Current Schedule or Review Punches and then
require additional time for the employee to read, and possibly to scroll, what
appears on the Series 4000 terminal. The valid values are 1 through 25, in
seconds. The default value for Series 4000 terminals is 5. The default value
for all other devices is 1.
To specify the device message displays and their durations, in the Message area:
1. In the Device text box, enter a message that consists of 20 characters or fewer
for Series 400 devices, and 40 characters or fewer for Series 4000 terminals.
2. In the Duration text box, enter the length of time that the message appears.
The valid values are 1 through 255, in seconds. The default value is 13.
3. In the Alternate text box, enter a message that appears alternately with the
first message. The alternate message can be 40 characters or fewer.
4. In the Alt Duration text box, enter the length of time that the alternate
message appears. The valid display duration for an alternate message is from
1 to 25 seconds. If the first or alternate is blank, the remaining message
appears constantly and ignores the length of time specified for the blank
message.
To set the format for the date that appears on the device:
1. From the Format drop-down list, select the day, month, and year order.
2. From the Delimiter drop-down list, select the character that is to be used to
separate the day, month, and year.
3. Select the 2-digit year or four-digit year format for the display.
To set the format for the time that appears on the device:
1. From the Delimiter drop-down list, select the character that is to be used to
separate the day, month, and year.
2. Select the 12-hour format or 24-hour format for the display. The 12-hour
format displays the hours and minutes and AM or PM. The 24-hour format
displays the hours and minutes.
Employee tab
Use the Employee tab to specify when an employee punches in and punches out,
and the text that appears after a punch. You also select a method that the device
uses to calculate an employee's next in-punch when an out-punch is omitted. The
features that are visible and enabled are specific to the device that you configure,
based on the options you selected.
Use the Employee tab to:
• Specify whether to display the employee’s name or badge ID when an
employee punches in or out.
• Specify whether to use punch interpretation rules or schedule shifts to
calculate an employee's next in-punch when an out-punch is omitted.
• Specify whether or not home employees can punch only during their regularly
scheduled hours. If you do not select this feature, home employees can punch
at any time.
• Specify the number of individual schedules that the device makes available
for each home employee. Enter a value from 0 to 14. The default value is 3.
• Specify the number of days ahead that the device is to use when determining
the future schedules to display. The default is 38.
For optimum performance, set the number of individual schedules and the
number of days ahead to the lowest values that will ensure that the needed
schedules are available at the terminal. For example, if all the employees
assigned to a device work one shift five days a week and need to view their
schedules for this week and next week, specify 10 individual schedules per
employee and 14 days for the Number of days to look for future schedules.
FIFO tab
FIFO (first-in, first-out) is the data storage buffer in the device’s random access
memory (RAM). The FIFO contains a consecutive list of records of events that
take place at the device. Use the FIFO tab to specify the number of hours that
certain soft keys that are assigned employee and manager or supervisor functions
“look into the past” for data. Setting the FIFO scan interval properly helps to
avoid the use of older, obsolete data.
When configuring a Series 4000 terminal, you can use the FIFO tab to set the
Scan Interval for Reviewing Punches (in hours). The scan interval defines the
number of hours that certain soft key functions “look into the past” for data.
Setting the FIFO scan interval properly helps to avoid the use of older, obsolete
data. Valid settings are 0 to 72 hours. The default setting is 12.
When configuring a Series 400 device, you can use the FIFO tab to set the
following options:
• Scan Interval for Reviewing Punches (in hours)—The scan interval defines
the number of hours that certain soft key functions “look into the past” for
data. Setting the FIFO scan interval properly helps to avoid the use of older,
obsolete data.
Valid settings are 0 to 72 hours. The default setting is 12.
• Scan Interval Offset (in hours)—The scan interval offset enables you to
offset the scan interval so that it matches times for reviewing your standard 8-
hour shifts. By default, the FIFO scan interval measures time in terms of three
8-hour shifts beginning at midnight (midnight to 8:00 A.M., 8:00 A.M. to
4:00 P.M., 4:00 P.M. to midnight). However, if your first daily shifts begin at a
time other than midnight, for example, 2:00 A.M., you can offset the FIFO
scan interval by 2 hours so that the scan interval begins at 2:00 A.M. instead
of at midnight.
The ability to offset the FIFO scan interval enables the device to scan data in
terms of the employee’s shifts. Entering a value of 0 results in no offset of the
FIFO scan interval.
Valid settings are 0 to 7 hours. The default setting is 0.
Note: Use this tab only if you are an advanced user and are certain that the XML
files will cause the desired behavior of the Series 4000 terminal.
The Select XML File Name to Add Before Selection in List dialog box
appears. DCM defaults to the DCM data directory. You may browse to other
directories.
2. The file name that you select must have an .xml extension. Select the file
name to add to the end of initializations and click Open. The file name
appears in the Free Form XML dialog box.
The maximum file size for the file is 32K. You may add up to 20 free form
XML files. You cannot add duplicate files.
3. To add additional file names, click Add Before or Add After.
4. The files are processed in the order in which they are listed. To move a file
name up or down in your list, select the file name and click Move Up or
Move Down.
5. To remove a file from the list, select the file and click Remove.
Note: If you configure a function key with a transaction that includes a pay code,
device work rule, comment code, or total, be sure to select the corresponding item
in the Download options and to initialize the device. Otherwise, validation of the
entered code fails because the corresponding validation list does not exist in the
device and the assignments are not allowed. If this validation fails, the user cannot
complete the transaction.
4. For some selections, such as Add Punch, you may need to enter more details
by clicking Detail. Detail dialog boxes vary according to the function. For
example, if you selected Start Work Rule Transfer, the Detail dialog box
includes a Must prompt user for Labor Account check box. If no default
values are assigned for any labor levels, the check box is active and you can
select it or clear it. If one or more default values are assigned for which the
Allow override check box was selected, the Must prompt user for Labor
Account check box is selected and unavailable. If all the usable labor levels
have Allow override not selected, you cannot change any labor values and the
Must prompt user for Labor Account check box is cleared and unavailable.
When you finish, click OK.
After you click Details, the Function Key Settings that may appear are Device
Work Rules, Labor Levels, and Comment Codes. For more information about
device work rules and comments codes, see “Device Work Rules, Comment
Codes, and Pay Code Edits” on page 203. For more information about labor
levels, see “Setting Up Labor Level Information” on page 181. For more
information about totals definitions (pay codes or accrual codes), see “Totals
and Accruals” on page 195.
For more information about the Function Key tab and all available options,
press Help.
5. Click OK in the Assign Function dialog box.
6. For function key mapping, you can select the Perform function key activity
on out-punch check box to enable employees to perform a function key task
when they punch out from a shift. When you select this check box, the
Function key mapping list displays the Out Punch selection for function key
task assignments.
7. If you selected Labor Account Transfer in the No function assigned function
key assignment, selected Details, and specified the function key text, you can
select the Display function key text for labor transfers check box. This
causes the text that is assigned to a function key to appear when the employee
presses that function key.
8. You can select the Tips and function keys only to enable employees check
box to perform tip and function key entries only. When you select this check
box, the device does not accept simple punches, such as in-punches and out-
punches, but labor account transfers are still available.
9. You can select the Allow negative tips check box to enable employees to
enter negative decimal tips.
10. You can select the Enable tips shortcut keys check box to enable employees
to use the + (plus) and - (minus) keys to enter tips.
11. To add, delete, or edit totals for Totals configuration, click Configure Totals.
For more information about Totals, see “Totals and Accruals” on page 195.
Managers and supervisors can unlock the door for individual employees without
generating a time and attendance punch, and they can unlock the door for a
specified length of time, whenever necessary. Managers and supervisors perform
these functions at the device with the terminal in Manager mode or Supervisor
mode.
Note: You can configure a Series 4000 terminal to activate a bell or a gate, but not
both.
Note: The Workforce Timekeeper application does not support the Gate Entry
records and discards the records if they are stored. DCM places selected Gate
Entry records in a transaction output file. For more information about transaction
output files, see “Transaction output files” on page 263 and “Setting up a
transaction output file for a device group” on page 233.
Note: You can configure a Series 4000 terminal to activate a bell or a gate, but not
both.
DCM retrieves jobs data from the Workforce Timekeeper application and
downloads that data to the device. DCM also collects job transfer transactions
from the device and submits these transactions to the Workforce Timekeeper
application.
A job set specifies a collection of jobs. A job transfer set is a type of job set to
which an employee can transfer. Jobs, job sets, and job transfer sets are defined by
the Workforce Timekeeper application. Job transfer sets are assigned to
employees in WTK or to devices in DCM.
The two types of job transfer sets that can be downloaded to a device are the
device job set and employee job sets. Any job transfer set that is defined in the
Workforce Timekeeper application may be selected to be the device job set, using
the Device > Applications Options dialog box in DCM Device Manager. You can
specify a different job transfer set as the device job set for each Series 4000
terminal in the system. You can also assign a job transfer set to each employee in
the Workforce Timekeeper application. Each employee may have a different
assigned job transfer set, or the same job transfer set may be assigned to multiple
employees. You can also use the same job transfer set as the device job set and one
or more employee job sets.
The job sets that are downloaded to the Series 4000 terminal are determined by
the Device > Download Options dialog box. If the Device Job Transfer Set
download option is selected, the device job set that you specify on the Application
Options dialog box is downloaded. If the Employee Job Transfer Sets download
option is selected, all job sets that are assigned to the home employees for the
device are downloaded. Selecting the device job transfer set downloads only one
job transfer set, while selecting employee job transfer sets usually downloads
multiple job sets. If no device job set is selected and downloaded to the device,
only home employees can use the device for job transfers.
Note: The job sets that are downloaded to the Series 4000 terminal must
correspond to the validation rule for jobs entered by home employees that is
specified on the Job Transfer tab. Also, if non-home employees are allowed to
perform job transfers, the jobs in the device job set are always used to validate the
entered job value. For non-home employees to perform job transfers, the device
job set must be downloaded to the Series 4000 terminal.
If you selected Employee job transfer set, the job entered by a home employee
is checked for validation. Only home employees can perform job transfers if the
employee has an assigned employee job set that is downloaded to the device.
Note: Standard badges support only numeric values. If you enable alphanumeric
labor data and select standard labor badges, the badge format supports only
numeric data.
If you are configuring a Series 4000 terminal, you can use the Soft Key tab to
enable ad hoc entries for a labor level. If Ad hoc is enabled, a labor level list is
downloaded only if the list is needed for validation of a transaction. The labor
level list is needed for validation when both of the following circumstances exist:
• The labor level is enabled in the Labor Options dialog
• At the terminal that allows the user to enter a value for the labor level, at least
one function is configured that does not allow ad hoc entries.
The ad hoc flag must be set first in the Access Profile and Labor Level
Maintenance options of the Workforce Timekeeper Setup Applications.
The labor level list is not sent for a given labor level if any of the following
conditions exist:
• The labor level is not enabled in the Applications Options dialog box or is not
included in the selected labor level set.
• A function is assigned to the device that prompts the user to enter labor level
data.
• Every function that prompts for a labor level is configured to allow ad hoc
entries.
For a Series 4000 terminal version 2.0 or higher, this setting to allow ad hoc
entries includes the configuration of any default transactions that prompt for
labor levels.
For a Series 400 device, this setting to allow ad hoc entries also applies to the
configuration of a labor level for the # key and supervisor transfers that are
configured on the Labor Level tab of the Configuration Options dialog box.
If you are configuring a Series 400 device, you can also specify whether or not to
accept leading zeros. If you use labor level values that contain leading zeros, for
example 000123, you may can configure a Series 400 device to not require the
user to enter the leading zeros. That is, if you configure the device to skip leading
zeros, the user can enter 123 for the labor level. In the device report, the value as
000123 and this is how it appears in Workforce Timekeeper.
You can configure a Series 400 device to skip leading zeros if labor level values
are numeric only, and if all the values in any given labor level contain the same
number of digits. The number of digits in each value must be the maximum length
that is specified in Workforce Timekeeper.
For example, if the maximum length of Labor Level 2 is set to 8 in Workforce
Timekeeper, the following values support skip leading zeros:
• 00000123
• 00012345
• 12345678
Manager tab
Series 4000 version 2.1 devices have the following two options for identifying
users as managers and allowing them to enter Manager mode and perform
Manager mode functions:
• Identifying home employees as managers based on their badge IDs and their
license levels in Workforce Central. When configured to use managers’ badge
IDs, Series 4000 terminals generate an audit trail for Workforce Timekeeper
to identify which manager performed edits at the Series 4000 terminal. The
devices can also perform biometric verification prior to allowing entry into
Manager mode.
• Recognizing a specially formatted badge as a supervisor badge. When
configured to use supervisor badges, Series 4000 terminals cannot generate an
audit trail for Workforce Timekeeper and cannot perform biometric
verification prior to allowing entry into Manager mode.
Use the Manager tab to specify which way is used to identify a user as a manager
or an employee with a manager’s license. You can use only one way for a given
Series 4000 terminal. In addition, if the manager badge ID is used, use this tab to
configure how the Series 4000 terminal behaves when managers swipe their
badges.
Note: Series 400 devices and Series 4000 version 2.0 devices and earlier support
only the use of supervisor badges. These devices do not support the use of
manager badge IDs.
To prompt managers for a device work rule when they add, edit, or delete a
transaction, see “Soft Key tab” on page 171.
If you select Use supervisor badge, Series 4000 users use an employee badge for
Employee mode functions and a supervisor badge to enter Manager mode. When
a user swipes a supervisor badge at the Series 4000 terminal, the Manager Log On
screen appears. The user must enter the Supervisor badge password to enter
Manager mode. The Manager mode password defaults to 00000 and can be reset
by using the Change Supervisor Badge Password function in Manager mode at the
Series 4000 terminal. This is not the password that can be configured in the
Manager tab. This password is used only if Use manager badge ID is selected.
Note: If you change from Supervisor mode to Manager mode and have the
Change Password transaction assigned to any soft key, you are prompted to
confirm the mode change. If you confirm the change, the assignment to the soft
key is removed. If you change from Manager mode to Supervisor mode and have
the Manager Log On transaction assigned to any soft key, you are prompted to
confirm the mode change. If you confirm the change, the assignment to the soft
key is removed.
You can change the password after clicking OK, by clicking Restore, clicking
Use manager badge ID, resetting the After entering badge ID is necessary,
and entering the new numeric password.
To prompt supervisors or managers for a device work rule when they add, edit, or
delete a transaction, see “Soft Key tab” on page 171.
Use the Punch Rules tab to change the settings that control home employee and
non-home employee punching.
To specify the punch rules, you can:
• Set general functions.
For Series 400 terminals, the Validate badge type check box specifies that the
badge type that an employee uses for punching in and out is to be verified at
the terminal.
For all terminals, the Enable display punch status check box specifies that the
punch’s statuses to appear at the terminal.
For all Series 4000 v 2.1 or higher biometric terminals, the verification
threshold determines how closely the finger scan image for an employee
punching at the terminal must match the employee’s biometric template for
successful biometric verification. Possible settings are Normal, Low, and
None. The threshold that you select sets the threshold for each device. The
system looks at the higher of the employee biometric verification threshold or
the device biometric verification threshold.
• Set the repunch interval for home employees.
A repunch interval setting of zero for a Series 4000 terminal allows multiple
punches by the same employee in the same minute.
A repunch interval setting of zero for a Series 400 device does not allow a
repunch within the same minute. The interval before a repunch is allowed can
vary from 1 to 59 seconds, depending on the point within the minute that the
original punch was made.
• Instruct the device to accept punches from non-home employees, specify the
repunch interval, and enable biometric verification if appropriate.
A repunch interval setting of zero for a Series 4000 terminal allows multiple
punches by the same employee in the same minute.
A repunch interval setting of zero for a Series 400 device does not allow a
repunch within the same minute. The interval before a repunch is allowed can
vary from 1 to 59 seconds, depending on the point within the minute that the
original punch was made.
Select Enable biometric verification if non-home employees must verify their
identification by using the Kronos Touch ID finger scan identification device.
Note: Biometric verification for all transactions also must be enabled in the
Global Features section of the Soft Key tab so that non-home employee
biometric verification is active.
• Unassigned
• Assigning a function to a soft key for use by all employees, including
managers or supervisors
• Assigning a command to a soft key for use by managers or supervisors only
Use the Soft Key tab to assign tasks to the soft keys. Examples of soft key
assignments include canceling an automatic meal deduction, labor level transfer,
start and stop an activity, view totals, and enter tips. You can assign tasks to soft
keys for employee and manager or supervisor use, or only for manager or
supervisor use. The options that are available are determined by the model of the
selected device. For more information about the Function Key tab, see “Function
Key Tab” on page 156.
A manager soft key function is available only to users while the device operates in
Manager mode. After you assign a manager function to a soft key and download
device configuration to the device, a manager can perform the function by
entering Manager mode and pressing the associated soft key on the device.
An employee soft key function is available to users while the device operates in
Employee mode. After you assign an employee function to a soft key and
download device configuration to the device, a user can perform the function by
pressing the associated soft key on the device.
Note: If you configure a soft key with a transaction that includes a pay code,
device work rule, comment code, or total, be sure to select the corresponding item
in the Download options and initialize the device. Otherwise, validation of the
entered code fails because the corresponding validation list does not exist in the
device and the assignments are not allowed. If this validation fails, the user cannot
complete the transaction.
– No function assigned. This is applied to a soft key that all employees’ use,
– No manager command assigned or No supervisor command. This is
applied to a soft key assignment that only managers or supervisors can use.
Series 4000 terminals support up to 28 soft key assignments. All other devices
support up to 12 soft key assignments.
2. Click Assign. The Assign Function window opens.
3. Select the transaction that you want to assign to the soft key. Not all
transactions are applicable to the application in which the device is connected.
Some transactions enable you to define which actions can be performed at the
device.
If you want the display at the Series 4000 terminal to be other than the default
command list label, specify the display text in the Soft Key label text box.
Series 4000 terminals support up to 40 characters that line wrap. All other
devices support up to 20 characters without line wrap.
4. For some selections, such as work rule transfers, you may need to enter more
details by clicking Detail. Detail dialog boxes vary according to the function
selected. For example, if you selected Start Work Rule Transfer, the Detail
dialog box includes a Must prompt user for Labor Account check box. If
no default values are assigned for any labor levels, the check box is active and
you can select it or clear it. If at least one default value with Allow override is
assigned, the Must prompt user for Labor Account check box is selected
and unavailable. If no usable labor levels has Allow override, you cannot
change any labor values, and the Must prompt user for Labor Account check
box is cleared and unavailable. When you finish, click OK.
Note: If you select Add Punch and click Detail, you can specify that
managers be prompted for a device work rule when they add a transaction on
a Series 4000 terminal.
After you click Detail, the Soft Key Settings that may appear are Device
Work Rules, Labor Levels, Job Transfers, and Comment Codes.
For more information about device work rules and comments codes, see
“Device Work Rules, Comment Codes, and Pay Code Edits” on page 203. For
more information about labor levels, see “Setting Up Labor Level
Information” on page 181. For more information about job transfers, see “Job
Transfer tab” on page 161. For more information about totals definitions (pay
codes or accrual codes), see “Totals and Accruals” on page 195.
5. Click OK in the Assign Function dialog box.
Note: The available functions are specific to the device being configured. For
example, the Series 4000 terminal soft keys can be assigned Pay Code Hours
Edit and Pay Code Money Edit in Employee mode, and Pay Code Move
Amount and Pay Code Hours Edit in Manager mode or Supervisor mode.
6. If it is available, you can select the Always require soft key press check box
to require employees to press a soft key before swiping their badges or
entering a badge IDs to initiate a transaction.
7. If it is available, you can select the Tips and soft keys only to enable
employees check box to perform tip and soft key entries only. When this
option is selected, the device does not accept simple punches, such as in-
punches and out-punches, but labor account transfers are still available.
8. You can select the Allow negative tips check box to enable employees to
enter negative decimal tips.
9. If it is available, you can select the Enable tips shortcut keys check box to
enable employees to use the + (plus) and - (minus) keys to enter tips.
10. Use the Enable biometric verification for all transactions check box to
specify which transactions require biometric verification at Series 4000
terminals with the Kronos Touch ID finger scan device. This check box is
available for Series 4000 terminals, version 2.1 and later.
If this option is selected, all Employee mode transactions, including those that
generate a punch record and those that are view-only and excluding Smart
View transactions, require biometric verification at the device.
For more information about verification for Smart View transactions, see
“Creating a Smart View transaction” on page 107.
11. To add, delete, or edit totals for Totals configuration, click Configure Totals.
For more information about Totals, see “Totals and Accruals” on page 195. For
more information about the Soft Key tab and all available options, click Help.
Supervisor tab
Use the Supervisor tab to specify the tasks that supervisors and guards perform at
the device. Supervisors perform supervisor tasks only when the device is in
Supervisor mode.
Note: The Supervisor tab is for use with Series 400 devices and with Series 4000
terminals running firmware version 2.0 or lower. The Manager tab is available for
configuring Series 4000 terminals running firmware version 2.1 or higher.
For Series 4000 terminals, specify whether or not to allow supervisors to use the
keypad to enter an employee’s ID or badge ID.
For Series 400 devices, the supervisor tasks available on the Soft Key tab may
vary according to device that you are configuring. For example, some devices do
not use Guard mode.
You can specify the following configuration options:
• Allow supervisors to use the keypad to enter an employee’s badge ID. For
some devices, if this function is enabled, the supervisor must press the
asterisk (*) key and then enter the badge ID.
• Allow supervisors and guards to perform specific commands at the device.
Select the commands in the Supervisor command list.
• Allow supervisors to edit a punch or transaction. The edits include adding a
punch, deleting a punch, adding hours to a pay code, moving hours to a
different pay code, and adding monetary amounts to a pay code.
• Prompt supervisors for a device work rule when they add or delete a
transaction. The Allow punch and transaction edits check box must be
selected first.
• Prompt supervisors to enter a comment code for commands where comments
are supported. This check box appears only for devices where comments are
supported and enabled for individual soft keys.
• Specify the commands that are to be available to supervisors and guards.
Note: To prompt supervisors for a device work rule when they add a transaction
on a device, see “Soft Key tab” on page 171.
Note: The Communications > Update command does not load device
configurations. The Update command loads from the host application the
employee information that has changed since the last update.
Note: When you initialize a Series 400 device with download options that include
Device Configuration, all information about home employees is deleted from the
device. This includes the current punch in or out status of each employee. Therefore,
be very careful about performing an initialize to a Series 400 device with the Device
Configuration download option selected, and do not select Device Configuration as
one of the default download options. The default download options are used by
many Event Manager events, and can result in employee information being deleted.
If you need to send Device Configuration to a Series 400 device, always select
one or more employee list download options as well. If you are using schedules,
select the download options Employee list with schedules. If you are using totals,
select Employee totals when you initialize. If you use schedules at devices,
initialize only at times when employees are not expected to be working a shift. If
you initialize during a shift when employees are working, their in or out statuses
at the devices are erased and they may not be able to punch out properly.
For more information about initialization, see “Initialization” on page 139. For
information about loading device parameters that are not included in the
Configuration Options tabs, see “Loading Files and Data to and from a Device”
on page 279.
The device name changes from a dark gray to light gray in the Device Manager
main window, designating that the device is now enabled for data collection if it is
responding and is able to communicate with DCM.
This chapter explains how to set up labor level information and how to load it to
devices.
This chapter contains the following sections:
• “Overview” on page 182
• “Selecting labor level options for the device” on page 184
• “Defining labor transfer options” on page 185
• “Configuring labor transfer settings” on page 187
• “Assigning labor levels to a soft key” on page 190
• “Removing labor levels from a device” on page 192
• “Downloading labor levels to a device” on page 193
Chapter 6 Setting Up Labor Level Information
Overview
Host applications provide the labor levels, labor level sets, and labor level entry
options that are available to the DCM system. DCM provides the means for you to
set up labor level information for a device and download this information to the
device. This chapter describes how to accomplish this.
Labor levels
Typically, labor levels associate an employee’s time with cost centers that have a
hierarchical relationship to each other. For example:
• Level 1 is a department (Facilities)
• Level 2 is a division in the department (Maintenance)
• Level 3 is a job in the division (Electrician)
Certain host applications and devices support only three labor levels. The Data
Collection Manager system lists screens that are appropriate to the number of labor
levels that the host application or the device supports. If your host application or
device supports seven labor levels, additional example labor levels are:
• Level 4 is a Cost Center
• Level 5 is a Product
• Level 6 is an Item Number
• Level 7 is a Work Order
Caution: If you create labor level entries that contain non-English characters, you
cannot download any labor level entries to your Series 400 devices.
Note: Whenever you modify a device configuration, you need to load the changes
to the device so that they can be reflected at the device. After making your labor
level changes, see “Downloading labor levels to a device” on page 193 later in
this chapter.
5. Select the Allow keypad entries check box to enable employees to enter labor
level data by using the device keypad. If you do not select Allow keypad
entries, the employees must use labor level or account badges to enter labor
data.
6. Specify if and how the device prompts for labor levels when the employee
performs a simple punch.
– Select None to specify that the device does not prompt for labor transfer
data.
– Select First daily in-punch to perform a labor transfer on only the initial
in-punch.
– Select All in-punches to perform a labor transfer each time an employee
punches.
7. Specify when an entry is required for labor levels that are prompted when an
employee performs a simple punch.
– Select None to specify that no data transfer is required.
– Select First daily in-punch to specify that data transfer is required only on
the initial punch.
– Select All in-punches to specify that data transfers are required on all
employee entries.
8. If Standard is selected as the transfer badge type, the Standard Badge
restriction level specifies the restriction levels that the device accepts for labor
account and labor level transfers. Ensure that the restriction levels are
encoded in the badge format.
Note: You set up restriction levels and assign employees to the levels in the
host application.
Note: You can edit the Generic badge format only if you specified a Generic
badge type on the Labor Transfer tab. Otherwise, the Edit Format button is not
available.
For Labor level transfer badges, the data field is the labor level number.
The sum of the digits in the seven labor levels cannot exceed 30.
Note: The sum of the Number of characters in the data field and the number
of characters to ignore (from the right) is equal to or less than the Total
number of characters on the badge.
b. Enter the number of Characters to ignore at the end of the format. This
number locates the data field.
c. Click Test to verify the entries. If the entries are valid, the format appears
in the Badge Format box. If the entries are invalid, an error message
appears in the Badge Format box.
d. Click OK to accept the changes, run the test, and return to the Labor
Levels tab.
7. On the Labor Levels tab, select the Allow alphanumeric values check box to
allow alphanumeric values. If the box is cleared, only numeric values are
allowed.
8. If you are configuring a Series 400 device, the default order for the Labor
Levels that were configured in the Application Options appears in the Labor
level prompt order check box. The order specifies the sequence in which the
device prompts for labor level entries when the employee performs a labor
level transfer. You can edit the order of the levels, but not add or delete any
level. For example, if you configured Labor Levels 1, 2, 3, and 5, or the Labor
Level Set is configured for Labor Levels 1, 2, 3, and 5, the default order could
be 5321. You can change the order to 3512, but not 351 or 3571.
If you are configuring a Series 4000 terminal, the labor levels are specified on
the Soft Key tab. For more information assigning labor levels, see “Assigning
labor levels to a soft key” on page 190.
For more information about setting labor levels, see “Selecting labor level
options for the device” on page 184.
9. A partial transfer is a labor level transfer feature that enables users to specify
fewer labor levels, rather than all labor levels, to be used in the host
application. The user only needs to enter a value for every labor level that is
configured in the host application.
If you are configuring a Series 400 device, select the Allow partial transfers
check box to enable employees to bypass prompts by pressing Enter. You also
must assign a Not Assigned value and allow override for any labor level that
you want to be able to enter as a partial labor transfer.
If you are configuring a Series 4000 terminal, partial labor level transfers are
specified on the Soft Key tab. For more information about configuring partial
labor level transfers for a Series 4000 terminal, see “Assigning labor levels to
a soft key” on page 190. Go to step 15.
10. Select a Labor Level from the Default value for the # key and supervisor
transfers list box, and click Assign. The Labor Level dialog box appears.
11. To allow override for any labor level that you entered as a partial labor
transfer, select the Allow override check box.
If you select the Allow override option, the employee either accepts or
changes the associated labor level entry at the device.
12. To allow ad hoc entries, if your host application has defined ad hoc labor
levels, click the Allow ad hoc check box.
If you select Allow ad hoc, the employee can enter a new labor level at the
device.
Note: The options that appear depend on how labor levels have been
configured in the host application. Disabled options are not available.
For example, the ad hoc flag must be set first in the Access Profile and Labor
Level Maintenance options of the Workforce Timekeeper Setup Applications.
If the host application is configured for three or fewer labor levels, three
check boxes appear, where you can enable ad hoc for each labor level
individually.
Note: The options available are determined by the device that you are
configuring.
3. If it is available, you can select the Perform soft key activity on out-punch
check box, which allows employees to perform a soft key transaction when
they punch out from a shift.
4. In the Soft Key mapping list, expand a Soft Key, select one of the following
options, and click Assign:
a. For Series 4000 terminals, select No function assigned or No manager
command assigned.
b. For Series 400 devices, select No function assigned.
If you are configuring a Series 4000 terminal, select Labor Transfer and click
Detail. If you are configuring a Series 400 device, select Labor Account Transfer
and click Detail. The Soft Key Settings dialog box appears.
5. From the Labor Transfer dialog box, click the Labor Levels tab, highlight a
labor level, and click Assign. The Labor Level dialog box appears.
6. Select the appropriate labor level entry from the Labor Level dialog box.
If you select Allow Override, the employee either accepts or changes the
associated labor level entry at the device.
If you select Allow ad hoc, the employee can enter a new labor level at the
device.
If you select Allow partial transfers, the employee can specify fewer labor
levels, rather than all labor levels, to be used in the host application. The
employee only needs to enter a value for every labor level that is configured
in the host application.
Note: The options that appear depend on how labor levels have been
configured in the host application. Disabled options are not available. For
example, the ad hoc flag must be set first in the Access Profile and Labor
Level Maintenance options of the Workforce Timekeeper Setup Applications.
7. Repeat steps 5 through 7 until you have assigned the appropriate labor levels
to the soft key.
8. If you are configuring a Series 400 device, enter the text that is to appear on
the device for that soft key and click OK.
9. If you are configuring a Series 4000 terminal and selected No function
assigned in step 4, select the appropriate Soft Key schedule, enter the Soft
Key label that is to appear on the terminal, and click OK.
10. If you are configuring a Series 4000 terminal and selected No manager
command assigned in step 4, enter the Soft Key label that is to appear on the
terminal and click OK.
For more information about the Soft Key tab, see “Soft Key tab” on page 171.
After a labor level is assigned to a soft key, you need to load the labor level
assignment to your device or devices. See “Downloading labor levels to a device”
on page 193.
Note: When you initialize a Series 400 device with download options that
include Device Configuration, all information about home employees is
deleted from the device. This includes the current punch in or out status of
each employee. Therefore, be very careful about performing an initialize to a
Series 400 device with the Device Configuration download option selected
and do not select Device Configuration as one of the default download
options. The default download options are used by many Event Manager
events, and can result in employee information being deleted.
The labor options are sent to the device that you specified and then the Device
Manager main window reappears.
This chapter explains how to define soft keys to display totals and accruals.
It contains the following sections:
• “Overview” on page 196
• “Creating a totals definitions” on page 197
• “Assigning totals definitions to soft keys” on page 200
• “Downloading totals definitions and accruals to a device” on page 201
Chapter 7 Totals and Accruals
Overview
Certain devices display totals and accrual balances for employees. A device is
configured to list a number of totals definitions for home employees. Users
display device totals from totals definitions by using a soft key. A totals definition
contains the sum of a specific calculation, such as hours worked or sick time
earned.
DCM supports these totals definitions with pay codes or accrual codes. Each
totals definition has one setting system-wide; totals definitions are not device-
independent. DCM uses the application connection library to retrieve the list of
configured pay codes and accrual codes in the application. You can create totals
definitions with pay code or accrual code selections, and then assign totals
definitions to soft keys to display the totals at that device. You can configure
different soft keys to show different totals definitions for different devices.
When you select Employee Totals as a download option for a device, the totals
definitions and employee totals are downloaded to the device with a device
initialize or scheduled totals download event. When you select Device
Configuration as a download option for the device, totals definition assignments
to soft keys are downloaded with the device initialize. DCM uses the application
connection library to interface with the application to retrieve totals and accruals
for the employees.
For more information about configuring pay codes, refer to “Device Work Rules,
Comment Codes, and Pay Code Edits” on page 203.
Note: To download soft key assignments that display totals at the device, you
need to download Device Configuration as part of an initialize.
When totals definitions are deleted, verify the soft key assignments and save the
device configuration.
To reflect the proper soft key assignments for totals definitions at the device, you
need to send the device configuration to the device.
4. Click OK.
Sending totals and accruals to a deviceWhen a communication
channel receives the request to initialize or update, it loads the configuration
service of DCM KrCfgSvc.dll. The configuration service builds the
download file based on the selected device download options. It requests
application-specific information—for example, employees, totals, labor levels,
entry lists, device work rules, pay codes, and punch interpretation rules from the
application connection library.
The Workforce Timekeeper connection library provides employee totals data lists
to the configuration service and devices only during initialization, not during an
update request.
When you initialize a Series 400 device with download options that include
Device Configuration, all information about home employees is deleted from the
device. This includes the current punch in or out status of each employee.
Therefore, be very careful about performing an initialize to a Series 400 device
with the Device Configuration download option selected, and do not select Device
Configuration as one of the default download options. The default download
options are used by many Event Manager events, and can result in employee
information being deleted.
If you do need to send Device Configuration to a device, always select one or
more employee list download options as well. If you are using schedules, select
the download options Employee list with schedules. If you are using totals, select
Employee totals when you initialize. If you use schedules at devices, initialize
only at times when employees are not expected to be working a shift. If you
initialize during a shift when employees are working, their in or out statuses at the
devices are erased and they may not be able to punch out properly.
Series 4000 terminals retain all employee information during all initializations
unless the Clear all employee information download option is selected. Clear all
employee information does not delete employee punches from devices.
Individual totals are part of the employee totals record that depend on the total
number of configured totals definitions.
With the Workforce Timekeeper application, totals and accruals are downloaded
with vested balances in the current pay period.
This chapter describes how to configure device work rules, comment codes, and
pay code edits.
This chapter contains the following sections:
• “Device work rules and profiles” on page 204
• “Comment codes” on page 212
• “Pay codes and pay code edits” on page 216
Chapter 8 Device Work Rules, Comment Codes, and Pay Code Edits
Work rules, device work rules, and device work rule profiles
A pay rule is a category used to organize time and money. Time pay codes accrue
hours, while money pay codes accrue money. Examples of pay codes are Regular
and Overtime for worked or productive time. Jury Duty, Vacation, and Sick time
are examples of pay codes used for unworked time or non-productive time. Bonus
is an example of a pay code that holds monetary amounts.
Work rules are used in Workforce Timekeeper to apply specific payroll rules to
shifts that determine how an employee accrues hours. All employees have a default
work rule assigned to them as part of their pay rule, and some employees may be
allowed to change their work rule when they perform a specific type of work.
For example, an employee's default work rule might specify that the employee
begin to accrue overtime after the employee works eight hours in a single shift. If
an employee is called back to work after just completing a shift, that employee
may be allowed to transfer to a different work rule that accrues a minimum of four
hours towards overtime, even if the employee did not work eight or more hours in
the original shift.
A device work rule is used to allow employees to perform a work rule transfer at
a device. Device work rules map work rules to pay rules, allowing a single device
work rule to be used at a device to transfer different employees to different work
rules, based on the employee's pay rule assignment in Workforce Timekeeper.
For example, a device work rule named "Call back" could be used to transfer
employees with pay rule A to work rule A, and employees with pay rule B to work
rule B, if these employees accrue hours differently for a "Call back". This allows
all employees to use a single device soft key, which could be labeled "Call back",
to perform a work rule transfer, even though each is transferred to a different work
rule. If all employees, regardless of their pay rule, accrue hours the same for a
"Call back", the device work rule may be configured with a single default work
rule.
To create device work rules, use the DCM Device Work Rules application’s
Device Work Rule Definition dialog box. A device work rule definition includes
the following information:
• The default work rule. This is the work rule that the employee is transferred to
in Workforce Timekeeper when none of the pay rules in the device work rule
match the employee's pay rule.
• Pay rule and work rule associations. These associations are used to define
which work rule an employee is transferred to based on the pay rule assigned
to the employee in Workforce Timekeeper. If the device work rule does not
contain any pay rule to work rule associations, all employees are transferred
to the default work rule, regardless of their pay rule assignment.
Device work rule profiles are the means that you use to assign device work rule
definitions to devices. You may have many device work rules defined, but
employees that use a particular device may only need to use a subset of them.
Work rule profiles are also used to assign a numeric value to each device work
rule, which may be used at devices with numeric-only keypads to specify the
device work rule.
A device work rule profile consists of a list of device work rules and
corresponding device work rule numbers.
Employees or managers use Start and End Work Rule Transfer functions at
devices to perform work rule transfers. A Start Work Rule Transfer changes the
employee's work rule based on the device work rule assigned to the soft key or
selected by the employee after pressing the soft key. An End Work Rule Transfer
returns the employee to the work rule specified in the employee’s Pay Rule
assignment in Workforce Timekeeper.
4. Enter a unique name for the new device work rule, such as Global Service.
Note: Do not use the following special characters in the device work rule
name: \ / * ” ’ ? < > | : ; #
5. Select a default work rule for the device work rule. The default work rule goes
into effect when the pay rule in the device work rule definition does not match
the pay rule assigned to the employee in Workforce Timekeeper.
You have the option to select a default work rule for this device work rule by
using the Default Work Rule drop-down box.
Note: If you select None and the pay rule in the device work rule definition
does not match the employee's pay rule, the work rule transfer is rejected by
Workforce Timekeeper and the rejected work rule transfer request appears in
the Transaction Data Editor with an error message.
6. To associate pay rules with the work rules, select a pay rule on the left side of
the window and a work rule on the right side of the window, and click Add.
A pay rule can be listed only one time in each device work rule. However, you
can associate a single work rule with many different pay rules.
As you link pay rules to work rules, the associations appear in the Pay Rule/
Work Rule Associations area of the window.
7. When you have finished, click OK to save the new device work rule.
2. In the Device Work Rule Configuration window, select Device Work Rule
Definition from the list box.
3. 3. Select File > Edit.
4. 4. In the Device Work Rule Definition dialog box, select the pay rule/work
rule association from the Pay Rule/Work Rule Associations list box.
5. Click Remove. The pay rule/work rule association is deleted from the Pay
Rule/Work Rule Associations list. The pay rule is displayed in the Available
Pay Rules list and can be used in association with any work rule in the
Available Work Rules list.
4. From the Device work rule profile drop-down list, select a profile and
click OK.
5. Use the Initialize command to download device work rule profiles to devices.
After you assign device work rule profile to a device, perform an initialize
with Device Work Rules enabled in the download options. Initialization
downloads your device work rule profiles to devices. Initialize whenever you
make changes to device work rules or device work rule profiles. For more
information about initialization and cautions when using initialization, see
“Initialization” on page 139 and “Loading basic configuration parameters to a
device” on page 177.
You can also program a soft key to prompt for device work rules. Employees enter
a device work rule after pressing the soft key. For more information about
assigning a device work rule to a soft key, refer to the next section.
7. If you selected End Work Rule Transfer, go to step 8. If you selected Start
Work Rule Transfer, click Detail. The Soft Key Settings dialog box appears.
a. To assign a device work rule to the soft key, select a device work rule
from the list.
b. To automatically transfer to this work rule when the soft key is pressed,
clear the Allow override check box.
The user is not prompted to enter a device work rule and the default
device work rule that you assigned to the soft key is included in the
transaction data.
c. If you want employees to be able to modify the selected work rule, check
the Allow override check box.
The user is prompted to enter a device work rule and is required to accept
the default value or to enter a different value.
d. Select options on other tabs as appropriate.
8. Click OK until you return to the Device Manager main window. For more
information about the Soft Key tab, see “Soft Key tab” on page 171.
After you assign device work rule to a soft key, perform an initialize with
the Device Configuration download option enabled. For more information
about initialization and cautions when using initialization, see
“Initialization” on page 139 and “Loading basic configuration parameters to
a device” on page 177.
You are also prompted for configuration options to unassign soft keys.
4. Download the option to the device by using the Initialize command. For more
information about initialization and cautions when using initialization, see
“Initialization” on page 139 and “Loading basic configuration parameters to a
device” on page 177.
After unassigning the device work rule profile from the device, delete the device
work rule profile from the Device Work rule Configuration application.
Comment codes
This section explains how to configure and download comment codes to devices.
If you configure a soft key with a function or transaction that includes a pay code,
device work rule, comment code, or total, be sure to select the corresponding item
in the Download options list the next time you initialize the device. Otherwise,
validation of the entered code always fails because the corresponding validation
list does not exist in the device. If this validation fails, the user cannot complete
the function or transaction.
7. Click Assign. The Assign Function or the Assign Manager Command dialog
box appears.
8. Select the function to assign to the soft key.
In the Function List, select Add Punch, Delayed Labor Transfer, Delete
Punch, End Work Rule Transfer, Job Transfer, Labor Transfer, Pay Code
Move Amount, Pay Code Hours Edit, Pay Code Money Edit (Decimal
Transaction), or Start Work Rule Transfer.
Note: If you select Add Punch, you can specify that managers be prompted
for a device work rule when they add a transaction on Series 4000 terminals
with firmware version 2.1 or higher.
9. Click Detail. The Soft Key Settings dialog box that is specific to the function
that you selected appears.
10. In the Comment Code area, select the Prompt for comment code check box.
11. From the drop-down list, select a default comment to assign a default value or
leave the text box blank.
12. Optionally, select the Entry required to require the user to enter a comment code.
13. Optionally, select the Allow override check box to allow an override to the
default.
of the current month to the current date plus one day. For example, if the date
is March 15, the user can enter any day from 1to 16 for a Delayed Labor
Transfer within the first 16 days of March. If the user enters 17 or above, the
Delayed Labor Transfer is entered for the previous month on February 17.
Note: If you configure a soft key with a function or transaction that prompts the
user to enter a pay code, device work rule, or comment code, be sure to select the
corresponding item in the Download options list the next time you initialize the
device. Otherwise, validation of the entered code fails because the corresponding
validation list does not exist in the device. If this validation fails, the user cannot
complete the function or transaction.
Pay code names with pay code ID numbers that were defined in the host
application are downloaded through DCM to the device. Use the Soft Key
Settings dialog box to associate the transaction with a specific pay code. You
may also specify a number of default hours and you can prevent employees
from overriding this default setting.
9. If it is selected, clear the Allow override check box.
If you select Pay Code Move Amount and the default values for the From and
To selections, and also do not allow these to be overridden, the soft key
always performs an adjustment with the From and To default values, even if it
is inappropriate for that employee.
For more information about the options listed in Soft Key Settings dialog box,
click Help.
10. Click OK.
11. To change the label that appears on the device for the soft key, enter the new
label text in the Soft Key label box.
12. Click OK twice.
10. Select the Pay code to be the default that is associated with the soft key
setting. For more information about the options listed in the Function Key
Settings dialog box, click Help.
11. Click OK twice.
Example
This chapter explains how to start data collection, manage transactions, and
schedule events.
This chapter contains the following sections:
• “Enabling data collection” on page 222
• “Monitoring transactions and device communications” on page 225
• “Collecting transaction input files” on page 229
• “Processing a transaction input file” on page 230
• “Viewing transactions” on page 234
• “Correcting invalid transactions” on page 235
• “Scheduling events” on page 237
• “DCM command events” on page 245
• “Centralized log file” on page 260
• “Transaction output files” on page 263
• “Data backups” on page 266
Chapter 9 Collecting Data and Managing Transactions
Note: For updating, the date and time for the DCM communication PC, devices,
and database should be synchronized. If the database server time is behind the
communication PC time when biometric data is deleted using the Workforce
Timekeeper People Editor, the biometric data may or may not be deleted from the
device when a device update is performed. Also, Employee badge data may not be
updated immediately when a device update is performed.
• Use the Event Manager application to start data collection at a specified time
in the future. Define a Start Data Collection event to start data collection from
all devices in a specified device group at a specified time. See “Scheduling
events” on page 237.
You can select View > Filter to activate viewing status messages for the local PC
only or for all PCs. The default is to view the status of all devices on all PCs that
are assigned to the communication channels. Because the database is queried for
the status, a 15-second delay occurs before the status is posted.
To view the real-time status for all requests to devices that are assigned to
communication channels that are running only on the local PC, select View >
Filter and click on Local Status. The local memory cache is queried for the
status.
The following table describes the different types of messages that appear in the
Communication Monitor:
The following table lists the Communication Monitor window drop-down menus
and icons:
Drop-
down
Menu Function/Icon Action
File Exit Exits the Communication Monitor.
View Toolbar Displays or hides toolbar.
Status Bar Displays or hides status bar.
Filter Displays all system status messages or local PC status
messages only
Refresh Sends registration messages to active communication
channels and device groups, and updates displays.
Device Initialize Downloads the configuration settings to the selected device
or device group. Clears any settings that were already in the
device.
Collect Polls the devices in a selected device group and collects data.
This starts a manual data collection process.
Collect Processes an existing device or group transaction input file
Transaction File that resides in the kronos\wfc\dcm\data\trx folder.
For more information, see the "About Transaction Input File"
topic in the DCM online Help.
Update Updates a selected device or selected device groups by
downloading changes.
Set Date and Sends the date and time of the communication PC to the
Time specified device.
Test Device Verifies whether or not communication is available between a
Communications device or a device group and the DCM communication PC.
Start Data Starts the data collection process for devices in a selected
Collection device group. This initiates the automatic data collection
process.
Drop-
down
Menu Function/Icon Action
Stop Data Stops the data collection process for devices in a selected
Collection device group. This stops the automatic data collection
process.
Tools Transaction Data Enables you to edit a selected transaction. For more
Editor information about the Transaction Data Editor, see
“Correcting invalid transactions” on page 235.
View Displays punch data. For more information about viewing
Transactions transactions, see “Viewing transactions” on page 234
View Transaction Displays the total number of successful transactions and total
Statistics number of failed transactions for communication PCs that are
configured and running DCM. For more information about
viewing transaction statistics, see “Viewing transaction
statistics” on page 236
View Log Displays a centralized log. For more information about log
files, see “Centralized log file” on page 260.
Device Manager Accesses the Device Manager.
Event Manager Accesses the Event Manager.
Help Help Topics Enters the online Help system.
If you receive more than one Collect Complete message for a Series 4000
terminal, the device has finished sending data, but the Collection Agent has not
finished processing it. You may receive Collect Complete messages
approximately every 5 seconds until the Collection Agent finishes processing, or
until a processing error occurs.
Transaction codes
The following table lists transaction codes that are listed in a transaction input file.
Based on the application connection and its configuration, DCM determines the
routing for Trx In files for a specified device group. The associated
communication channel uses this information to set up the routing from the device
to the collecting group and to the application connection.
Transaction files are located on the local communication PC, where the event is
launched, and are found in the \dcm\data\trx directory.
Viewing transactions
The Transaction Viewer shows transaction data, the device that processed the
transaction, and the total number of transactions processed. Transactions appear in
descending order from the most recent to the oldest. Up to 1000 transactions can
appear. If more than 1000 transactions are processed, the newest transactions
appear at the top of the list and the display is refreshed to contain no more than
1000 transactions. The transaction count is updated to include all transactions.
To access the Transaction Viewer, from the Communication Monitor main menu,
select Tools > View Transactions. The Transaction Viewer appears and shows
the raw transaction data coming from the devices.
You do not need to close the Transaction Viewer to access other DCM functions.
The information that appears on the Transaction Viewer is view-only and both
valid and invalid transactions appear. To determine if a transaction displayed on
the viewer is an invalid transaction, access the Transaction Editor, where the
invalid transactions are also listed. For more information about the Transaction
Editor, see “Correcting invalid transactions” on page 235.
Note: When the Communication Monitor is shut down, the Transaction Viewer
window is shut down automatically.
DCM retrieves from the database the total values every minute and refreshes the
statistic values in that appear on the Transaction Statistics dialog box. To
manually retrieve the total values and reset the one-minute timer, click Refresh.
To reset the count values for one communication PC to zero, select a
communication PC and click Reset. To reset the count values for all
communication PCs to zero, click Reset All.
To schedule an automatic reset of the count value to zero for a particular
communication PC, use the Reset Communications PC Transaction Statistics
event. This event causes the Total Counts in the Total Count Window to be
updated appropriately.
To schedule an automatic reset of the count values to zero for all communication
PCs, use the Reset All Transaction Statistics event. This event resets the Totals
counts in the Total Count Window.
If the total count reaches 2 billion, all count values are reset to zero
For more information about DCM events, see “DCM events and the Task
Scheduler” on page 238.
Scheduling events
An event is a DCM task, such as a data collection, a device update, or a program
execution, that you configure and schedule to be launched. When you configure
events in the Dcommunication PCCM Event Manager, you create actions for
DCM to perform at specific date and time. To configure a DCM command event,
refer to “Defining a DCM command event” on page 239. To configure a program
event, refer to “Defining a program event” on page 254.
For events to run successfully, the Microsoft Task Scheduler must be running on
the DCM communication PCs. For all events except Disable Sentinel and Enable
Sentinel, the Sentinel Service must be running on the same DCM communication
PC. The Event Manager does not need to be running when an event is launched.
Note: Event failure e-mail notifications are sent for events that are launched after
the Disable Sentinel event is launched. The e-mail notification states that the
Sentinel Service is not running. All events that are successfully launched after the
Enable Sentinel event is launched execute as scheduled.
You can access DCM Event Manager from the Data Collection Manager main
menu by selecting Event Manager. You can also select Tools to access the DCM
Event Manager from the Device Manager and Communication Monitor
applications.
Events are listed in the Event Manager main window in alphabetical order by
default. You can click any column heading to change the sort order.
The Event Manager window lists the events, the launch schedule, and the next and
previous run times. The Schedule column lists the event’s launching
configuration. If the event is to launch in the future, the Next Run Time column
lists the future run time. If the event was launched, the Last Run Time column lists
the time that the event launched.
The first time the Event Manager is opened, the DCM Event Manager - Events
window, in which no event commands are loaded to the DCM Event Manger,
appears by default. After an event is launched, the status of the event is written to
the DCM log file.
Event commands are stored in event sets, which are files with the .evt extension.
For more information about event sets, see “Event sets” on page 258.
If your DCM 6.0 system is an upgrade from a previous DCM system, your event
list files are converted to individual DCM events and stored in an event set with
the same name. The new event set files have the .evt extension.
Note: If the command line for a Run Program event contains the executable name
and parameters, the event cannot be converted. You must recreate the Run
Program event.
Schedule events for present and future times only. If you define a one-time event
for a past time, the event does not run until you manually run events. To manually
run the events, select Tools > Run Event Now.
You can stop events from launching. For example, you may want to suspend
events while you perform an upgrade or while you resolve a network or device
problem. To suspend events or resume events, select Tools > Suspend or Tools >
Resume.
b. From the Event Type drop-down menu, select Execute DCM Command.
c. Select the Enabled (scheduled task runs at specified time) check box to
allow the event to occur. Clear the check box to save the confutation but
not run the event.
Note: If you schedule events to run at a time that falls within a DST (Daylight
Saving Time) change, the event runs twice if the time is set backward due to
the change, or does not run at all if the time is set forward due to the DST
change on the day of the DST change. For example, any event that is
scheduled to run between 1 a.m. and 2 a.m. on the day of a backward DST
change that sets the time backward 1 hour will run twice because the hour
between 1 a.m. and 2 a.m. occurs twice on that day. Any event that is
scheduled to run between 2 a.m. and 3 a.m. on the day of a forward DST
change that sets the time ahead 1 hour will not run on that day because the
hour between 2 A.M. and 3 A.M. does not occur at all on that day.
The following windows show completed configuration tabs for an event with
these actions:
• The event is enabled to collect all device data from the devices in the device
group called Headquarters.
• The event collects data from the Ethernet device group called Headquarters.
Note: When renaming an event, you cannot change a letter from one case to
another case in the existing event name. For example, if the name of the event is
Collect first shift, you cannot rename it to Collect First Shift.
Testing an event
To test an event:
1. If necessary, from the Event Manager window's event set, select the event set
that contains the event to be tested.
2. Select the event.
3. Select Tools > Run Event Now.
The time at which the event was fired appears at the bottom of the window.
A record that the event was run before its scheduled time appears in the
DCM.log file and does not affect the next scheduled time for the event. You
can view the log file from the Event Manager by selecting Tools > View Log.
2. Specify, in seconds, the event set refresh interval. The minimum is 2 seconds.
The maximum is 64000 seconds. The default is 5 seconds.
3. Click OK
Device, Group, or
DCM Event Connect Name Description
Check for Series 4000 Sends an e-mail notification if uncollected
devices with uncollected transactions are on a Series 4000 device. The
transactions e-mail message includes:
• The device ID
• The device name
• The date and time that the uncollected
transactions were found in the device.
• The collection state
• The communications state
Device, Group, or
DCM Event Connect Name Description
Collect Group Device Group name Retrieves data from devices in a specified
device group. This applies to both online and
batch devices.
For example, you collect data from your
finance device group daily at 6:00 A.M. The
event specifies the device group.
Collect Group Transaction Device Group name Sends a request to the DCM Collection Agent
File on the local DCM communication PC to
process a transaction input file for the
specified group.
Connect to Modem Device The Device telephone Retrieves data from one or more devices
at Phone Number number that is specified connected to a single modem by using the
in the device modem’s telephone number. For example, you
configuration; for collect data from all devices connected to a
example, modem whose telephone number is 1-222-
1-222-555-1212. 555-1212 daily at 9:00 A.M.
Disable Sentinel Service Stops the Sentinel Service.
Enable Sentinel Service Starts the Sentinel Service.
Initialize Device Comment Device ID Sends only Comment Codes to the specified
Codes device.
Initialize Device Employee Device ID Sends the employee and biometric data to the
Biometric Data specified device.
Initialize Device Employee Device ID Sends all employees without their schedules to
List with no Schedules the specified device.
Initialize Device Employee Device ID Sends all employee-specific data to the
List with Schedules specified device.
Initialize Device Employee Device ID Sends employee totals to the specified device.
Totals
Initialize Device Labor Device ID Sends Labor Levels to the specified device.
Accounts
Initialize Device Labor Device ID Sends only Labor Levels with No Reference
Accounts with no Text to the specified device.
Reference Text
Device, Group, or
DCM Event Connect Name Description
Initialize Device Pay Codes Device ID Sends pay codes to the specified device.
Initialize Device Punch Device ID Sends Punch Interpretation Rules to the
Interpretation Rules specified device.
Initialize Device with Device ID Sends only device configuration data to the
Device Configuration specified device.
Initialize Device with Device ID Sends the device configuration data selected in
Device Download Options download options to the specified device.
Initialize Device with Device ID Sends the device job transfer set to the
Device Job Transfer Sets specified device.
Initialize Device with Device ID Sends only Device Work Rules to the specified
Device Work Rules device.
Initialize Device with Device ID Sends the employee job transfer set to the
Employee Job Transfer Sets specified device.
Initialize Group Comment Device Group name Sends the Comment Codes to all devices in the
Codes specified group.
Initialize Group Employee Device Group name Sends the employee and biometric data to all
Biometric Data devices in the specified group.
Initialize Group Employee Device Group name Sends employees with no schedules to a group
List with no Schedules of devices.
Initialize Group Employee Device Group name Sends all employee-specific data to all the
List with Schedules devices in the specified device group.
Initialize Group Employee Device Group name Downloads totals and accruals for all
Totals employees for the specified device group.
Initialize Group Labor Device Group name Sends Labor Levels to all devices in the
Accounts specified group.
Initialize Group Labor Device Group name Sends only Labor Levels with No Reference
Accounts with no Text to all devices in the specified group.
Reference Text
Initialize Group Pay Codes Device Group name Send Pay Codes to all devices in the specified
group.
Initialize Group Punch Device Group name Sends only Punch Interpretation Rules to all
Interpretation Rules devices in the specified group.
Device, Group, or
DCM Event Connect Name Description
Initialize Group with Device Group name Sends device configuration data to all devices
Device Configuration in the specified group.
Initialize Group with Device Group name Sends the device configuration data selected in
Device Download Options download options to all the devices in the
specified device group.
Initialize Group with Device Group name Sends the device job transfer set to all devices
Device Job Transfer Sets in the specified group.
Initialize Group with Device Group name Sends Device Work Rules to all devices in the
Device Work Rules specified group.
Initialize Group with Device Group name Sends employee job transfer sets to all devices
Employee Job Transfer Sets in the specified group.
Load Device Firmware Device ID and File name Sends the specified file that contains the
firmware to the specified device.
Load Device Parameter File Device ID and File name Sends the specified AFT or XML file to the
specified device.
Load Group Firmware Device Group name and Sends the specified version of firmware to all
File name devices in the specified group.
Load Group Parameter File Device Group name and Sends the specified AFT or XML file to all
File name devices in the specified device group. The
group must contain compatible devices; for
example, all Series 4000 or all Series 400.
Reset All Transaction Resets the count values of successul and failed
Statistics transactions for all communication PCs to
zero.
Reset Communication PC Communication PC Resets the count values of successul and failed
Transaction Statistics transactions for one communication PC to
zero.
Resubmit All Failed None
Transactions
Set Device Date and Time Device ID Sends the date and time of the DCM
communication PC to the specified device.
Device, Group, or
DCM Event Connect Name Description
Set Group Date and Time Device Group name Sends the date and time of the DCM
communication PC to all devices in the
specified device group.
Start Data Collection Device Group name Starts online data collection for all devices in a
specified device group. This applies only to
online devices.
For example, you start data collection from all
devices in your accounting device group daily
at 12:00 A.M.
Stop Data Collection Device Group name Stops online data collection for all devices in a
specified device group. This applies only to
online devices. For example, you stop data
collection on the accounting device group at
1:00 A.M.
Update Device Employee Device ID Sends the changed employee and biometric
Biometric Data data to the specified device.
Update Device Employee Device ID Sends changed employee data for employees
List with no Schedules without their schedules to the specified device.
Update Device Employee Device ID Sends changed employee data, including
List with Schedules schedules, to the specified device.
Update Device with Device Device ID Sends changed application data specified in
Download Options the download options to the specified device.
Update Group Employee Device Group name Sends changed employee and biometric data to
Biometric Data all devices in the specified device group.
Update Group Employee Device Group name Sends changed employee data for employees
List with no Schedules without their schedules to all devices in the
specified device group.
Update Group Employee Device Group name Sends changed employee data, including
List with Schedules schedules, to all devices in the specified device
group.
Update Group with Device Device Group name Sends the changed application data specified
Download Options in download options to all devices in the
specified device group.
The asterisk (*) means that you must select the download option from the
Download Options dialog box for the data to be sent to the device. For all other
events, the Event Manager ignores whatever is selected in the Download Options
dialog box. It sends whatever you see in the Download Options column in the
table.
DCM Initialize Events Download Options
Initialize Device with Device Download Options Employees*
Initialize Group with Device Download Options Biometric Data*
Schedules*
Punch Interpretation Rules*
Totals*
Labor Levels*
Device Work rules*
Device Configuration*
Comments*
Pay Codes*
Device Job Transfer Set*
Employee Job Transfer Sets*
Initialize Device Employee List with Schedules Employees
Initialize Group Employee List with Schedules Schedules
Punch Interpretation Rules
Initialize Device with Device Configuration Device Configuration
Initialize Group with Device Configuration
Initialize Device with Device Work Rules Device Work Rules
Initialize Group with Device Work Rules
Initialize Device Employee Biometric Data Employees
Initialize Group Employee Biometric Data Biometric Data
Initialize DeviceEmployee List with no Schedules Employees
Initialize GroupEmployee List with no Schedules Punch Interpretation Rules
Initialize Device Employee Totals Employees
Initialize Group Employee Totals Punch Interpretation Rules
Totals
The following tables list the Initialize (download) and Update events and the
download options for each event. The asterisk (*) means that you must select the
download option from the Download Options dialog box for the data to be sent to
the device. For all other events, the Event Manager ignores whatever is selected in
the Download Options dialog box. It sends whatever you see in the Download
Options column in the table.
Update Device with Device Download Options and Update Group with Device
Download Options use the download options configuration for each device. If no
download options are selected that can be updated, the events do not update the
configurations. When you specify the Update Device with Device Download
Options or Update Group with Device Download Options event, you must also set
the appropriate download options.
Update Device Employee List with Schedules and Update Group Employee List
with Schedules update the employees with schedules, regardless of the download
options. By specifying the Update Device Employee List with Schedules and
Update Group Employee List with Schedules s event, you do not need to set the
download options.
Update Device Employees with no Schedules and Update Group Employee with
no Schedules update the employees without schedules, regardless of the download
options.
Event Description
CollectDomain Retrieves data from modem devices in a specified
domain. For example, you collect data from your
finance domain daily at 6:00 A.M. The event specifies
the domain
LoadDomain Sends all device configuration data to all the devices
in the specified domain.
LoadDomainActvityCodes Sends only Device Work rules to all devices in the
specified domain.
Event Description
LoadDomain Configuration Sends only device configuration data to all devices in
the specified domain.
LoadDomainEmployees Sends all employee-specific data to all the devices in
the specified domain.
LoadDomainEmployees Totals Downloads totals and accruals for all employees for
the specified domain.
LoadDomainFile Sends the specified AFT or XML file to all devices in
the specified domain. The domain must contain
compatible device— for example all Series 4000 or
all Series 400.
LoadDomainLaborLevels Sends Labor Levels to all devices in the specified
domain.
LoadDomainLaborLevels Sends only Labor Levels with No Reference Text to
NoRefText all devices in the specified domain.
LoadDomainRestrictionProfiles Sends only Punch Interpretation Rules to all devices
in the specified domain.
SetDateTimeDomain Sends the date and time of the DCM communication
PC to all devices in the specified domain.
UpdateDomain Sends changed application data to all devices in the
specified domain.
UpdateDomainEmployees Sends changed employee-specific data to all devices
in the specified domain.
UpdateDomain Sends changed employee data for employees without
EmployeesNoSchedules their schedules to all devices in the specified domain.
• The event executes the update program in the scripts directory. When the
program is run the program icon appears in the task bar.
Note: When renaming an event, you cannot change a letter from one case to
another case in the existing event name. For example, if the name of the event is
Collect first shift, you cannot rename it to Collect First Shift.
Event sets
You can store groups of DCM events in one event set file. You can select the
location for event sets or you can select the default location, which is the events
subdirectory in the DCM data directory. You can create copies of an event set and
copy it to other DCM communication PCs that are running an Event Manager.
After you configure an event, it is added to the working event set. If no other event
set has been created, the Event Manager displays that event set when you log on to
the Event Manager. After another event set is created, the Event Manager displays
the last event set that was opened.
To open an event set into Event Manager, select File > Open and select the
appropriate .evt file. Editing and saving an event set
Caution: The system saves event set files every five minutes. When editing an
event set file, changes may be saved without warning. If you want to save an event
file as is, select the event set and click Save As and edit the new event set file.
To copy an event set file, from the DCM Event Manager window:
1. Select File > Open and open the event set to be copied.
2. Click File > Save As. The Save As dialog box appears.
3. Specify the name of the new event set. The .evt extension is added by default
when you save the event set.
4. Click Save. The Event Manager dialog box appears with the event set name
included in its heading.
To remove event set files, delete files from the folder where the event set files are
stored. The default is C:\kronos\wfc\dcm\data\events. When you
open the Event Manager, all the event sets are deleted except the last-opened
event set.
– Caller Identifier
– Log Message
You can specify that the information be filtered so that only certain information is
displayed. To specify which log messages are displayed based on a specific
column-level attribute:
1. From the Filter Column drop-down list, select a column label (All, Date, Date
Time, Log Context, Log Level, Caller Identification, or Log Message).
If you select All, no filtering is done and the Look for field is not available.
2. In the Look for text box, enter the column entry that is to be used in a filtered
search. For example, if you chose Log Context in the Filter Column drop-
down list, you could enter DCM.UTILITYLIBRARY text box.
Entries in the Look for text box are case-sensitive. Log Context and Log
Level entries must be in capital letters. Caller Identifiers are mixed capital and
lower-case letters. If the Caller Identifier is DevMgr.exe, a search on
devmgr.exe does not find the Device Manager Caller Identifier. You can enter
any unique consecutive letters in your search. For example, for a Log Context
search, you can type API in the Look for text box and display all
DCM.APILIBRARY log messages. You can type ION or CONN to display all
DCM.CONNECTIONLIBRARY log messages.
You can abbreviate the date search. For example, if the filter is Date, you can
enter 09/04 to display all 09/04/2004 log messages.
3. Click Find Now. The log file displays the filtered information. Caller
Identifier for Sentinel displays DCM.SENTINEL log messages and Context
for Sentinel displays DCMUTILITYLIBRARY log messages.
4. To filter another search, change the Filter Column text box, specify your
search criteria in the Look for text box, and click Find Now.
5. To clear the search results and return to view the entire log, click Clear
Search.
The Log View displays the number of records found.To view the entire log
message, click on the message. The Details area displays the date and time, the
Log Context, the Caller Identifier, the Log Level, and the entire message.
Entry Description
Date Time Month, day, and year in mm/dd/yyyy format; and the time in hours,
minutes, and seconds in hh:mm:ss (24-hour) format when a message
was posted to the log file.
Source of The DCM module identifier (application or library) from which this
Message message is being logged.
Log Level Log level setup for the calling application (INFO, WARNING, ERROR,
or DEBUG).
Caller Identifier The calling DCM application name that is logging this message. For
example, commclnt.exe, appclnt.exe,
SentinelService.exe, and so on.
Message Text Message information, which depends on the type of the message.
The message for Net Check request example is logged from the Comm channel
Ether' (shown by Caller Identifier as Commclnt.exe) as the INFO (information)
message. The DCM module that wrote the message is the DCM API library
(shown by Source of Message DCM.APILIBRARY).
Note: Disable the Sentinel Service before archiving and purging transaction files.
This prevents transactions from occurring during this procedure. After modifying
or purging a transaction file, restart the Sentinel Service to ensure that it monitors
for the new modifications.
The following examples are based on different supported transaction types from
the devices. The format of the Data field is different starting from offset 63, based
on the transaction types. The format depends on the order of the data fields that
were received as part of the transactions from the devices. For more information
about the transaction formats, see the device documentation.
Data backups
Properly configuring your system is one of the most important things you do to
ensure maximum performance. In addition, be sure to back up your data and your
system regularly to ensure data integrity. All DCM data is contained in the host
application unless it is a standalone system and is included in the host application
backup.
For more information on backing up data in your application, see your application
documentation.
Overview
The Sentinel is always running when the Data Collection Manager system is in
operation. You can disable or enable from the Sentinel icon on the system tray or
on the Sentinel status window. The Sentinel launches and manages the application
connections and communication channel connections. If any one of these
processes stop, the data flow is interrupted. You can use the Sentinel to verify that
these processes are running. Every DCM communication desktop in the system
has a Sentinel process running on it.
Windows 2003 and Windows XP Professional can launch the Sentinel as a
Windows service. This ensures that the Sentinel remains running when you log off
the machine.
For more information, see “Providing enhanced database connection support” on
page 277.
The Sentinel performs the following tasks:
• Manages all the communication channels configured for processing on the
given system. The Sentinel Service starts, monitors, and stops the
communication channels.
• Manages all the application connections configured for processing on the
given system. The Sentinel Service establishes, monitors, and disconnects
application connections.
• Provides enhanced database connection support. When the Sentinel Service
starts, it requires a connection to the database; it does not start communication
channels or application connections without a database connection. If the
Sentinel Service cannot connect to a database, it retries to connect after a
fixed amount of time. When this time expires, the Sentinel Service lists an
error on the screen and in the log.
The Sentinel Service constantly checks the connections to the database during
its monitoring operations. If the database connection is lost during this
processing, the Sentinel Service shuts down all DCM application connections
and communication channels. During this period of time, a message appears
in the Sentinel Service window indicating that the Sentinel Service is
attempting to reconnect to the database.
The Sentinel Service then starts a thread that tries to reconnect to the database.
This thread attempts a connection, waits 60 seconds, and then retries. When
the connection is reestablished, the Sentinel Service restarts the DCM
application connections, communication channels and, if configured,
automatic data collection and the Event Manager.
• Monitors the DCM State Manager, which is a troubleshooting tool designed
for Kronos Global Support personnel.
• If the disk space falls below the minimum that is required, the Sentinel
Service shuts down all communication channels and application connections,
and enters error messages into the log file. When the required disk space
becomes available, the Sentinel Service restarts the DCM application
connections, communication channels, and, if configured, automatic data
collection and the Event Manager.
Sentinel startup
The Sentinel application starts the following processes:
• The communication channels and application connections.
• Data collection on devices that are enabled for automatic data collection
through their device group association. The communication channel
determines which devices have been enabled.
Communication channels
The Sentinel launches all the communication channels configured for processing
on that system, by using the following process:
1. The Sentinel queries the CommPC field in the DCMCommChannel table in
the DCM database.
2. If the CommPC field contains the current system name or is configured for
local processing, the Sentinel starts the communication channel by launching
the proper communication channel executable with the channel name. The
executable is either commclnt.exe for Series 400 devices or
commclnt2.exe for Series 4000 terminals. Communication channel
executables run in the background and do not present any user interface.
Note: Before any of the DCM applications can run, the Workforce Central server
must be running. If you start the Sentinel too soon, DCM applications send a
warning and wait for the Web server to start.
Application connections
The Sentinel establishes all the application connections configured for the local
system.
1. The Data Collection Manager determines on which system the application
processing launches. DCM determines this by checking the application
mappings in the device group configuration.
The Sentinel starts the application connection by launching the application
client executable with the application connection name.
2. For each application connection, an application client starts processing all
application messages.
The application-specific connection library processes all DCM messages for a
given application. The application-specific connection library validates and
posts the DCM messages, including punches and transactions, to the
application client’s database.
The application client, which is managed by the Sentinel, requires access to the
Workforce Central server during startup. If the server is not available, the
application client keeps punches in a .q or .qin file.
Sentinel icon
The information that appears on the Status section of the Sentinel Service Status
window is for viewing only and cannot be edited.
The Process Names appear. A check mark in front of a process name indicates that
the application is running and no identified problems are associated with the
application. Each process is either Running or Not Running.
The System Status display uses symbols about the system status. A yellow
triangle with an exclamation point in front of the process name is a warning sign.
The following error messages appear with a red x:
• Disk space low.
Shutting down all Communication Channels, Application Connections and
DCM Core Service appears when the disk space is too low.
• Unable to establish a connection to the database
appears when the database connection was lost or was never established.
• Sentinel Service is not ready appears when the service was
started but was not completed due to an error.
• Please wait while the Sentinel Service is stopping
appears when you click Disable.
• Please wait while the Sentinel Service is starting
appears when you click Enable.
• The Sentinel has been disabled appears when the Sentinel Service
is not running.
• Application Server configuration has not been
complete appears when the Workforce Central application server
connection has not been configured.
To change the database that DCM uses to collect and store data:
1. Right-click the Sentinel icon and click Status. The Sentinel Service Status
window appears.
2. Click Properties. The Sentinel Service Properties dialog box appears.
3. Click the Database tab.
4. On the Database tab, edit the database Data Source Name, the user name, and
the password for an SQL Server database connection, or edit the database
Data Source Name, the System Identifier, the database server, and the port
number for an Oracle database connection.
5. Enter the password again to confirm it.
6. Click OK.
Caution: Collect all data before changing the information in the application
connection. Do this to avoid routing information to the wrong destination.
Note: Disable and Enable on the Sentinel Status window disables or enables the
Sentinel, not a communication channel nor a DCM application.
Sentinel shutdown
When the Sentinel shuts down, it shuts down all the communication channels that
it started on the local system, following this process:
1. The Sentinel retrieves a list of all communication channels running on the
communication PC.
2. The Sentinel posts a DCM request to shut down the channel.
3. If a communication channel is processing when it receives a shutdown
request, it finishes processing the request, and then shuts down.
When the Sentinel shuts down, it posts a Windows message to each application
client to shut down and continues its shutdown processing.
Note: Before any of the DCM applications can run, the Workforce Central server
must be running, and it may take up to 10 minutes or more to be ready. Start the
Sentinel Service after that. If you start the Sentinel Service too soon, DCM
applications send a warning and wait for the Web server to start.
To obtain the part number of the Series 4000 terminal, do either of the following
steps:
• Look at the bar code label on the bottom of the terminal (the underside of the
terminal as you look at the display and keypad). The part number is directly
above the bar codes.
• If the Series 4000 terminal uses firmware version 2.0 or higher, access
Maintenance mode at the terminal and run the Hardware Report. The part
number of the terminal is included in the report output on the screen.
Important: If you are not using DCM version 6.0, refer to the Series 4000
version 2.2 Release Notes to see the minimum release numbers of DCM
versions 4.8, 5.0, and 5.1 that you can use to load .krm or .krl terminal
firmware files.
• DCM initiates and controls the softload process with the Series 4000 terminal.
The terminal displays a message indicating that a softload is in progress. You
cannot enter information at the terminal while the softload is in progress.
• The softload process restarts the Series 4000 terminal and removes all data
except communication settings from the terminal. After the softload process
finishes, use DCM to restore terminal configuration settings, the date and
time, and employee data to the terminal. Employees cannot use the terminal
until the terminal has been initialized with employee data.
• To upgrade a Series 4000 terminal from a firmware version lower than 1.3 to
version 2.2, you must first softload firmware version 1.3. Then, softload
version 2.2.
• If you upgrade a Series 4000 terminal from firmware version 1.3 to version
2.2, the Telnet-FTP setting on the Comm Settings screen is set to “No”
regardless of what the setting was before you performed the upgrade. For
example, if the Telnet-FTP setting for your terminal was “Yes” before the
upgrade, the setting after the upgrade changes to No. After you upgrade the
terminal, change the Telnet-FTP setting to Yes.
If you upgrade a Series 4000 terminal from firmware version 2.0 to version
2.x, the Telnet-FTP setting does not change as a result of the upgrade.
Complete the following steps before softloading new firmware to your Series
4000 terminal:
1. Verify which firmware version your Series 4000 terminals are currently using.
Do this in either of the following ways:
– With the terminal in Maintenance mode, run the Device Status Report.
– If your host application is Workforce Timekeeper, use Device Manager
(DCM) to run Get Device Report.
Important: If the terminals are using a version of firmware lower than 1.3,
the upgrade procedure requires you to softload version 1.3, and then softload
version 2.2.
Series 4000 terminals with firmware versions 1.3.x and earlier have FTP
enabled and use the default user name and password. The Use Default
User ID and Password box should be checked.
Series 4000 terminals with firmware versions 2.0.x and later versions
have FTP disabled by default. You must access Maintenance mode at the
Series 4000 terminal and enable FTP using the Telnet-FTP setting on the
Comm Settings screen. You may also change the user name and password
from their default values. User names and passwords that you enter at
Series 4000 terminals can be only numbers and uppercase alpha
characters (if the terminal has an alpha-numeric keypad). Ensure that the
same user name and password that are set at the terminal, are also set in
DCM for that terminal.
4. Verify that the DCM Sentinel has been launched and that all Series 4000
communication channels are running.
5. Plan the best time to upgrade the terminal firmware with the following
information in mind:
– If you use punch restriction rules at the Series 4000 terminals, plan to
perform the softload procedure between shifts, if possible, to avoid
employees having problems with punch restrictions after you initialize the
terminal. (You need to manually initialize the terminals after the softload
process finishes. Instructions for initializing the terminals are presented
later in this section.)
– The amount of time it takes DCM to softload (transfer) the firmware to a
Series 4000 terminal varies. Also, the softload process takes significantly
longer for terminals using modem communication than it does for
terminals using Ethernet communication. If the terminals are equipped
with the Kronos® Touch ID® verification devices, the process may take
longer. After the firmware is softloaded, the terminals restart themselves.
The restart process for each terminal generally takes 3 to 5 minutes to
complete. If a biometric verification device is attached to a Series 4000
terminal, the terminal takes 6 to 9 minutes to restart.
– The process of re-initializing the terminal may take several minutes,
depending on the processing power of the computer; and the amount of
data that Data Collection Manager must query, generate, and send to the
Series 4000 terminal.
Upgrading Series 4000 terminals from version 1.3 firmware to version 2.2
Important: You cannot upgrade directly to firmware version 2.2 from a firmware
version lower than 1.3. If the terminal is currently using a firmware version lower
than 1.3, you need to perform two softloads: one to upgrade to version 1.3, one to
upgrade to version 2.2.
To upgrade from version 1.3 firmware to version 2.2, read and perform the
following steps carefully:
1. Use DCM to collect data from the terminal.
2. If your Series 4000 terminals are equipped with Kronos Touch ID verification
devices, you must collect the biometric templates from the terminals.
Note: If you are using a version of Kronos Touch ID software that is earlier
than 2.0, collect the biometric templates using the Kronos Touch ID version
1.x application according to instructions in the Kronos Touch ID Enrollment
Kit Installation and User’s Guide.
If you are using Kronos Touch ID version 2.0 or higher, use Data Collection
Manager (DCM) to collect the biometric templates from the terminals. Be
sure to select the Employee Biometric Data option as one of the download
options in DCM.
When you collect the biometric templates from the terminals, the template
information also remains resident in the finger scan verification devices so
that the terminals can perform biometric verification.
3. Access the DCM Device Manager application.
4. Select one or more Series 4000 terminals or device groups in the left pane of
the Device Manager window.
7. Click Open. DCM begins softloading the firmware to the selected Series
4000 terminal or device group. The screen on the Series 4000 terminal
displays text indicating the progress of the softload function.
8. After the firmware loads successfully:
– If you loaded the version 1.3 .krm file, go back to step 5 to perform
another softload. This time, select the version 2.2 .krl file.
– If you loaded the version 2.2 .krl file, proceed to the next step.
9. To upgrade the terminals to use the Smart View functionality, go to
“Upgrading Series 4000 terminals to include Smart View functionality
(optional)” on page 286.
To upgrade the terminals without the Smart View functionality, go to
“Initializing Series 4000 terminals after you softload the firmware (required)”
on page 288.
If you have upgraded Series 4000 terminals to firmware version 2.2, and want to
add Smart View functionality:
1. If you upgraded the terminal to 2.2 firmware and the terminal part number is
8602000-xxx:
a. Order the Memory Upgrade Kit that contains an M-SYSTEM flash disk
and 32 Mb SDRAM memory chip needed to support Smart View
functionality.
b. Follow the instructions that come with the Memory Upgrade Kit to install
the disk and memory chip.
If you purchased a terminal with version 2.2 firmware already installed, the
terminal is already equipped with the M-SYSTEM flash disk and SDRAM
memory chip necessary to support Smart View functionality.
2. Use DCM to collect data from the terminal.
3. If Series 4000 terminals are not equipped with Kronos Touch ID finger scan
verification devices, go to step 4.
If Series 4000 terminals are equipped with Kronos Touch ID finger scan
verification devices, you must collect the biometric templates from the
terminals.
Note: If you are using a version of Kronos Touch ID software that is earlier
than 2.0, collect the biometric templates using the Kronos Touch ID version
1.x application according to instructions in the Kronos Touch ID Enrollment
Kit Installation and User’s Guide.
If you are using Kronos Touch ID version 2.0, use Data Collection Manager
(DCM) to collect the biometric templates from the terminals. Be sure to select
“Employee Biometric Data” as one of the download options in DCM.
When you collect the biometric templates from the terminals, the template
information also remains resident in the finger scan verification devices so
that the terminals can perform biometric verification.
4. Using DCM Device Manager, select one or more Series 4000 terminals or
device groups in the left pane of the Device Manager window.
b. Click Open. DCM begins softloading the firmware to the Series 4000
terminal or device group you selected. The screen on the Series 4000
terminal displays text indicating the activities being performed by the
softload function.
7. Initialize the terminal. For instructions, go to “Initializing Series 4000
terminals after you softload the firmware (required)” on page 288.
Initializing Series 4000 terminals after you softload the firmware (required)
After you softload the firmware to the Series 4000 terminals, you must reinitialize
the terminals to restore configuration and employee information. To initialize the
Series 4000 terminals:
1. Ensure that you do not initialize terminals during the times when many
employees are performing transactions at those terminals (for example,
punching in or out for shifts). This ensures that the initialization process will
not adversely affect the results of those transactions.
2. Test the communications to the terminals to which you softloaded the
firmware to ensure that the softload and rebooting processes have finished. If
you cannot communicate to one or more of the terminals, wait a few minutes
and try to communicate again.
3. From the Device Manager, select Communications > Set Date and Time
(optional for Series 4000 terminals).
4. Use the Device Manager to initialize the terminals, specifying device
configuration and other information that needs to be restored to the terminals
(for example, employees, labor level entries, and schedules).
5. From the Device Manager, select Communications > Set Date and Time.
6. If the terminals you upgraded were configured for online data collection, the
terminals do not continue performing online data collection after the softload
process finishes. Use DCM to restart online data collection for those
terminals.
7. If your system uses Kronos 4500 Touch ID version 1.x, proceed to the next
section, “For Kronos 4500 Touch ID version 1.x users only: Sending
biometric templates to the Series 4000 terminals” on page 289.
If any of the terminals that you upgraded are equipped with Kronos Touch ID
finger scan verification devices, you must send the biometric templates to the
verification device so that the terminal prompts employees for biometric
verification when they swipe in and out.
Note: You can perform this procedure for only one terminal at a time.
6. Repeat this procedure for each upgraded terminal that is equipped with a
finger scan verification device.
If you are using Kronos Touch ID version 1.5:
Softload failure
Caution: Do not remove power from the Series 4000 terminal while it displays
the Softload waiting for client message. This could result in the
inability to complete the Load Firmware operation, and require the Series 4000
terminal to be returned for repair.
Hardware/firmware incompatibility
If the hardware configuration of the terminal you are trying to upgrade is not
compatible with the firmware version you are loading, DCM displays error
messages. “Hardware configuration” refers to the version of the main board the
terminal uses, and the memory and flash disk that is installed.
An example of a hardware/firmware incompatibility error message is:
-906#Load Device#Softload failed preparing file activity
list for softload (011D8015), 770 - Incompatibility between
Device Hardware(SUPPORTED_400_SDRAM16M_0F8M_1F8MMIN) and
Requested Software(02.02.00.xx)##
where xx represents the build number of the terminal firmware.
The message states that the firmware you are trying to load to the terminal
(02.02.00.xx) is not compatible with the hardware configuration represented by:
SUPPORTED_400_SDRAM16M_0F8M_1F8MMIN
Loading firmware
To load firmware to a device or group of devices:
1. From the Data Collection Manager main menu, select Device Manager.
2. From the Device Manager main window, select one or more devices.
3. Select Communications > Advanced > Load Firmware.
4. Select the file to load.
As the Device Manager completes loading the program to each device, the
message “Download Complete” appears in the status window.
If the status window lists a message that DCM’s attempt to load the program was
unsuccessful, note the message number and check it in “Troubleshooting” on page
301 for help.
For more information about loading a program, search on load program in the
online Help index or click Help from the Device Manager main window.
Note: Collect all punches in the device before loading a parameter file to the
device. Otherwise, the device does not collect these punches. The parameter file
that you load to the device overrides the configuration that is stored in the device.
Use this load parameter file utility only if you are an advanced user.
The following procedure extracts the parameters to the deviceID.prm file and
then imports the deviceID.imp file into the database.
To extract a parameter file from a device:
1. From the Data Collection Manager main menu, select Device Manager.
2. From the hierarchical tree in the Device Manager main window, select the
device to extract the device configuration.
3. Select Communications > Advanced > Extract Device Parameters.
DCM system properties determine whether or not a parameter file is deleted
or not after a device configuration is extracted. For more information about
deleting or saving parameter files, see “System Settings” on page 114.
Note: DCM supports importing only AFT parameter files to device configurations
that are stored in the database. Importing XML files is not supported.
Note: You can copy the commands in the deviceID.imp file into the AFT
Commands tab in the Configuration Options dialog box to update the
configuration in the database, or download the AFT Commands to a device.
An Export Parameter File command retrieves information from the database and
places it in a file named deviceID_exp.aft. For Series 4000, Export
Parameter File generates a manifest file (deviceID_exp.mft) and multiple
XML files. The exported file contains some or all the following: supported device
configuration commands, and all commands entered in the AFT Commands tab in
the Configuration Options dialog box.
If you are using a non-Series 4000 terminal, one file is returned. If you are using a
Series 4000 terminal, two or more files are returned. One of the Series 4000
export files is an XML manifest file that lists, in order, the exported XML files.
Note: Before changing the date or the time on your DCM communication PC,
shut down all DCM applications, including the Sentinel. When you restart DCM,
you must send the date and time to all devices.
You send the date and time to devices by using one of the following methods:
• Select all device groups as a shortcut to sending the date and time to all
communication channels and devices connected to the DCM communication
PC.
• Select a device group as a shortcut to sending the date and time to all
communication channels and devices associated with that device group.
• Select a communication channel as a shortcut to sending the date and time to
all devices associated with that communication channel (Device Manager
only).
• Select a specific device.
You set the date and time by using the Communication Monitor or the Device
Manager applications.
This chapter provides instructions to view software and hardware properties and
the procedures for solving problems that you encounter while using the Data
Collection Manager system. It describes the transaction output file and lists and
explains error messages.
This chapter contains the following sections:
• “Series 4000 terminal and configuration reports” on page 302
• “Troubleshooting procedures” on page 306
• “Optimizing Ethernet timeouts on busy networks” on page 321
• “Viewing application connections and communication channels” on page 322
• “Reading a transaction output file” on page 323
• “Labor level settings” on page 325
• “Troubleshooting with the Communication Monitor” on page 326
Chapter 12 Troubleshooting
Note: If you selected multiple devices, you are not prompted to view the
reports.
You may also view reports by opening them in a text editor program from the
DCM\data\reports folder.
Note: Each time you run a device report, any previous device report for that
device is overwritten.
2. Edit the text line containing: Record llid="1" value="100" to include the labor
level number and labor level entry name of the labor level entry. For example,
if the labor level entry name is 301 and the labor level is level 3, edit the line
as follows:
Record llid="3" value="301"
3. Save the file as plain text with the .xml extension.
Note: Each XML file can contain return information for one labor level entry
only.
Troubleshooting procedures
The following sections provide troubleshooting procedures to solve common
problems within DCM:
• “Setup and configuration” on page 307
• “Operation/data collection modes” on page 315
• “System faults and recovery” on page 318
These sections list error information and the solutions using the following format:
• Problem—Description of problem
• Environment—Client PC (local device), network, host applications
• Solution—Client PC (local device), Ethernet, modem, and serial
Environment Solution
Serial device Check the following items concerning the serial communication channel
connection to the device:
1. Is the port set up properly?
• Is the baud rate/COM port set properly in the Device Manager?
• Is there a port conflict? Is another resource is trying to use the port at
the same time?
• Is the cable plugged in?
• Is the Smart Converter (if used) set up properly?
• Is the device ID correct in the Device Manager?
• Does the device model setting match the physical device?
2. Are the device/device settings set up properly?
• Does the baud rate match PC settings?
• Is the device ID correct?
3. Are the applications and communication channels running in the
Sentinel? If they are not running, restart them. Also, try stopping and
restarting each application and communication channel.
4. Verify that the device that you are trying to communicate with has
the correct boot prom and application firmware, by doing either of
the following:
• Check the boot prom and application firmware at the device.
• Test the device in the Device Wizard. If the test is successful, the
device has the correct boot prom and application firmware.
Environment Solution
Ethernet device Check the following items for the Ethernet communication channel
connection to the device:
1. Is the Ethernet connection set up properly?
• Is there a conflict/error with the configuration of the Ethernet
interface on the PC? Verify that your Windows network settings are
configured correctly.
• In the Device Manager:
• Is the IP address correct? Make sure you are able to ping the device
by using that IP address.
• Is the device ID correct?
• Is the cable plugged in?
• On a Series 400 device or the Series 4000 terminal, check that the
green link LED located inside the device is lit, and check that the
green link LED on the hub or switch is also lit.
2. Are the device/device settings set up properly?
• Is the IP address set at the device?
• Is the device ID correct?
• Is the IP address being used by another network device?
3. Are the applications and communication channels running in the
Sentinel? If they are not running, restart them. Also, try stopping and
restarting each application and communication channel.
4. Does the device that you are trying to communicate with have the
correct boot prom and application firmware? Check by doing either
of the following:
• Check the boot prom and application firmware at the device.
• Test the device in the Device Wizard. If the test is successful, and
then the device has the correct boot prom and application firmware.
Environment Solution
Modem device Check the following items for the Series 400 modem communication
channel link connection to the device:
1. Is the modem set up properly?
• In the Device Manager, check the following:
• Is the phone number where the device is located correct?
• Is the device ID correct?
• Does the device model setting match the physical device?
• Does the baud rate match the device baud rate?
• Is the COM port setting correct?
• Are miscellaneous communication settings in the Comm Channel/
Advanced and Comm Channel/Modem screens correct?
• Is the modem configured correctly? Refer to the modem manual.
• Is the telephone network functioning properly?
• Is the dial-up delay is excessive?
• Is the modem string correct?
2. Are the applications and communication channels running in the
Sentinel? If they are not running, restart them. Also try stopping and
restarting each application and communication channel.
Environment Solution
Network, Serial Use an administrator’s PC to configure the settings for one or more
communication PCs.
1. Is the communication PC for the devices configured correctly for
network operation?
• Is there a conflict/error with the configuration of the Ethernet
interface on the PC?
• Are the Windows network settings configured correctly?
• Is the data collection computer name correct?
• Ensure that the proper computer name is assigned in the Windows
settings.
2. Is the communication PC functioning?
• Use Microsoft networking utilities to confirm that the
communication PC is in operation.
3. Is the administrator’s PC configured correctly?
• Is the computer name correct?
Ensure that the proper name is assigned in Windows settings at
the administrator’s PC.
4. Are the database location and/or location settings correct?
5. See the problem, “I get database error messages whenever one of my
DCM applications attempts to read or write information,” on page
11-9 for more information about troubleshooting database errors.
6. Is the administrator’s PC functioning properly?
• Use the Windows utilities to confirm general network operation.
PROBLEM: I get an error message such as “Comm driver error code [-4].”
Environment Solution
Biometric device When you initialize two or more Series 4000 biometric devices with
only the download command “Employee with (or No) Schedules"
option selected, you may see a download failure for one or more of the
clocks if they are using firmware Version 1.3.3.2 or earlier.
If you observe this problem, upgrade the firmware for your Series
4000 terminals to Version 2.0.
PROBLEM: I get an error message such as “Comm driver error code [-6].”
Environment Solution
Serial Your system may be unable to respond within the set timeout period,
due to CPU resource issues. You must adjust the timeout to allow for
additional response time.
The amount of time that you should allow depends on the number of
processes running on the system and the extent to which CPU
resources are being used. More processes and resources in use may
require a larger timeout value.
For more information, see Advanced tab in “Series 400 Ethernet
communication” on page 56 and “Registering a new communication
PC” on page 424.
Environment Solution
Series 4000 Check the configuration of the TCP/IP and redialing properties in your
terminal with a dial-up connection. Your dial-up connection may have the Use as
modem default gateway check box selected. For more information, see
“About dial-up networking” on page 47.
Environment Solution
Modem Open the Advanced Modem Settings dialog box and increase the Wait
after hang-up value to 4000 msec. For more information, see “Series
400 Ethernet communication” on page 56.
Environment Solution
Client PC If you are running the entire DCM system on a local communication
PC, database error messages indicate the following:
1. The database server is not running properly.
a. Ensure that the database server is running on the database PC.
b. Ensure that the DCM data source is configured for the proper
database server.
2. The DSN may not be correct. Check the ODBC settings in the
Control Panel.
3. The database that is a component of your system may exist in the
wrong location or may not exist.
Caution: The application database file contains application-specific
records. Unless you are directed by a service representative, do not
attempt to use database development tools to alter the internal records
in the database file.
a. Execute the ODBC administration program on your Windows
system. Verify that a DSN exists for the application database.
Record the location (path) of the database file.
b. Use Microsoft Explorer to ensure that the database file exists in
the ODBC-assigned directory. If it does not exist, perform a
system search for the file. If you locate it, move it to the
assigned directory.
c. Check that the database is set as read-write, not read-only.
d. Check that the database file has not been corrupted.
4. The connection may be broken. Use the Test Connection function
in the ODBC setup to check connectivity.
Network If you configured your data collection system for database access
across a network, database error messages indicate the following:
• The remote system is inaccessible.
• The database file resides in the wrong location on the remote
system.
• The ODBC DSN is not configured to point to the proper location of
the database on the remote system.
• The database on the remote system is set as Read-Only.
• The database file is corrupted.
PROBLEM: I have added a device group to the database, but it does not appear
on the device group/communication channel tree in the Device Manager.
Environment Solution
Setup Device groups are not shown on the tree until you assign devices to
device groups. To assign devices:
1. Create records for the devices and communication channels (if they
do not already exist).
2. Use Setup > Assign Devices to Groups to add the devices to your
device group, by using one or more of the communication channels
that you created.
Environment Solution
Database To enhance performance, do one of both of the following:
• If a segment of the network is particularly slow, move the database
to another location in the system.
• If the server PC is not fast enough, change servers.
Environment Solution
Database When the system tried to build an employee without schedules list for
download to the device, the database error message indicates:
• An Oracle database needs increased TEMP space.
• The database needs maintenance and reindexing.
PROBLEM: The log file does not contain all the transactions/messages that I
expect to see.
Environment Solution
Setup Log messages are posted in the DCM centralized log file based on the
log options defined in the System Properties in the Device Manager
application. For more information about the DCM log file, see “Log
File settings” on page 118.
PROBLEM: An attempt to process trx.in files by copying OUT files and re-
naming them results in all files being marked with a .failed extension on the
files. No punches are processed through the system.
Environment Solution
Setup The existence of .failed files indicates that DCM is handling the
request. If you see this type of file, consider the follow conditions that
may lead to its creation:
• No groups are present on this communication PC.
• The group is on another communication PC or is not assigned.
• DCM is not renaming a file in process.
• DCM failed to write to app.q.
• DCM cannot open a server connection.
Environment Solution
Application Some error messages are logged for the WFCAPI integration into the
connection connection library (krdcmwfc4.dll). These error messages do not
appear on the user’s display. The following error messages are written
to the centralized log file in the data\logs\commpc subdirectory.
• Error in loading WFCAPI library
• Failure in connecting to the database
• Error in validating Username/Password for WFCAPI connection
• Error in queue message data
• Error in user logout for WFCAPI connection
• WFCAPI error during call to get Bulk Accruals
• WFCAPI error during call to get Bulk Totals
• WFCAPI error during call to get Labor Level Sets
• WFCAPI error during call to get Biometric Data
• WFCAPI error during call to get Smart Views
• Application Server failure or Network failure occurred
• Failed to add invalid transaction - Device ID
PROBLEM: I do not see any particular error messages but the application does
not appear to be receiving any transactions.
Environment Solutions
Application To verify that transactions are being collected at the device and
processing prepared for delivery at the communication PC:
1. In the Device Manager, select Communications > Test Device
Communications to verify that the device is online.
2. In the Sentinel verify that the necessary applications and
communication channels are running.
3. Use the Communication Monitor to verify that transactions are
being picked up and posted to the application input queue.
4. Use the Device Manager to verify that there is an associated
application entry for your application and that the entry includes
the proper communication PC.
5. Verify that all the system paths are mapped properly.
PROBLEM: I am not receiving any transactions from all the devices connected
to a particular communication PC in my network.
Environment Solution
Application Use the Windows network tools (for example, Microsoft Explorer) to
processing verify that the communication PC is visible according to its computer
name, or do the following:
1. Verify that the computer name is correct.
2. Use the Device Manager to test device communications.
3. Verify that the communication channels all reference the same
computer name.
4. Stop and restart the Sentinel.
Environment Solution
Application These errors usually indicate faults in the following areas:
processing • The application is not registered with the data collection system.
• The computer name is not correct. For more information, see
“Communication Channels” on page 37 and “Setup and
configuration” on page 307.
Do the following:
• If you have opened the Device Manager, close and restart it.
• If no communications are reestablished, stop and restart the
communication channel by using the Sentinel application.
• The local disk is full.
• Be sure each PC in your data collection environment is accessible
and has sufficient disk space.
• Be sure each PC or server used for data collection has been set up
with access rights to the other PCs. See the Workforce Central Data
Collection Manager Installation Guide for more detailed
information.
• Use the Microsoft Windows utility Network Neighborhood or the
Explorer to verify that the PC is accessible.
Environment Solution
System In the Communication Monitor, use the Device menu to enable or
monitoring disable the transactions to list.
Environment Solution
Application On the Sentinel Service Status window, click Properties, correct the
processing database account information, and click OK.
Environment Solution
Application Do the following:
processing 1. Make sure that the database is up and running.
2. Close and restart your DCM applications.
Environment Solution
Host Verify that the ...\kronoscm\dcm entry is in your path.
applications You do not see these messages if your communication PC is
running only DCM, as recommended.
Environment Solution
DCM Restart the application from the DCM menu to update the Workforce
applications Timekeeper cross-launch information properly.
Environment Solution
System In a system operating with one or more NIC cards, a socket notification
sync error may be generated and Windows aborts the program that is
running or waits to shutdown the computer.
Complete the following steps in order until the problem is corrected.
Do not complete more steps than are necessary to eliminate the error:
1. Update the application or service that is generating the error.
2. Update your computer's NIC device drivers and any other network
adapter drivers you may have on your computer. For more
information on updating device drivers, refer to Window's online
help about using the Device Manager or consult the documentation
that came with your hardware.
3. Check the TCP/IP setup of the computer and make sure that it is
installed and properly configured.
4. Update as many as possible of the services installed and running on
your computer. See the list of these services at Start > Settings >
Control Panel > Administrative Tools > Services.
5. Download and save the latest NIC driver. Go to Start > Settings >
Control Panel > Administrative Tools > Computer
Management > Device Manager > Network Adaptors.
6. Remove the NIC/network devices from the network device list and
then complete the following steps:
a. Shut down and turn off your computer and physically remove
your NIC/network hardware.
b. Reboot your computer and reinstall the drivers for the hardware
even though the hardware is not attached.
c. Shut down and turn off your computer.
d. Re-attach your network hardware in the computer.
e. Turn on your computer and follow the instructions for new
hardware in the configuration wizard.
Environment Solution
Devices Although it is possible to enter non-ASCII characters in the host
application, do not use such characters in any data sets that you expect
to be downloaded to the device.
Such data sets include, but are not limited to, employee names,
schedule names, pay codes, accrual profiles, labor level definitions and
entries, and global messages.
Environment Solution
Application The Workforce Central application server was restarted and it is not yet
server fully running.
Wait several minutes to be sure the application server is running before
you initialize or update again.
Environment Solution
Devices If a communications or other error occurs during a Load Firmware
operation to a Series 4000 terminal, DCM eventually stops the Load
Firmware operation and displays or logs an error message, such as
Softload failure while file loading was in
progress. The Series 4000 terminal displays Softload
waiting for client. From Device Manager, retry the Load
Firmware request to the terminal.
Caution: Do not remove power from the Series 4000 terminal while it
displays Softload waiting for client. This could result in
the inability to complete the Load Firmware operation, requiring the
Series 4000 terminal to be returned for repair.
To set Ethernet timeout values for the communication PCs and devices, do the
following:
1. Close all data collection processes running on the communication PC.
2. Select Setup > Comm Channels.
3. Highlight the appropriate communication channel and click Edit.
4. Increase the Response Timeout. The maximum allowed is 5 seconds.
Note: Set the timeout value for the device equal to the timeout value for the
communication PC.
For more information on the Sentinel, see “Using the Sentinel” on page 267.
If transactions are not picked up by the device, check the Sentinel to make sure
that the following components are operational for the device:
• Communication channel
• Application connection
• Data collection for the given device group
• Database connection
If the database is not running, a message appears at the bottom of the Sentinel
Status window. In this case, the Sentinel continues to reestablish connection
with the database. When the connection is successful, the Sentinel
automatically restarts the applications and communication channels.
Note: Disable the Sentinel before archiving and purging transaction files. This
prevents transactions from occurring during this procedure. After modifying or
purging a transaction file, restart the Sentinel to ensure that it monitors for the new
modifications.
Entry Description
Date/Time Month, day, and year in mm/dd/yyyy format; and the time in hours,
minutes, and seconds in hh:mm:ss (24-hour) format when a message was
posted to the transaction output file.
Source Device group or communication channel that created and posted the
message to the transaction output file.
Note: If the Source field contains a colon, the information following the
colon is the computer name in which the device group or communication
channel is running. In the previous example, Ethera is the device group,
and SYSTEM12NT is the computer name.
Entry Description
Type String The type string consists of the different types of messages posted to the
transaction output file; they include the following types:
• Completion Status - designates that the transaction has completed
• Collect - standard
• Connect - standard
• Device Out Of Service - designates that communication did not occur
with a specific device
• Device Status - standard
• Get Date Time - standard
• Host Report - host application-related
• Load Configuration - initialize or update
• Load File - standard
• Load Program - load firmware
• Load Trx (Transaction) Table
• Message Response
• Net(work) Check - check for one or more device
• Parameter Save
• Process Error - contains information about a processing error that
occurred
• Process Status - contains interim information about a request
• Set Date/Time - standard
• Start DC - standard
• Stop DC - standard
• Transaction - punch/trx
• Transaction Response - designates a response to a device trx from an
application
Type Numeric message type ID.
Pwd Device ID and password of the device.
Data Message content, such as error strings, transactions, requests, and
response strings.
Note: The Data entry for responses also includes the following numbers:
0 = Operation complete
1 = Device status
2 = Download complete
3 = Collect complete
[000123]
LaborEntriesUpper=0 // 0=unaltered (default), 1=uppercase
[Configuration Services]
LaborEntriesUpper=1 //0=unaltered (default), 1=uppercase
Error messages
This section contains lists of error codes and messages for the Data Collection
Manager and their resolutions.
The following list provides a quick synopsis. For more information or further
assistance, contact your service representative.
Format
Communication channel error messages have the following format:
<error code>#{device}#<text>{optional text}#{file
name}#{phone number}{IP address}
Where:
<phone number> is the optional telephone number of the remote device(s) that is related
to the error.
<IP address> is the optional IP address of the remote device(s) that is related to the
error.
The format of the error messages in the Communication Monitor and log files
differs from that shown above. The format shown above is internal to the
communication channel.
Serial and modem devices generate the following error codes. Error codes -1
through -22 (listed in the Error Code column) indicate problems with direct
connect serial communication. If these errors occur infrequently, the
communication channel typically recovers automatically. If the errors become
excessive, take one or more of the following actions:
• Verify that the communication cable is hooked up and properly wired.
• Verify that the same serial comm parameters are set in the device(s) and in
Device Manager.
• Choose a lower baud rate.
• Increase the intermessage delay.
• Increase the message begin timeout.
Note: In the following table, “See list above.” refers to these five actions.
Error
Code Text Description/Action
-1 No DSR (check cable) See list above.
-2 RTS ON; unable to transmit See list above. Check Smart Converter or hub
configuration.
-3 No DCD (receiver timeout) See list above. Check Smart Converter or hub
configuration.
-4 No STX (receiver timeout) See list above.
-5 Bad check-sum See list above.
-6 Bad sequence number See list above.
-7 Receiver timeout See list above.
-8 Short I-Frame (receiver See list above.
timeout)
-9 Bad character received See list above.
-10 No CTS (hand-shake timeout) See list above.
-11 DCD ON timeout See list above.
-12 Transmit failed See list above.
-13 No comm port Verify that the port exists and is enabled on the
communication channel PC. Also, see list above.
-14 I-Frame too long See list above.
-15 Status check failed See list above.
-16 Wrong device responded See list above.
-17 Attempt to send before device See list above.
EOT
-18 Device is not selected See list above.
-19 Receiver overrun See list above.
-20 Attempt to read device after See list above.
EOT
-21 Bad packet size See list above.
-22 Bad ETX See list above.
Error
Code Text Description/Action
-23 Modem fault; echoing Verify that the modem is properly configured and
connected to the telephone line. Retry the operation.
-24 Modem not ready Verify that the modem is properly configured and
connected to the telephone line. Retry the operation.
-25 Modem dial failed Verify that the modem is properly configured and
connected to the telephone line. Adjust the telephone
number or modem string assigned in Device
Manager. Retry the operation.
-26 Carrier lost Verify that the modem is properly configured and
connected to the telephone line. Retry the operation.
-29 Unrecognized error code Contact your service representative; <code> contains
[<code>] the unrecognized error code.
Error
Code Text Description/Action
-30 Model not initialized The comm driver does not determine the host
command offset because it was not initialized with
the device model family. Verify that there is only one
copy of DCM program files and libraries on the PC.
Reinstall everything, if necessary.
-31 Command not supported The comm driver does not translate the host
command (by host command offset) because the
command is not supported by the device model
family.
Error
Code Text Description/Action
-32 FIFO file not supported The comm driver does not drain the FIFO of the
specified device because no file name was given for
the temporary punch file. Verify that there is only
one copy of DCM program files and libraries on the
PC. Reinstall everything, if necessary.
-33 Opening FIFO file The comm driver does not drain the FIFO of the
specified device because it does not open the
temporary punch file. Retry the operation; if
unsuccessful, contact your service representative.
-34 Device application not The comm driver does not perform a parameter save
running on the device in boot mode. Run the application in
the specified device and retry the operation.
-48 Host report not enough The comm driver tried sending a host report to a
memory device without enough memory to store the report.
Reconfigure the device to increase memory, or delete
host reports stored on the device and retry the
operation.
-49 Host report invalid file The comm driver attempted to send a host report
with invalid characters (null, STX, or ETX).
Error
Code Text Description/Action
-40 Unable to erase flash memory Retry; need to restart device.
-41 Unable to set softload mode Retry; need to restart device.
-42 Unable to read boot PROM ID Retry; need to restart device.
-43 Incorrect firmware file The improper firmware file was specified for
extension device model.
-44 Invalid firmware file extension The firmware file is *.kre, *.krn, *.krs,
or *.kra.
Error
Code Text Description/Action
-45 No accessory board You can load *.kra files only to a device that
has an Ethernet port.
-46 Too many firmware blocks The program file (*.kre, *.krn, or *.krs)
contains more than 2 blocks. DCM does not
soft-load this program file.
-47 Unable to exit softload mode Send a parameter file to the device. If necessary,
cold-start the device.
File downloads generate error codes that are independent of communication type.
Error
Code Text Description/Action
-50 Unable to allocate AFT Shut down the Sentinel and restart.
memory
-52 Unable to open output file Verify write access to the indicated path.
-53 Unable to write to output file Verify write access to the indicated path.
-54 Unable to open <device- Verify write access to the indicated path.
id>_ERR.log file
-55 Unable to write to <device- Verify write access to the indicated path.
id>_ ERR.log file
-61 Too many reports specified DCM has requested to download an AFT file
that contains more than 200 commands that
result in an output file. Reduce the number of
commands that specify an output file or split the
download into two or more separate operations.
-62 Comm unreliable, transfer Retry the operation.
aborted
-63 File contains invalid Check devicename_ERR.log.
commands For an explanation of the error codes in this file,
refer to “Device error messages from a Series
400 device” on page 393 later in this chapter.
Error
Code Text Description/Action
-64 Empty file The download file contains no commands or
report requests.
-65 Did not release all AFT Shut down the Sentinel and restart.
memory
Error
Code Text Description/Action
-100 Command not supported The device does not support the attempted
operation, or components of the DCM installation
are incompatible. Verify that the proper device
model is specified in the DCM configuration. Next,
verify that you have proper versions of the device
firmware (boot and app) and all components of
DCM. Upgrade the device, or reinstall DCM, as
necessary.
-101 Invalid argument The components of the DCM installation are
incompatible. Verify that you have proper versions
of all DCM components. Reinstall DCM, if
necessary.
-102 Invalid device ID Specify a valid six-digit device ID and retry the
operation.
-103 A device ID must be An operation was attempted that requires a device
specified ID to be specified. Verify that you have proper
versions of all DCM components. Reinstall DCM, if
necessary.
-104 Unable to open port Verify that the port exists and is enabled in
communication channel PC.
Error
Code Text Description/Action
-105 Port is already open An attempt to open port that was already open
occurred.
Verify that the same port is not defined for more
than one active communication channel on a PC.
Shut down the Sentinel and restart.
-106 Transport is not available The device cannot send data via modem or Ethernet.
Try the following solutions:
• Select the device in the Device Manager and
look for a series of error messages that may help
diagnose the problem. If you receive a RAS
error, see Microsoft Help.
• Open the Sentinel Status window. Stop and then
start the device.
• Only if the other methods do not work, shut
down the Sentinel and restart.
-107 Input file not specified An operation was attempted that requires a file
name to be specified. Verify that you have proper
versions of all DCM components. Reinstall DCM, if
necessary.
-108 File does not exist Verify the location of the file at indicated path, and
that it has at least read access.
-109 Unable to delete The DCM system automatically retries and recover
transaction from this error. If this error persists or occurs
frequently, it indicates a problem with
communication or the device hardware.
Error
Code Text Description/Action
-110 Invalid transaction format This error is caused by one of the following:
• The device firmware version is incompatible
with DCM.
• DCM is attempting to collect “old” FIFO data
from the device.
• The device firmware versions (boot and app)
may not be compatible with DCM. If this is the
case, flush the device FIFO, reinitialize the
device configuration, and retry the operation.
Note: This results in loss of punch data.
-111 Invalid XML or syntax Validate the XML data file format, using a standard
error in XML data browser.
-112 Empty HTTP response or Retry the request.
no response from device
-113 Unable to load XML file to Verify that the device is operating and the
device communication channel is working.
-114 Error reported by series Retry the operation. Reboot if the retry fails.
4000 OS
-115 Error reported by series Retry the operation. Reboot if the retry fails.
4000 application
-116 Error reported by series Retry the operation. Reboot if the retry fails.
4000 communication
-117 Error reported by series Retry the operation. Reboot if the retry fails.
4000 configuration
services
-118 Error reported by series Retry the operation. Reboot if the retry fails.
4000 database processing
-119 Error reported by series Retry the operation. Reboot if the retry fails.
4000 diagnostics
-120 Unable to open data Verify ODBC configuration and drivers.
source/database
-121 Domain/device group not Shut down all DCM components and restart.
defined
Error
Code Text Description/Action
-122 No devices in specified Use the Device Manager to add devices to the
domain/device group device group.
-123 Unable to add device to Shut down the Sentinel and restart.
communication channel
-124 Invalid port specified The components of the DCM installation are
incompatible. Verify that you have proper versions
of all DCM components. Reinstall DCM, if
necessary
-125 Unable to get required Shut down the DCM module that you are running,
value from DCM database and restart. If the problem persists, contact your
database administrator.
-126 Invalid DCM home path Stop and restart DCM.
-127 Invalid command The communication channel does not recognize the
specified command. Verify that there is only one
copy of DCM program files and libraries on the PC.
Reinstall everything, if necessary.
-128 Unknown comm channel The communication channel does not recognize the
type communication channel type in the DCM
database.Verify that there is only one copy of DCM
program files and libraries on the PC. Reinstall
everything, if necessary.
-129 Selected device is disabled Enable the device for communication.
-130 Error during data Refer to the centralized log file.
collection
-131 Invalid Transaction Refer to the centralized log file.
message
-132 Unable to reset mailbox Stop and restart DCM.
-135 Starting DC The communication channel does not start the data
collection thread. Exit DCM and application; reboot
and retry the operation. If unsuccessful, contact
your service representative.
Error
Code Text Description/Action
-136 Opening FIFO file for read The communication channel does not open the
temporary FIFO file during the process of draining
punches from the specified device. Exit DCM and
the application; reboot and retry the operation. If
unsuccessful, contact your service representative.
-137 Writing bulk transaction Check the disc space and the DCM network
file during data collection settings.
-140 STATUS: Device Information only.
responding
-141 Device not responding Verify that the device exists on the network and is
running. Verify communication configuration
(serial parameters or IP address).
-142 Unable to download; Run data collection to retrieve all data from device,
device contains data and then retry the download.
-143 FAULT: Device put out of Too many comm errors have caused the
service communication channel to stop attempting to collect
data from the device.
-145 ERROR: Transport not The phone line is in use. The device with telephone
available. ##nnnnnnn number ##nnnnnnn is using the line to do a
currently has exclusive use collection. The device with telephone number
of line. Does not allow yyyyyyy cannot use the modem until the first device
yyyyyyy to hang it up. has finished the collection. Let the collection
complete and try again later.
-160 DCM post message The communication channel does not post messages
to DCM; as a result, data collection stops. Exit
DCM and the application; reboot and retry the
operation. If unsuccessful, contact your service
representative.
-161 FATAL: Output Multiple processes in the communication channel
Reentrancy attempted to execute a protected area of code. Exit
DCM and the application; reboot and retry the
operation. This is a fatal error; if unsuccessful,
contact your service representative.
Error
Code Text Description/Action
-162 Connecting to config The communication channel loaded but does not
service completely connect to the configuration service
DLL to load a configuration or import an AFT file.
Verify that there is only one copy of DCM program
files and libraries on the PC. Reinstall everything, if
necessary.
-163 Loading config service The communication channel does not load the
configuration service DLL to load a configuration
or import an AFT file. Verify that the configuration
service file (KrCfgSvc.dll) exists.
-170 Invalid URI Error reported Stop the communication channel and the Data
by series 4000 Collection Agent. Reboot the device.
communication
-171 No Parser Memory Stop the communication channel and the Data
reported by series 4000 Collection Agent. Reboot the device.
communication
-172 XML Parse error reported Stop the communication channel and the Data
by series 4000 Collection Agent. Reboot the device.
communication
-173 No root object in XML Stop the communication channel and the Data
reported by series 4000 Collection Agent. Reboot the device.
communication
-175 Invalid END in XML Retry the operation.
document reported by
series 4000
communication
-176 Application protocol error Retry the operation.
reported by series 4000
communication
-178 Invalid XML tag name Retry the operation.
reported by series 4000
communication
Error
Code Text Description/Action
-179 Invalid XML packet Retry the operation.
reported by series 4000
communication
-180 Invalid session header Retry the operation.
reported by series 4000
communication
-181 No client buffers left Retry the operation.
reported by series 4000
communication
-182 Web client buffers Retry the operation.
exhausted reported by
series 4000
communication
-183 Client take resource failed Retry the operation.
reported by series 4000
communication
-184 Client give resource failed Retry the operation.
reported by series 4000
communication
-186 Flash write error reported Retry the operation.
by series 4000
communication
-187 Flash read error reported Retry the operation.
by series 4000
communication
-188 Wrong packet type error Retry the operation.
reported by series 4000
communication
-189 Client invalid request Retry the operation.
reported by series 4000
communication
-190 Client buffer overflow Retry the operation.
reported by series 4000
communication
Error
Code Text Description/Action
-191 Client no server reported Reboot and retry the operation.
by series 4000
communication
-192 Client file error reported Reboot and retry the operation.
by series 4000
communication
-193 Client abort connection Reboot and retry the operation.
error reported by series
4000 communication
-194 Client abort general error Reboot and retry the operation.
reported by series 4000
communication
-195 Client queue request Reboot and retry the operation.
failure error reported by
series 4000
communication
-196 Client syntax error Retry the operation.
reported by series 4000
communication
-197 Client protocol error Reboot and retry the operation.
reported by series 4000
communication
-198 Client no resources error Reboot and retry the operation.
reported by series 4000
communication
-202 Failed to read COMM Retry the operation.
request reported by series
4000 application
-203 Missing attribute tag Retry the operation.
reported by series 4000
application
-204 Invalid verb reported by Retry the operation.
series 4000 application
Error
Code Text Description/Action
-205 Invalid object name Retry the operation.
reported by series 4000
application
-207 Invalid XML record Retry the operation.
reported by series 4000
application
-208 Failed to update Retry the operation.
configuration reported by
series 4000 application
-209 Invalid configuration data Retry the operation.
reported by series 4000
application
-210 Transaction not supported Retry the operation.
reported by series 4000
application
-211 COMM aborted operation Retry the operation.
reported by series 4000
application
-212 Failed to lock database Retry the operation.
reported by series 4000
application
-213 Record not found reported Retry the operation.
by series 4000 application
-214 Failed to update FIFO Reboot and retry the operation.
status reported by series
4000 application
-215 Value out of range reported Check configuration parameters and retry the
by series 4000 application operation.
-216 Database full reported by Run a data collection operation on the device and
series 4000 application wait 5 to 10 minutes.
-217 Internal database error Contact your service representative.
reported by series 4000
application
Error
Code Text Description/Action
-218 Client busy reported by Retry the operation.
series 4000 application
-219 Failed to spawn task error Reboot and retry the operation.
reported by series 4000
-220 Message Queue send error Retry the operation.
reported by series 4000
-221 Message queue receive Retry the operation.
error reported by series
4000
-222 Out of memory error Run a data collection operation, and then retry the
reported by series 4000 OS original operation.
-223 Exceeded buffer size error Retry the operation.
reported by series 4000
-224 Unrecognized object error Retry the operation.
reported by series 4000
-225 Invalid parameter error Retry the operation.
reported by series 4000
-226 Symbol not found error Retry the operation.
reported by series 4000
-227 Symbol not found error Retry the operation.
reported by series 4000
-228 Device ID unknown error Check the device setup to validate the device ID.
reported by series 4000
-229 Invalid List error reported Retry the operation.
by series 4000
-230 Invalid packet type error Retry the operation.
reported by series 4000
-231 Invalid XML version ID Retry the operation.
reported by series 4000
communication
Error
Code Text Description/Action
-232 Series 4000 terminal has Consult your Series 4000 documentation and follow
reached set database the procedure to clean the database.
memory capacity
-233 Failed to read COMM Retry the operation.
request reported by series
4000
-234 Previous Load Firmware Verify that the agent is running. It the error persists,
request is still pending, stop the communication channel and retry the
please wait for that request operation.
to complete first.
-235 Boot cycle for the Wait at least three minutes for the device to boot
specified device has not before attempting any operation.
completed.
-236 Incompatible Series 4000 Use the proper vendor-specific device.
terminal type detected.
-240 XML files for series 4000 Retry the operation.
terminals cannot exceed
32K
Error
Code Text Description/Action
-800 Unknown structure The host application or configuration GUI
(graphical user interface) requested information
for an unrecognized data structure. Verify that the
proper versions of the host application and DCM
are installed. Verify that there is only one copy of
DCM program files and libraries on the PC.
Reinstall everything, if necessary.
Error
Code Text Description/Action
-801 Not app struct The configuration GUI requested information from
the host application for a data structure that the
host application does not recognize. Verify that the
proper versions of the host application and DCM
are installed. Verify that there is only one copy of
DCM program files and libraries on the PC.
Reinstall everything, if necessary.
-802 No app data Contact your service representative.
-805 Errors in building download The configuration service requested application
file with application data data to build the file, but received an error from the
application connection library. Look for error in
deviceID_ERR.log.
-806 Not implemented in The configuration service requested an application
application data item that is not supported by the application in
the connection library.
-810 Invalid argument The host application or configuration GUI failed to
supply one or more required arguments to a
configuration service API function. Verify that the
proper versions of the host application and DCM
are installed.Verify that there is only one copy of
DCM program files and libraries on the PC.
Reinstall everything, if necessary.
-811 No cfg session The application attempted to build or import an
AFT file without properly initializing the
configuration service. Verify that the proper
versions of the host application and DCM are
installed. Verify that there is only one copy of
DCM program files and libraries on the PC.
Reinstall everything, if necessary.
Error
Code Text Description/Action
-812 Getting model info The configuration service was unable to obtain the
model information from the DCM database for the
specified device. Verify that there is only one copy
of the DCM program files and libraries on the PC.
Verify that the DCM database is current and
properly referenced. Reinstall everything, if
necessary.
-813 Cannot determine device ID The configuration service was unable to determine
the device ID (password) by querying the DCM
database with a device name. Use the Device
Manager to verify that a device exists in the DCM
database with a given device name.
-814 Cannot determine model The configuration service was unable to determine
DLL the model DLL file name by querying DCM
database. Use the Device Manager to verify that
the device exists in the DCM database. If it does,
the problem designates incompatible versions of
the programs in DCM. Verify that there is only one
copy of DCM program files and libraries on the
PC. Reinstall everything, if necessary.
-815 Loading Model DLL The configuration service was unable to load the
specified model DLL. Verify that the proper model
DLL file exists in the DCM share directory. Ensure
that the path includes a reference to this directory.
-816 Connecting to model DLL The configuration service loaded but was unable to
completely connect to the model DLL. Verify that
there is only one copy of DCM program files and
libraries on the PC. Reinstall everything, if
necessary.
-817 Model DLL does not support An incorrect model DLL was loaded for the
model specified device. Verify that there is only one copy
of the DCM program files and libraries on the PC.
Verify that the DCM database is current and
properly referenced. Reinstall everything, if
necessary.
Error
Code Text Description/Action
-818 Model DLL not accessible The application requested that the configuration
service build an AFT file when no model DLL was
loaded. Exit DCM and the application; reboot, and
retry. If the error persists, contact your service
representative.
-819 Freeing model DLL The configuration service failed to unload the
model DLL. Exit DCM and the application;
reboot, and retry. If the error persists, contact your
service representative.
-820 Opening DB The configuration service was unable open the
DCM database. Verify that there is only one copy
of DCM program files and libraries on the PC.
Verify that the DCM database is current and
properly referenced. Reinstall everything, if
necessary.
-821 ERR:Writing to DB The configuration service was unable to write to
the DCM database.Verify that there is only one
copy of DCM program files and libraries on the
PC. Verify that the DCM database is current and
properly referenced. Reinstall everything, if
necessary.
-832 Writing cfg file The configuration service was unable to write to
the AFT output file. Exit DCM and the
application: reboot, and retry. If the error persists,
contact your service representative.
-833 Opening input file The configuration service was unable to open the
AFT input (import) file. Verify that the import file
exists. If it does, exit DCM and the application;
reboot, and retry. If the error persists, contact your
service representative.
-834 Reading Input File The configuration service was unable to read from
the AFT input (import) file. Exit DCM and the
application; reboot, and retry. If the error persists,
contact your service representative.
Error
Code Text Description/Action
-840 Cannot talk to application The configuration service was unable to connect to
the host application DLL to perform an operation
that requires data stored in the application. Verify
that the host application is properly registered in
DCM. Verify that the proper versions of the host
application and DCM are installed. Verify that
there is only one copy of DCM program files and
libraries on the PC. Reinstall everything, if
necessary.
-841 Opening list The configuration service was unable to initialize
the labor account and labor level lists used by the
configuration GUI. Exit DCM and the application;
reboot, and retry. If the error persists, contact your
service representative.
-842 Cannot add lab field to list The configuration service was unable to set up the
labor level list used by the configuration GUI. Exit
DCM and the application; reboot, and retry. If the
error persists, contact your service representative.
-843 Cannot add account to list The configuration service was unable to set up the
labor account list used by the configuration GUI.
Exit DCM and the application; reboot, and retry. If
the error persists, contact your service
representative.
-844 Getting list info The configuration service was unable to obtain
information from the host application regarding
whether a validation list was included in the AFT
file. Verify that the proper versions of the host
application and DCM are installed. Verify that
there is only one copy of the DCM program files
and libraries on the PC. Reinstall everything, if
necessary.
Error
Code Text Description/Action
-845 Labor entries list size The configuration service returned an error while
exceeded building a download file with labor entries. The
labor entries list size exceeded what the device
supports. Download the build error. Deselect the
labor level for download.
-850 kErrMemoryException The configuration service returned an error while
building a download file. Retry the operation.
-851 kErrCreatingExportObject The component of the configuration service that
builds the download files (AFT or XML) could not
be loaded into memory. There may not be enough
free memory on the PC.
Check the available memory on the PC. Stop any
unnecessary programs on the PC and retry.
-852 kErrCreatingAppAwareObje The component of the configuration service that
ct defines how to build a configuration that is
compatible with the host application could not be
loaded into memory. There may not be enough free
memory on the PC.
Check the available memory on the PC. Stop any
unnecessary programs on the PC and retry.
-853 kErrCreatingStdProximity The configuration service was unable to create the
definition for the Kronos standard proximity
badge. This format should be sent to a Series 4000
terminal that has a proximity reader. There may
not be enough free memory on the PC.
Check the available memory on the PC. Stop any
unnecessary programs on the PC and retry.
-854 Config service error in The configuration service returned an error while
building download building a download file. Retry the operation.
Error
Code Text Description/Action
-900 Invalid reply XML file format Make sure communication is working, and try
the softload again.
-901 Invalid manifest file format The *.krm file is not correctly formatted.
Replace the file with a new copy.
-902 Incompatible file version The *.krm file is not correctly formatted.
Replace the file with a new copy.
-903 Error during file upload Make sure communication is working, and try
the softload again.
-904 Authentication failed Make sure communication is working, and try
the softload again.
-905 Device cannot reboot Unplug the device and reboot. If you need
further assistance, contact your service
representative.
For more information about the Softload application, see “Loading Files and Data
to and from a Device” on page 279.
Error
Code Text Description/Action
-1000 Error adding the application to Internal error. Retry the operation. If the error
the Data Collection Manager reoccurs, contact your service representative.
registration table
Error
Code Text Description/Action
-1001 Error removing the application Internal error. Retry the operation. If the error
from the Data Collection reoccurs, contact your service representative.
Manager registration table.
-1002 The selected application has not Internal error. Retry the operation. If the error
been registered for use with the reoccurs, contact your service representative.
Data Collection Manager.
-1003 An invalid application handle Internal error. Retry the operation. If the error
has been specified. reoccurs, contact your service representative.
-1004 Invalid data field received Internal error. Retry the operation. If the error
reoccurs, contact your service representative.
-1005 No records found in the Internal error. Retry the operation. If the error
application input queue reoccurs, contact your service representative.
-1006 The application has not properly Internal error. Retry the operation. If the error
initialized with Data Collection reoccurs, contact your service representative.
Manager
-1007 An unregistered Comm Channel Internal error. Retry the operation. If the error
was found in the Data Collection reoccurs, contact your service representative.
Manager database.
-1008 Error opening the Data Check that the database is connected, that the
Collection Manager data source ODBC System DSN for the Data Collection
Manager is correct, and that the database user
name and password are correct.
-1009 This application has already Internal error. Retry the operation. If the error
initialized the connection with reoccurs, contact your service representative.
Data Collection Manager.
-1010 An invalid group name has been Enter a valid device group name and retry the
specified. operation.
-1011 An invalid application name has Internal error. Retry the operation. If the error
been specified. reoccurs, contact your service representative.
-1012 Only one group per application. Internal error. Retry the operation. If the error
reoccurs, contact your service representative.
Error
Code Text Description/Action
-1013 No devices found in the given Assign devices to the specified group or
group specify another device group and retry the
operation.
-1014 An invalid device ID has been Specify a valid six-digit device ID and retry
specified the operation.
-1015 No database has been specified. Internal error. Retry the operation. If the error
reoccurs, contact your service representative.
-1016 An invalid message type has Internal error. Retry the operation. If the error
been specified. reoccurs, contact your service representative.
-1017 The specified group is already Internal error. Retry the operation. If the error
being accessed. reoccurs, contact your service representative.
-1018 The specified file does not exist. Ensure that the file name is correct and that
the file is in the specified location, and retry
the operation.
-1019 Unable to copy the specified file Check the following:
for download. • Available disk space
• Share rights to the directory
-1020 An invalid path has been Internal error. Retry the operation. If the error
specified. reoccurs, contact your service representative.
-1021 No message read procedure has Internal error. Retry the operation. If the error
been specified. reoccurs, contact your service representative.
-1022 Error starting the specified Disable and enable the Sentinel. Contact your
Comm Channel service representative if this problem
reoccurs.
-1023 An invalid Comm Channel has Internal error. Retry the operation. If the error
been specified. reoccurs, contact your service representative.
-1024 Error stopping the specified Internal error. Retry the operation. If the error
Comm Channel reoccurs, contact your service representative.
-1025 The specified phone number Specify a telephone number that matches the
does not exist in the Data number assigned to one of the devices that
Collection Manager database. you are attempting to connect to, and retry the
operation.
Error
Code Text Description/Action
-1026 The Data Collection Manager Check that the database is connected, that the
database is not open. ODBC System DSN for the Data Collection
Manager is correct, and that the database user
name and password are correct.
-1027 The specified device already Internal error. Retry the operation. If the error
exists. reoccurs, contact your service representative.
-1028 The current program is not set up Internal error. Retry the operation. If the error
with Data Collection Manager as reoccurs, contact your service representative.
an application.
-1029 Unable to write to the transaction Check the following:
output file • Available disk space
• Access rights to the DCM\data directory
-1030 Unable to open the queue file Check the following:
• Available disk space
• Access rights to the DCM\data directory
-1031 Unable to mark the current Check the following:
record for delete • Available disk space
• Access rights to the DCM\data directory
-1032 Unable to write empty records to Check the following:
the queue file • Available disk space
• Access rights to the DCM\data directory
-1033 Unable to access the required Check the following:
location in the queue file • Available disk space
• Access rights to the DCM\data directory
-1034 Unable to write to the queue file Check the following:
• Available disk space
• Access rights to the DCM\data directory
-1035 Unable to read from the queue Check the following:
file • Available disk space
• Access rights to the DCM\data directory
-1036 No queue name specified Internal error. Retry the operation. If the error
reoccurs, contact your service representative.
Error
Code Text Description/Action
-1037 Error allocating required Internal error. Retry the operation. If the error
memory reoccurs, contact your service representative.
-1038 Error locking required memory Internal error. Retry the operation. If the error
block reoccurs, contact your service representative.
-1039 Error accessing tables in the Check that the database is connected, that the
Data Collection Manager ODBC System DSN for the Data Collection
database Manager is correct, and that the database user
name and password are correct.
-1040 Error accessing tables in the Check that the database is connected, that the
Data Collection Manager ODBC System DSN for the Data Collection
database Manager is correct, and that the database user
name and password are correct.
-1041 Error editing records in the Data Check that the database is connected, that the
Collection Manager database ODBC System DSN for the Data Collection
Manager is correct, and that the database user
name and password are correct.
-1042 Error adding records in the Data Check that the database is connected, that the
Collection Manager database ODBC System DSN for the Data Collection
Manager is correct, and that the database user
name and password are correct.
-1043 Error updating records in the Check that the database is connected, that the
Data Collection Manager ODBC System DSN for the Data Collection
database Manager is correct, and that the database user
name and password are correct.
-1044 Error deleting records from the Check that the database is connected, that the
Data Collection Manager ODBC System DSN for the Data Collection
database Manager is correct, and that the database user
name and password are correct.
-1045 No records found in the given Internal error. Retry the operation. If the error
database table reoccurs, contact your service representative.
-1046 End of the current record set has Internal error. Retry the operation. If the error
been reached. reoccurs, contact your service representative.
Error
Code Text Description/Action
-1047 Unable to rename the given file Check the following:
name • Available disk space
• Access rights to the DCM/data directory
• Specification of the input path
-1048 Unable to open the given file Check the following:
• Available disk space
• Access rights to the DCM\data directory
-1049 The requested application is Internal error. Retry the operation. If the error
already being used. reoccurs, contact your service representative.
-1050 Invalid type specified for PC Internal error. Retry the operation. If the error
name validation reoccurs, contact your service representative.
-1051 Invalid location specified for PC Internal error. Retry the operation. If the error
name validation reoccurs, contact your service representative.
-1052 Error writing to log file Check the following:
• Available disk space
• Access rights to the DCM\data directory
-1053 Invalid destination key specified Internal error. Retry the operation. If the error
for message reoccurs, contact your service representative.
-1054 Invalid input path has been Internal error. Retry the operation. If the error
specified reoccurs, contact your service representative.
-1055 Invalid output path has been Internal error. Retry the operation. If the error
specified reoccurs, contact your service representative.
-1056 Duplicate message found in Internal error. Retry the operation. If the error
message queue reoccurs, contact your service representative.
-1057 No message found in message Internal error. Retry the operation. If the error
queue reoccurs, contact your service representative.
-1058 Invalid request type specified Internal error. Retry the operation. If the error
reoccurs, contact your service representative.
-1059 No list items found in the given Internal error. Retry the operation. If the error
list reoccurs, contact your service representative.
-1060 No more items left in the given Internal error. Retry the operation. If the error
list reoccurs, contact your service representative.
Error
Code Text Description/Action
-1061 Invalid device group specified Enter a valid device group name and retry the
operation.
-1062 Specified device is not assigned Assign the devices to an specified device
to any group. group or specify another device group, and
retry the operation.
-1063 Specified device is not assigned If the device that you specified is not assigned
to any device group. to any device group, check the configuration
of the device groups and assign the device to
an appropriate device group.
-1064 Unable to open registry key Internal error. Retry the operation. If the error
reoccurs, contact your service representative.
-1065 Unable to set registry value Internal error. Retry the operation. If the error
reoccurs, contact your service representative.
-1066 Unable to get registry value Internal error. Retry the operation. If the error
reoccurs, contact your service representative.
-1067 Error starting the application Stop and start the Sentinel Service. Contact
connection your service representative if this problem
reoccurs.
-1068 Error stopping the application Internal error. Retry the operation. If the error
connection reoccurs, contact your service representative.
-1069 Unable to remove existing file Check the following:
• Available disk space
• Access rights to the DCM\data directory
-1070 Input buffer size is too large for Internal error. Retry the operation. If the error
the request reoccurs, contact your service representative.
-1071 The specified device group still Internal error. Retry the operation. If the error
has devices assigned to it. reoccurs, contact your service representative.
-1072 The specified group still has Internal error. Retry the operation. If the error
devices assigned to it. reoccurs, contact your service representative.
Error
Code Text Description/Action
-1073 Unable to connect with the Validate that the following items are included
specified application connection in the DCM communication PC system path:
library \kronoscm\dcm
\kronoscm\lib directory
-1074 Invalid device name specified Specify a valid device name and retry the
operation.
-1075 Invalid device ID specified Specify a valid six-digit device ID and retry
the operation.
-1076 Invalid model ID specified Internal error. Retry the operation. If the error
reoccurs, contact your service representative.
-1077 Specified communication Internal error. Retry the operation. If the error
channel already exists reoccurs, contact your service representative.
-1078 No IP address specified An Ethernet device requires an IP address.
Enter an IP address for the device by using
the Device Wizard or the Device Manager.
-1079 No phone number specified A telephone number is required when you add
a modem device by using the Device Wizard,
the Device Manager, or the Event Manager.
Enter the phone number to communicate with
the device.
-1080 No initialization string specified An initialization string is required when you
add a modem device by using the Device
Wizard or the Device Manager. Select the
modem initialization string for the specified
device.
-1081 No port name specified A port is required when you add a serial or
modem device by using the Device Wizard or
the Device Manager. Specify the port name.
-1082 No baud rate specified A baud rate is required for the port when you
add a modem or serial device by using the
Device Wizard or the Device Manager. Select
the baud rate for the port.
Error
Code Text Description/Action
-1083 No modem name specified A modem name is required when you add a
modem device by using the Device Wizard or
the Device Manager. Select a modem name
from the Modem string list.
-1084 No modem string name specified A modem string is required when you add a
modem device by using the Device Wizard or
the Device Manager. Specify a modem string.
-1085 No group specified A device group is specified when you add a
device by using the Device Wizard or the
Device Manager. Assign the device to a
device group.
-1086 Invalid communication method If the communication method you specified is
specified not the correct one for the added device,
select the correct communication method:
Ethernet, modem, or serial.
-1087 No transaction table specified Internal error. Retry the operation. If the error
reoccurs, contact your service representative.
-1088 Device cannot be removed, it is The device is the only device assigned to a
still being used by the group that still has employees assigned to it.
application. Please check to see Reassign employees to another device group,
if employees are still assigned to and then try removing the device again.
it.
-1089 The specified device does not Select a device that has a printer attached to
have a printer attached to it. it, or add a printer to the specified device, and
then try printing again.
-1090 Unable to connect to the Validate that the following items are included
Configuration Service library in the DCM communication PC system path:
\kronoscm\dcm
\kronoscm\lib directory
-1091 No application update state Internal error. Retry the operation. If the error
found for specified device group reoccurs, contact your service representative.
Error
Code Text Description/Action
-1092 The selected group still has All employees must be removed from this
employees assigned to it. All group before it can be deleted. Make sure that
employees must be removed the device group that you remove is not the
from this group before it can be last device group associated with the host
deleted. application. Also, make sure that all devices
have been removed or reassigned before
attempting to remove the device group.
-1093 The model types cannot be You are unable to copy the device settings
different when editing or from a device of one model type to a device
copying a device. of a different model type. Make sure that the
model types are the same when copying
device settings from one device to another.
-1094 The specified host PC name was Internal error. Retry the operation. If the error
not found in the database. reoccurs, contact your service representative.
-1095 A local host PC cannot be You have specified a local PC for a network
specified in a network installation of the Data Collection Manager.
environment. Enter a network path to a DCM
communication PC.
-1096 A network host PC cannot be You have specified a network host PC for a
specified in a local environment. local installation of the Data Collection
Manager. Enter the name of the local PC.
-1097 Invalid application user The user does not have DCM access rights
defined for the specified application. See your
supervisor.
-1098 Invalid library handle specified Internal error. Retry the operation. If the error
reoccurs, contact your service representative.
-1099 Unable to retrieve database The database information is inaccessible.
information Check the database connection or the ODBC
setup.
-1100 Invalid password specified The password that you entered is not correct.
Enter the correct password.
-1101 User does not have the proper The user does not have DCM rights to
DCM access rights. perform the operation. Modify the user’s
access profile and retry the operation.
Error
Code Text Description/Action
-1102 Improper application licensing The host application that you are trying to run
does not have a proper license.
-1103 Invalid application code DCM internal error.
specified
-1104 Initialization error on the The connection library is unreacheable.
connection library Check the database connection. If the
database is running, DLLs are missing.
Contact your service representative.
-1105 XLaunch request failure Internal error. Retry the operation. If the error
reoccurs, contact your service representative.
-1106 Instance of XLaunched DCM internal error.
application already exists
-1107 Invalid device group specified Specify a valid device group and retry the
operation.
-1108 Specified group contains devices If the device group that you are trying to
delete still contains devices, reassign the
devices to another device group, and then try
the operation again.
-1109 Authentication service failure The information in the Service.Properties file
is invalid.
-1110 Invalid Oracle MERANT driver The MERANT drivers are not properly
license licensed. Update the license.
-1111 Invalid communication status Internal error. Retry the operation. If the error
specified reoccurs, contact your service representative.
-1112 Transaction posted to invalid The transaction received from the device
transaction table contains incorrect information. View and
correct the invalid transaction by using the
Transaction Data Editor accessed from the
Tools menu in the Communication Monitor.
Error
Code Text Description/Action
-1113 Invalid Download Options You have specified an Update command in
specified for Device Update. The the Communication Monitor or the Device
download options for this device Manager with device configuration specified
must be modified to specify as the only download option.
more than just the device If you send device configuration information
configuration for an update to the device, use the Initiate command in the
request. Communication Monitor or the Device
Manager. To send information other than
device configuration to the device, use the
Update command.
-1114 Transaction record exceeded A transaction record was longer than 2048
maximum length and was not characters and could not be successfully
processed. collected. Contact your service
representative.
-1115 Invalid MERANT driver license Contact your service representative.
-1116 Transaction record less than A transaction record was less than 64
minimum length and was not characters and could not be successfully
processed. collected. Contact your service
representative.
-1117 An invalid IP address has been Verify the IP address format. Do not use
specified. IP address octets must leading zeroes for Series 4000 terminals.
be a valid number between 0 and
255
-1118 The specified IP address has Enter a different IP address.
been used by another device,
please enter a different IP
address.
-1119 Exceeded the maximum number Consult the DCM documentation for device
of serial devices limits.
-1120 Exceeded the maximum number Consult the DCM documentation for device
of modem devices limits.
-1121 Exceeded the maximum number Consult the DCM documentation for device
of peer devices limits.
Error
Code Text Description/Action
-1122 Exceeded the maximum number Consult the DCM documentation for device
of Ethernet devices limits.
-1125 Queue Message is null Internal error. Retry the operation. If the error
reoccurs, contact your service representative.
-1126 Queue Message is internal Internal error. Retry the operation. If the error
reoccurs, contact your service representative.
-1127 Invalid installation information The system registry has been edited or
(Product ID) corrupted. Reinstall Data Collection Manager
Software.
-1128 Hard failure partially through Internal error. Retry the operation. If the error
processing Bulk. reoccurs, contact your service representative.
-1129 General SecDLL error Internal error. Retry the operation. If the error
reoccurs, contact your service representative.
-1130 Requested API was not found Internal error. Retry the operation. If the error
reoccurs, contact your service representative.
-1131 Unsupported Encryption Type Internal error. Retry the operation. If the error
reoccurs, contact your service representative.
-1132 Overflow of string buffer. Internal error. Retry the operation. If the error
reoccurs, contact your service representative.
-1133 Error starting the Collection Stop and start the Sentinel Service. Contact
Agent your service representative if this problem
reoccurs.
-1134 Device is incompatible with Verify the compatibility of devices on the
Communication Channel type communication channel.
-1135 Critical authentication failure Internal error. Retry the operation. If the error
reoccurs, contact your service representative.
-1136 Logon authentication failure Internal error. Retry the operation. If the error
reoccurs, contact your service representative.
-1137 Incompatible DCM database If you are using the Workforce Central
version system, upgrade your DCM installation to
match the current version of WFC. If using
DCM Standalone, ensure all DCM
installations are at the same revision.
Error
Code Text Description/Action
-1138 UpdateClients, unsuccessful Internal error. Retry the operation. If the error
viewer request to Collection reoccurs, contact your service representative.
Agent, unable to convert status
-1139 Database Error: Unable to find Internal error. Retry the operation. If the error
the SEQ_NAME record for this reoccurs, contact your service representative.
application in the SEQUENCE
table
-1140 ODBC Error(08002): Contact your database administrator to check
Connection is in use on the maximum number of connections
available to the database.
-1141 Internal error. Retry the operation. If the error reoccurs,
contact your service representative.
-1142 Internal error. Retry the operation. If the error the reoccurs,
contact your service representative.
-1144 Application server failure. Ensure that the Workforce Timekeeper
application server is running.
-1145 No dial-up network connection Ensure that Series 4000 modem
is specified for a Series 4000 Communication Channels have a valid dial-
modem terminal Communication up network connection specified in Device
Channel. Manager > Setup > Communication
Channels.
-1146 No dial-up network connection Create a dial-up network connection for
found in the phone book Series 4000 modem devices as specified in
specified for Series 4000 modem “Communication Channels” on page 37.
terminals.
-1147 No Host Name specified for this Specify a valid Host Name or IP address for
device. the device in Device Manager > Setup>
Device Wizard.
-1148 Duplicate Host Name specified Ensure that each device has a unique Host
for this device. Name or IP address specified in Device
Manager > Setup > Device Wizard.
Error
Code Text Description/Action
-1149 Host Name for this device The IP address returned for this device based
resolves to an IP Address on its DNS name is already assigned to
assigned to another device another device in DCM. Contact your
network administer to determine which
device should have this IP address.
-1150 Internal error. Retry the operation. If the error reoccurs,
contact your service representative.
-1151 Unable to connect to database. The specified database was created using
The specified database is an Workforce Record Manager and cannot be
Archive. used with DCM. Contact your system
administrator to change the DCM data source
DSN to point to the production database.
-1152 Internal error. Retry the operation. If the error reoccurs,
contact your service representative.
-1153 Unable to validate DCM Reboot the DCM communication PC. If the
Standalone license - Vendor error persists, contact your service
daemon not running. representative.
-1154 Unable to validate DCM Reboot the DCM communication PC. If the
Standalone license - License error persists, contact your service
server not running. representative.
-1155 Missing properties file for a Language properties files for the selected
specific language. language is not in the properties directory.
-1156 Improper language file Properties files may have been deleted or
configuration. moved. Reinstall DCM to restore properties
files.
-1157 Unable to read from the The DCM Comm client was unable to find a
requested file. download file that was built for an initialize
or update. Retry the initialize or update. If the
error continues to occur, make sure that there
are no processes running on the PC that could
be periodically deleting files from the DCM
temp directory.
Error
Code Text Description/Action
-1158 Unable to open the requested A properties files may have been deleted or
DCM properties file. moved. Reinstall DCM to restore properties
files.
-1159 Unable to read information from A property file read error was encountered.
the requested DCM properties Reinstall DCM to restore properties files.
file.
-1160 Internal error. Property file read error was encountered.
Reinstall DCM to restore properties files.
-1161 Unable to open the Data Verify that the database server is running and
Collection Manager database. that the Data Collection Manager data source
Please verify that the data base has been properly configured. Be sure that
server is running and the Data sufficient database connections are
Collection Manager data source configured.
has been properly configured. It
is also possible that there are
insufficient database connections
configured.
-1162 Specified device is not assigned Internal error. Retry the operation. If the error
to the specified group. reoccurs, contact your service representative.
-1163 Invalid Syntax. Internal error. Retry the operation. If the error
reoccurs, contact your service representative.
-1164 Error writing to properties file. A property file write error was encountered.
Reinstall DCM to restore properties files. If
the error reoccurs, contact your service
representative.
-1165 Error backing up the properties Internal error. Retry the operation. If the error
file. reoccurs, contact your service representative.
-1166 Error setting the value for the Internal error. Retry the operation. If the error
key. reoccurs, contact your service representative.
-1167 Error getting the value for the A property file error was encountered.
key. Reinstall DCM to restore properties files.
-1168 Firmware file is incompatible Use the proper firmware and retry the
with device type. operation. If the error reoccurs, contact your
service representative.
Error
Code Text Description/Action
-1169 Unable to write out requested Check access rights on all DCM-related disk
Device Report file drives. If the error reoccurs, contact your
service representative.
-1170 Requested DCM process not Internal error. Retry the operation. If the error
found reoccurs, contact your service representative.
-1170 Requested DCM process not Internal error. Retry the operation. If the error
found reoccurs, contact your service representative.
-1171 Error posting request to DCM Internal error. Retry the operation. If the error
Message Processing Agent reoccurs, contact your service representative.
-1172 Request object is not found in Internal error. Retry the operation. If the error
list reoccurs, contact your service representative.
-1173 Specified device was not found Internal error. Retry the operation. If the error
reoccurs, contact your service representative.
-1174 Error adding a device state Internal error. Retry the operation. If the error
reoccurs, contact your service representative.
-1175 Error removing a device state Internal error. Retry the operation. If the error
reoccurs, contact your service representative.
-1176 Device state list is full Internal error. Retry the operation. If the error
reoccurs, contact your service representative.
-1177 Error retrieving a device state Internal error. Retry the operation. If the error
reoccurs, contact your service representative.
-1178 Unable to access the Device Internal error. Retry the operation. If the error
State server reoccurs, contact your service representative.
-1179 Error reading FIFO file Internal error. Retry the operation. If the error
reoccurs, contact your service representative.
-1180 Error accessing allocated Internal error. Retry the operation. If the error
required memory reoccurs, contact your service representative.
-1181 Invalid collection method Internal error. Retry the operation. If the error
specified reoccurs, contact your service representative.
-1182 Invalid key value was provided Internal error. Retry the operation. If the error
for search reoccurs, contact your service representative.
Error
Code Text Description/Action
-1183 Internal DCM Error Internal error. Retry the operation. If the error
reoccurs, contact your service representative.
-1184 Specified Communications port Internal error. Retry the operation. If the error
is unavailable reoccurs, contact your service representative.
-1185 Specified Communications port Internal error. Retry the operation. If the error
is being used by another reoccurs, contact your service representative.
communications Channel
-1186 Invalid Communications Port Internal error. Retry the operation. If the error
specified reoccurs, contact your service representative.
-1187 Sentinel Service is not running Start the Sentinel Service. Retry the
operation. If the error reoccurs, contact your
service representative.
-1188 Message Processing Agent A request was made to the collection agent,
returned error for the given which could not process the request. Use
command. details of error message to take further action.
You can also disable and enable the Sentinel
and retry the operation.
-1189 Message Processing Agent Use the DCM Collection Agent transport log
returned non-200 HTTP status to get details about the error:
code. 1. In the krdcm.ini file, add or edit the
following lines:
[dcm collection agent]
transportlog=1
2. Disable and enable Sentinel.
3. The transport log is in the dcm ..\data\logs
directory.
-1190 Message Processing Agent The server, while acting as a gateway or
returned got a 502 HTTP status proxy, received an invalid response from the
code (some error in upstream server that it accessed in attempting
proxyservlet...can’t get to CA?) to fulfill the request. Disable and enable the
Sentinel and retry the operation.
Error
Code Text Description/Action
-1191 FIFO file was corrupted FIFO processing detected invalid punch data.
If the error reoccurs, contact your service
representative.
-1192 DCM WebServer type (secure Reinstall DCM.
install) is not IIS or Apache.
Error
Code Text Description/Action
00000001 Communication error Unable to communicate with Series 4000
terminals. Ensure that IP address and device
ID for this device are the same in DCM and at
the device. Ensure that the device is properly
connected to the network and can be pinged
from the DCM communication PC. Retry the
operation.
00000002 Series 4000 HTTP server Retry the operation. If the error reoccurs,
error contact your service representative.
00000003 DCM file error There was en error with the specified file.
Refer to the detailed error description for the
specific file error, correct the error, and retry
the operation.
00000004 Series 4000 Message The Series 4000 terminal responded with an
information or warning message. Refer to the
detailed error description for the specific error,
correct the error, and retry the operation. Refer
to “Error messages from a Series 4000
terminal” on page 392.
Error
Code Text Description/Action
00000005 Unable to determine DCM Contact your network administrator to ensure
PC IP Address that the DCM communication PC has a valid
IP address or DNS name assigned to it.
00000007 DCM internal error Internal Error. Retry the operation. If the error
the reoccurs, contact your service
representative.
00000009 DCM unknown error Internal Error. Retry the operation. If the error
the reoccurs, contact your service
representative.
00000029 Comm Channel is not A required communication channel was not
running, attempting to running and will be started by the DCM
restart Sentinel Service. If the communication
channel is not restarted successfully, and
additional error message is displayed, contact
your service representative.
0000002D Unable to Softload device - The krm file contains an invalid entry. Check
bad line in Softload the format for each line in the file.
manifest file
0000002E Communication Error A communication failure occurred between
DCM and a Series 4000 terminal. A
connection to the devices cannot be opened.
00000101 Device not found in device Retry the operation. If the error reoccurs,
list contact your service representative.
00000102 DNS lookup failed and no This device is configured to use a DNS name
saved IP for this device and the DNS name could not be determined.
Ensure that the specified DNS name is correct,
and confirm with your network administrator
that the DCM Communication PC and the
DNS server are properly configured.
00000103 Device model is The specified device is not compatible with
incompatible with installed Workforce Timekeeper. Contact your service
application representative to replace the device.
Error
Code Text Description/Action
00000104 Reported device ID does The device ID programmed at the device is
not match stored device ID different than the device ID that is specified in
DCM. Change the device ID at the device to
match the device ID specified in DCM in
Device Manager > Setup > Devices.
00000107 Device model does not The selected device model does not support
support Load Firmware the Load Firmware command. Select a device
model that does support Load Firmware, or
refer to your device documentation to
determine how to upgrade the firmware.
00000109 Invalid file or filename The specified file does not exist. Check the file
path and name and retry the operation.
0000010A File does not exist The specified firmware file does not exist.
Check the file path and name and retry the
Load Firmware operation.
0000010B Unable to connect to Contact your database administrator to ensure
database that the DCM database source, name, and log
on settings are correct and that the database
server is operating properly.
0000010C Error occurred trying to An internal error occurred. Retry the
start or access application operation. If the error reoccurs, contact your
service representative.
0000010D Error occurred trying to An internal error occurred. Retry the
access device list operation. If the error reoccurs, contact your
service representative.
0000010E Error occurred trying to An internal error occurred. Retry the
create the Device List operation. If the error reoccurs, contact your
Object service representative.
0000010F Error setting the An internal error occurred. Retry the
configuration session operation. If the error reoccurs, contact your
service representative.
00000110 Error closing the An internal error occurred. Retry the
configuration session operation. If the error reoccurs, contact your
service representative.
Error
Code Text Description/Action
00000111 Failure trying to derive a An internal error occurred. Retry the
class from a base class operation. If the error reoccurs, contact your
service representative.
00000112 Device is disabled The specified device is disabled. Enable the
device by using Device Manager > Setup >
devices or select an enabled device and retry
the operation.
00000113 File access denied (check The current user does not have rights to access
permissions) the selected firmware download file. Contact
your network administrator to provide the
appropriate access rights, and retry the
operation.
00000114 API Error: Required device An internal error occurred. Retry the
ID was not provided in API operation. If the error reoccurs, contact your
call service representative.
00000115 API Error: Required file An internal error occurred. Retry the
specification was not operation. If the error reoccurs, contact your
provided in API call service representative.
00000116 Application is exiting due to An internal error occurred. Disable and Enable
an unrecoverable error the DCM Sentinel Service and retry the
operation. If the error reoccurs, contact your
service representative.
00000117 Device not found in device The selected device may have recently been
list. Device list update assigned to another group or communications
pending. Please try again. channel. Retry the operation.
00000118 Error occurred trying to An internal error occurred. Disable and Enable
create the Group List the DCM Sentinel Service, and retry the
Object. operation. If the error reoccurs, contact your
service representative.
00000119 Error retrieving An internal error occurred. Disable and Enable
Communications PC IP the DCM Sentinel Service, and retry the
Address from database. operation. If the error reoccurs, contact your
service representative.
Error
Code Text Description/Action
0000011A Sentinel Service request An internal error occurred. Disable and Enable
error. Restart the Sentinel the DCM Sentinel Service and retry the
Service or reboot. operation. If the error reoccurs, reboot the
DCM Communication PC. If the error
reoccurs, contact your service representative.
0000011B Sentinel Service response An internal error occurred. Disable and Enable
error. Restart the Sentinel the DCM Sentinel Service, and retry the
Service or reboot. operation. If the error reoccurs, reboot the
DCM Communication PC. If the error
reoccurs, contact your service representative.
0000011C Sentinel Service finish An internal error occurred. Disable and Enable
error. Restart the Sentinel the DCM Sentinel Service, and retry the
Service or reboot. operation. If the error reoccurs, reboot the
DCM Communication PC. If the error
reoccurs, contact your service representative.
0000011D Sentinel Service mutex An internal error occurred. Disable and Enable
error. Restart the Sentinel the DCM Sentinel Service, and retry the
Service or reboot. operation. If the error reoccurs, reboot the
DCM Communication PC. If the error
reoccurs, contact your service representative.
00000121 Sentinel Service is not A database connection could not be made.
ready.
00000122 Unable to establish a Verify that the application server is running.
connection to the Start it if it is not running.
application server. Please
verify that the application
server has been started, and
is running.
00000123 Error opening the specified Retry the operation; if unsuccessful, contact
file your service representative.
00000125 Error getting a handle to the Reboot the system.
event status mutex.
00000126 Error getting a handle to the Reboot the system.
event status request event.
Error
Code Text Description/Action
00000127 Error getting a handle to the Reboot the system.
event status response event
00000128 Error getting a handle to the Reboot the system.
event status finished event
00000129 Unable to retrieve the Verify that the Task Scheduler is running. Start
requested task it if it is not running. Stop and restart the Event
Manager.
0000012A Error running the requested Verify that the Task Scheduler is running. Start
task it if it is not running. Stop and restart the Event
Manager.
0000012B Unable to initialize the Stop and restart the Event Manager.
COM library
0000012C Unable to create Task Verify that the Task Scheduler is running. Start
Scheduler interface it if it is not running. Restart the Event
Manager.
0000012D Unable to retrieve task list Verify that the Task Scheduler is running. Start
from Task Scheduler it if it is not running. Restart the Event
Manager.
0000012E Specified task already exists Enter a unique task name.
in Task Scheduler
0000012F Unable to delete the Verify that the Task Scheduler is running. Start
specified task from Task it if it is not running. Restart the Event
Scheduler Manager.
00000130 Unable to create a new task Verify that the Task Scheduler is running. Start
in Task Scheduler it if it is not running. Restart the Event
Manager.
00000131 Unable to save task Verify that the Task Scheduler is running. Start
it if it is not running. Restart the Event
Manager.
00000132 Error setting the task Verify that the Task Scheduler is running. Start
properties it if it is not running. Restart the Event
Manager.
Error
Code Text Description/Action
00000133 Access rights failure Check the user name and password for
launching DCM Events to ensure that the user
has the required access rights.
00000134 Error removing the Verify that the file properties is not write-
specified file protected.
00000135 Error getting a handle to the Reboot the system.
communications request
status cache server mutex
00000136 Error getting a handle to the Reboot the system.
communications request
status item request event
00000137 Error getting a handle to the Reboot the system.
communications request
status item response event
00000138 Error getting a handle to the Reboot the system.
communications request
status item finished event
00000139 Error getting a handle to the Reboot the system.
event status item request
event
00000140 Error getting a handle to the Reboot the system.
event status item response
event
00000141 Error getting a handle to the Reboot the system.
event status item finished
event
01001002 Path or other error occurred A Path setting required by DCM is incorrect.
trying to initialize the comm Contact your service representative.
driver
01001003 Database or other error Contact your database administrator to ensure
occurred trying to create the that the DCM database source, name, and log
CommChan Object on settings are correct and that the database
server is operating properly.
Error
Code Text Description/Action
01001004 Database, memory, or other Contact your database administrator to ensure
error occurred trying to that the DCM database source, name, and log
create the Download Object on settings are correct and that the database
server is operating properly.
01001005 Database or other error Contact your database administrator to ensure
occurred building that the DCM database source, name, and log
configuration files on settings are correct and that the database
server is operating properly.
01001006 Error committing the update Disable and Enable the DCM Sentinel Service,
states and retry the operation. If the error reoccurs,
contact your service representative.
01001007 Database or other error Contact your database administrator to ensure
occurred building the that the DCM database source, name, and log
configuration file(s) using on settings are correct and that the database
the manifest file server is operating properly.
01001008 Error building the Contact your database administrator to ensure
configuration file(s) that the DCM database source, name, and log
on settings are correct and that the database
server is operating properly.
01001009 Error importing parameter Ensure that the imported parameter file is
file properly formatted, and retry the import.
0100100A Communication channel or An internal error occurred. Disable and Enable
database error trying to the DCM Sentinel Service, and retry the
createLoadConfigObject() operation. If the error reoccurs, contact your
to perform device service representative.
configuration
0100100B Communication channel or Contact your database administrator to ensure
database error occurred that the DCM database source, name, and log
trying to create the on settings are correct and that the database
CCommRequestProcessor server is operating properly.
Object
Error
Code Text Description/Action
0100100C Communication channel or Contact your database administrator to ensure
database error occurred that the DCM database source, name, and log
trying to initialize the on settings are correct and that the database
CCTools DLL server is operating properly.
0100100D Another instance of this An internal error occurred. Retry the
CommChannel is already operation. If the error reoccurs, disable and
running enable the DCM Sentinel Service, and retry
the operation. If the error persists, contact your
service representative.
0100100E Invalid comm channel type The specified communications channel is not
compatible with the specified device. Ensure
that Series 4000 terminals are assigned only to
Comm Channels configured for Series 4000
terminals, and all other devices are configured
for Comm Channels configured for other
devices in Device Manager > Setup >
Communication Channels.
0100100F Comm channel startup Internal error. Retry the operation. If the error
cancelled reoccurs, contact your service representative.
01001010 Database or other error Contact your database administrator to ensure
occurred trying to build the that the database server is operating properly.
Device List
01001011 Error occurred trying to An internal error occurred. Retry the
create the operation. If the error reoccurs, disable and
CommClientDialog Object enable the DCM Sentinel Service, and retry
the operation. If the error persists, contact your
service representative.
01001012 Error occurred trying to An internal error occurred. Retry the
create the operation. If the error reoccurs, disable and
CCommClientDebugDlg enable the DCM Sentinel Service, and retry
Object the operation. If the error persists, contact your
service representative.
Error
Code Text Description/Action
01001013 Comm channel name not An internal error occurred. Retry the
specified operation. If the error reoccurs, disable and
enable the DCM Sentinel Service, and retry
the operation. If the error persists, contact your
service representative.
01001014 Database lookup failed for Contact your database administrator to ensure
Comm channel named that the database server is operating properly.
01001015 Path, Sentinel Service, or A Path setting required by DCM is incorrect.
other error occurred trying Contact your service representative.
to initialize the DCMAPI
library
01001016 Error occurred while Contact your database administrator to ensure
reading a database value that the database server is operating properly.
01001017 The comm channel Verify that the comm channel configuration is
configuration is invalid valid. Retry the operation. If the error
reoccurs, contact your service representative.
01001018 Cannot create the Disable and enable the DCM Sentinel Service,
CCommChannel object and retry the operation. If the error persists,
contact your service representative.
01001019 Unable to retrieve An internal error occurred. Retry the
download data to build operation. If the error reoccurs, contact your
device configuration files service representative.
0100101A Unable to load the DCM An internal error occurred. Retry the
configuration service to operation. If the error reoccurs, disable and
perform device enable the DCM Sentinel Service, and retry
configuration the operation. If the error persists, contact your
service representative.
0100101D Error trying to update the An internal error occurred. Disable and Enable
device state - restart the DCM Sentinel Service, and retry the
Sentinel Service operation. If the error reoccurs, contact your
service representative.
Error
Code Text Description/Action
0100101E Cannot find the State An internal error occurred. Disable and Enable
Manager process - restart the DCM Sentinel Service, and retry the
Sentinel Service operation. If the error reoccurs, contact your
service representative.
01001020 No valid download options The only specified download option was
selected Employee Biometric information and the
specified devices does not support Biometrics.
Select valid download options or upgrade the
device to support biometrics, and retry the
operation.
01001021 Error retrieving DCM Contact your network administrator to ensure
Collection Agent IP that the DCM communication PC has a valid
Address for use in IP address or DNS name assigned to it.
collection request to device
01001022 Device state1 value Wait for operation to complete and retry.
indicates a softload is in
progress
01001023 Device state1 value Wait for operation to complete and retry.
indicates an Initialize is in
progress
01001024 Device state1 value Wait for operation to complete and retry.
indicates an Update is in
progress
01001025 Device state1 value Wait for operation to complete and retry.
indicates a LoadFile is in
progress
01001026 Error extracting specified Verify that the krm file is valid. Check the file
file from krm file protection in the DCM data temp directory.
Retry softload operation.
01122001 Error trying to stop data DCM is unable to successfully complete a
collection StopDC command. Perform a StartDC
command followed by a Stop DC command.
1132001 XML file for Series 4000 The specified file is empty. Edit or specify a
terminal is empty different file and retry the operation.
Error
Code Text Description/Action
1132002 XML file for Series 4000 The specified file is larger than 32 KB. Divide
terminal exceeded 32K the file into multiple files less than 32 KB, and
retry the operation.
1132003 DCM Configuration An internal error occurred. Retry the
Service Exception Detected operation. If the error reoccurs, contact your
on LoadConfig service representative.
1132004 Error finding Load Ensure that a valid .krm file is specified and
Firmware .krm file - retry retry the Load Firmware operation.
Load Firmware.
1132005 Unable to Load Firmware to A previous load firmware attempt was in
device - previous Load process and failed. Wait for 5 minutes, then
Firmware failed. retry the Load Firmware operation.
1132006 Unable to Softload device - One or more Smart View transactions are
Smart Views must first be stored in the device. Ensure that the remote
collected by connecting to server is enabled and perform the Smart View
the remote server transaction to ensure that all Smart View
transactions are collected. Retry the Load
Firmware operation.
1132007 Unable to Softload device - The device has at least one biometric template
biometric templates must that must be collected. Retry the Load
first be collected by Firmware operation to collect any available
performing a Collect templates.
01132008 Unable to Softload device - An Initialization request to stop data collection
failed stop data collection failed. Test the device communication, check
request the network connection, and retry the softload
request.
01132009 Unable to Softload device - An Initialization request to collect request
failed primary collection failed. Test device communication, check
request network connection, and retry softload
request.
0113200A Stopped online data A batch collect was requested and the device
collection yielding to a was taken out of online collection state first.
batch collect The StopDC command was successful.
Error
Code Text Description/Action
0113200B FAILED to stop online data A batch collect requested and the device was
collection while yielding to taken out of online collection state first.
a batch collect StopDC was not successful. Retry the
collection request.
0113200C ReStarted online data Online collection successfully restarted after
collection after yielding to a being stopped to do a batch collection.
batch collect
0113200D FAILED to reStart online Online collection failed to restart after it was
data collection after stopped to do a batch collection. Issue start
yielding to a batch collect Data Collection on the device's collection
group.
0113200E Stopping Data Collection The StopDC command to a Series 4000
on device terminal was issued successfully.
0113200F FAILED Stopping Data The StopDC command to a Series 4000
Collection on device terminal failed.
01132010 Starting Data Collection on The StartDC command to the device was
device successful.
01132011 FAILED Starting Data The StartDC command to the device failed.
Collection on device Reissue the StartDC command.
01132012 Security state processing - The initial get capability report to device
Initial device capability failed. Review the error message log for
request failed details.
01132013 Security state processing - DCM and device security settings are not
DCM and device have compatible. Examine the mask and update the
incompatible security DCM device configuration to make it
settings compatible.
01132014 Security state processing - The HTTPS test of get capability report failed.
DCM to device Be sure that the device firmware is version 2.1
communications path test or higher. Review the error message log for
failed more details.
Error
Code Text Description/Action
01132015 Security state processing - The request to test Series 4000 to DCM
DCM request instructing Collection Agent connectivity failed. Be sure
the device to test that the DCM Web server or Collection Agent
connectivity with the DCM is running. Review the error message log for
Collection Agent failed more details.
01132016 Security stte processing - The request to get results of a Series 4000 to
DCM request to retrieve the DCM Collection Agent connectivity test
results of the device failed. Be sure that the DCM Web server or
connectivity with the DCM Collection Agent is running. Review the error
Collection Agent failed message log for more details.
01132017 Security state processing - DCM successfully changed the device's
DCM request to set the security state.
security state of the device
successful
01132018 Security state processing - The device's security state was not changed.
DCM request to set the Review the error message log for more details.
security state of the device
failed
01132019 Security state processing - A request to get capability request after
Final device capability security state change failed. Check the device
request failed communication status. Review the error
message log for more details.
0113201A Security state processing - Informational message that indicates that the
FYI: The software version device is not SSL-capable. Retry the softload.
of this device does not Review the error message log for more details.
support secure
communications
0113201B Successfully reset device The request to reset the security state on the
security from secure to non- device from secure to non-secure for softload
secure state in order to was successful.
perform a softload
Error
Code Text Description/Action
0113201C FAILED to reset device The request to reset the security state on the
security from secure to non- device from secure to non-secure for softload
secure state in order to failed.
perform a softload
0113201D Uncollected biometric An attempt was made to initialize the device
templates found at device when it had uncollected bio templates. Issue a
collect to the device and re-initialize.
0113201E Security state processing - The DCM configured device state is the same
DCM/4500 security states as current device security state. A security
match. No need for DCM to state change is not needed.
command security state at
this time.
0113201F Security state processing - The get capability report indicates that the
Initial device capability device application is not running. This
request successful but condition is acceptable since only the state
return status indicates the mask is needed. This holds true for initial and
device application is not final get capability reports. This condition
running occurs only after a failed softload.
01132020 Waiting for collect Informational message. DCM is checking to
complete on modem comm see if the modem connection used for the
channel. The RAS collect is active.
connection watchdog timer
has fired to test if RAS
connection is still up.
01132021 Waiting for collect Informational message, which is sent when a
complete on modem comm modem collection is started for a Series 4000
channel state has been terminal (cleared on collect complete or
updated. connection timeout).
01132022 Selected device does not Upgrade the SDRAM to at least 32K or select
have 32 MB SDRAM as an earlier version of the Series 4000 firmware.
required by the specific
firmware revision
Error
Code Text Description/Action
01132023 A Series 4000 batch collect After the current collect has finished, issue a
was requested while a stopDC to the device,and reissue the batch
previous request is still in collect.
progress, command
ignored.
01132025 Security state processing - A discrepancy between the DCM view of the
DCM implicit security state device security state and the device view of
transition of the device the device security state do not agree. DCM is
failed the master and sent a command to put the
device into the DCM view of the security
state.
01132026 Unable to Softload device - Verify device communications and retry
failed secondary collection softload operation.
request
01132027 Unable to Softload device - The attempt to shutdown user input on the
failed stop user input device failed. Verify device commutations and
request retry softload operation.
0113202F Collect state mismatch Because DCM detected a mismatch of one and
detected - DCM collect idle states, DCM set both to online and started
state online, Device collect data collection.
state idle - Issuing Start
Data Collection to device
01170101 DeviceId is not registered Security state of the device has been
with Host successfully changed. Indicates the device and
DCM where not in sync and the device was
commanded to the DCM held security state.
01172004 Connection from secure Initialize the device with the configuration
device on non-secure port option selected to put the device in non-secure
mode. Disable and enable Sentinel.
011A2001 Exception caught Serializing download retry to archive file
attempting to read caused an exception. Delete the archive file as
download retry archive file it may be corrupt. Re-run the device update or
to disk initialize for failed devices.
Error
Code Text Description/Action
011A2002 Exception caught Writing the serialized download retry archive
attempting to write file resulted in a C++ exception. Allow
download retry archive file another download retry time period to expire,
from disk and verify success. If repeated failures occur,
delete the archive file.
011A2003 Failed to post DCM Contact your service representative.
command results,
destination key is empty
011A2004 Failed to post DCM Contact your service representative.
command results
011D8001 Communications socket A communications error occurred. Retry the
error with Series 4000 operation. If the error persists, reboot the
Series 4000 terminal and retry the operation.
011D8002 Non success device status An internal error occurred at the Series 4000
received from Series 4000 terminal. Retry the operation. If the error
persists, reboot the Series 4000 terminal and
retry the operation.
011D8003 HTTP Server error (not An internal error occurred at the Series 4000
200) from Series 4000 terminal. Retry the operation. If the error
persists, reboot the Series 4000 terminal and
retry the operation.
011D8004 File open error for Series The specified file could not be opened. Verify
4000 related operation the file name and location, and retry the
operation.
011D8005 File access or not specified The specified file could not be accessed.
error for Series 4000 Verify that the current DCM Communication
operation PC user has the proper rights to access the file.
011D8006 File length is zero for Series The specified file was empty. Verify the file
4000 operation name and location, and retry the operation.
011D8007 File too large for transfer to The specified file was larger than 32767 bytes.
Series 4000 If the file was manually created, split the file
into two files. If DCM generated the file, retry
the operation. If the error persists, contact your
service representative.
Error
Code Text Description/Action
011D8008 Unknown error type An unknown error occurred at the Series 4000
detected by driver for a terminal. Retry the operation. If the error
Series 4000 operation persists, reboot the Series 4000 terminal and
retry the operation.
011D8009 Series 4000 Request status An unknown error occurred at the Series 4000
unknown - no status in xml terminal. Retry the operation. If the error
response from device persists, reboot the Series 4000 terminal and
retry the operation.
011D800A Series 4000 RAS DCM was unable to connect to Series 4000
connection error modem device due to a RAS connection
problem. Verify proper RAS configuration on
the DCM Communication PC, and retry the
operation.
011D800B Softload failure while Retry the softload. Device could be in a mixed
loading was in progress version.
011D800C DCM time out occurred An expected Series 4000 response was not
while waiting for a Series received. Retry the operation.
4000 response
011D800D Series 4000 xml packet A Series 4000 terminal closed the socket
terminator missing from connection before sending an XML packet
Series 4000 response terminator ("</packet>"). Retry the operation
and check the device’s communication status.
011D800E Unexpected Series 4000 Unable to get URL connection object and
driver failure unrecognized URL connection error. Disable
and Enable the DCM Sentinel Service.
011D800F Modem comm channel The modem connection for batch collects must
M8M Driver is allowing remain up until the collect is complete for the
forced hang-ups device as the punches come in to the collection
agent.
011D8010 Empty Series 4000 HTTP Retry the Softload operation.
Server response detected
during softload
Error
Code Text Description/Action
011D8013 Softload unable to obtain From the Device Manager, select the device
hardware profile report and select Communications > Test Device
Communications. If communication was
established, retry the operation.
011D8014 Softload unable to obtain From the Device Manager, select the device
device status report and select Communications > Test Device
Communications. If communication was
established, retry the operation.
011D8015 Softload failed preparing The hardware and software are incompatible.
file activity list for softload Contact your service representative.
011D8016 Softload FTP session failure Retry the operation. If the error reoccurs,
contact your service representative.
011D8017 Softload unable to issue Retry the operation. If the error reoccurs,
beginDownload; cannot contact your service representative.
shutdown Series 4000 host
application
011D8019 Softload Incompatibility The hardware and software are incompatible.
between Device Hardware Contact your service representative.
and Requested Software
011D801A Softload unable to connect Be sure that FTP is enabled on the device.
to the FTP Server
011D801B Softload unable to log in to Be sure that username/password are in sync
the FTP Server between DCM and the device.
011D801C Softload set for FTP Enable FTP on the device.
protocol, but Series 4000
device has FTP disabled
011D9008 Series 4000 detected an An invalid XML attribute was sent to the
invalid parameter in the device. Verify the XML of the failed file,
request which should be valid for the M8M
Application Protocol. If the error reoccurs,
contact your service representative.
011D900A A command was sent by Allow more time for device to reboot after a
DCM when the application softload. Reboot the device and allow time for
was not running. it to come up.
Error
Code Text Description/Action
011D900D The Series 4000 model The device detected that the type attribute in
number does not support the the request is other than request or response.
SML data contained in the
document that was sent
011D9015 Series 4000 hardware does Use a compatible krm file and update
not support the version of hardware.
software specified in the
krm file
011D9089 Series 4000 is busy and Retry the command at a later time.
unable to process the
request at this time
011D9103 The XML file sent to the Check the XML that was sent to the device for
device is not well formatted correctness. The comm channel transport log
can be used to capture the XML that is failing.
After correcting the XML, retry the operation.
If the error persists, contact your service
representative.
011D9117 Series 4000 Incompatible The Series 4000 version does not support the
Software Module software to be loaded, or the software in the
Series 4000 device cannot be directly
upgraded or downgraded to the software to be
load and an intermediate softload is needed.
011D9118 Series 4000 URL A test is currently in process. Wait and query
connectivity test is in again.
progress
011D9251 Series 4000 Http Client The response that the Series 4000 client
Error receive buffer is too received from the server is too large to
large process.
011D9252 Series 4000 Http Client The server is not running or the network is not
Error unable to connect to connected.
server
011D9254 Series 4000 Http Client The server is not running or the network is not
Error unexpected connected. The termination was not graceful.
connection termination
Error
Code Text Description/Action
011D9255 Series 4000 Http Client The server is not running or the network is not
Error connection connected.
termination
011D925A Series 4000 Http Client The Series 4000 connected to the server but
Error incomplete server not response was received.
response detected
011D9304 An attempt was made to add The boimetric template on the device has
a biometric template and limited storage resources. No more templates
failed because the bio pod can be added. This error occurs when DCM is
database was full adding templates as part of a device
initialization or update and the pod memory is
exhausted. Delete employee templates to free
up space.
011D9305 Biometric delete requested Uncollected biometric templates exist on the
and uncollected templates device. Perform data collection on the device
exist on Series 4000 before deleting templates.
011D9308 The format of the bio The template data could not be processed.
template in the XML Retry the opertion. If the retry fails, delete the
document is not compatible template and re-add it.
with the biometric unit in
the Series 4000
011DA003 Series 4000 application Series 4000 terminal response. The Series
detected an invalid verb in 4000 application received a request from the
the xml document communication layer that was not a GET, SET,
or DELETE.
011DA302 No data found The requested data could not be found. This is
an informational message that indicates that
the terminal user needs to try again or request
other data. For example, if an employee name
and its biometrics template were deleted from
a terminal, a request to delete the template is
rejected by the terminal because the employee
is not in the database as a home employee.
Error
Code Text Description/Action
011DA603 Series 4000 database has The Series 4000 terminal database is almost
reached watermark full. It has only enough room for punch data.
Perform punch collection.
011DA604 Series 4000 database is full The Series 4000 terminal database is full.
Perform punch collection.
011DA801 A biometric template From the Device Manager, select the device
request was sent to the and select Communications > Initialize with
device for an employee that the Employee Biometric Data download
is not in the device database option selected.
01172001 Unable to successfully An informational message that indicates that
process update device state the state manager cannot be accessed. Disable
request and re-enable the Sentinel Service.
01212001 DCM HTTP Proxy The DCM proxy logged an INFO message to
properties LOADED: DCM.log that it has loaded the
port1:[%d] port2:[%d] DCMProxy.properties file.
transportlog:[%s]
01212002 DCM HTTP Proxy shutting The DCM proxy logged an INFO message to
down. DCM.log that it is shutting down.
Service already A request to collect data was sent to the device when collection
active was already in process.
Symbol not found A command was sent to DCM when the application was not
running.
Undocumented error A generic message that means there is no text associated with the
code error code.
Note: You can disable error messages 01, 02, and 10 by using Procedure 1, Step 1
of the Series 400 device program. If you are experiencing badge reading
problems, ensure that these error messages are enabled.
Error messages
Message Description/Action
Error 01: BADGE The Series 400 device is unable to read the badge correctly, or the
READ ERROR bar code symbology is not enabled in the device program.
Clean the reader and test the other badges. If the badge is
properly encoded, make sure that the bar code symbology has not
been disabled (Procedure 11).
Error 03: USE The Series 400 device is set to disable “simple” time and
FUNCTION KEY attendance punches. The device accepts only punches that have a
soft key associated with them. This is usually a requirement of
the host system.
If this behavior is not desirable, change the associated parameter
in the Series 400 device program by using Procedure 5, Step 3,
Value 8.
Error 04: REPUNCH The Series 400 device rejected a punch because the elapsed time
RESTRICTION since the employee last punched is less than the repunch interval.
There are separate repunch intervals for home and non-home
employees.
• The home employee repunch interval comes from either a
schedule rule (restriction profile) or a parameter in the device
program (Procedure 7, Step 1).
• Non-home employees always have the device program
parameter applied to their punches (Procedure 7, Step 2).
A possible cause of Error 04 is that the device time was set to
some time in the future, some punches occurred, and then the
time was corrected.
Wait and try the punch again.
Error 05: PUNCH The Series 400 device rejected a punch because, according to the
RESTRICTED schedule enforcement information stored in the device, the
employee is not authorized to punch at this time. The schedule
rule (restriction profile) includes generic and individual
schedules to which the employee is assigned.
Message Description/Action
Error 06: The Series 400 device (not the 420 or 405 models) rejected a
UNKNOWN punch because the employee assigned to this badge or badge ID
EMPLOYEE is not a home employee, and cross-punching or entry
management features are not enabled.
Use the employee list to verify employee device assignments. To
enable the punching of non-home employees, change the setting
for Procedure 22 in the device program to enable non-home
employees to punch, according to their restriction level.
Error 07: OFF TIME The device rejected a punch because it is configured with an off-
time that includes the current time of day.
If this behavior is not desirable, do the following:
• Ensure that the off-times are correct, and that the day-of-week
exclusion(s) are correct. Refer to Procedure 21, Steps 1
through 4 of the device program.
• Check to see if the punch requires gate entry but the current
time is during a gate off-time. Refer to Procedure 21, Steps 5
through 12.
Error 08: PUNCH The Series 400 device rejected a punch because the restriction
RESTRICTED level encoded on the badge does not match the restriction
template parameter in the device program. This applies only to
non-home employees. Refer to Procedure 22, Step 1, of the
device program.
Error 09: HOME A supervisor used a home employee’s badge while executing
EMPLOYEE supervisor command 5. This command is intended for non-home
employees; supervisor command 2 is the corresponding
command for home employees.
Message Description/Action
Error 10: BADGE The badge that was read was decoded but contains invalid data.
DATA ERROR For a standard badge, this includes the wrong company code, out-
of-range values for one of the three 1-of-7 code fields, and the
wrong checksum for a code 3-of-9 badge.
If the badge is not a standard badge, it is a generic badge. Use the
Series 400 device program to configure the device to accept
generic badges. The following are relevant procedures in the
device program:
• Use Procedure 1, Step 2 to enable the use of employee
generic badges.
• Use Procedure 1, Steps 4 through 6 to define characteristics
of the employee generic badge bar code.
• Use Procedure 5, Step 3, Value 64 to enable use of badges for
departments and labor accounts.
• Use Procedure 24, Steps 1 through 3 to define characteristics
of the labor accounts for generic bar code badges.
• Use Procedure 24, Steps 4 through 12 and Steps 14 through
25 to define characteristics of the labor level generic bar code
badges (seven labor levels). Set nonzero values in Procedure
24, Steps 4 through 12 to enable the use of expanded labor
tracking fields.
• Use Procedure 25, Steps 1 through 3 to define characteristics
of a department generic bar code badge.
Error 11: The device rejected a punch because it is configured for entry
UNKNOWN management, and the badge that was read is not on the gate lists.
EMPLOYEE Error 11 occurs on the 420 device model when a simple punch
badge ID does not result in a gate opening (home employee or
gate lists). The 405 device model returns Error 11 when it rejects
a badge ID because it is not on the deduct lists.
Error 12: PUNCH The Series 400 device rejected a department/labor account/labor
RESTRICTED level badge because the restriction level encoded on the badge
does not match the department badge restriction template
specified in the device program (Procedure 22, Step 2).
Message Description/Action
Error 13: OUT OF Error 13 is associated with changing parameter values in the
RANGE Series 400 device program and appears in any of the following
situations:
• The combination of settings for a generic bar code badge size,
date size, and number of digits to ignore is invalid.
• A value for employee, department, labor level, or labor
account generic bar code badge settings is invalid.
• The badge size of a labor level badge is set to that of the labor
account badge.
Error 14: The Series 400 device rejected a badge read because the badge
DEPARTMENT ID is on the department validation list or on one of the labor level
BADGE validation lists. The device is expecting an employee badge read.
If this behavior is not desirable, change the setting for Procedure
5, Step 3, in the device program to 128. Exclude the weighted
value of 128 to turn off this feature.
Error 16: OUT OF Error 16 is associated with changing parameter values in the
RANGE Series 400 device. Possible reasons for this error message are:
• The generic bar code data size is longer than the maximum
possible length.
• The data size specified for the labor account badge does not
match the combined data size settings of the labor levels.
Error 18: (sent to host The Series 400 device rejected host command 90 (Set Terminal
PC) Program) because the device is operating in program mode. Do
the following:
• Use host command 99 to force the Series 400 device into
normal mode.
• Use host command 90 to edit the device program’s
parameters as desired.
• For details on host commands, see the Series 400 Terminal
Host Software Interface Guide.
Message Description/Action
Error 19: (sent to host The Series 400 device rejected host command 10 or 11 (Add
PC) Home Employee) because the maximum number of home
employees the device accommodates has been reached. Do the
following:
• Check the setting for Procedure 4, Step 1 or Step 7, which
determines the maximum number of home employees the
device accommodates. This is done through host command
89.
• Use host command 120#25# to verify that all home
employees in the list belong in the list. For the syntax of the
host commands, see the Series 400 Terminal Host Software
Interface Guide.
Error 20: LIST ITEM The Series 400 device does not find the list item you are trying to
NOT FOUND modify or delete.
Note: Use of error 20 was discontinued in a later flash version.
Any attempts to delete items that are not in the list are no longer
considered to be an error. If a modify request is anticipated, and
the entry is not already in the list, the attempt is treated as an add.
Error 21: LIST NOT The specified list is not be found or the list number you specified
FOUND is not valid.
Error 22: LIST FULL The specified list (to add to) is full. The validation list has the
maximum number of items. Check the Series 400 device program
setting for the allowable number of entries. See the Series 400
Terminal Configuration Guide to determine which procedure in
the device program to check.
Error 23: (sent to host No memory is allocated for this list. Change the appropriate
PC) parameter in the Series 400 device program to allocate memory
for the list. See the Series 400 Terminal Configuration Guide to
determine which procedure in the device program to check.
Error 24: ERROR A change to a list size limit or other memory allocation parameter
(translation text) does not fit in the memory available in the
device. Check values for the device program, or try using the
memory sizing utility MEM400 (described in the Series 400
Terminal Configuration Guide).
Message Description/Action
Error 26: OVER Error 26 is associated with the model 405 Employee Debit
CREDIT LIMIT Terminal (EDT). The employee attempting a debit transaction is
marked by the host system as over the credit limit. Therefore, the
device does not allow the employee to perform the transaction.
The employee still performs credit transactions.
Error 27: WILL NOT These two error messages appear together and are associated
BE SPLIT with model 405 Employee Debit Terminal (EDT). The errors
Error 28: EMP’S indicate that an employee attempting a debit transaction has
SPLIT FULL reached the maximum number of pay period splits. You can split
large purchases across multiple pay periods, but these messages
warn the employee that this transaction will not be split across
multiple pay periods. The transaction is accepted and is
forwarded to the host.
Error 30: NEED This message appears when an employee attempts to enter a
BADGE badge ID at the Series 400 device while the badge ID entry is
disabled. The employee swipes a badge at the Series 400 device
instead.
If you enable a badge ID entry by using the device program
(Procedure 5, Step 1, Value 1), you also prevent home employees
from using badge IDs (Procedure 16, Step 3) based on their
punch interpretation rules (restriction profiles). For details on the
procedures, see the Series 400 Terminal Configuration Guide.
Error 36: WARNING This message appears when an operator tries to enter data at a
FIFO FULL device when the first in, first out (FIFO) buffer is full. All punch
attempts are rejected until the FIFO is collected and flushed. Do
the following as soon as possible:
• Use host command 100 (Send Complete FIFO) to send data
from the device.
• Use host command 110 (Clear FIFO) to flush the data from
the device.
For information on using host commands 100 and 110, refer to
the host application collection of data and to the Series 400
Terminal Host Software Interface Guide.
Message Description/Action
Error 41: INVALID The Series 400 device rejected a punch attempt by a home
SCHEDULE employee because the host system has not sent schedule
enforcement information to the device. Schedule information
includes punch interpretation rules (restriction profiles) and
generic schedules and allows the device to determine whether to
accept a punch.
Error 42: CONFIG This error is associated with changing parameter values in the
CONFLICT Series 400 device program. The current settings indicate that the
shorthand notation feature is enabled (Procedure 25, Step 4), but
there is no memory allocated for the labor account list (Procedure
26, Step 7). Use Procedure 26, Step 7 to allocate memory for the
labor account list.
Error 43: CONFIG This error is associated with changing parameter values in the
CONFLICT Series 400 device program. The current settings indicate that the
shorthand notation feature is enabled (Procedure 25, Step 4), but
one of the prompt sequence settings (Procedure 24, Step 13;
Procedure 25, Step 8; Procedure 25, Steps 10 through 13;
Procedure 44, Steps 1 through 13) is not compatible with the
labor levels enabled (Procedure 25, Steps 1 through 3). Another
reason for this error message is that the value in Procedure 25,
Step 4 is greater than the number of enabled labor levels.
The Series 400 device now accepts seven labor levels, but still
supports use of just three labor levels. The settings mentioned in
the previous paragraph are valid for configurations not using the
new labor levels. Procedure 33 was added to specify prompting
sequences to support all seven labor levels (not just the new labor
levels). For details on the procedures, see the Series 400 Terminal
Configuration Guide.
Error 44: NOT This error is associated with the break enforcement feature. A
ALLOWED home employee attempted an in-punch, but the time since the
corresponding out-punch is shorter than the minimum set in the
Series 400 device program. The feature is enabled based on the
schedule rule (restriction profile) associated with the home
employee (Procedure 69, Steps 1 through 15), the shift length,
minimum break, and minimum meal are determined when the
shift first starts (Procedures 61 through 68, Steps 1 through 15).
Message Description/Action
Error 50: ERROR The Kronos Options Package (KOP) value stored in the Series
400 device indicates that the downloaded system is for the wrong
product (400 versus 550). Contact your service representative.
Another reason for this error message is the wrong Softload file
was sent to the device. The flash application starts and
determines that the KOP bit settings do not agree with the flash
application version (420 versus 460).
Error 59: ERROR The baud rates set in the Series 400 device program for host
communication (Procedure 10, Step 1) and printer
communication (Procedure 9, Step 2) are not compatible with the
hardware (DUART). If both baud rates are greater than 9600,
ensure that they are set to the same rate.
This error is also returned when maintenance command 138 is
executed to test the integral modem, and the device does not
communicate with the modem. The modem is either inoperable
or not installed.
Error 60: TABLE While executing host command 65 (Create/Edit Bell Schedule
FULL Table), the device determined that the time of day for the bell
does not exist in the current bell schedule, and that the bell table
contains the maximum number of entries (fixed at 48). If
necessary, use host command 65 to edit the bell schedule as
needed. For information on host command 65, see the Series 400
Terminal Host Software Interface Guide.
Error 61: INVALID The bell time specified does not exist in the bell schedule, or the
BELL TIME time entered is not a valid time of day.
Error 62: NOT The action the user attempted involves bells or gates, but they are
INSTALLED not enabled in the device program. Use of both bells and gates is
only possible if the optional I/O daughterboard has been
installed.
This error is seen when using host commands 65, 66, 120#58#,
121, 122, 123, 124, 129; and maintenance commands 6, 7, l1, 14,
17, 65, 66.
This error is also returned if maintenance command 118 is used
to interrogate the integral modem, but the integral modem is not
enabled. See Procedure 9, Step 1 to enable the integral modem.
Message Description/Action
Error 63: ERROR A hardware problem was detected when the Series 400 device
was turned on. Contact your service representative.
Error 64: ERROR An error was detected during the external loopback test
(maintenance command 177 or 182). The required loopback was
not completed or there was a hardware failure. If the device is
equipped with an internal modem module, ensure that Procedure
9 has been configured with a valid number of rings (1 to 4).
Error 65: RAM A fatal RAM error has occurred during execution of maintenance
FAULT command 111. Try cold-starting the device. If this fails, return the
unit for service.
Error 68: CONFIG This is a catch-all error message returned when a resource or
CONFLICT configuration conflict prevents the Series 400 device from
performing a command. Here are some situations when this error
is returned:
• Maintenance command 137 is executed (Reset Printer Port),
but the port is being used for host communication.
• Host command 70 is sent (Store Host Report), but the Series
400 device is not configured to store host reports (Procedure
54, Step 2, Value 2).
• A change to Procedure 4, Step 7 is nonzero, but perimeter
management is enabled (Procedure 41, Step 1, Value 1).
• A change to Procedure 5, Step 5 includes the value 4, but
there is no daughterboard installed or the daughterboard is
being used for ringing a bell (Procedure 5, Step 3, Value 1) or
is being used for perimeter management (Procedure 41, Step
1, Value 1).
• A change to Procedure 27, Step 1 is being made, but the
device is configured for expanded labor tracking (Procedure
25, Steps 1 through 3 and 10 through 13).
• A change to Procedure 27, Step 2 is being made, but the
device is configured for expanded labor tracking (Procedure
25, Steps 1 through 3 and 10 through 13).
Error 70: ERROR There is no software loaded in the mainboard flash to support the
Datasave or Detailed process that was initiated. Therefore, the
boot-EPROM does not contain any code to perform the requested
action.
Message Description/Action
Error 73: (sent to the During the softload process, an attempt to erase flash-EEPROM
host PC) failed.
Error 74: BAD This error is associated with changing parameter values in the
DEFAULT Series 400 device program. The default department or labor level
value specified is longer than the size specified in the device
program.
Error 75: NO SUCH The department, labor level, or labor account entry is not in the
ENTRY validation list. Cross-check list entries in the host system, and
download the corrected list to the Series 400 device.
Error 76: DUART During a Datasave operation, the Series 400 device failed to send
ERROR all the RAM contents. This is most likely due to a host
communication failure.
Error 77: ERROR During programming of the I/O daughterboard flash chip, the
memory to be programmed was found not to be blank.
Error 78: (sent to host During the softload process, an attempt to program the flash-
PC) EEPROM failed.
Error 79: (sent to host During the softload process of programming the flash-EEPROM,
PC) the Series 400 device rejected data sent by the host software.
Error 80: NOT A user is attempting to execute a command that is disabled in the
ALLOWED Series 400 device program. Refer to Procedure 60 to enable use
of the command.
Error 81: NO DATA A user is attempting to select a host report, but either there is no
AVAILABLE memory allocated for the host report buffer or there are no reports
in the buffer.
Error 82: BAD A user is attempting to use a default department or labor level
DEFAULT assignment, but the default was not found in the validation list.
The Series 400 device lists the error message, disregards the
default, and prompts for entry of a valid value. The default is not
validated when it is specified in the Series 400 device program; it
is validated when it is used.
Ensure that the default is part of the validation list sent by the
host system.
Message Description/Action
Error 83: ERROR This error is associated with changing parameter values in the
Series 400 device program. A user is attempting to set an invalid
soft key assignment or use a value that is out of range.
Not all models support all possible soft key functions. Refer to
Procedure 50 to verify a correct function number.
Error 86: PRINTER A user is attempting to access the printer attached to the Series
NOT READY 400 device through the serial connection on the I/O
daughterboard.
Either the printer has not been configured in the device program
(Procedure 9, Step 3), or the printer has lost its network
connection.
Error 87: ERROR This error is associated with changing parameter values in the
Series 400 device program. The change affects memory
allocation, and the FIFO must be empty to reallocate memory.
The host system collects and flushes the FIFO data before the
parameter is changed, or you use maintenance command 135 if
the saved record FIFO is erased.
Error 92: OUT OF A legal argument was entered with a value that is out of range, in
RANGE a command sequence. Reasons for this error message are that
non-numeric values were used for numeric-only arguments or
that required arguments are not present.
Error 94: INVALID A user entered an illegal argument. Reasons for this error
ENTRY message are that numeric values used are too large or too small or
not in an acceptable set of values.
Error 95: INVALID A user entered an illegal password. This error is returned in the
PASSWORD following situations:
• When an invalid password has been entered after attempting
to enter Maintenance mode, Supervisor mode, or Guard
mode.
• When an invalid entry code is entered (gate list or deduct list).
• When an invalid communication password is entered when
attempting to perform a system restart through maintenance
commands 90, 91, 93 or device program Procedures 78, 79,
80.
• When a nonmatching password is used with command 69 to
change a supervisor or guard password.
Message Description/Action
Error 99: INVALID A user entered a nonexistent command or programming
ENTRY procedure number.
EXCEPTION nn An error occurred in the application. Operation of the Series 400
device from this point on is unpredictable and unreliable. Note
the exception number (nn). If there are uncollected punches in the
FIFO, use host command 101 (Send FIFO From Last Poll) to
collect them as soon as possible. For details, see the Series 400
Terminal Host Software Interface Guide.
Depending on the cause of the error, all information stored in the
Series 400 device is possibly erased. Cold-start the device and
perform a softload operation to load a new application to correct
the situation. Contact Kronos Global Support and report the
device configuration.
Failed on AddNew This message may appear in a DCM log during a
communications check to various devices. It indicates a possible
problem updating the DCMCOMMSTATUS table for a device.
Queue files
Queue files provide storage for transactions, requests, and responses in the data
stream flow. These files, also called data transfer files, may be communication
channel queue files or application queue files. They reside in the input data path,
dcm\data\queues\PCName.
The location for the queue files is defined as part of the application connection
and the communication channels configuration and cannot be changed.
Queue files provide the following benefits:
• Data Integrity—Queue files ensure a maximum level of reliability during the
transfer of transactions and messages. They prevent data loss during most
failure events, for example, a system lockup or power outage at the
communication PC.
• User Transparency—Except during system setup, you need not be aware of
the existence of data transfer files. They provide complete run-time isolation
between the DCM system and the host application. The host application does
not have to run while DCM is communicating with the data collection devices.
Application client
The application client is a DCM executable process that transfers the DCM
messages and collected transactions (punches) from queue file to the application
connection library that interfaces with the host application. The data is then
processed in the host application.
Transaction files
Transaction files contain transaction data from all devices. Communication
channels for Series 400 devices and the DCM Collection Agent for Series 4000
terminals write transaction files based on the host application connection specified
for the device in the active data collection group. The transaction output file is
created by the communication channel or the Collection Agent for collected
transactions from the device. The transaction input file is created by a user or by
renaming a trx.out file to a trx.in file that is to be used for reprocessing
transactions.
Transaction file processing is initiated as part of a scheduled event from the DCM
Event Manager or from a manual request in the DCM Communication Monitor.
Transactions are routed directly to the host application queue. Manual requests
from Communication Monitor or scheduled events from Event Manager are
supported for transaction input files at the group or device level.
The file name for a specific transaction input file is based on the name of the
device group or device. The file, group.in or DeviceId.in, must be located
in the \dcm\data\trx directory.
Log messages
Log messages are posted in the DCM centralized log file based on the log options
defined in the System Settings in the Device Manager application. The Log View
of the file provides information for audit trails and troubleshooting. For more
information about the DCM log file, see “Log File settings” on page 118.
Sentinel
The Sentinel application manages the application connections and communication
channels configured for processing on the DCM system. Every DCM
communication desktop in the system has a Sentinel process running on it.
When the DCM installation is complete, the Sentinel starts automatically when
you reboot your system; it continues to run in the background when the Data
Collection Manager system is in operation.
You can open the Sentinel Status window to view, start, and stop application
connections and communication channels.
Communication channels
Communication channels for Series 400 and Series 4000 terminals use the routing
information based on the application connection for the device in the active data
collection group. Routing, which is based on the application connection, posts all
messages, including DCM messages and collected transactions, directly to the
application queue.
Communication clients
Communication drivers
The DCM communication driver is a dynamic link library (DLL) that is specific
to the data collection method supported by the devices.
The communication drivers manage Ethernet, modem, and serial communication
for Series 400 devices, and Ethernet and modem communication for the Series
4000 terminals. The communication driver manages handshaking, messaging, and
error processing for each device type and implements the high-level APIs that are
used to communicate with devices.
Note: Punches must occur between January 1, 1985, and December 31, 2037.
Uploading data
Uploading data occurs in any of the following ways:
• The upload, or collection, event is scheduled in the DCM Event Manager.
• A request is made in the DCM Communication Monitor to retrieve data from
devices, and the collection is initiated.
• A device group is configured for Automatic Data Collection. When a device
group is configured for Automatic Data Collection, all online devices in that
group are placed in an automatic collection state.
• A data collection start on a device group is issued from the Communication
Monitor.
Figures in the following sections show uploading data from a Series 4000 terminal
and a Series 400 device.
Services on WTK
Application Server Step 4: The transactions
are passed to the WTK
WTK database Services Interface, which
makes an XML request to
one or more WTK app
XML data requests servers to process the
transactions.
WTK Services Interface (WFCAPI.DLL)
Step1: The communication channel receives a request from the application client to retrieve punch
data from the Series 400 terminals. The communication channel posts the request to the device
and initiates collection.
Step 1: The communication channel receives a request from an application to retrieve punch data from
a Series 400 device. The request is posted to the device and collection begins.
Downloading data
Downloading data occurs in one of two ways:
• The download event is scheduled in the DCM Event Manager.
• An initialize or update request is made in the DCM Communication Monitor
to download data to devices.
Figures in the following sections show downloading data to a Series 4000
terminal and a Series 400 device.
Configuration Service
XML Series 4000 Communication Channel
WTK Connection Library
Series 4000 Communication Driver
Configuration Service
AFT Series 400
WTK Connection Library Communication Channel
Communication Driver
Step 3: The Configuration Service builds the Ethernet, serial, modem
required AFT download files by looking in the
data file repository or querying the application
and the database for the proper data.
This appendix provides information about using INI file values with the Data
Collection Manager system. The DCM INI file is called krdcm.ini and is
found in kronos\wfc\dcm.
This appendix contains the following sections:
• “Setting bulk processing” on page 420
• “Setting the Sentinel Service status automatic refresh intervals” on page 421
• “Database disconnect retry wait time” on page 422
• “List size settings” on page 423
• “Registering a new communication PC” on page 424
Note: Changes to the INI files affect your system. Contact your service
representative before making changes to ensure your system’s integrity.
Before you modify your INI file, be sure to make a backup copy.
Appendix B Modifying INI File Values
[Sentinel]
Display Update Interval = 120 //Set update interval to 120
seconds
Note: The database must be running. If the utility is unable to connect to the
database, you receive an error message and the utility ignores the rest of the
process.
The utility now checks to see whether any one of the defined application
connections is set up in the network configuration. If at least one is set up, the
utility lists a confirmation message to change all connections to the Local
communication PC setup.
4. Click Yes to convert any application connections that are set up in the network
configuration, to run in Local configuration on the communication PC.
The utility checks to see whether any one of the defined communication
channels is set up in the network configuration. If at least one is set up, the
utility lists a confirmation message to continue to convert all communication
channels to the Local communication PC setup.
5. Click Yes to continue.
The utility finishes the registration process and lists a success message.
6. Click Close to exit the application.
This appendix provides information about using the records events (such as
punches, labor account transfers, tip entries) in the collected transactions from
devices.
This chapter contains the following topic:
• “Understanding collected transaction records” on page 428
Appendix C Understanding and Accessing Punch/Transaction Data
The following table describes the data fields in the DCM transactions formats that
are described in subsequent sections.
Collected
Transaction
Symbol Record Field Description
aa Device work rule Two-digit field. Values for the field range from 0 to 20 and correspond
to a device work rule that is associated with a period of work.
Implications such as pay code are interpreted by the host software.
b Badge reader One-digit field that indicates how the employee ID was entered for the
event. Valid values are:
• 0 Not applicable
• 1 Integral reader
• 2 First remote reader
• 3 Second remote reader
• 4 No reader (PIN)
ccc Pay code number Field of up to three digits. The host software uses pay code numbers to
calculate and store the types of hours worked. Collected transaction
records associate the pay code with a duration of time or a dollar
amount.
dddddd Simple labor Alphanumeric field of up to 20 characters. The host software uses it to
account track labor other than by pay code or by employee.
e Entry event One-digit field that indicates the device has detected an unusual entry
management event. Valid values are:
• 0 Not applicable
• 1 Gate forced open
• 2 Gate open too long
• 3 Gate finally closed
g Gate code One-digit, fixed-length field that indicates what type of entry
management activity was performed.
Valid gate codes are:
• 0 Not applicable
• 1 Entry allowed (gate opened)
• 8 Punch allowed (gate not opened)
• 9 Entry denied
Collected
Transaction
Symbol Record Field Description
hhhhh Time Variable-length numeric field that represents the number of minutes,
from midnight (00:00) of the collected transaction reference date. The
date associated with the time of day can be another field in the
transaction record, or the transaction report reference date (Z record).
Examples:
• hhhh can be the number of minutes from midnight on the effective
date for the transaction, or the amount of time to be added or
subtracted from a pay code (expressed in minutes).
• hhhhh can be the number of minutes from midnight (00:00) of the
collected transaction reference date.
iiiiiiiii Employee ID Variable length nine-digit field. Employees are represented by a
numeric string in collected transaction records. In the device, the
employee ID is equivalent to the badge number or PIN.
kk Function key code Two-digit fixed-length field. The device has soft keys to represent
various time and attendance and labor tracking functions.
lf3|lf2|lf1 Labor account Variable length alphanumeric field. The labor account is in fixed
or subfield order; each subfield has a maximum length of 20. The
lf3|lf2|lf1 format is used for all device firmware versions except 400.6
lf7|lf6|lf5|
and later versions. (Pre-400.6 versions supported up to three labor
lf4|lf3|lf2| levels. Version 400.6 supports up to seven labor levels.) The maximum
lf1 number of characters for this field is 30 characters. The
lf7|lf6|lf5|lf4|lf3|lf2|lf1 format is used by devices using version 400.6
of the device firmware, which supports up to seven labor levels. It is
used if the labor account structure includes any of levels 4 through 7.
The maximum number of characters for each labor entry is 20; the
total maximum number of characters for this field is 140 characters,
not including the delimiters ( | ). The labor level delimiters ( | ) are
always present even if there is no value for a labor level. The host uses
labor accounts to track labor other than by pay code or by employee.
mmmm Minutes from Field of up to four digits. The value represents a time of day expressed
midnight in minutes.
Collected
Transaction
Symbol Record Field Description
nnnnnn Quantity Field of up to six digits. The value that the quantity field represents
varies depending on the record type. Examples:
• nnn can be the number of minutes to move from one pay code to
another.
• nnnnn can be the effective date (a date since 1/1/85) for a pay code
transaction.
ooooooo Gross receipts Field of up to seven digits. The value is associated with a tips amount
(a quantity record field).
p Punch code One-digit field that identifies the type of punch.
In order for this field to be included, punch typing must be enabled in
the device program.
Valid punch codes are:
• 0 Unknown (not important)
• 1 Out-punch
• 2 In for new shift
• 3 In from break
• 4 In from meal
• 5 Dept./labor transfer while in
• 6 In from meal or break
• 7 Gate entry only
• 8 Cross punch
• 9 Restricted (violation)
q Opened gate One-digit field that identifies which gate was involved with the entry
management event.
Valid values are:
• 0 Not applicable
• 1 First gate
• 2 Second gate
• 8 No gate
Collected
Transaction
Symbol Record Field Description
r Direction One-character field that represents on/off, forward/backward, or plus/
minus. The possible values for this field are:
• + represents on, forward, or plus
• – represents off, backward, or minus
For example, in a pay code transaction, + can specify the addition of
hours.
ss Supervisor code Two-digit field that represents the identification number of the guard,
supervisor, or maintenance person who performed the edit, transaction,
or override. The maintenance ID is always 99. A supervisor code of 98
indicates that the record was generated through an employee edit
function.
tt Seconds Two-digit field that is part of the collected transaction record time
stamp; indicates the seconds at which the event took place. By default,
events are recorded only to the minute.
v Affect overtime One-digit field. Valid values are:
• 1 Transaction affects overtime
• 0 Transaction does not affect overtime
ww Supervisor The host interprets this field as a reason for a supervisor to generate the
comment code collected transaction record.
x Message status One-digit field. The field reflects action by an employee when an
individual message is viewed. The host software interprets the value.
Valid values are:
• 1 Message acknowledged
• 2 Message display was not finished
• 3 Message not acknowledged
• 4 Message previously acknowledged
yyy Message index Field of up to three digits (1 through 127), indicating a particular
message in the message dictionary.
z Message age One-digit field that represents the number of days elapsed since the
individual message was assigned.
type Subrecord ID See the table of valid values in “Supervisor, Guard, and Maintenance
Transaction records” on page 447.
data Other relevant information.
DCM collects transactions from the device and translates the transaction records
from the device-specific format to the DCM transaction message format. The
transaction is stored in this translated format in the Transaction output file
(group.out). The transaction is also stored in the Bulk transaction file (.btx)
or in the queue file (app.q), or both, based on the DCM configuration for data
collection.
The following table defines the format of the DCM formatted transaction:
Example
012345678901234567890123456789012345678901234567890123
45678901234567890
| | | ||| | | |||||
#Group1 111111
DAA 122520031530001130110#|<--- Data begins here
The top row of numbers represents the position index for the transaction fields, to
clarify the example. The position index is not included in the transaction file. This
example shows that Transaction A (Simple Punch) was collected from device ID
111111 from group Group1 on 12/25/2003 at 15:30:00. The badge number and
other details specific to this transaction appear in the Data section.
Example of transactions
Simple Punch Record (A)
#Group 1 111111 PAA 062620021322001130110#402#1###
Labor Transfer Record (B)
#Group 1 111111 PBB
062620021322001130110#402#701|601|501|401|301|201|101##5#0###
Examples of other transaction types
#Group 1 061228 PGG 062620021323001130110#98#9#2001#
#Group 1 061228 PLL 062620021324001130110#+#675#2001#3
#Group 1 061228 PII
062620021331001130110#98#6385#0#+#300#0#2#2001#301|201|101#
#Group 1 061228 PEE
062620021332001130110#98#6385#812#2001#5#301|201|101#
#Group 1 061228 PVV 062620021335001130110#1#2001#6#0#301|201|101#
The device writes a record when the device is operating in Employee mode, and
an employee swipes a badge or manually enters a PIN number. The punch record
is translated to an A transaction type record when it is collected by DCM.
An A record in the DCM transaction message format contains the following data:
#iiiiiiiii#p#g#q#b#
The following list describes the data fields, in the order they appear in the record
format:
• iiiiiiiii is the employee ID (badge number).
• p is the punch type (optional).
• g is the gate code (optional).
• q is the gate number (optional).
• b is the employee badge ID source (optional).
Example
#402#1####
In this example, employee 402 punched in and the device processed the punch as
an out punch (1). The punch date and time are included in the DCM message.
#402#701|601|501|401|301|201|101##5#0#####
In this example, employee 402 was transferred to labor account
701|601|501|401|301|201|101. The function key is 5 and the punch code is
unknown. The punch date and time are included in the DCM message.
When a supervisor performs the function of Pay Code Money Edit at the device
by using the assigned soft key or using the device-supported command, it
#01#5155#120#402#1#701|601|501|401|301|201|101#05#16#
In this example, the device writes an Add-a-Punch record to the transaction at
7:36 a.m. (1896 minutes past midnight of the transaction reference date).
Supervisor 01 added a punch for the date 2/9/99 (5155 days past 1/1/85) at 2:00
A.M. (120 minutes past midnight) for employee 402. The labor account is
701|601|501|401|301|201|101. Future hours are associated with device work rule
05. The supervisor entered a comment code of 16. No soft key is associated with
the punch (0). The punch date and time are included in the DCM message.
The device writes an F Function Key record to the transaction when an employee
presses a soft key that is configured as a generic soft key. The host software
program interprets this punch.
An F record in DCM transaction message format contains the following data:
#iiiiiiiii#kk#g#q#b#
The following list describes the data fields, in the order they appear in the record
format:
• iiiiiiiii is the employee ID (badge number).
• kk is the soft key.
• g is the gate code (optional).
• q is the gate number (optional).
• b is the employee badge ID source (optional).
Example
#402#2#1###
In this example, the device wrote a Function Key record to the transaction at 9:21
a.m. (2001 minutes past midnight of the transaction reference date), employee 402
pressed soft key 2, and the gate was opened (1). The punch date and time are
included in the DCM message.
When a supervisor performs the function of Delete Punch at the device by using
the assigned soft key or using the device-supported command, it generates a
Delete-a-Punch transaction record at the device. Delete-a-Punch Transactions are
translated to H transaction type records when they are collected by DCM.
An H record in DCM transaction message format contains the following data:
#ss#nnnnn#hhhh#iiiiiiiii#kk#lf7|lf6|lf5|lf4|lf3|lf2|lf1#aa#ww#
The following list describes the data fields, in the order they appear in the record
format:
• ss is the supervisor number.
• nnnnn is the effective date (days past 1/1/85) for the pay code transactioon.
• hhhh is the number of minutes from midnight on the effective date of the
deleted punch.
• iiiiiiiii is the employee ID (badge number).
Example
#01#5155#120#402#0#701|601|501|401|301|201|101###
In this example, the device wrote a delete-a-punch record to the transaction at
7:31 a.m. (1891 minutes past midnight of the transaction reference date).
Supervisor 01 deleted a punch for the date of 2/9/99 (5155 days past 1/1/85) at
2:00 A.M. (120 minutes past midnight) for employee 402. No soft key is
associated with the punch (0), the punch is associated with labor account
701|601|501|401|301|201|101, no device work rule was entered (aa), and the
supervisor did not enter a comment code (ww). The punch date and time are
included in the DCM message.
When an employee or supervisor performs the function of Pay Code Hours Edit at
the device by using the assigned soft key or using the device supported
commands, it generates a Category Transaction record at the device. Category
Transactions are translated to I transaction type records when they are collected by
DCM. A supervisor uses the assigned soft key or command 52 at the device, in
supervisor or in Maintenance mode, to add or subtract hours from a pay code for
an employee.
An I record in the DCM transation message format contains the following data:
#ss#nnnnn#hhhh#r#hhhh#v#ccc#iiiiiiiii#lf7|lf6|lf5|lf4|lf3|lf2|lf1#ww#
The following list describes the data fields, in the order they appear in the record
format:
• ss is the supervisor number.
• nnnn is the effective date (days since 1/1/85) for the pay code transaction.
• hhhh is the number of minutes from midnight on the effective date for the
transaction.
• r determines whether hours are added (+) to or subtracted (-) from the pay
code.
• hhhh is the amount of time to be added or subtracted from the pay code,
expressed in minutes.
• v determines whether the transaction affects overtime (1) or does not affect
over-time (0).
• ccc is the pay code number.
• iiiiiiiii is the employee ID (badge number).
• lf3|lf2|lf1 or lf7|lf6|lf5|lf4|lf3|lf2|lf1 is the labor account (optional).
• ww is the supervisor comment code (optional).
Example
#62#5155#120#+#240#1#14#402###
In this example, the device wrote a Pay Code Transaction record to the transaction
at 1990 minutes past midnight of the transaction reference date. Supervisor 62
performed a transaction by using an effective date of 2/9/99 (5155 days past
1/1/85) and an effective time of 2:00 A.M. (120 minutes past midnight), to add (+)
4:00 (240 minutes). The hours do affect overtime calculations (1), using pay code
14 for employee 402. There is no labor account (lf3|lf2|lf1) and no comment code
(ww). The punch date and time are included in the DCM message.
Move Pay Code Hours from One Pay Code to Another record (J)
When a supervisor performs the function of Pay Code Move Amount at the device
by using the assigned soft key or using the device-supported command, it
generates a Category Adjustment transaction record at the device. Category
Adjustment transactions are translated to J transaction type records when they are
collected by DCM.
A J record in DCM transaction message format contains the following data:
#ss#nnnnn#hhhh#r#nnnnnn#ccc#ccc#iiiiiiiii#lf7|lf6|lf5|lf4|lf3|lf2|lf1#lf7|lf6|lf5|lf
4|lf3|lf2|lf1#ww#
The following list describes data fields, in the order they appear in the record
format:
• ss is the supervisor number.
• nnnnn is the effective date (days past 1/1/85) for the pay code adjustment.
• hhhh is the number of minutes from midnight on the effective date for the
adjustment.
• r determines whether the decimal quantity is added (+) to or subtracted (-)
from the pay code.
• nnnnnn is the amount (in hundredths with implied decimal; for example,
60000 equals 600.00).
• ccc is the pay code number (the first pay code field is the “from” paycode).
• ccc is the pay code number (the second pay code field is the “to” paycode).
• iiiiiiiii is the employee ID (badge number).
• lf3|lf2|lf1 or lf7|lf6|lf5|lf4|lf3|lf2|lf1 is the labor account (optional). The first
labor account field is for the “from” paycode.
• lf3|lf2|lf1 or lf7|lf6|lf5|lf4|lf3|lf2|lf1 is the labor account (optional). The
second labor account field is for the “to” paycode.
• ww is the supervisor comment code (optional).
Example
#93#5155#120#+#305#14#15#402#701||||||101#708||||||101##
In this example, the device wrote a Pay Code Move Amount record to the
transaction at 6:56 a.m. (1856 minutes past midnight of the transaction reference
date). Supervisor 38 performed the transaction by using an effective date of 2/9/99
(5155 days past 1/1/85) and an effective time of 2:00 A.M. (120 minutes past
midnight) to move 5:05 (305 minutes) from pay code 14 to pay code 15 for
employee 402. The supervisor used labor account 701||||||101 for pay code 14 and
labor account 708||||||101 for pay code 15 and did not include a comment code
(ww). The punch date and time are included in the DCM message.
Example
#93#5155#120#+#400#14#402###
In this example, the device wrote a Decimal Transaction record (K) to the
transaction at 5:49 a.m. (1789 minutes past midnight of the transaction reference
date). Supervisor 93 performed the transaction using an effective date of 2/9/99
(5155 days from 1/1/85) and an effective time of 2:00 A.M. (120 minutes past
midnight) to add (+) $4.00 (400) to pay code 14 for employee 402. There is no
labor account (lf3|lf2|lf1) and no comment code (ww). The punch date and time
are included in the DCM message.
The device writes a Tips record to the transaction when an employee enters a tip
amount (a decimal amount) at the device. You use the device program to enable
employees to enter tips using a soft key, tips keys on the keyboard (+ and - keys),
or out-punch processing.
An L record in DCM transaction message format contains the following data:
#r#nnnnnn#iiiiiiii#kk#lf7|lf6|lf5|lf4|lf3|lf2|lf1#ooooooo#
The following list describes the data fields, in the order they appear in the record
format:
• r determines whether the entered amount is added (+) or subtracted (-) from
the tips pay code.
• nnnnnn is the tip amount (in hundredths with implied decimal, for example,
500 equals 5.00).
• iiiiiiiii is the employee ID (badge number).
• kk is the soft key code (optional).
• lf3|lf2|lf1 or lf7|lf6|lf5|lf4|lf3|lf2|lf1 is the labor account (optional).
• ooooooo is the gross receipts amount (optional).
Example
#+#500#402####
In this example, the device wrote a tips record (L) to the transaction at 9:30 a.m.
(2010 minutes past midnight of the transaction reference date). A positive (+) tips
amount of $5.00 (500) is added to the tips pay code for employee 402. There is no
labor account (lf3|lf2|lf1, or lf7|...|lf1) and no gross receipts amount (ooooooo).
The punch date and time are included in the DCM message.
Only Gatekeeper devices (model 420) can generate an entry management record.
The perimeter management function detects three events that are indicated in this
collected transaction record. None of the events is directly associated with a
punch. All represent abnormal perimeter management conditions that are detected
by monitoring attached hardware.
An S record in DCM transaction message format contains the following data:
#v#q#
The following list describes the data fields, in the order they appear in the record
format:
• v is the type of entry management event.
• q is the gate associated with the event.
Example
#3#2#
This example shows that a Gatekeeper device wrote an entry management record
(S) at 1:52 A.M. (1552 minus 1440 divided by 60 equals 1.867 hours) and 16
seconds. The event that occurred was a gate closing (3). The gate involved was the
second gate (2). The punch date and time are included in the DCM message.
If you enable this feature in the device program, the device writes an hourly Time
Stamp record to the transaction every hour on the hour. The device is unable to
write time-stamp records to the transaction during power failures.
A T record in DCM transaction message format contains the following data:
#hhhhh#
The following list describes the data fields, in the order they appear in the record
format:
• hhhhh is the number of minutes from midnight (00:00) of the transaction
reference date).
Example
#1560#
In this example, the device writes an hourly time-stamp record (T) to the
transaction at 1560 minutes past midnight of the transaction reference date. This
time corresponds to 2:00 A.M. The punch date and time are included in the DCM
message.
The device writes an Individual Message Audit Trail record to the transaction
when the device displays a message to an employee. The record reports employee
activity during the viewing of one or two messages.
A T record in DCM transaction message format contains the following data:
#0#iiiiiiiii#x#yyy#z#x#yyy#z#
The following list describes the data fields, in the order they appear in the record
format:
• 0 distinguishes the record from a time-stamp record.
• iiiiiiiii is the employee ID (badge number).
• x is the message status.
• yyy is the number of the message shown to the employee.
• z is the number of days since the message was assigned to the employee.
• x is another message status (optional).
• yyy is the number of the message shown to the employee (optional).
• z is the number of days since the message was assigned to the employee
(optional).
Example
#0#123654#3#112#2#1#78#0#
In this example, the device writes an Individual Message Audit Trail record (T) to
the transaction at 7:21 A.M. (1881 minus 1440 divided by 60 equals 7.35 hours).
This record is not an hourly time-stamp record (0). Employee 123654 did not
acknowledge (3) message 112, displayed by the device. The message was
assigned 2 days ago. The employee did acknowledge (1) message 78, which was
assigned today (0 days ago). The punch date and time are included in the DCM
message.
The device writes a Device Work rule record to the transaction when an employee
presses a soft key configured as an activity start or as an activity clear.
A V record in DCM transaction message format contains the following data:
#aa#iiiiiiii#kk#g#llf7|lf6|lf5|lf4|lf3|lf2|lf1#ss#ww#q#b#
The following list describes the data fields, in the order they appear in the record
format:
• aa is the device work rule number.
• iiiiiiiii is the employee ID (badge number).
• kk is the soft key number.
• g is the gate code (optional).
• lf3|lf2|lf1 or lf7|lf6|lf5|lf4|lf3|lf2|lf1 is the labor account (optional).
• ss is the supervisor number (optional).
• ww is the supervisor comment code (optional).
• q is the gate number (optional).
• b is the employee badge ID source (optional).
Example
#03#402#6#1#33|01|96#78#35###
In this example, the device writes a Device Work rule record (V) to the transaction
at 8:21 P.M. (2661 -1440 / 60 equals 20.35 hours). Future hours are associated
with device work rule 03 for employee 402, who pressed soft key 6 to start the
transaction. The gate is opened (1), future hours are associated with labor account
330196, and supervisor 78 entered comment code 35. The punch date and time are
included in the DCM message.
Only Gatekeeper devices (model 420) can generate a Gate record. The device
writes a gate record to the transaction to store a time and attendance record for
interpretation by the host software program.
A W record in DCM transaction message format contains the following data:
#iiiiiiiii#p#g#q#b#
The following list describes the data fields, in the order they appear in the record
format:
• iiiiiiiii is the ID of the employee who opened the gate.
• p is the punch code.
• g is the gate code.
• q is the gate number (optional).
• b is the employee badge-ID source (optional).
Example
#102595#2#1#2#1#
In this example, the device writes a Gate record (W) at 2:16 A.M. (628 equals
1576 minutes, 1576 minus 1440 equals 136 minutes, or 2 hours and 16 minutes)
when employee 102595 punches to start a new shift (2). The punch causes a gate
(1) to open. The second gate (2) opened when the employee swiped her badge at
the first integral reader (1). The punch date and time are included in the DCM
message.
The device writes a Login record to the transaction when a supervisor or guard
logs in.
A 0 record in DCM transaction message format contains the following data:
#ss#0#
The following list describes the data fields, in the order they appear in the record
format:
• ss is the supervisor number.
• 0 is the subrecord ID (0 = login).
Example
#14#0#
In this example, at 4:40 P.M. (2440 minus 1440 divided by 60 equals 16.667
hours), supervisor 14 logged in (0). The punch date and time are included in the
DCM message.
The device can create the Logout record only when the device is in supervisor or
guard mode. The device writes this record to the transaction when a supervisor or
guard logs out.
A 1 record in DCM transaction message format contains the following data:
#ss#1#
The following list describes data fields, in the order they appear in the record
format:
• ss is the supervisor number.
• 1 is the subrecord ID (1 = logout record).
Example
#01#1#
In this example, supervisor 01 logs out (1) at midnight (1440 minutes past
midnight of the transaction reference date). The punch date and time are included
in the DCM message.
The device writes the Transaction record to the transaction when a supervisor
performs a transaction for an employee at the device.
You use the host software to define transaction codes to perform specific tasks.
For example, you can define a transaction code to add hours to an employee's sick
time. To perform this transaction, a supervisor must enter the defined transaction
code using the device keyboard.
A 2 record in DCM transaction message format contains the following data:
#ss#2#nnnnnn#iiiiiiiii#kk#lf7|lf6|lf5|lf4|lf3|lf2|lf1#
The following list describes the data fields, in the order they appear in the record
format:
• ss is the supervisor number.
• 2 is the subrecord ID (2 = transaction record).
• nnnnnn is the transaction code; six digits; maximum value 999999.
• iiiiiiiii is the employee ID (badge number) (optional).
• kk is the optional soft key (optional).
• lf3|lf2|lf1 or lf7|lf6|lf5|lf4|lf3|lf2|lf1 is the labor account to which the employee
is transferring (optional).
Example
#01#2#345####
In this example, at midnight (1440 minutes past midnight of the transaction
reference date), supervisor 01 performed a transaction (2) specifying a transaction
code of 345. The punch date and time are included in the DCM message.
The device writes a Single Restriction Override record to the transaction when a
supervisor uses the assigned soft key or command 2 at the device (in Supervisor
mode) to give or remove a restriction credit for a single home employee.
Home employees at the device have a restriction credit status of 0 or 1. A status of
0 means the employee is restricted from punching during a defined restriction
period. A restriction credit status of 1 means the employee is allowed to punch
during a defined restricted period.
A 3 record in DCM transaction message format contains the following data:
#ss#3#r#iiiiiiiii#
The following list describes data fields, in the order they appear in the record
format:
• ss is the supervisor number.
• 3 is the subrecord ID (3 = single restriction override record).
• r determines if the restriction credit is given (+) or removed (-).
• iiiiiiiii is the employee ID (badge number).
Example
#01#3#+#14525356#
In this example, at midnight (1440 minutes past midnight of the transaction
reference date, supervisor 01 gave (+) a restriction credit (3) to employee
14525356. The punch date and time are included in the DCM message.
The device writes a Home Employee Global Restriction Override record to the
transaction when a supervisor uses command 3 at the device (in Supervisor mode)
to set or clear the global restriction credit for all home employees. This overrides
the state of the restriction credit stored as part of the home employee schedule
enforcement data.
A 4 record in DCM transaction message format contains the following data:
#ss#4#r#hhhhh#
The following list describes the data fields, in the order they appear in the record
format:
• ss is the supervisor number.
• 4 is the subrecord ID (4 = global restriction override record).
• r determines if the global restriction credit is set (+) or cleared (-).
• hhhhh is the duration in minutes of the restriction override (optional).
Example
#01#4#+#120#
In this example, at midnight (1440 minutes past midnight of the transaction
reference date), supervisor 01 used host command 3 (4) to set (+) the global
restriction credit for all home employees, for a duration of 2:00 (120 minutes).
The punch date and time are included in the DCM message.
#01#5#-###
In this example, at midnight (1440 minutes past midnight of the transaction
reference date), supervisor 01 uses host command 4 (5) to clear (-) the non-home
employee global restriction credit. When a credit is cleared, there is no associated
duration (hhhhh). The punch date and time are included in the DCM message.
Example
#01#6#135#2468#
In this example, at midnight (1440 minutes past midnight of the transaction
reference date), supervisor 01 recorded a security transaction (6), using
transaction code 135, for employee 2468. The punch date and time are included in
the DCM message.
The device writes an Open Gate for an Individual Employee record to the
transaction in either of the following situations:
• A supervisor or guard uses the assigned soft key or command 12 at the device
(in Supervisor, Guard, or Maintenance mode).
• The host software sends host command 122 to the device.
The function in the device opens a gate for an employee.
A 7 record in DCM transaction message format contains the following data:
#ss#7#g #iiiiiiii#q#b#
The following list describes the data fields, in the order they appear in the record
format:
• ss is the supervisor number.
• 7 is the subrecord ID (7 = open gate for individual record).
• g is the gate code for the entry management activity.
• iiiiiiiii is the ID of the employee for whom the gate was opened.
• q is the gate number (optional).
• b is the employee badge-ID source (optional).
Example
#01#7#1#402###
In this example, at midnight (1440 minutes past midnight of the transaction
reference date), supervisor 01 used command 12 (7) at the device (in Supervisor
mode) to open the gate (1) for employee 402. The punch date and time are
included in the DCM message.
The device writes an Open Gate for specified duration record to the transaction in
either of the following situations:
• A supervisor or guard uses either either the assigned soft key or command 14
at the device.
• The host software sends host command 124 to the device.
Either action causes the gate to be opened for a specified length of time, or
indefinitely.
An 8 record in DCM transaction message format contains the following data:
#ss#8#r#hhhhh#q#
The following list describes the data fields, in the order they appear in the record
format:
• ss is the supervisor or guard number.
• 8 is the subrecord ID (8 = open gate for specified duration).
• r determines whether the gate was opened (+) or closed (-).
• hhhhh is the duration that the gate is to be open (optional).
• q is the gate number (optional).
Example
#01#8#+#120##
In this example, at midnight (1440 minutes past midnight of the transaction
reference date), supervisor 01 used command 14 (8) to open (+) the gate for 120
minutes. The punch date and time are included in the DCM message.
The device writes a Cancel Meal Deduct record to the transaction in either of the
following situations:
• A supervisor uses either either the assigned soft key or command 59 at the
device (in Supervisor mode).
• An employee presses a soft key configured as a cancel meal deduction.
Either action cancels the normal time deduction for meal breaks so that an entire
shift is considered worked time.
A 9 record in DCM transaction message format contains the following data:
#ss#9#iiiiiiiii#
The following list describes the data fields, in the order they appear in the record
format:
• ss is the supervisor number.
• 9 is the subrecord ID (9 = cancel meal deduct record).
• iiiiiiiii is the ID of the employee for whom the meal deduction was canceled.
Example
#01#9#402#
In this example, at midnight (1440 minutes past midnight of the transaction
reference date), supervisor 01 used command 59 (9) to cancel the normal
deduction for any meal breaks taken by employee 402. The punch date and time
are included in the DCM message.
The punch record shows a time (minutes from midnight) that is adjusted to offset
the DST toggle, and a punch type of 0. This information allows the host software
to perform calculations for minutes worked, using the time reported on this punch
and previous punches for this employee. The adjusted time subsequently makes
the record appear out of sequence with the rest of the punch data.
The following table lists a sample transaction report with appropriate punch data.
The sample report includes hourly time-stamp transaction records, for clarity. Text
on the left is the transaction report; text on the right explains the line of the report.
Transaction
Report Text Explanation
T 2220 Passing of 13:00
A 2220 120946 Punch at 13:00 for employee 120946
A 2279 120958 Punch at 13:59 for employee 120958
D 2340 + Forward DST change at 14:00 to 15:00
T 2340 Passing of 15:00
T 2400 Passing of 16:00
T 2460 Passing of 17:00
T 2520 Passing of 18:00
A 2520 120910 Punch at 18:00 for employee 120910
A 2401 120946 0 Punch at 18:01 for employee 120946, who started a new shift
when that employee punched at 13:00.
No D record for 14:00 (2280) is available because that time never "existed" in the
device.
The time of the last punch is relative to the 13:00 punch; the elapsed time between
the punches is 3:01, but the time change at the device record relates to the time of
the previous punch. It has been 3:01 since this employee last punched (2401
minus 2220 equals 181 minutes).
Note: The time of all transaction events is stored based on the device's current
local time. Since the DST state field appears only in the host command 108
response, use it carefully. The host software adjusts the time of the punch
according to its own rules when the punch is collected from the device. The only
piece of time-sensitive data missing is the time zone in which the event occurred.
This appendix provides information about using Series 4000 terminals with the
Data Collection Manager system.
This appendix contains the following sections:
• “Series 4000 terminal features” on page 460
• “Functional differences between Series 4000 and Series 400 devices” on page
461
Appendix D Using DCM with Series 4000 Terminals
Feature Description
Schedule enforcement Controls when specific employees can swipe badges.
Totals display Displays employee names, vacation, sick time, and other
totals at the device.
Message display Enables the devices to display messages for individual
employees.
Functions and Enables the devices to process various functions and
transactions transactions, such as labor account transfers and pay code
transactions.
Soft keys Keys that are configured to perform specific functions.
The names of the functions associated with each key are
configured to display on the screen. The display names can be
up to 40 characters in length. If necessary, the display name
wraps to the second line.
Function or
Characteristics Series 4000 Series 400
Punch status Employees can view Employees can view punch status,
information display punches, last punch, and elapsed time, and last punch.
punch status.
Individual employee Employees can display Employees can display and print
information display individual employee individual employee information.
information.
Entering a PIN Employees enter the Employees press the * key before
badge number directly. entering the badge number, except
for PIN-only devices (430, 450, or
470) or if the badge is configured on
the Badge Reader tab as None.
Supervisor functions Supervisors or managers Supervisors enter command numbers
use soft keys to initiate to initiate functions.
functions.
Device configuration Users configure devices in Users configure devices by using
DCM. DCM and AFT commands.
Installation and Performed by the Performed by a Kronos
maintenance customer. Representative.
Keys Soft keys. Function keys.
Modem configuration Users configure a dial-up Users configure the device with a
connection in Windows modem by using the Device Wizard.
first, and then configure
the device by using the
Device Wizard.
access profile
A user-specific file that determines which DCM components a user can access
and the types of functions a user can perform within the DCM system.
accrual
An amount of time or money that employees earn or accumulate over time, based
on a company’s employment terms and policy. Typically, an employee accrues
time for vacation days, sick days, and floating holidays. Employees can also
accrue money for bonuses, travel allowances, or uniforms.
accrual code
The account that identifies and holds the type of accrual balance, such as vacation,
sick, or bonus.
ad hoc query
A search for people in the Workforce Timekeeper system that you create and save
for use during your current session only. If Ad hoc is active, validation is turned
off at the device.
application client
An executable that runs an instance of an application.
application connection
The connection library and connection(s) specification that DCM uses when
transferring data between devices and host applications.
badge reader
The hardware that decodes data from badges, such as a bar code badge, magnetic
stripe badge, or proximity badge, and stores that data until an application collects it.
bell schedule
Bell time settings, including the optional warning bell settings, configured to ring
one bell.
bulk processing
A collection method that optimizes data collection performance by processing
simple punches in large blocks of data.
comment code
A comment code, and its associated comment text, is an item that is defined in the
Workforce Timekeeper Setup application. DCM comment code configuration
enables employees to enter comments at the device.
Communication Monitor
The DCM application that allows you to start and stop data collection, and
initialize and update devices. The Communication Monitor lists devices that are
responding and not responding, and the data and transactions that travel to and
from devices. In addition, you access the Transaction Data Editor from the
Communication Monitor. The Communication Monitor enables you to monitor
transactions between devices and the host applications that manage the
information.
communication channel
The transmission method (Ethernet, serial, or modem) that the communication PC
uses to communicate with one or more devices.
communication client
An executable that runs an instance of the communication channel.
communication driver
A dynamic link library (DDL) that is specific to the data collection method
supported by the devices; handles device handshaking, messaging, and error
processing for each device type and implements the high-level APIs that are used
to start data communication to devices.
communication (comm) PC
The PC that collects data from and downloads data to the devices.
communication type
A type of device communication—Ethernet, serial, or modem.
Configuration Options
The DCM application that enables you to set the configuration parameters for data
collection devices.
connection library
The DLL for the host application that provides interaction between DCM and the
host application.
cross-launch
After you log on to DCM, the Cross-Launch utility enables you to access other
applications in the Workforce Timekeeper application without logging on to the
applications separately.
cross-punching
Cross-punching allows a device to accept non-home employees. Validation is not
performed at the device when employee enters a punch.
device
The hardware that allows users to enter time and activity data, which is then sent
to host applications.
device group
A logical group of data collection devices. For example, all data collection
devices in a specific building might be called by one device group name.
Device Manager
The DCM application that enables you to create devices, communication
channels, and device groups, then assign the devices to device groups that use the
communication channels.
Device Wizard
A DCM utility that helps you create and edit devices and device groups.
Ethernet
Local Area Network (LAN) technology. Defined by the IEEE 802.3 specification.
event
An action or task that you schedule to run at specified intervals by using the Event
Manager application.
Event Manager
The DCM application that enables you to schedule events such as data collection
and device updates.
firmware
The software that resides on a device.
function key
A programmable button on a Series 400 device that allows employees and
supervisors to perform functions quickly.
gate entry
The configuration that unlocks a physical portal with an attached universal contact
relay that electrically opens the device, such as a door, turnstile, or swing gate.
global message
A user-entered message set up in the configuration user interface that appears on
the device display.
home employee
An employee assigned to a specific device or device group. These devices are
called the employees’ home devices.
host application
The Kronos application for which the device is collecting information. You use
the host application to update the device with new employee information and to
collect punches and transactions from the device.
HTTP
Hypertext Transfer Protocol defines how messages are sent and displayed
between websites and browsers.
in-punch
A punch that starts a work interval.
job set
A collection of jobs.
labor account
A labor account is the location where employees’ worked hours are accrued.
Employees are assigned a home account to which their hours are accrued, unless a
shift is an account transfer. Accounts consist of up to three or seven levels,
depending on your device, to allow you to clearly define the account. Start with a
general description.
legacy device
All devices except Series 4000 terminals.
log file
A file that continually accrues information; used as an audit trail and a diagnostic
tool.
messages
Device information, such as status and errors, that is returned from the host
application in response to a transaction.
monitor PC
One or more optional PCs on which DCM is installed. Monitor PCs monitor
communication between devices and the communication PC.
non-home employee
An employee not assigned to a particular device.
not responding
Not in communication with the communication channel.
out-punch
The punch that ends a work interval.
pay code
A category used to organize time and money. Time pay codes accrue hours, while
money pay codes accrue money. Examples of pay codes are Regular and Overtime
for worked or productive time. Jury Duty, Vacation, and Sick time are examples of
pay codes used for unworked time or non-productive time. Bonus is an example
of a pay code that holds monetary amounts.
pay rule
A set of rules that are used to calculate hours worked by employees. A pay rule
contains general payroll rules such as type of pay period (for example, weekly). A
complete pay rule controls such items as the pay period length, the day divide,
when punches link to schedules, when devices accept and reject punches, which
holidays give holiday credits, and the order that hour types are processed.
punch
Employee or supervisor input at a device as collected by DCM. The input
specifies the employee or supervisor attendance at work and the hours worked.
queue file
The file from which the host application collects data and enters it into the host
application.
request
An inquiry initiated by an application to a device or device group.
schedule
A series of days defined for items such as shifts and transactions.
Sentinel
The DCM application that launches communication channels for each
communication PC in the network.
shared directory
A directory that is network-accessible based on permissions assigned to the share
name by the system administrator.
simple punch
A badge read or Badge ID entry at the device that has no associated transaction
nor requires any other action, such as using a function key.
soft key
A programmable button on a Series 4000 terminal that allows employees and
supervisors to perform functions quickly.
status check
A feature in the Communication Monitor that allows you to verify whether or not
communications is available between a device or device group and the DCM
communication PC.
transfer
Hours charged to a labor account that is different from an employee’s home
account or hours charged to a work rule.
transaction
Information that travels from the devices to the host application for processing,
such as the time an employee punched in or out.
work rule
Work rules apply specific payroll rules to shifts. These rules determine how
employee hours accrue. Examples are breaks, overtimes, and pay code
distribution.
XML
Extensible Markup Language, a subset of the Standard Generalized Markup
Language (SGML) that facilitates data transfers between applications. Developers
create tags, tag definitions and validation rules that determine how the data is
transferred between applications.
I configuring 187
labor transfers
INI file values
badge types, selecting 185
using with DCM 419
editing generic badge format 187
initialization
enable # key for transfers 185
process 139
non-home employees 185
retry 140
restrict time on repunch 185
invalid transactions, correcting 235
specifying 165
IP addresses
standard badge labor level restrictions 186
changed 41
list size settings 423
DCM communication PC 48
loading configuration data 178
recommended 46
loading to a Series 400 device 293
Series 4000 modem 48
local reader options, Series 400 device 145
log file settings 118
J log files
job sets 162 centralized 118
job transfers maintenance 260
configuring 163 messages 323
function key setting 164 number 119
overview 161 severity reporting levels 118
soft key setting 164 viewer 260
log message files 118
L log messages 314, 410
labor level accounts, configuring 164 Log Viewer 260
labor level options logging on 25
selecting 184 logging on to DCM 21
labor level sets 183 logon
labor levels error messages 390, 392
assigning to function key 190 screen 25
assigning to soft key 190
definition 182 M
downloading 193 magnetic stripe readers 143
order for Series 400 device 188 manager badges
order for Series 4000 terminal 188 enabled 167
override 189 use 168
overview 182 manager soft key commands 172
removing 192 Manager tab 167
labor transfer options message display times 152
specifying 185 messages
labor transfer settings log 314, 410
parameter files R
deleting 116
exporting 298 rasphone 49, 51
extracting 296 Remote Access Service 47, 122
importing 297 Series 4000 terminal with modem 43
loading 295 reports
saving 117 DCM 25
partial transfers Series 4000 terminal 302
configuring 188 Series 4000 terminal configuration 303
password
S reports 302
troubleshooting 311
scan interval
server connections
FIFO 154
manually configuring 32
schedules
setting date and time
bell 96
Communication Monitor 300
gate 98
Device Manager 300
secure communications 54
Smart View transactions 105 to 112
Secure Sockets Layer
assigning to a function key 111
communication PC 55, 78
assigning to a soft key 111
device 82
copying 110
Sentinel 322
creating 107
accessing the database 277
deleting 111
disabling 274
editing 110
establishing communication with
in a NAT environment 109
applications 270
soft keys 105
monitoring
soft key commands
communication channels 272
employee 172
overview 268, 410
manager 172
shutting down 275, 276
soft key schedules
starting a communication channel 269
assigning to a function key 103
starting and stopping host application 275
copying 102
status monitoring 271
creating 101
viewing status of comm channels 272
deleting 103
Sentinel icon 272
editing 102
Sentinel Service
soft keys
application server properties 274
assigning labor levels 190
database properties 273
assigning tasks 171
overview 24
bell schedules 96
serial communication channels 38
enabling biometric verification 174
defining 60
gate schedules 98
Series 4000 modems
schedules 101
dial-up entry on Windows 2003 48
Smart View transactions 105
dial-up networking on Windows XP
uses 26
Professional 51
softload failure, Series 4000 terminal 291
IP address 43, 48
softloads 279
prerequisites 47
modem 81
troubleshooting 311
re-initializing 294
Series 4000 terminals
Series 400 device 293
biometric reports 302
Series 4000 terminal 280 to 290
configuration data 303
U
update process 140
upgrading firmware
Series 400 devices 293
Series 4000 terminal 280 to 290
uploading data 412
W
Web server
port setting 123
WFC application server instance, multiple 132
WFC connection 132