Key Manager Function 5

Sub-section Page
5.1 Presentation 5/2

5.2 Functions 5/4

5.2-1 Station Configurartion 5/4
5.2-2 Using the Station 5/5
5.2-3 Running an Application after a Key Module Failure 5/6

5.3 Accessing the Key Manager 5/7

5.4 Action Menu 5/9

5.4-1 Read Action 5/9
5.4-2 Transfer Action 5/10
5.4-3 Backup Action 5/11
5.4-4 Restore Action 5/13
5.4-5 Create Action 5/15
5.4-6 Increment Action 5/17

5.5 Key Module Markings 5/19

5.5-1 General 5/19
5.5-2 Example 5/20

5 / 1
5.1 Presentation
The Key Manager function is accessed from the primary window in the User Interface.
Telemecanique programs (except PL7-1 for TSX 17) are supplied with a software key
module (original key) that contains its rights of use.
The original key module lets the user access the basic functions of the User Interface.
The various PL7-X programs are individually protected with their own original key
modules.
In order to access a number of programs simultaneously on the same machine, the
various rights of use should be combined into a single key module. The Key Manager
accessed from the User Interface handles the various steps that ensure that the user has
a usable work key module.
When the Key Manager is invoked, the following screen is displayed:

KEYMANAGER
Action Exit

SLOT A SLOT B
Work Key No. 030500350 Empty Key No. 030500218
(Associate Key No. 030500216) (-----)
Bkp Symbol Cat Bkp Symbol Cat

B TSX L PL7 2 V5 (TE4)

B TSX L PL7 22 V5 (TE4)

Symbol Symbol
TSX L PL7 2 V5
Comment Comment
PL7-2 DOS for TSX 17-20

<F1> Help <F10> Menu

The first Key Manager screen displays the characteristics of the key modules (key
number and type, rights of access that it contains, etc.) present in the key module holder.
The user can pull-down two menus from the action bar, enabling selection of an action
to perform.

5/2
 Key Manager Function 5

Various steps are required to ensure that the user has a usable work key module.
A key module can take seven different states:
• Original key module:
The key module supplied with the program contains the original right of use.
• Work key module:
The key module comprises the rights of use after the backup key has been made.
• Backup key module:
A copy of the rights of use available for backup purposes.
• Help (emergency) key module:
A key module that lets the user continue to use the program for a limited amount of
time after a work key module failure.
• Empty key module:
A key module after its rights of use have been transferred.
• Temporary pass key module:
A key module with a limited service life that lets the user continue to use all
Telemecanique programs in X-TEL, MINI X-TEL or DOS (User Interface).
• Incremental key module:
A key module that is used to upgrade the rights of use in an original key module to the
latest version.

5/3
5.2 Functions

5.2-1 Station Configuration

Telemecanique programs are supplied with a software key module with a right of use.
This key module is called the original key module.
Before using the software key module, the user must perform the steps described in this
section.

Transfer the right of use

To use a number of different programs simultaneously, combining their rights of use into
a single software key module is recommended. This operation comprises transferring
the rights. A right of use can only be transferred from an original key module.
Once a transfer has been completed, for as many rights of use as required, a single work
key module contains all of the rights of use. The original key modules have become
empty key modules.

Transfer of rights of use Result

after transfer

α α
α
Original Key Empty Key Empty Key
β α β

β
β
Original Key

γ
Empty Key Empty Key
γ α β γ α β γ α β
γ
Original Key Original Key

Note:
The reverse action to union of the various rights of use restores them to their original software key
modules.

5/4
 Key Manager Function 5

5.2-2 Using the Station

Once the rights of use have been transferred to a single original software key module,
it is strongly recommended that a backup key module be made.
The backup operation creates a backup key module that the user should be sure to store
in a safe place. It is now possible for the user to start using the station with the work key
module just created.

Preliminary Operations
Using the Programs

γ α β γ α β
Original Key Work Key γ α β

γ α β Work Key

Empty Key Backup Key

Reversible operation

Store in a safe place

The backup key module is created using a empty key module.

Note:
The reverse operation, returning the rights of use to the original software key modules, regenerates
an original key from a work key module and a backup key.

Normal operation of the station is only possible with a work key module that contains the
rights of use for all of the programs that are installed on the station.
A program can only be started if its right of use is present.
During program execution, a regular check is made to ensure that the correct right of use
is present in the work key module.
If the work key module fails or is removed, the program informs the user that any work
in progress must be saved immediately and the station correctly and completely. After
approximately 10 minutes, the program stops execution making it impossible to save
any data on the application if it is still open.

The backup key module should be kept in a safe place. It does not allow the user
to use the rights it contains directly, this is only possible with the work key, but it does
let the user:
• Create an help key module that provides approximately 200 hours of operation,
giving time to procure a replacement for the failed work key module.
• A means of proving the rights of use that were originally transferred to the work
key module should the latter fail.

