Setting up DC1 Time

Related topics

Note: The “Installing the DC1 Time Client” document is removed and can be found as a separate document included on the installation CD for Time Client.

What this document contains:

• General information
• Installation information
• Tables and files
• Authority control
• System values
• Attesting
• Communication
• Manufacturing reporting
• Payroll system interface
• Project reporting
• Panel texts
• Windows Client
• General
• Various system and terminal tables

General information

This document contains the activities to go through to prepare DC1 Time for usage after it has been installed on your computer.

DC1 Time has interfaces to the following types of systems:

• Manufacturing system
• Project system
• Payroll system

For DC1 Manufacturing and for DC1 Project Management the interfaces are complete.

Interface capabilities

For other manufacturing and project systems and for the payroll system some additional work has to be done to adapt the interfaces to the specific system that is used. See Interface capabilities.

Installation information

For a description on how to install the system on the iSeries, see the DC1 Technical Implementation Guide available on the Iptor Intranet.

Installation of a new company

For a description on how to generate a new company or how to copy one, see the DC1 Technical Implementation Guide (available on the Iptor Intranet) and the Panel help.

Loading data

Mandatory entries for the different files and tables are described. For a more thorough explanation of code usage and the operation of the different maintenance programs, see the Panel help.

The following area is also described:

• Standard terminal messages

There are a number of tables and files in DC1 Time that need to be initialised before the system can be used.

Prerequisites
To maintain the tables described you must have System Administration authority. For more information, see section Authority control below.

Tables and files

Some of the basic data maintenance functions have been added into the Table maintenance program table and are available for selection under application TME.

A number of enquiry programs have been added into the Enquiry program table and are available for selection under application TME.

Time shares the batch job table with DC1 Manufacturing. The table will be set up during company creation.

Number series table

Time will – when needed – open two number series into DC1. One for Card id numbers (301) and one for Consolidated order numbers (302).

Mandatory tables

The following tables should be maintained before you start using the system:

• User profile table
• System value table
• Process table
• Terminal tables (if external reporting terminals will be used)

Preloaded tables

The following tables are preloaded when a DC1 company is created or when running the Update preloaded application tables menu item.

Note: If update is repeated, then only new records are added. Existing records are not changed.

• Job schedule control table (TMJSCD)
• Process message table (TMMSGE)
• Process table (TMPROC)
• System program table (TMSPGM)
• System value group table (TMSYSG)
• System value table (TMSYSV)
• Terminal table (TMTRML)
• Terminal client table (TMTRMC)
• Terminal function list (TMTRMF)
• Terminal standard function table (TMTRMS)
• Job parameters table (MFJBPS)

Authority control

In addition to the menu item/program level authority in DC1 and the possibilities to tailor menus with Medea, there is an authority control in Time. The purpose of this control is to limit the access to only relevant information. These authority levels are maintained in the Time User profile table.

DC1 System Administrator

If you sign on as a DC1 System Administrator you are automatically granted access to all parts of the Time application.

The Time User profile table is an extension of the DC1 user profile table. The user id’s, created in the DC1 user profile table will automatically be created in the Time User profile table if the Time application is active. Deleting records is also done from the maintenance panel for the DC1 user profile table.

Maintenance of the records in the Time User profile table can be done from the Work with DC1 user profiles menu item. In the suite of panels there is one panel where the data specific for Time is maintained.

System administration authority

The system administration authority switch controls the access to application control information. If this field is set to NO (default value when created), then access is denied to the following functions:

• System value group maintenance
• System value maintenance
• User profile maintenance
• Process message maintenance
• Process maintenance
• System program table maintenance

Data authority

The data authority specifies the “user class”. It defines which functions that can be used and limits the data that can be accessed.

The following authorities can be assigned:

Code	Description
NONE	This value is assigned to user profiles that are not using DC1 Time or user profiles only using the time reporting functions. In the time reporting functions, a card number is used for identification and control of access to data.
EMPLOYEE	The user has access to personal data also from programs where a card number is not used for identification.
ATTEST GROUP	The user has full control over data related to specified attest groups. This means that the user acts as an attestor controlling and calculating the reported time of other employees. When this authority level is used the authorised attest groups must be stated in the Attestor table.
ALL	The user has access to all data related to employees and most basic data. Note: Be restrictive to grant this level. Attest group authority should, in most cases, be sufficient.

System values

The system values are company level parameters used to set up and customise the system. The system values control which functions that are active and the behaviour of functions in different parts of the application.

The System value table is preloaded when the DC1 company is created, but the preloaded values should be checked and adjusted before the system is used.

The system values are grouped as follows:

Value	Description
Attesting/Calculation	System values controlling the functionality in the attesting and calculation routines.
Communication	System values controlling the communication between Time and reporting terminals.
Manufacturing reporting	System values controlling manufacturing reporting and the interface between Time and a manufacturing system.
Payroll system interface	System values controlling the interface between DC1 Time and a payroll system.
Project reporting	System values controlling project reporting and the interface between Time and a project system.
Panel text	System values containing texts used on application panels.
Windows Client	System values for configuration of the Windows Reporting Client.
General	System values having a general influence in the application.

The system values are described by the following headings:

• System value code and short description
• Purpose (detailed description)
• Valid values
  Note: The preloaded value is in bold and underlined.
• Special considerations
• Dependencies with other system values

Attesting

Communication

Manufacturing reporting

Payroll system interface

Project reporting

Panel texts

Windows Client

General

Various system and terminal tables

System program table

The System program table (TMSPGM) in Time contains a list of batch routines that Time executes using the system process. An example of this is when ordering the time calculation directly from the attesting panels or when trying to delete a basic data record (like wage type).

The system process uses this table to determine if a completion message should be sent and to retrieve the text of the completion message when a task has been performed. The message is sent to the message queue of the user sending the request.

If completion messages should not be sent, then the switch can be turned off for individual tasks.

Process table

A process is an iSeries server job that is waiting for requests to perform different tasks. The requests are called messages and they must follow a predefined syntax so that the process driver program will be able to recognise which task that should be performed.

The Process table is accessed through the Work with processes menu item. Three processes are preloaded:

• TRM (Terminal)
• TMESAL (Payroll)
• TMESYS (System)

The system process and payroll process only receive messages and use data queues for the messages. The terminal processes can both receive and send messages and can use either data queues or files for incoming and outgoing messages.

At company generation, the associated data queues and data areas that must exist for a process are only created for the system process. You must, therefore, use the process maintenance function and create the necessary objects for the terminal and payroll processes.

Terminal

The terminal process or processes in Time serve the communication between the iSeries and external reporting terminals. The table is preloaded with one process for terminal communication, but you can create any number of this type of processes.

When a request is sent the external reporting terminal must supply the terminal name as an identifier for Time. By means of the configuration parameters in Time the request is sent to the right process.

The preloaded receiver programs contain the logic to receive the standard messages sent from the Windows Reporting Client and these messages types are defined in the Process message table.

It is possible to attach other reporting terminal systems to Time or define other types of requests by writing a new receiver program and define the message type.

Payroll

This process serves the interface from the payroll system, i.e., receiving and updating basic data. There can only be one payroll process.

The interface from the payroll system is described in Interface capabilities.

System

The system process is always running. It is used to:

• perform some batch tasks like employee calendar generation and time calculation (if not requested from Work with batch jobs),
• perform tasks related to the interface between Time and other applications as the manufacturing system, project system.

Job schedule control table

The purpose of this table is to facilitate the creation of scheduled jobs. Instead of directly using OS/400 commands, the table can be used to create and maintain scheduled job entries for three types of jobs:

• Start system process
• Stop system process
• Time calculation

The table is preloaded with one record for each type of job. For time calculation additional records can be created. This makes it for instance possible to run time calculation for different groups as different scheduled jobs.

The records in the table refer to a job description. The default job description, which is included in the shipment, is TMEJOBDSCD.

Before you activate any scheduled jobs, check that the initial library list of the job description contains the same product and system libraries as the initial library list of the environment in which you are working. To check the initial library list, select the Work with environments menu item and choose the applicable environment.

Job parameters table

This table is preloaded with all batch jobs available within DC1 Time. For each batch job the table contains default values for job attributes such as job queue and output queue as well as job specific parameters.

The Work with reports/jobs menu item contains functionality to maintain job attributes and parameters. New versions of a job can be created with different settings of parameters.

For documentation describing the parameters of the batch job, see the Panel help.

Parameters of type date, week or month can be defined by a formula and the actual value is then calculated when the job is executed. For further information, see the Panel help.

Job group table

A job group consists of a number of jobs that are executed together. For instance, instead of individually submitting each job that is run in the daily batch a job group containing these jobs is created and the job group is submitted.

The jobs in a job group and their parameters must have been defined in the Job parameters table.

Terminal tables

The terminal tables contain configuration parameters for external reporting terminals and must be maintained if external reporting terminals are used.

All external terminals must be defined in the Terminal table. If the Windows Reporting Client is used, then the configuration parameters in the Terminal client table should also be checked.

Related topics

• Interface capabilities
• Standard terminal messages
• About DC1 Time
• About the Windows Reporting Client