5/5
5.2-3 Running the Application after a Key Module Failure
Despite the care taken during production of the software key modules, it is always
possible that a failure may occur occasionally.
To ensure that the user can continue to use their programs while a replacement is being
obtained, a help key module can be created.
The help key module supports approximately 200 hours of operation, equal to approxi-
mately 25 eight hour working days.
The time base retained is 15 minutes. This means that the working life of the help key
module is reduced by 15 minutes each time one of the programs that it contains a right
of use for remains in service for 15 minutes.
When the 200 hours available are used up, the help key module can no longer be used.
Its service life cannot be extended.
As soon as a failure is detected on a station, the user should:
• Save work in progress,
• Retrieve the backup key previously stored in a safe place and along with the failed
work key module and an empty key module, proceed to create an help key module,
• Create an help key module (Create action). When this action is complete, the backup
key module will become an “inhibited key module”, no longer able to generate help key
modules and the empty key module becomes the help key module that allows
operation to proceed,
• Return the failed work key module and the inhibited key module to Telemecanique for
replacement.

Preliminary Operations Temporary Program Return to

Operation Telemecanique

γ α β Failure Failure γ α β
Work Key Work Key

Recover the Backup

Key Module

γ α β γ α β γ α β
Backup Key Inhibited Backup Key Inhibited
γ α β γ α β Backup Key

Empty Key Help Key Help Key

200 hr
life

Attention:
This operation cannot
be reversed

5/6
 Key Manager Function 5

5.3 Accessing the Key Manager

______________________________________________________________________________________________________________________

The Key Manager is accessed from the Keymngr menu in the User Interface screen.

Primary window

KEYMANAGER
Action Exit

SLOT A SLOT B
Work Key No. 030500350 Empty Key No. 030500218
(Associate Key No. 030500216) (-----)
Bkp Symbol Cat Bkp Symbol Cat

B TSX L PL7 2 V5 (TE4)

B TSX L PL7 22 V5 (TE4)

Symbol Symbol
TSX L PL7 2 V5
Comment Comment
PL7-2 DOS for TSX 17-20

<F1> Help <F10> Menu

The Key Manager primary window displays the characteristics of the key modules (serial
number and type of key module, rights of use available, etc.) located in the key module
holder slot. This window is described in detail in sub-section 5.4-1.

This window lets the user select an action to execute from those proposed in the two
menus displayed by accessing the action bar.

5/7
Diagram

Telemecanique - TSX17 [TSX17]

Files Communication Keymngr

Action Exit

Read Resume
Transfer Restart
Print Exit
BackUp
Restore
Create
Increment
About...

5/8
 Key Manager Function 5

5.4 Action Menu

_________________________________________________________________________________________________________________________________

5.4-1 Read Action

This window lets the user display the contents of the key modules inserted in key slots
A and B of the FTX 507 or FTX 417 terminal or the TSX SCC 02 key module holder when
using an IBM PS/2 or compatible microcomputer.

KEYMANAGER
Action Exit
1
SLOT A SLOT B
2 Help Key No. 030500350 Empty Key No. 030500218
Service Life = 200 hr / 200 hr
(-----)
(Associate Key No. 030500216)
3 Bkp Symbole Cat Bkp Symbol Cat

B TSX L PL7 2 V5 (TE4)

4
B TSX L PL7 22 V5 (TE4)

5
Symbol Symbol
6 TSX L PL7 2 V5
Comment Comment
7 PL7-2 DOS for TSX 17-20

<F1> Help <F10> Menu

This screen displays the following information for each key module:
1 its type and serial number,
2 the remaining amount of working time available in the case of a Help (emergency)
key module,
3 the serial number of the associate key module,
4 the rights of use available.

For each right of use in a key module, the screen displays:

5 whether it has been backed-up ("B" shown in the Bkp column),
6 the program catalog reference (shown in the Symbol column),
7 the full name of the program (shown in the Comments field).
The data contained in the Category field is reserved for use by Telemecanique.

5/9
5.4-2 Transfer Action
The transfer action lets the user transfer rights of use from one key module to another.
It lets the user combine or merge a number of rights of use for different programs into
the same key module.
Before starting the transfer action, the user should select the right(s) of use to be affected
by the operation and located in the original key module, identified by its location
(Transfer A B or B A).
Once this selection has been made, the following screen is displayed:

KEYMANAGER
Action Exit

SLOT A SLOT B
Work Key No. 030500350 Cle Vide No. 030500218
(Associate Key No.
List030500216)
of rights to be transfered. (-----)
Bkp Symbol Cat Bkp Symbole Cat
Bkp Symbol Cat
B TSX L PL7 2 V5(TE4)
B TSX L PL7 22 V5---(TE4)
TSX L PL7 2 V5 (TE4)

Symbol OK Symbole
Cancel Help
TSX L PL7 2 V5
Comment Commentaire
PL7-2 DOS for TSX 17-20

<F1> Help <F10> Menu

OK Transfers the selected rights of use,

Cancel Cancels the transfer and returns the user to the primary window of the
Key Manager.

5/10
 Key Manager Function 5

5.4-3 Backup Action

The Backup action should be used before any application program is used on the station.
This operation requires inserting a key module into both slots A and B:
• The original key module with the various rights of use for the programs to be used, and
• An empty (blank) key module.

Once the backup operation is complete,

• The original key module becomes the work key module, and
• The empty key module becomes a backup key module.
The screen shown below displays the status of the two key modules before the backup
action is performed:

KEYMANAGER
Action Exit

SLOT A SLOT B
Original Key No. 000024024 Empty Key No. 000024004
(-----) (-----)
Bkp Symbol Cat Bkp Symbol Cat

B TSX L PL7 2 V5(TE4)

B TSX L PL7 22 V5 (TE4)

Symbol Symbol
TSX L PL7 22 V5
Comment Comment
PL7-2 DOS TSX 17-20

<F1> Help <F10> Menu

5/11
Selecting the Backup action causes the following screen to be displayed:

KEYMANAGER
Action Exit

SLOT A SLOT B
Original Key No. 000024024 Empty Key No. 000024004
(-----) (-----)
Bkp Symbole Cat Bkp Symbole Cat

B TSX L PL7 2 V5(TE4)

B TSX L PL7 22 V5 (TE4) Perform Back-Up?

OK Cancel Help
Symbol Symbol
TSX L PL7 2 V5
Comment Comment
PL7-2 DOS TSX 17-20

<F1> Help <F10> Menu

Cancel Cancels the request and returns the user to the primary window of the
Key Manager function.
OK Starts the Backup procedure and displays the following screen:

KEYMANAGER
Action Exit

SLOT A SLOT B
Work Key No. 000024024 Backup Key No. 000024004
(Associate Key No. 000024004) (Associate Key No. 000024024)
Bkp Symbol Cat Bkp Symbol Cat

B TSX L PL7 2 V5 (TE4) – TSX L PL7 2 V5 (TE4)

B TSX L PL7 22 V5 (TE4) – TSX L PL7 22 V5 (TE4)

Symbol Symbol
TSX L PL7 2 V5 TSX L PL7 2 V5
Comment Comment
PL7-2 DOS for TSX 17-20 PL7-2 DOS for TSX 17-20

<F1> Help <F10> Menu

5/12
 Key Manager Function 5

5.4-4 Restore Action

The Restore action has the opposite effect to the Backup action.
This operation requires inserting a key module into both slots A and B:
• The work key module with the various rights of use for the programs used, and
• The appropriate backup key module for the work key module.
Once the Restore procedure is complete,
• The work key module becomes the original key module again. Therefore the rights of
use that it contains can be transferred to another key module using the Transfer action,
and
• The backup key module becomes an empty key module again.
The screen shown below displays the status of the two key modules before the restore
action is run:

KEYMANAGER
Action Exit

SLOT A SLOT B
Work Key No. 000024024 Backup Key No. 000024004
(Associate Key No. 000024004) (Associate Key No. 000024024)
Bkp Symbol Cat Bkp Symbol Cat

B TSX L PL7 2 V5(TE4) - TSX L PL7 2 V5(TE4)

B TSX L PL7 22 V5 (TE4) - TSX L PL7 22 V5(TE4)

Symbol Symbol
TSX L PL7 2 V5 TSX L PL7 2 V5
Comment Comment
PL7-2 DOS for TSX 17-20 PL7-2 DOS for TSX 17-20

<F1> Help <F10> Menu

5/13
Selecting the Restore action displays the following screen:

KEYMANAGER
Action Exit

SLOT A SLOT B
Work Key No. 000024024 Backup Key No. 000024004
(Associate Key No. 000024004) (Associate Key No. 000024024)
Bkp Symbole Cat Bkp Symbole Cat

B TSX L PL7 2 V5(TE4)

B TSX L PL7 22 V5 (TE4) Perform Restore?

OK Cancel Help
Symbol Symbol
TSX L PL7 2 V5
Comment Comment
PL7-2 DOS for TSX 17-20

<F1> Help <F10> Menu

Cancel Cancels the request and returns the user to the main screen of the Key
Manager.
OK Starts the Restore procedure and displays the following screen:

KEYMANAGER
Action Exit

SLOT A SLOT B
Original Key No. 000024004 Empty Key No. 000024024
(-----) (-----)
Bkp Symbol Cat Bkp Symbol Cat

– TSX L PL7 2 V5 (TE4)

– TSX L PL7 22 V5 (TE4)

Symbol Symbol
TSX L PL7 2 V5
Comment Comment
PL7-2 DOS for TSX 17-20

<F1> Help <F10> Menu

5/14
 Key Manager Function 5

5.4-5 Create Action

This action lets the user create a help key module in order to continue working in the
event of a work key module failure.
This operation requires inserting a key module into both slots A and B:
• The backup key module for the failed work key module, and
• An empty key module.
Selecting the Create action causes the following screen to be displayed:

Key Manager: Create

IMPORTANT

CREATION OF HELP KEY MODULE

This operation should only be performed after

failure of the Work Key Module.
The Help Key Module will enable this work station
to continue operating for 200 hours.
Once the Help Key Module has been created,
return the Work Key Module and the now inhibited
Backup Key to Telemecanique support.

Contact TELEMECANIQUE Support.

Create a Help Key Module?

OK Cancel Help

OK Starts the help key module create procedure,

Cancel Cancels the create action and returns the user to the primary window of
the Key Manager,
Help Displays on-line help.

5/15
Once the help key module has been created, the following screen displays the status
of the two keys:

KEYMANAGER
Action Exit

SLOT A SLOT B
Inhibited Backup Key No. 000024004 Help Key No. 000024024
Service Life = 200 hr / 200 hr
(Associate Key No. 000024024) (Associate Key No. 000024004)
Bkp Symbol Cat Bkp Symbol Cat

– TSX L PL7 2 V5 (TE4) B TSX L PL7 2 V5 (TE4)

– TSX L PL7 22 V5 (TE4) B TSX L PL7 22 V5 (TE4)

Symbol Symbol
TSX L PL7 2 V5 TSX L PL7 2 V5
Comment Comment
PL7-2 DOS for TSX 17-20 PL7-2 DOS for TSX 17-20

<F1> Help <F10> Menu

When this operation is complete,

• The backup key module becomes an inhibited backup key module and cannot be
used,
• The empty key module becomes a help key module. A help key module lets the user
continue to use the application programs for up to 200 working hours.

Warning:

The faulty work key module and the inhibited backup key module must both be
returned to Telemecanique together for replacement.

5/16
 Key Manager Function 5

5.4-6 Increment Action

The increment action, with an incremental key module and an original key module
containing the right of use for version level n of a program, allows the user to create a
new original key module with the right of use for the same program at version level n+1.
This action therefore allows the user to update an existing installed base of systems (e.g.
upgrading from PL7-2 version V3 to PL7-2 version V5).

This operation requires inserting key module in both slots A and B:

• The incremental key module with the updated rights of use,
• The original key module containing the initial right of use for the program used.
Activating the increment action displays the dialog box shown on the next page.

5/17
 Key Manager: Increment

IMPORTANT

INCREMENT OF A SOFTWARE RIGHT

This operation, using an incremental protection key

module, supports update of the level of software
protection.

Once the increment action is complete, the

INCREMENTAL key module is declared EMPTY.

Confirm the INCREMENT action?

OK Cancel Help

OK Runs the incrementation procedure

Cancel Cancels the incrementation procedure and returns the user to the Key
Manager primary window.
Once the increment action is complete,
• The original key module containing the right of use for version level n becomes the
original key module containing the right of user for version level n+1. Therefore all of
the rights of use that it contains can be transferred to another key module using the
Transfer action.
• The incremental key module becomes an empty key module.
The screen below shows the status of the two key modules once the increment action
is complete.
KEYMANAGER
Action Exit

SLOT A SLOT B
Empty Key No. 000024004 Original Key No. 000024024
(-----) (-----)
Bkp Symbol Cat Bkp Symbol Cat

– TSX L PL7 2 V5 (TE4)

Symbol Symbol
TSX L PL7 2 V5
Comment Comment
PL7-2 DOS for TSX 17-20

<F1> Help <F10> Menu

5/18
 Key Manager Function 5

5.5 Key Module Markings

5.5-1 General
The labels on the key modules are essential for ease of use, enabling:
• Identification of the type of key,
• Listing the rights of use contained in the key module,
• Displaying the key module serial number.

Label description Serial number

1
1 xxxxxxxx
Key module serial number.
Module Type
2 Type of key module: Empt Orig Work

Empt = Empty key module, 2

Back Inhi Help
Orig = Original key module,
Work = Work key module, Associate module
Back = Backup key module, Type Serial Numb

Inhi = Inhibited backup key module, 3

Telemecanique
Help = Help key module. Software

3 Type and serial number of the associate

key module.
4
4 Application program rights of use
transferred to the key module.

It is recommended that the user fill-in the labels completely and correctly as the various
operations are performed.

5/19
5.5-2 Example

Reception of two application programs

Program 1 Program 2
TSX L PL7 22V5 TSX L SYD V5

Serial number Serial number

9170022 9180023

Module Type Module Type

Empt Orig Work Empt Orig Work

Back Inhi Help Back Inhi Help

Associate module Associate module

Type Serial Numb Type Serial Numb

Telemecanique Telemecanique
Software Software
TSX L PL7 22V5 TSX L SYD V5

Key Module 1 Key Module 2

Merging rights in to Key Module 1

TSX L PL7 22V5 TSX L SYD V5

Serial number Serial number

9170022 9180023

Module Type Module Type

Empt Orig Work Empt Orig Work

Back Inhi Help Back Inhi Help

Associate module Associate module

Type Serial Numb Type Serial Numb

Telemecanique Telemecanique
Software Software
TSX L PL7 22V5 TSX L SYD V5
TSX L SYD V5

Key Module 1 Key Module 2

5/20
 PROM Programmer 6

Sub-Sections Page
6.1 Using the PROM Programmer 6/2
6.1-1 Primary Window Description 6/2
6.1-2 Function Key Actions 6/3

6.2 Selcting the Serial Port 6/4

6.3 Using the funcTion Menu 6/5

6.4 Using the File Menu 6/6

6.5 Selecting funcTion 6/7

6.5-1 PL7-1/PL7-2 Single-Cartridge Application 6/7
6.5-2 PL7-3 Single-Cartridge Application 6/8
6.5-3 PL7-3 Multiple-Cartridge Application 6/10

6 / 1
6.1 Using the PROM Programmer

The PROM Programmer function is used to write EPROM type memory cartridges used

m
to store PLC application programs.
Note:
The applications for V3 type stations must be imported into the User
Interface so that they can be processed by the PROM Programmer.
To use this function, the TSX TPE 01 cartridge programmer must be connected to the
terminal.

6.1-1 Primary Window Description

The primary screen lets the user access three pull-down menus for:
• Parametering the connection between the cartridge programmer and the terminal,
• Selecting the binary file to transfer,
• Determining the function to execute (write, read, compare).

PROM PROGRAMMER - TSX17 [TSX17]

File funcTion Port

FUNCTION : WRITE
FILE_NAME : TRIAL_1
SERIAL PORT : COM1

Cartridge
UVP 8K08 UTIL.
Blank

TELEMECANIQUE Copyright 1993

<F1> Help <F10> Menu

6/2
 PROM Programmer 6

6.1-2 Function Key Actions

<F1> Help: Calls-up the on-line help screens.

+*
<F10> Allows access to the action bar to select a pull-down menu (File, funcTion, Port).
A menu is selected by moving the reverse video highlighting with the keys
or by typing the keyboard shortcut for the appropriate menu

m
(e.g.: funcTion - T).
Note:
Pressing ” returns the user to the User Interface.
r Confirms a selection.
e Cancels the current command.

6/3
6.2 Selecting the Serial Port

The serial port selection screen is accessed by typing the keyboard shortcut P the
following screen is displayed:

PROM PROGRAMMER - TSX17 [TSX17]

File funcTion Port
com1
FUNCTION : com2 WRITE
FILE_NAME : com3 TRIAL_1
com4
SERIAL PORT : COM1

TELEMECANIQUE Copyright 1993

<F1> Help <F10> Menu

The =/ keys let the user move the selection bar to the appropriate serial port. Typing
the number of the port (e.g.: com2) will also select the port to connect.

The r key confirms the selection made and displays the primary screen with the
selected serial port shown. If the port does not exist or is not the one that the cartridge
programmer is connected to, an error message is displayed on-screen.

6/4
 PROM Programmer 6

6.3 Using the funcTion Menu

This menu is used to determine the type of action to perform. The pull-down menu can
be selected by pressing the keyboard shortcut T, the following screen is displayed:

PROM PROGRAMMER - TSX17 [TSX17]

File funcTion Port
Write
FUNCTION : Read
FILE_NAME : Compare
Write with Protection
SERIAL PORT checkSum
: Calculation

TELEMECANIQUE Copyright 1993

<F1> Help <F10> Menu

funcTion menu description

• Write: Transfers the application to the cartridge installed in the cartridge programmer.
• Read: Creates a binary application file from the data in the memory cartridge in the
cartridge programmer.
• Compare: Compares the contents of a memory cartridge with the contents of the
corresponding file.
• write with Protection: Transfers the application to the memory cartridge installed in
the cartridge programmer and inhibits read/write access to it by Telemecanique
terminals (PL7-1 and PL7-2 only).
• calculate checkSum: Defines the value in hexadecimal notation of the contents of
the memory cartridge (source → cartridge coherence check).

6/5
6.4 Using the File Menu

This menu lets the user select the binary file to transfer to the memory cartridge or quit
the PROM Programmer function and return to the User Interface.

PROM PROGRAMMER - TSX17 [TSX17]

File funcTion Port
File.bin
FUNCTION
eXit : WRITE
FILE_NAME : TRIAL_1
SERIAL PORT : COM1

TELEMECANIQUE Copyright 1993

<F1> Help <F10> Menu

The user can select the binary file to access by pressing r or typing the keyboard
shortcut F, the following window is displayed:

TRIAL_1 BIN 24709 24/06/1993 09:51

MOTOR BIN 24003 28/06/1993 19:21

OK Cancel

The binary files stored in the directory are listed in a window (as shown above), where

=/
the name of each file, its size in bytes, the date and time it was created are displayed.
The let the user select the file to transfer.
Pressing r confirms the selection made and displays the primary screen and the
selected binary file.
If the Read function is selected, the source for the data from the memory cartridge can
be:
• Not defined (no existing file)
• Defined (existing file - backed-up - protected)
in all cases, a menu lets the user determine the name of the target file from the data
transferred.

6/6
 PROM Programmer 6

6.5 Selecting funcTion

Once the various selections are made, (file.bin, port), this action can be selected.
There are three possible cases:
• PL7-1/PL7-2 single-cartridge application,
• PL7-3 single-cartridge application,
• PL7-3 multiple-cartridge application.

6.5-1 PL7-1/PL7-2 Single-Cartridge Application

From the funcTion menu, pressing r executes the source or target transfer for the
selected binary file.
Transfer progress is displayed on-screen in real-time. The user is informed that the
operation is complete when the message "FUNCTION COMPLETED" is displayed.
The screen below shows the action of writing to a cartridge in the programmer.

PROM PROGRAMMER - TSX17 [TSX17]

File funcTion Port

FUNCTION : WRITE
FILE_NAME : TRIAL_1
SERIAL PORT : COM1

WRITE
Cartridge
UVP 8K08 UTIL
Written

TELEMECANIQUE Copyright 1993

<F1> Help <F10> Menu

6/7
6.5-2 PL7-3 Single-Cartridge Application
From the funcTion menu, pressing r
displays the screen shown below, that shows the
word memory layout (part of the cartridge memory, refer to the V3 Reference Manual

=/
- Section 3) and places a cursor symbolizing the memory cartridge, in the memory
layout. This cursor can be moved in increments of 8 Kwords using the keys.

PROM PROGRAMMER - TSXV3 [TSXV3]

File foncTion Port
TSX MEMORY

FUNCTION : WRITE 1 8 kw

3
FILE_NAME : TRIAL_1
2
SERIAL PORT : COM1

64 kw
3

Cartridge
RPM 32K16 UTIL.
Written 128 kw

TELEMECANIQUE Copyright 1993

<F1> Help <F10> Menu

1 Data field (cannot be stored on an EPROM cartridge),

2 Program and constants field,

3 Blank memory space.

6/8
 PROM Programmer 6

The transfer is executed by pressing r. The binary file transferred is the one
determined when selections were made from the funcTion menu. Transfer progress is
displayed on-screen as shown below:

PROM PROGRAMMER - TSXV3 [TSXV3]

File funcTion Port
TSX MEMORY
8 kw
FUNCTION : WRITE
FILE_NAME : TRIAL_1
SERIAL PORT : COM1
64 kw

WRITE
Cartridge
RPM 32K16 UTIL.
Written
FUNCTION COMPLETED
TELEMECANIQUE Copyright 1993
<F1> Help <F10> Menu

The user is informed that the operation is complete when the message "FUNCTION
COMPLETED" is displayed.

6/9
6.5-3 PL7-3 Multiple-Cartridge Application

r
The access procedure is identical to that used for a PL7-3 single-cartridge application,
by pressing .
The main differences are:
• READ is impossible,
• The user must use the cursor to define the memory segments to write or compare for
each memory cartridge (as shown in the screen below).
Precautions to follow:
• Correctly identify the memory cartridges to avoid all confusion when inserting them
into the PLC,
• Define the memory fields for each cartridge, taking care to avoid any overlaps.

PROM PROGRAMMER - TSXV3 [TSXV3]

File funcTion Port
TSX MEMORY
8 kw
FUNCTION : WRITE
FILE_NAME : TRIAL_1
SERIAL PORT : COM1

64 kw

Cartridge
RPM 32K16 UTIL.
Written 128 kw

TELEMECANIQUE Copyright 1993

<F1> Help <F10> Menu
Cartridge n°1
Cartridge n°2
Cartridge n°3

r
The Cartridge 1 - 2 and 3 markers identify the memory fields used by each selected
segment. After pressing , progress of the transfer action is displayed on-screen in
real-time. The user is informed that the operation is complete when the message
"FUNCTION COMPLETED" is displayed.
The =/ keys let the user select the memory segments that apply to memory cartridges
2 and 3.

6/10
 Appendix 7

Sub-Sections Page
7.1 Program Storage Tree Layout in the User Interface 7/2

7.2 Application File Organization 7/3

7.3 Application Migration from PL7-1/2 V3 to V5 7/4

7.3-1 V3 Level 7/4
7.3-2 V5 Level 7/4

7.4 PL7-2 Application Migration in the Software Workshop 7/5

7.5 Installing a Utility Program 7/6

7.5-1 Purpose 7/6
7.5-2 Operating Mode 7/6
7.5-3 Conclusion 7/8

7.6 Telemecanique Help 7/9

7.7 List of Help Topics 7/10

7.8 RAM Requirements 7/11

7.9 Installing a PL7-3 V3 Program 7/11

7.9-1 Introduction 7/11
7.9-2 Installing PL7-3 Under DOS 7/12

7.10 Glossary 7/13

7.11 Forcing User Interface Parameters 7/14

7 / 1
7.1 Program Storage Tree Layout in the User Interface

The access path to programs installed in the User Interface is shown below.
Path: C:\XDOSSYS\EXE
•
•
•
pl72_17 . exe
pl72_47 . exe
pl7_1 . exe
promprog . exe
•
•
•
List of functions installed

The New → command in the File menu lets the user select the appropriate PL7
function for the PLC used.

x Example:
1 - TSX17_1 station: The User Interface displays PL7-1 and PROM
PROGRAMMER in the primary window.
2 - TSX27-47 station: The User Interface displays PL7-2-27/47 and PROM
PROGRAMMER in the primary window.

7 / 2
 Appendix 7

7.2 Application File Organization

Files linked to applications are stored as shown below:

C:\
XDOSPRJ
PROJDOS
projdos.dsc TSX17
projdos.prj
VV4.vol TSX17.sta PL7-2-17

APPLI

*.bin Application
*.dat Files
*.sym
…

MOD
Key:
*.SCY
Directories …
XXXX
Sub-directories

XXXX.XXX Files

The file storage layout of directories and files corresponds to an application developed
for a TSX17-20 using PL7-2 language.

7 / 3
7.3 Application Migration from PL7-1/2 V3 to V5

All applications developed with PL7 V3 can, after migration from V3 level to V5 level, be
used with PL7 V5 programs. The Import command supports the migration procedure
(refer to Sub-section 4.2-9).

7.3-1 V3 Level
The V3 level tools use the storage layout shown below:

C:\PL7USER\Objcode\files

Logical Device
Project Name Application Current
(the default name storage application files
is "USER") sub-directory

7.3-2 V5 Level
The V5 level tools use the storage layout shown below (for the work field):

C:\XDOSPRJ\project\station\function\zone\files

Application
Project Station Language Storage in Application
storage directory
Name Name used Sub-directory Files
(station (PL7X or <APPLI>
type by Sysdiag)
default)

Call-up the on-line help to refer to the storage layout equivalents for each program.

7 / 4
 Appendix 7

7.4 PL7-2 Application Migration in the Software Workshop

File migration can also be performed from the X-TEL or MINI X-TEL Software
Workshops to the User Interface environment or vice-versa.
The Import/Export functions are used to exchange applications between these environ-
ments.

!
Precautions:
• Before making a transfer, ensure compatibility between the source and
target zones.
• Do not transfer PL7-2 applications for TSX 17 PLCs to a TSX 27-47 type
station.

7 / 5
7.5 Installing a Utility Program

7.5-1 Purpose
Lets the user run a program installed under DOS from the User Interface environment
and automatically return to the User Interface once the task is complete.

7.5-2 Operating Mode

Requirement description

Allow the user to run the EPSILON utility directly in order to access files while remaining
in the User Interface operating environment.

m Note:
The command file name is "EPSILON.REF".

!
Setting-up the program and its parameters

Ensure that the required program is present under DOS.

Do not use the DOS SHELL command.

1 - Using DOS, access the <XDOSSYS> sub-directory

C:>\CD XDOSSYS r
2 - Select the <REFERE> sub-directory, and press r to confirm.
C:>\XDOSSYS\CD REFERE r
3 - Copy the "Standard.TE" file to the EPSILON.REF that will become the definition

!
of the executable program to run.
Note:
Terminology specific to the execution of files in the "User Interface" requires that
these files take the extension ".REF".
The appropriate command line is:
C:>\XDOSSYS\REFERE\Copy Standard.TE EPSILON.REF r

7/6
 Appendix 7

4 - Run a DOS editor. In this example "EDIT" in DOS 5.0 is used.

The operation described below will fill-in the definition "USER BLOCK".
C:>\XDOSSYS\REFERE\Edit EPSILON.REF r
The following screen is displayed:

g to fill-in: The
Lines g User Block

Fichier
File Edition
Edit Recherche
Search OptionsOptions Aide
Help
EPSILON.REF
NORTON.REF
REM= User block
1 PROD _NAME=<Enter the label of the name that you want to see in the list box>
2 EXE_NAME=<Enter the name and path of the run file (default path U : \xdossys\exe>
3 PAR_CONST=<Enter (static) parameters given to the run file>
REM= End user block
REM= -
REM= Block reserved by Telemecanique
REM= Do not modify this block
PARAM=
TITTLE=
TYPE=ALL#
PRJENVIR=XDOSPRJ\PROJDOS\<TYPE>\
SAVEPATH=ARCHIVE
SAVEFROM=PROJDOS
XTELCOMPAT=OUI
REM=#AIL# 1206444 78 50 A 01 70 STANDARD.TE #F#
REM= End block

Editeur
MS-DOS MS-DOS
Edit F1=Aide
F1=Help ALT=Activer
ALT=Menu le menu 00001:001

DOS Editor Window

File EPSILON.REF is the result of copying the standard.TE file

Line 1 - Enter the name used to call-up the utility to display in the program list.

! Note:
It is possible to install up to 20 programs tools (functions) in this list.
The data entry required is:
Example: PROD_NAME = EPSILON

7/7
Line 2 - Define the name and access path for the file to execute (the default path is:
C:\xdossys\exe).
C:\ is the prompt designating the logical drive selected when the User Interface was
installed.

For the example described above, the entry required is:

EXE_NAME=C:\DOS\EPSILON.EXE

Execution
Command
Storage
directory for
EPSILON

Line 3 - Name of the parameters to assign to the execution file.

For this example the corresponding line will be left blank.

7.5-3 Conclusion

Once the three lines have been filled-in, the user can invoke the TE command and use
EPSILON from the User Interface.

7/8
 Appendix 7

7.6 Telemecanique Help

The help screen shown below is displayed when the user presses ´

Files Categories Help=<F1>

Telemecanique On-line Help

X - Exit Telemecanique on-line help

HOME - Start of a topic
END - End of a Topic
PgUp - Move up one screen
PgDn - Move down one screen
UP - Move up one line
DOWN - Move down one line
→ - Move to the next button
← - Move to the previous button
ESCAPE - Exit the menu or a dialog box
Enter - Validate a selection

The menus can be chosen by entering their significant letter.

The Categories menu lists the Help topics available to the user.

Telemecanique On-line Help

7/9
7.7 List of Help Topics

The user can access the help topics via the Categories and List of Screens commands.

Fles Categories Help=<F1>

Screen_List

Pressing r to confirm will

display the screen shown below:

Files Categories Help=<F1>

GENERAL_INTRODUCTION
BASIC_PRINCIPLES
PRIMARY_WINDOW
LAUNCH_A_TOOL
COMPATIBILITY_V3_V5
INTEGRATION_OF_EXTERNAL_TOOLS
MENU_COMMANDS
FILE_MENU
menu_New : New
menu_Open : Open…
menu_Save : Save...
menu_Save_as : Save as…
menu_Delete : Delete…
menu_Rename : Rename…
menu_Backup : Backup…
menu_Restore : Restore…
menu_Import : Import…
menu_Export : Export…
menu_Dosshell : Dosshell
menu_Exit : Exit…

Screen_List

This is a complete list of the help topics available for the User Interface.

7/10
 Appendix 7

7.8 RAM Requirements

For the best system performance with Telemecanique programs, approx. 570 -
580 Kbytes of memory is required. Using the MEM command supported by DOS, check
the amount of memory available in your terminal.
If this is inadequate, make any necessary changes to the CONFIG.SYS file (such as
deleting unused drivers, etc.).

Reminder:
On FTX 417-20 terminals, the HIDOS.SYS utility loads the operating system kernel in
high memory, releasing some of the conventional memory located below the 640 Kbyte
boundary.

Typical CONFIG.SYS file for FTX417-20:

SHELL=C:\DRDOS\COMMAND.COM /P
BUFFER=10
FILES=10
LASTDRIVE=Z
COUNTRY=033,437, C:\DRDOS\COUNTRY.SYS
DEVICE=C:\DRDOS\VDISK.SYS 1024 512 32/E
DEVICE=C:\DRDOS\HIDOS.SYS /B=FFFF
DEVICE=C:\TE_TOOLS\SCATEMM.SYS
DEVICE=C:\XDOSSYS\EXE\DTSXPC.EXE INST=1 PORT=COM2 CONN=-1
MAXSPEED=19200 TELEMECANIQUE

The "FILES" and "BUFFER" values can be increased if there is enough memory
available in order to improve conditions of use for PL7-2.

7.9 Installing a PL7-3 V3 Program

7.9-1 Introduction
Installing a V3 level program after installing the User Interface should be avoided.
Any installation of V3 level software will cause the loss of the updated AUTOEXEC.BAT
and CONFIG.SYS files and therefore the data required to start and run the User
Interface.
If this cannot be avoided, always reinstall the User Interface.
Never install a program tool from the DOS Shell accessed via the User Interface.

7/11
7.9-2 Installing PL7-3 Under DOS

Follow the standard PL7-3 V3 installation procedure, then install the User Interface.
Use XDOSSYS\REFERE to edit the PL73 V3.REF file and modify the line PAR_CONST=
by replacing the variable "Vdu" with the letter corresponding to the virtual drive unit used
by PL7-3:

PROD_NAME=PL7-3 V3
EXE NAME=C:\TE_AP\PL7_3\PL73.COM
PARAM=
PAR_CONST=C Vdu COM2 Bin ← Vdu to fill-in after installing the
TITTLE= User Interface
TYPE=TSXV3
PRJENVIR=XDOSPRJ\PROJDOS\TSXV3\PL7_3\APPLI
SAVEPATH=ARCHIVE
SAVEFROM=PROJDOS
XTELCOMPAT=YES

7/12
 Appendix 7

7.10 Glossary

The terminology used in this manual comprises:

• Work field: Field on the terminal's logical disk drive that is used for the current
application.

• Archive field: A terminal disk or diskette field. When an application is saved, the user
determines which volume will be used (disk or diskette).

• Project: A single PLC automation application that is stored in the PROJDOS

directory.
An 8 character name is assigned to the project.

• Station: A device recognized by the User Interface. By default it corresponds to the

type of PLC.

• Tool: An element that provides a service for Telemecanique products. A tool can be
a program (programming tool) such as PL7-2 or a Telemecanique utility such as the
PROM PROGRAMMER or a third party utility program such as the EPSILON editor
used in the examples.

7/13
7.11 Forcing User Interface Parameters

A change of parameters, where necessary can be made as follows:

C:\TE Param1 Param2

Prompt Parameters

User Interface
Run Command

The parameter types are listed below:

Param(x):
Color → Forces color video
BW → Forces black and white video
COMx with x = 1 or 2 → Changes the communication port
(for V3 level programs)
NoBeep → No Beep (for V3 level programs)
UART → Changes the speed of data exchanges with the
PLC (for V3 level programs).

7/14