Schneider Electric XTEL User Guide

Below you will find brief information for TSX 67-30, TSX 87-10/20, TSX 47-30, TSX 67-20, TSX 87-30, TSX 47-400/410/411/420, TSX 67-410/420, TSX 87-410/420. This guide explains how to manage program module library databases using the XTEL-MOD option for the X-TEL Software Workshop, which is used when programming Telemecanique multifunction PLCs running V2, V3, V4 or V5 level software. The XTEL-MOD software permits the use of PL7-3 functional entities in the form of program modules or macro-modules, allowing coherent, documented and tested program sub-sets to be directly used in an application.

PDF

Document

________________________________________________________

XTEL-MOD Option

Contents Divider E

___________________________________________________________________________

Page

XTEL-MOD Reference Manual

1/1

1.1 Presentation

1.2 Defining a Program Module

1.3 Defining a Macro-module

1.4 Defining the Field or Context

1.5 Program Module Library Databases

1.6 Functions of Program Modules

1.7 Functions of Macro-modules

_______________________________________________________________________________________

Modular Application Construction

2/1

2.1 General Principles

2.2 Program Module Creation

2.3 Using Program Modules and Macro-modules

_______________________________________________________________________________________

XTEL-MOD Operating Modes

3/1

3.1 Hardware Description

3.2 Software Installation

3.3 General

3.4 SELECTION Menu

3.5 DEFINITION Menu

3.6 VIEW Menu

3.7 DOCUMENTATION Menu

3.8 USE Menu

3.9 Error Messages

___________________________________________________________________________

E / 1

___________________________________________________________________________

E / 2

___________________________________________________________________________

The main enhancements to the TXT L MDD V52 software in relation to TXT L MDD

V4 are as follows :

• Automatic reading of symbol tables relating to each program module and macromodule, in the station symbol database.

• The "replace multiple objects” function for function blocks has been extended : timer, monostable, up/down counter, register, text, control.

This new function also enables :

- the relocation of remote I/O and of associated bit objects and words

- the relocation of a set of labels

- the renumbering of an OFB and the associated bit objects and words.

• Enhanced command file (.M5M) which enables program modules and macro-modules to be integrated automatically into the PL7-3 application of the station.

• Program module code can be write-protected.

• A macro-module can be represented graphically by an associated "icon".

• Management of the documentation dossier of program modules and macro-modules.

• Program modules and macro-modules can be updated automatically in the station.

• Automatic recognition of the OFB internal constants.

It should be noted that the only major differences between TXT L MDD V52 and

TXT L MDD V5 are the recognition of the OFB internal constants and a new icon entry screen.

Compatibility rules

• XTEL-MOD tool reference TXT L MDD V52 is compatible with the X-TEL V5 and V52, and MINI X-TEL V5 and V52 Software Workshops.

• The upward compatibility rule is respected. A module base created with XTEL-MOD

V4, V42 or V5 can be reused, in a manner transparent to the user, by the XTEL-MOD tool reference TXT L MDD V52.

___________________________________________________________________________

P / 1

________________________________________________________

___________________________________________________________________________

P / 2

________________________________________________________

XTEL-MOD Reference Manual 1

Section 1

___________________________________________________________________________

1.1

Presentation

Page

1/3

_______________________________________________________________________________________

1.2

Defining a Program Module 1/4

1/5

_______________________________________________________________________________________

1.3

Defining a Macro-module 1/6

1/6

_______________________________________________________________________________________

1.4

Defining the Field or Context 1/7

1/7

1/8

_______________________________________________________________________________________

1.5

Program Library Databases 1/8

1/9

_______________________________________________________________________________________

1.6

Functions of Program Modules 1/10

1/10

1/11

1/12

1/13

1/14

___________________________________________________________________________

1 / 1

________________________________________________________

___________________________________________________________________________

Section 1

___________________________________________________________________________

1.7

Functions of Macro-modules

This section ends on page

Page

1/15

1/15

1/16

1/17

1/18

1/20

___________________________________________________________________________

1 / 2

XTEL-MOD Reference Manual 1

___________________________________________________________________________

1.1

Presentation

XTEL-MOD is an X-TEL Software Workshop option for managing the program module library database.

The XTEL-MOD program is used when programming Telemecanique multifunction

PLCs running V2, V3, V4 or V5 level software. These PLCs include :

TSX 67-30, TSX 87-10/20,

TSX 47-30, TSX 67-20, TSX 87-30,

TSX 47-400/410/411/420, TSX 67-410/420, TSX 87-410/420, TSX 107-410/420,

PMX 47-430, PMX 67-420, PMX 87-420, PMX 107-420/430,

TSX 47-405/415/425/455, TSX 67-425/455, TSX 87-425/455, TSX 107-425/455,

PMX 47-425/455, PMX 67-425/455, PMX 87-425/455, PMX 107-425/455.

This program can be accessed at two levels :

• At Project level, XTEL-MOD is a Project tool

• At Station level, XTEL-MOD is a Station tool.

PROJECT

XTEL-MOD

STATION 1

XTEL-MOD

STATION n

XTEL-MOD

PL7-3 Axis Comm PL7-3

The XTEL-MOD software permits the use of PL7-3 functional entities in the form of program modules or macro-modules. These coherent, documented and tested program sub-sets can be directly used in an application.

___________________________________________________________________________

1 / 3

___________________________________________________________________________

XTEL-MOD uses the program source files which are saved in the various specialized applications and accesses the MOD directories (program source file storage fields).

Example : OVEN3

PROJECT : FACTORY

OVEN3 (V5 station)

APP OVEN3. APP PLC program file

MOD

PL7_3 APPLI

MOD

OVEN3. BIN

OVEN3. CA1

- - - - - - - etc.

OVEN3. LIT

. GR7

. LAD

. COM

. CST

PL7-3 modular files

PL7_3 PL7-3 modules

- - - - - Other applications (future implementation)

_______________________________________________________________________________________

1.2

Defining a Program Module

PL7 programs are designed to support the saving of application program source files.

The program modules are formed with these application program source files. At present only PL7-3 supports this function.

A program module is a set of files which were developed in the various PL7-3 function programs and stored under one name. They form a coherent, known, documented and tested program element.

___________________________________________________________________________

1 / 4

XTEL-MOD Reference Manual 1

___________________________________________________________________________

1.2-1 Building a Program Module

When PL7-3 software is used, a module corresponds to a program module, i.e. an entity such as : SR, PRL, XM, etc, files generated by PL7-3 :

PROGRAM MODULE

ALARM2

SOURCE FILE Literal, Ladder, Grafcet ---------------------------------> ALARM2.LIT

SYMBOLS FILE (V4 station only) ----------------------------------------> ALARM2.SCY

CONSTANTS FILE -----------------------------------------------------------> ALARM2.CST

OFB INTERNAL CONSTANTS FILE ------------------------------------> ALARM2.OBM

COMMENTS FILE ------------------------------------------------------------> ALARM2.COM

+ +

IDENTIFICATION SHEET ALARM2.FRM

Within a program module library database, a module is assigned a name, a list of all of its component files and a list of criteria.

_______________________________________________________________________________________

1.2-2 Program Module Criteria

Criteria are additional information specific to a program module. They characterize a module and support sort functions, speeding access to the program module.

Two criteria are fixed : Date of creation or of the last update

User version level number.

Five criteria are available to the user. Each criterion can have up to eight characters.

The evolution index is updated in the usual way under OS/2, as soon as any of its parameters are changed.

___________________________________________________________________________

1 / 5

___________________________________________________________________________

1.3

Defining a Macro-module

_______________________________________________________________________________________

A macro-module is a set of commands concerning a given functional entity.

B database, with which are associated a coherent file of all the symbols and a macromodule identification sheet.

If the station is V5 level a graphic representation or "icon" can also be associated with the macro-module.

_______________________________________________________________________________________

1.3-1 Building a Macro-module

A macro-module corresponds to a part of the automated system managed as a whole and composed of a coherent set of program modules.

In a macro-module, there is no duplication of the modules of the program module library database, but only management of the references to the modules concerned.

Program module library base Macro-module

EVACUATION

Program module

PRL EVACUATION

Program module

XM1 EVACUATION

Program module

POST EVACUATION

EVACUATION .SCY

IDENTIFICATION SHEET EVACUATION .FRM

ICON (V5 station)

EVACUATION.ICON

Within a library database, a macro-module is associated with :

• Its name

• A list of references to the program modules of which it is composed

• A list of criteria similar to those of program modules (see Section 1.2-2).

___________________________________________________________________________

1 / 6

XTEL-MOD Reference Manual 1

___________________________________________________________________________

1.4

Defining the Field or Context

XTEL-MOD can be activated at two levels : Project and Station. Although invoking

XTEL-MOD always activates the same program, the features that are available to the user are different.

PROJECT: FACTORY

XTEL-MOD Project field

STATION: OVEN3

XTEL-MOD Station field

_______________________________________________________________________________________

1.4-1 Station Field

The program is part of the PLC station environment.

All of the features that are described on the following pages are available.

At program module level :

• Create a program module

• Use a program module

: Source : PL7-3

Target : the program module library database

: Source : the program module library database

Target : PL7-3

• Modify or delete a program module : acts on the selected program module library database

• View and print a program module

• Transfer a program module between program module library databases.

At macro-module level :

• Create a macro-module : Source : the program module library database

Target : the program module library database

• Use a macro-module : Source : the program module library database

Target : PL7-3

• Modify or delete a macro- module : acts on the selected program module library database

• View and print a macro-module

• Transfer a macro-module between program module library databases.

___________________________________________________________________________

1 / 7

___________________________________________________________________________

1.4-2 Project Field

The program is part of the environment for the whole project.

At project level the create, modify or use actions affecting a program module or

macro-module are inhibited, as they use data such as the source files that are stored in the station space.

XTEL-MOD is designed primarily to enable the user to access various program module library databases, in order to review their contents without having to go through all of the file storage levels.

In addition to the program module management functions, XTEL-MOD lets the user work with multiple program module libraries (or databases).

XTEL-MOD offers three levels : System library

Project library

External library.

_______________________________________________________________________________________

1.5

Program Module Library Databases

________________________________________________________________________________________

XTEL-MOD can access three different program module library databases which are managed by the X-TEL Software Workshop user.

Program modules in the same program module library are stored in the same directory.

The total number of program modules allowed in the same library is limited to 2000. All component files of a module take the same name as the program module.

XTEL-MOD provides information on the library by displaying a complete list of its component modules. The criteria for each module enable the user to select only part of the library using its built-in sort functions.

Example :

Alarm1

Alarm2

Isocent.

LIT-CST- SCY --- • V0

LIT-CST- SCY --- • V1

Elevat GR7 ---- SCY-COM • V0

Elv_hor GR7-CST- SCY-COM • V0

Elv_hor GR7 ---- SCY-COM • V1

LAD ---- SCY --- • V2

15-06-90

18-06-90

13-06-90

13-05-90

10-06-90

13-06-90

The directory display is the same for all module databases.

The list of modules stored in a module data database is stored in the .DIR file of the module database.

___________________________________________________________________________

1 / 8

XTEL-MOD Reference Manual 1

___________________________________________________________________________

1.5-1 Main Database

This program module library can be accessed by all of the projects developed on any one of the logical drives.

In this case, program modules are stored in the :\XPROSYS\mod\pl7_3 directory. The file which contains the full list of modules is main .dir.

Regardless of whether XTEL-MOD is invoked at station or at project level, it displays a list of program modules stored in a user transparent manner.

_______________________________________________________________________________________

1.5-2 Project Database

As its name indicates, this type of module database is assigned to a project. It is accessible to all V2/V3/V4/V5 level multifunction PLC stations in the project. For example, in the "factory" project the directory containing the program module library is

:\XPROPRJ\factory\mod\PL7-3. The list of modules is stored in the project.dir. file.

_______________________________________________________________________________________

1.5-3 External Database

External implies a program module data database that is external to the project or the hard disk of the X-TEL Software Workshop workstation.

This step is required when transferring program modules between workstations or between volumes.

___________________________________________________________________________

1 / 9

___________________________________________________________________________

1.6

Functions of Program Modules

_______________________________________________________________________________________

1.6-1 Summary of Functions

XTEL-MOD software enables the user to select a working program module library and

ACTIONS

View

Delete

Modify

Generate

ACTIONS

View

Delete

Modify

Generate

Transfer

MAIN

DATABASE

FACTORY

PROJECT

DATABASE

Transfer

EXTERNAL

DATABASE

Transfer

ACTIONS

View

Generate

Delete

Use

OVEN3

STATION

SPACE

Create

Modify

PL7-3 source files

___________________________________________________________________________

1 / 1 0

XTEL-MOD Reference Manual 1

___________________________________________________________________________

1.6-2 Create a Program Module

This function enables the user to generate a program module in the selected program module library database, from the source files which were generated by the PL7-3 function of the station and stored in the MOD field. The create function uses the .M5M

interface file for a V5 station and a .MOD interface file for a V3 or V4 station. In all cases the interface file is located in the station MOD directory.

XPROSYS XPROPRJ volume

PROJECT

Main database

Modules

Project database

Modules

XTEL-MOD

Create module

▲

STATION

PL7-3 Axe Comm

\MOD

SDB

SDBASE

▲

V3/V4 STATION .LIT

.LAD

.GR7

.SCY

.COM

.CST

.MOD

V5 STATION

.LIT

.LAD

.GR7

.COM .CST

.M5M

.OBC

.OBM

Creating a program module requires entry of its name as well as the source files that compose it. Entering the criteria and identification sheet is optional. When the program module is generated, XTEL-MOD performs the following operations :

• Checks that the program module does not already exist in the selected library

• For a V4 station, purges the .SCY file - only the symbols used in the source program file are retained

• Reads the program module symbols in the station symbol database for a V5 station

• Sorts the .CST file if this option is selected. Only the constants used in the source program file are retained.

• Purges the .COM file - only the comments used in the source program file are retained.

In the case of a system application comments file (V4 only), XTEL-MOD ensures the correspondence of the comments, the name of the source program file forming the module, and its address which is stored in the .MOD file

• Program module creation : all module component files are renamed (with the new program module name). Finally, the module library is updated with the version number set to V0.

___________________________________________________________________________

1 / 1 1

___________________________________________________________________________

Identification sheet

Entering information in the identification sheet is optional and is performed by default by the OS/2 editor using a standard layout. The identification sheet describes how to use the program module. It is the technical data sheet which describes how the program

B the various input and output parameters and internal data used in the module.

Module name :

Description :

Creation date :

Author :

Input parameters :

Output parameters :

Module characteristics [Type and number of data objects used] :

This sheet can also be edited from any other OS/2 editor.

_______________________________________________________________________________________

1.6-3 Modify a Program Module

The modify action is designed to enable the user to update a program module which is already present in the program module library. It changes the module :

• Name

• Component files

• Criteria.

After modification, module generation is performed in the same way as the creation of a new module.

_______________________________________________________________________________________

1.6-4 View a Program Module

The user can view a program module to refer to its various components. XTEL-MOD permits editing of the contents of the various files that comprise the program module and thus checks that the selected program module is the one required :

• Edit source files : Literal, Ladder and with Grafcet files, display the program layout, and the contents of transitions and actions

• Edit symbol, constant, OFB internal constant, and comment files, the

identification sheet, the list of program modules used in the current station (.MOD

file), and the command file of the current station (.MCR file) for V4 stations, the

command file of the current station (STATION.M5M) for V5 stations.

___________________________________________________________________________

1 / 1 2

XTEL-MOD Reference Manual 1

___________________________________________________________________________

1.6-5 Print a Program Module

This function enables a documentation dossier to be printed, depending on the various items selected. The dossier can be viewed, printed or used in the station dossier of the

XTEL-DOC tool (V5 station only). It is possible to print out the documentation dossier for a single program module, a series of program modules, or the entire program module library database.

_______________________________________________________________________________________

1.6-6 Use a Program Module

This function uses the program library modules in order to create a PL7-3 application file.

The use function makes a library module correspond to a PL7-3 address according to the Task - Module tree structure.

The use function copies program modules to the PL7-3 "MOD" field and allows program module objects and symbols to be renamed while ensuring the coherence of the station symbol table.

XPROSYS XPROPRJ volume

PROJECT

Main database

Modules

Project database

Modules E

XTEL-MOD

Use module

STATION

PL7-3 Axis Comm

\MOD

SDB

SDBASE V3/V4 STATION

.LIT

.LAD

.GR7

.SCY

.COM

.CDE

.CST

.MOD

.MCR

V5 STATION

.LIT

.LAD

.GR7

.COM

.CST

.M5M

For the transfer to take effect, the user must specify the name of the program module used, the PL7-3 target address (MAST: SR or MAIN, PRL, POST CHART or XM - IT

FAST AUXi: SR or MAIN).

In the case of MAIN, PRL or POST, the user can merge several modules.

Before using a program module, XTEL-MOD proposes an adaptation of the module to integrate it into its new environment.

___________________________________________________________________________

1 / 1 3

___________________________________________________________________________

It is possible to replace :

• Objects (bits, words, constants)

• Symbols in strings of symbols

• Labels B

• OFB number and increase the station symbol database (SDB).

XTEL-MOD checks the coherence of the user request :

• Checks that the program module exists in the current database

• Replaces variables which were redefined at the level of :

- The program file (.LIT, .LAD, .GR7)

- The symbols file (.SCY)

- The constants file (.CST)

- The OFB internal constants file

- The program comments file (.COM) if the label is redefined

• Copies the program module to the station field under PL7-3

• Modifies program comments file if required, to take into account the copy address in the station field

• For a V4 station, updates the .MOD and .MCR files in the PL7-3 program of the target station

• For a V5 station, updates the .M5M file in the PL7-3 program of the target station.

_______________________________________________________________________________________

1.6-7 Delete a Program Module

When applied only to a program module, this command is the opposite to the create command. It deletes the selected program module from the current database.

It is also possible to delete a series of program modules or a complete module database.

_______________________________________________________________________________________

1.6-8 Transfer a Program Module

This command applies to program modules, a series of program modules or a complete module database.

The user is placed in the source database and must define a target database.

When copying program modules, XTEL-MOD first checks that these program modules do not already exist in the target database and then performs the copy.

The transfer function can enrich module databases by creating and merging.

Note : The criteria linked to the program modules are transferred (maximum of 5 criteria).

___________________________________________________________________________

1 / 1 4

XTEL-MOD Reference Manual 1

___________________________________________________________________________

1.7

Functions of Macro-modules

1.7-1 Summary of Functions

XTEL-MOD enables the user to select a working program module library and depending on the environment, the following functions can be accessed :

ACTIONS

View

Create

Delete

Modify

Generate

MAIN

DATABASE

Transfer

EXTERNAL

DATABASE

FACTORY

ACTIONS

View

Create

Delete

Modify

Generate

PROJECT

DATABASE Transfer

ACTIONS

View

Delete

Generate

▼

OVEN3

STATION

SPACE

___________________________________________________________________________

1 / 1 5

___________________________________________________________________________

1.7-2 Create a Macro-module

This function enables the user to generate a macro-module in the selected module database, from the various program modules which already exist in the database.

This is not a real generation since, unlike the creation of a program module, there is no

B modules it contains. Consequently, the evolution of the macro-module is dependent on the evolution of the modules of which it is composed.

XPROSYS

Main database program modules macro-modules

Volume XPROPRJ

PROJECT

Project database program modules macro-modules

XTEL-MOD

CREATION of macro-modules

XTEL-MOD

CREATION of macro-modules

Creation of functional macro-modules from the program module library database

Module 1

M1 .LIT

.CST

.SCY

.COM

Base or library of program modules

Module 2

M2 .LAD

.SCY

.COM

......

Module I

.GR7

.SCY

......

Module N

CREATION

Macro1

Macro1 .SCY

M1 .SCY

Macro1 .SCY = M2 .SCY

MI .SCY

___________________________________________________________________________

1 / 1 6

XTEL-MOD Reference Manual 1

___________________________________________________________________________

Creating a macro-module requires the user to enter the name of the macro-module to be created and to select the program modules that it will contain. Entering the criteria, the identification sheet and the icon is optional.

The identification sheet is similar to that for the program modules and it is entered in the same way.

Entering the icon (V5 station) requires the definition of 3 lists of variables : input variables, internal variables and output variables of the macro-module.

During the generation of the macro-module, XTEL-MOD performs the following operations :

• Merging of the symbol tables of the various program modules so as to create the main table of the macro-module. During the merging operation, if there is an inconsistency between the various tables, creation of the macro-module is interrupted. Great care should therefore be taken during the construction of program modules in order to avoid errors.

• Creation of the macro-module : the main table of symbols of the macro-module is given the name of the macro-module and the macro-module database is updated with initialization of the version number to V0.

1.7-3 Modify a Macro-module

The modify function is used to update a macro-module that is already present in the selected database. It allows the following to be changed :

• The name

• The component modules

• The criteria

• The identification sheet

• The icon (V5 station only)

After modification, the generation of the macro-module takes place in the same way as during the creation of a macro-module.

_______________________________________________________________________________________

1.7-4 View a Macro-module

The user can view a macro-module to refer to its various components. XTEL-MOD enables the contents of the various files that comprise each program module in the macro-module to be edited :

• Edit source files relating to each program module : Literal, Ladder and with

Grafcet files, display the program layout, the contents of transitions and actions

• Edit constant, OFB internal constant, and comment files relating to each program module

• Edit symbols file relating to each macro-module

• Edit the identification sheet of the macro-module

• For V4 stations, edit the list of program modules used in the current station (.MOD

file), and the command file of the current station (.MCR file)

• For V5 stations, edit the command file used in the current station (STATION.M5M).

___________________________________________________________________________

1 / 1 7

___________________________________________________________________________

1.7-5 Print a Macro-module

This function enables a documentation dossier to be printed, depending on the various items selected. The dossier can be viewed, printed or used in the station dossier of the

XTEL-DOC tool (V5 station only). It is possible to print the documentation dossier for a

B database.

_______________________________________________________________________________________

1.7-6 Use a Macro-module

This function makes a PL7-3 entity correspond to each program module in the macromodule, according to the same principle as the Use a module command, and then :

• Copies the source files of each program module composing the macro-module into the PL7-3 "MOD" field

• Proposes the renaming of the objects and symbols of the macro-module while ensuring the coherence of the station symbol database.

For the transfer to take effect, the user must specify the name of each program module used, as well as the PL7-3 target entity (MAST: SR or MAIN, PRL, POST CHART or

XM-IT FAST AUXi: SR or MAIN).

Before using a macro-module, XTEL-MOD proposes an adaptation of the macromodule to integrate it into its new environment.

It is possible to replace :

• Objects (bits, words, constants)

• Symbols in strings of symbols

• Labels and enrich the station symbol database (SDB).

XTEL-MOD checks the coherence of the user request :

• Checks the existence of each program module in the current database

• Replaces variables which were redefined at the level of the program file (.LIT, .LAD,

.GR7), the symbols table (.SCY), and the program comments file (.COM, if the label is redefined)

• Copies each program module to the station field

• Modifies program comments if required, to take into account the copy address in the station field

• For V4 stations, updates the .MOD and .MCR files in the PL7-3 program of the target station

• For V5 stations, updates the .M5M file in the PL7-3 program of the target station.

___________________________________________________________________________

1 / 1 8

XTEL-MOD Reference Manual 1

___________________________________________________________________________

XPROSYS program modules macro-modules

Volume XPROPRJ

PROJECT

XTEL-MOD

Use

Macro-module program modules macro-modules

STATION

PL7-3 Axis Comm

\MOD

SDB

SDBASE

V3/V4 STATION

M1.LIT

M2.LAD

MI.GR7

M1.COM

M1.CSTM1.CDE

M2.COM

M2.CDE

MI.CDE

MACRO

.SCY

STATION

.MOD

.MCR

▼

V5 STATION

M1.LIT

M2.LAD

MI.GR7

MMAIN.COM

MSR0.COM

M1.CST

STATION

.M5M

___________________________________________________________________________

1 / 1 9

___________________________________________________________________________

1.7-7 Delete a Macro-module

This command enables the deletion of a single macro-module (it is the opposite of the create a macro-module function), or a series of macro-modules or all the macromodules of the current database.

Comments :

• Deleting a macro-module does not delete the modules it contains

• The main .SCY symbols file of the macro-module is also deleted.

_________________________________________________________________________

1.7-8 Transfer a Macro-module

This command can apply to a single macro-module, a series of macro-modules or all the macro-modules in the current database.

The user is placed in the source database and must define a target database.

Transferring a macro-module consists of transferring :

• All the program modules contained in the macro-module

• All the information attached to the macro-module : criteria, references to its component modules.

When copying macro-modules, XTEL-MOD first checks that each program module and macro-module does not already exist in the target database, and then performs the copy.

___________________________________________________________________________

1 / 2 0

________________________________________________________

Modular Application Construction 2

Section 2

___________________________________________________________________________

2.1

General Principles

Page

2/2

_______________________________________________________________________________________

2.2

Program Module Creation 2/5

2/5

2/9

2/11

______________________________________________________________________________________________________________________________________________________________________

2.3

Using Program Modules and Macro-modules 2/13

2/13

2/16

This section ends on page 2/16

___________________________________________________________________________

2 / 1

___________________________________________________________________________

2.1

General Principles

Terminology Reminder

• Program module : A module created with XTEL-MOD, which comprises one or more

• Macro-module : A functional entity composed of one or more program modules.

• PL7-3 program module : An entity of the PL7-3 program structure (eg : preliminary program in sequential processing, master task subroutine, etc).

• Source file : A PL7-3 file generated by a Write command or one which can be restored by a Read command from the PL7-3 application. These files are located in the

PL7_3\MOD directory of the current station.

Modular construction

Modular application construction in the X-TEL Software Workshop is organized around a library module database whose modules can be reused in the various stations of one project (project database) or in the stations of a number of projects (main database) :

Creating a program module and a macro-module

The selected module database draws its contents from modules taken from PL7-3 applications. There are two phases in the creation of a program module :

1 Generation of source files in PL7-3 comprising the PL7-3 module with its associated comments, symbols and constants.

2 Creation of the program module in the module database using XTEL-MOD : this takes into account the program source files created in PL7-3 in order to form the program module which can be used in the project database or main database.

Macro-modules are created in XTEL-MOD after the creation of the program modules, subsets of the macro-module :

3 Association of the program modules created under XTEL-MOD in order to create a macro-module that can be used in the project database or main database.

Source station Module base

WRITE

PL7-3 source files

CREATE modules

CREATE macromodule

SDB program modules macromodule

Generation of PL7-3 source files

Creation of program modules

Creation of macro-modules

___________________________________________________________________________

2 / 2

Modular Application Construction 2

___________________________________________________________________________

Using program modules and macro-modules

The program modules and macro-modules in a program database can be reused in a different context. There are three phases in the use of a module or macro-module :

1 Using a program module or a macro-module from the XTEL-MOD module database in the target station : extraction of program module or macro-module source files from the database, and customizing these files for the individual station context. The source files modified in this way are transferred to the target station space.

2 Updating of the station database (SDB) by merging the references, symbols and comments.

3 Integration of source files into the PL7-3 application : acceptance by PL7-3 of the source files by automatic re-reading of all the files transferred.

Module base Target station library modules

Using program modules or macromodule

Using macro-modules

USE module or macromodule files

Automatic rereading

SDB

2 updating of SDB

3 Integration of the source files into the

PL7-3 application

Note : A source program file can be a complete PL7-3 program module (eg : SR of an aux. task,

Macro-step XM, etc.) or part of a PL7-3 program module (eg : Master Task, Master Task pre-processing or post-processing).

___________________________________________________________________________

2 / 3

___________________________________________________________________________

Summary : creation of program modules and macro-modules, then use of the same modules in another station of the same project.

PL7-3 XTEL-MOD

APPLI

WRITE source files

▼

CREATE program module

PRL-LIFT

G7-LIFT

POST-LIFT

SDB

CREATE macro-module

LIFT macromodule

Translation

Check

APPLI

Automatic rereading

(RETRIEVE PL7-3)

Creation of the

.MCR

(V4 station) or .M5M

(V5 station) command file

Initialization of the symbol database

SDB

USE program module

USE macromodule

PL7-3 XTEL-MOD

___________________________________________________________________________

2 / 4

Modular Application Construction 2

___________________________________________________________________________

2.2

Program Module Creation

2.2-1 Generating PL7-3 Source Files

The PL7-3 source file generation phase can be executed in two different ways, depending on the action being performed :

• Creation of source files for the standardization of a functional module

• Extraction of an existing application in order to generate source files.

First case, creation of source files :

For V4 stations only, establish the list of

PL7-3 modules to generate

Generate the PL7-3 PL7-3 program source files

3 Write the comments

4 Generate the constants source file

1 For V4 type stations only establish the list of PL7-3 modules (TSXV4 or

PMXV4). This list enables the user to define the name of the program source file corresponding to each PL7-3 program module to be generated.

The LIST OF MODULES screen can be accessed from the PROGRAM ADDRESS

SELECTION screen (See the PL7-3 Operating Modes manual, Divider C,

Section 7.1-2).

Enter the name of each module in the list and save it in the MOD field using the

WRITE command and give it the same name as the station. Once the file is generated, it takes a .MOD extension.

If the user wants to create, for example, the functional entity “LIFT”, give the various subsets a name which associates this function with the PL7-3 module (eg.

PRL_LIFT, POST_LIFT, XM_LIFT).

2 / 5

___________________________________________________________________________

2 Enter each PL7-3 module and generate the program source files using the

WRITE command which can be accessed in each programming language. See the detailed description of the procedure in the PL7-3 Operating Modes manual :

. Literal : Divider E, Section 9.2-2

. Grafcet : Divider C, Section 7.2-3.

For V4 type stations, assign the source files the same name as the corresponding

PL7-3 program modules (defined in the PL7-3 program module list : [MODULE]

[WRITE]). For example PRL, LIFT, etc.

The program source files are automatically saved in the PL7_3\MOD directory, with the following extensions :

. LIT for a Literal program

. LAD for a Ladder program

. GR7 for a Grafcet program.

With Grafcet, the Grafcet source file can be saved with or without its actions and transitions. The macro-steps linked to the Grafcet chart are not saved.

3 The comment source files which are specific to each program source file must be entered in the MOD field.

From PL7-3 program modules, pressing <Alt> <C> lets the user enter comments directly into the MOD field.

In the case of V4 type stations each comment file automatically takes the name of the corresponding program source file (comment files have a .COM extension).

4 Enter the constants and generate the constants source file of the application

(See the PL7-3 Operating Modes manual, Divider F, Section 10.2-3).

It is not necessary to generate constants files specific to each program source file, as XTEL-MOD can sort the constants which are used in each module. The constant source file takes a .CST extension.

.OBC files and the .OBM file, which take the OFB internal constants into account, are generated automatically when the program source file is generated (WRITE command with OBC option).

Note : Using the [WRITE] [STR.NAME] [DIR] commands in the LIST OF MODULES screen displays a list of all source files generated in the MOD field.

___________________________________________________________________________

2 / 6

Modular Application Construction 2

___________________________________________________________________________

Second case, generation of source files from an existing application :

2 present in the MOD field

3 present in the MOD field, if not import them

Fill-in the list of modules generated from be accessed in each of the programming languages. For a detailed description of the procedure, see the PL7-3 Operating Modes manual :

• Literal : Divider E, Section 9.2-2

• Ladder : Divider D, Section 8.2-2

• Grafcet : Divider C, Section 7.2-3.

The program source files are automatically saved in the PL7_3\MOD directory, with the following extensions :

• LIT for a Literal program

• LAD for a Ladder program

• GR7 for a Grafcet program.

In the case of Grafcet programs, the Grafcet source file can be stored with or without the actions and transitions. Macro-steps linked to the Grafcet chart are not saved.

2 The constants source file of the application is generated by the PL7-3 constant mode WRITE command (see the PL7-3 Operating Modes manual, Divider F,

Section 10.2-3).

XTEL-MOD sorts the constants.

___________________________________________________________________________

2 / 7

___________________________________________________________________________

3 In the case of V4 stations the comments source files which are specific to each source file must be generated in the MOD field.

Check that the comments are in the MOD field. To do this, select

<ENTER> accesses the [APPLI] and [MODULE] dynamic soft keys.

[MODULE] also accesses the LIST OF MODULES screen.

Read the list of modules available :

[READ] [STR.NAME] [DIR] <ENTER> <ENTER> ([MODE] AUTO) <ENTER>

Select the various modules in succession and check whether they have a comment.

If no list of modules is displayed or if no comment was entered for the various modules in the MOD field, then the comments are in the APPLI field.

Comments in the MOD field

No operation is required. It is recommended however that the comment source files take the same names as the program files to which they are linked.

Comments in the APPLI field

The main application comments file (with the .COM extension) must be moved from the APPLI field to the MOD field using the IMPORT command (See the PL7-3

Operating Modes manual, Divider C, Section 7.2).

The comments are sorted by XTEL-MOD to link them to the various program modules. This sorting is performed at the level of the labels.

In the case of V5 stations the comments source files are automatically generated in the MOD field.

4 In the case of V4 stations only, the list of modules enables the user to assign to each PL7-3 program module the name of the corresponding program source file.

The LIST OF MODULES screen is accessed from the SELECT PROGRAM

ADDRESS screen (see "PL7-3 Operating Modes", Divider C, Section 7.1-2).

Enter each of the elements in this table and save the list in the MOD field using the

WRITE command. Give it the same name as the station (once generated, this file will have a .MOD extension).

Entering this list is required by XTEL-MOD, especially for sorting comments.

.OBC files and the .OBM file, which take the OFB internal constants into account, are generated automatically when the program source file is generated (WRITE command with OBC option).

Note : The [WRITE] [STR.NAME] and [DIR] commands accessible from the LIST OF

MODULES screen, enable all of the program source files generated in the MOD field to be displayed.

___________________________________________________________________________

2 / 8

Modular Application Construction 2

___________________________________________________________________________

2.2-2 Creating a Program Module in the XTEL-MOD Database

All program module creation is performed by the Create function in XTEL-MOD, which is described in Sections 1.6-2 and 3.5-1.

XTEL-MOD must be launched from the station where PL7-3 source program files were generated.

Select the source files that comprise the program module

Define the criteria values specific to the module

Enter the identification sheet

Copy the program source files to the program module

___________________________________________________________________________

2 / 9

___________________________________________________________________________

CD_BRN. LAD

HOPPER. LAD

MVDGS1.OBC

...

xxx.OBC

CD_BRN.OBM

OVEN3. COM

PRL_OVEN. COM

CD_BRN. COM

. . . . . . . . . . .

<Station>.MOD (V4)

Station MOD

STATION.M5M (V5)

PRL_OVEN.OBM

PRL_OVEN. COM

PRL_OVEN.COM

Identification sheet

Identification values

Criteria

values

SDB

Notes

Selection of the program source files which form a program module is made easier if the user ensures that the various program source files have the same name.

In the case of a V4 station the Modules used item in the Use menu displays a list of the

PL7-3 program modules used to generate each program source file linked to it (modules are identified by their task/module address in the application).

For each OFB which contains internal constants and is used in the program source, an

.OBC file is generated with the same name as the OFB. The .OBM file is associated with the program source and contains the .OBC list.

The module .OBM file does not have the same syntax as the function .OBM file.

___________________________________________________________________________

2 / 1 0

Modular Application Construction 2

___________________________________________________________________________

2.2-3 Creating a Macro-module in the XTEL-MOD Database

All macro-module creation is performed by the Create function in XTEL-MOD, which is described in Sections 1.7-2 and 3.5-3.

XTEL-MOD must be launched from a station.

Select the library modules that will compose the macro-module

Enter the identification sheet

5 Generation of the macro-module

___________________________________________________________________________

2 / 1 1

___________________________________________________________________________

Module base Module base macro-module OVEN

PRL_OVEN

Module

Reference file

(.REF) to :

XM_OVEN

Module

Create

•PRL_OVEN

•XM_OVEN

•POST_OVEN

POST_OVEN

Module

OVEN. SCY

Identification sheet

Icon

(V5 station)

Criteria values

PRL_EVAC

Module

XM_EVAC

Module

POST_EVAC

Module

Create

Macro-module

EVACUATION

Reference file

(.REF) to :

•PRL_EVAC

•XM_EVAC

•POST_EVAC

EVAC. SCY

Identification sheet

Criteria values

___________________________________________________________________________

2 / 1 2

Modular Application Construction 2

___________________________________________________________________________

2.3

Using Program Modules and Macro-modules

2.3-1 Using a Module from the XTEL-MOD Database

All operations using a library module (program module or macro-module) are performed via the Use function of XTEL-MOD, which is described in :

• Sections 1.6-6 and 3.7-1 for modules

• Sections 1.7-6 and 3.7-2 for macro-modules.

XTEL-MOD must be launched from the station in which the PL7-3 source program files will be integrated.

Assign the program source file to the application task and module

Adapt objects and symbols to the application

Merge the module symbol file into the station symbol database

Copy source files to the MOD field of PL7-3

___________________________________________________________________________

2 / 1 3

___________________________________________________________________________

Module base Target station

INITOVEN.OBM

INITOVEN. SCY

INITOVEN.SCY

Use

INITOVEN. SCY

Source files

INITOVEN.LAD

INITOVEN. LAD

INITOVEN.OBM

and xxx.OBC

INITOVEN. CST

INITOVEN.CST

INITOVEN. COM

INITOVEN.COM

INITOVEN. COM

Identification

V4 station :

Station name .MCR

V5 station : sheet

Criteria values

SDB

SDBASE initialization of the station symbol database

Macro-module OVEN

PRL. LAD

OVEN. SCY

•XM OVEN

• POS_OVEN

•POST OVEN

OVEN.SCY

sheet

Identification sheet

Criteria

Criteria values

Use

PRL. CST

V4 station

V5 station

MPRL.COM

V4 station

V5 station

MXMi.COM

V5 station

MPOST.COM

___________________________________________________________________________

2 / 1 4

POST. COM

POST.COM

Modular Application Construction 2

___________________________________________________________________________

V4 stations

XTEL-MOD generates two files in parallel for the PL7-3 application :

• A file of modules used (.MOD) :

This file is the image of the modules used in the application and can be displayed by

PL7-3 and by XTEL-MOD.

• A command file (.MCR) :

This file is re-read by PL7-3 in order to construct the application and can be displayed only in XTEL-MOD.

Integrating program modules in PL7-3

XTEL-MOD proposes two options for integrating a program module in the PL7-3 application :

• The New module option : reading by deletion

The program module gives its name to the PL7-3 module and deletes the contents of the target PL7-3 module.

• The Merge module option : reading by merging

The contents of the program module are merged with the contents of the PL7-3 target module.

V5 stations

XTEL-MOD generates a command file (.M5M) for the PL7-3 application. This file is re-read by PL7-3 in order to generate the application and can be displayed by

XTEL-MOD (view "command file") and by PL7-3 (contents comprise the module selection screen in Program mode).

Integrating program modules in PL7-3

XTEL-MOD proposes two options for integrating a program module in the PL7-3 application :

• The New module option : reading by deletion

The program module gives its name to the PL7-3 module and deletes the contents of the target PL7-3 module.

• The Merge module option : reading by merging

The contents of the program module are merged with the contents of the PL7-3 target module.

In addition XTEL-MOD write protects program modules while they are being integrated into the PL7-3 application.

___________________________________________________________________________

2 / 1 5

___________________________________________________________________________

2.3-2 Integrating Source Files in PL7-3

Initialize the application configuration:

I/O, Task, Grafcet, Read.APP

Retrieve the application data:

- Application (.BIN file)

- List of modules (.MOD file)

- Application source (.MCR file)

V5 station • application source (.M5M file)

Check the presence of the symbols and comments

Save the application files

1 Adjust the configuration so that it agrees with the modules to be re-read :

• I/O configured and I/O used, bit, word

• Auxiliary tasks, IT, FAST, XMi, Xi.

2 Restore the application data by the command RETRIEVE which is accessible on the PL7-3 Mode Selection screen. For details, see the PL7-3 Operating Modes manual, Divider A, Section 3.7-2.

3 Enter the Program mode.

Press <Alt> <C> to directly access the comments associated with the label or the

Grafcet page.

Check (and modify if necessary) each of the comments. The comments remain stored in the MOD field. The management of .COM files is automatic.

4 To save the newly formed application in the APPLI field : select STORE command on the PL7-3 mode selection screen.

Reminder : Once they are saved, the files required by the application are located as shown below :

In the APPLI field :

• Binary file, .BIN program with constants

In the MOD field :

• Command file .MCR (V4 station) or .M5M (V5 station)

• Comments files, .COM extension (automatic save)

2 / 1 6

________________________________________________________

XTEL-MOD Operating Modes 3

Section 3

___________________________________________________________________________

3.1

Hardware Description

Page

3/3

_______________________________________________________________________________________

3.2

Software Installation 3/4

3/4

3/5

_______________________________________________________________________________________

3.3

General 3/6

3/6

3/8

3/9

_______________________________________________________________________________________

3.4

Selection Menu 3/10

3/10

3/11

3/12

3/14

_______________________________________________________________________________________

3.5

Definition Menu 3/15

3/15

3/19

3/20

3/22

3/24

3/25

3/27

_______________________________________________________________________________________

3.6

VIEW Menu 3/28

3/28

3/30

___________________________________________________________________________

3 / 1

Section 3

___________________________________________________________________________

3.7

DOCUMENTATION Menu

Page

3/31

3/32

3/34

_______________________________________________________________________________________

3.8

Use Menu 3/35

3/35

3/47

3/49

3/50

3/51

3/53

_______________________________________________________________________________________

3.9

Error Messages 3/54

This section ends on page 3/68

___________________________________________________________________________

3 / 2

XTEL-MOD Operating Modes 3

___________________________________________________________________________

3.1

Hardware Description

_______________________________________________________________________________________

To use the XTEL-MOD program, you need a terminal with :

• OS/2 version 1.2, 1.3 or 2.1 operating system

• X-TEL or MINI X-TEL Software Workshop, PL7-3, PL7-3 GLD or PL7-3 GLT software

This means one of the hardware configurations described below :

• An FTX 507 or FTX 417-20 workstation with :

• 6 MB of RAM recommended

• A 40 MB hard disk

• A mouse (recommended).

• An IBM PS/2 or compatible microcomputer with :

• At least an 80286 microprocessor (80386 recommended)

• 6 MB of RAM recommended

• A 40 MB hard disk

• A high resolution EGA or VGA monitor

• A national or international keyboard

• A mouse (recommended).

The complete XTEL-MOD software package (Ref. TXT L MDD V52E) comprises :

• A 3 1/2" program diskette.

• A software key module

• This manual, Ref. TXT DM MDD V52E.

Documentation

TXT DM MDD V5E

†

Software Key

Module

Diskettes

XTEL-MOD

PL7 Program Module

Library Manager

Add to the

X-TEL Software Workshop documentation binder

†

X-TEL

Software Workshop

†

___________________________________________________________________________

3 / 3

___________________________________________________________________________

3.2

Software Installation

3.2-1 Fitting the Software Key Module

Fit the software key module into the empty location in the software key module holder.

Ensure that the microcomputer is powered-down before inserting the software key module.

Note : The software key module contains the right of use required to run the XTEL-MOD program.

The Key Manager tool, supplied with the X-TEL Software Workshop, lets the user transfer this right of use to the working key module, freeing a software key module holder slot. For further information on the use of the Key Manager tool, see the X-TEL or MINI X-TEL Software Workshop documentation, references TXT DM XTEL V52E or TXT DM BJR V52E.

_______________________________________________________________________________________

3.2-2 Initial Preparations

Before installing the XTEL-MOD program on the hard disk, it is recommended that the user :

• Carefully read the licence and guarantee certificates concerning the restrictions that apply to copying and installing the program.

• Make a copy of the program disk and use this disk for all installation procedures to avoid accidental damage to the original.

Important : The XTEL-MOD program diskette is supplied write-protected. Do not change the position of the write protect tab on the diskette.

_______________________________________________________________________________________

3.2-3 Installation Conditions

XTEL-MOD is run in the X-TEL or MINI X-TEL Software Workshop environment.

The Software Workshop must already be installed on the workstation.

Before installing XTEL-MOD, ensure that at least 500 KB of free space is available on the target hard disk partition.

___________________________________________________________________________

3 / 4

XTEL-MOD Operating Modes 3

___________________________________________________________________________

3.2-4 Installation Procedure

The following operations must be performed before the XTEL-MOD program is installed :

• Ensure that the X-TEL or MINI X-TEL Software Workshop is already installed,

and that it is the correct version. To check this :

Open the Telemecanique group and check the XTEL icon is there :

- if the XTEL icon does not exist, proceed to the installation of the Software Workshop

(see the relevant documentation)

- if the XTEL icon is there, activate it to open the User window. Then pull down the

"Display" menu and select the "About" command. Check that the Software Workshop is version 5. If this is not the case, install this version (see the relevant documentation).

• Close all work sessions in progress (see relevant documentation)

• Install the XTEL-MOD software. To do this :

- open an OS/2 full screen session

- insert the diskette into the disk drive

- type the identification letter of the drive (a: or b:) containing the diskette and press

<Enter> to confirm

- enter the installation command from the new prompt (eg. [a:\] or [b:\]), and press

<Enter> to confirm

- follow the procedure displayed on the screen, and press <Enter> to confirm

- when the installation is complete, if it is the last, perform a configuration command and press <Enter> to confirm

- remove the diskette from the disk drive and return to X-TEL or MINI X-TEL with the <Ctrl><Escape> command.

___________________________________________________________________________

3 / 5

___________________________________________________________________________

3.3

General

3.3-1 Accessing XTEL-MOD

XTEL-MOD can be run at :

• Project level, when managing program module or macro-module databases.

X-TEL

Select a volume

Select a project

Select XTEL-MOD from PROJECT-TOOLS

• Station level, when creating, using and managing program module or macro-module databases.

X-TEL

Select a volume

Select a project

Select a station

Select XTEL-MOD from STATION-TOOLS

In both cases the same XTEL-MOD program is run. It accesses the same program module or macro-module databases, only the commands available to the user are different (refer to the table below).

Module or

Project field

Project Main

Station field

External Project Main External

Generate dossier yes yes yes yes yes yes yes yes yes yes yes yes yes yes yes yes yes yes yes yes yes yes yes yes yes yes yes yes

Automatic use yes yes yes yes

Note : XTEL-MOD must first be defined at project level before it can be defined in one of the stations of that project.

___________________________________________________________________________

3 / 6

XTEL-MOD Operating Modes 3

___________________________________________________________________________

Primary window

The XTEL-MOD primary window enables the user to select an action to perform from one of the seven menus displayed in the action bar.

The secondary window displays by default the list of basic modules or macro-modules contained in the project database. The following data is specified for each basic module or macro-module :

• Its name (8 characters maximum)

• The file name extensions of the files in the module (basic modules only) :

• LIT for a Literal source file

• LAD for a Ladder Diagram source file

• GR7 for a Grafcet source file

• CST for a constants source file

• SCY for a symbols source file

• COM for a program comments file

• Its version

• The creation or modification date of the module

• And in the Criteria field, the names and values of the user defined criteria.

The modules available are displayed by using the vertical scroll box. A module is selected by clicking on it.

___________________________________________________________________________

3 / 7

___________________________________________________________________________

3.3-2 Primary Window Menu

B mod

Window

Display criteria

About

Define

Create

Delete

View

View

Printing

Generate

View

Transfer

Use

Manual

Automatic

Use

Init command file

Command file

Modules used

XTEL-MOD also displays the usual Exit and Help menus.

Selection Menu

• Window

• Database

• Function

• Display

• Display criteria

• About

Selects the display mode : basic module or macro-modules.

Selects the working database (project, main or external).

Selects the type of source file : PL7-3.

Selective display (by criteria) of the basic modules or macro-modules in the database.

Selects the criteria that will be used to selectively list the basic modules or macro-modules in the database.

Displays the software version.

Define Menu

• Create Creates basic modules from PL7-3 source files or creates macromodules.

• Modification Modifies basic modules or macro-modules.

• Delete Deletes the selected basic modules or macro-modules.

• Transfer Transfers basic modules or macro-modules between two databases.

___________________________________________________________________________

3 / 8

XTEL-MOD Operating Modes 3

___________________________________________________________________________

View Menu

• View Displays the contents of the source files that form the selected basic module or macro-module.

Documentation menu

• Generate

• View

• Print

Creates the documentation dossier associated with the selected basic module(s) or macro-module(s).

Displays the contents of the last documentation dossier executed

(basic module or macro-module).

Prints the contents of the last documentation dossier executed (basic module or macro-module).

Use Menu

• Manual

• Automatic

Uses basic modules and/or macro-modules in the PL7-3 application.

Re-uses basic modules and/or macro-modules in the PL7-3 application.

• Use RESET Initializes the file of the basic modules and/or macro-modules to be read by the PL7-3 application (.MCR file for V4 stations and .M5M file for V5 stations).

• Command file Displays the contents of the file of basic modules and/or macromodules to be read by the PL7-3 application (.MCR file for V4 stations and .M5M file for V5 stations).

• Modules used Displays the contents of the .MOD file for V4 stations only.

3.3-3 Using the Keyboard

In the primary window :

<F10> accesses the primary window menu and returns to the secondary window.

In the dialog boxes :

<TAB> and <SHIFT> <TAB> move the cursor between data entry fields.

The up or down arrow keys make selections within the same action field.

The left and right arrow keys move the cursor within a data entry field.

___________________________________________________________________________

3 / 9

___________________________________________________________________________

3.4

Selection Menu

3.4-1 Selecting the Display Mode of the List

The Window function enables the user to select the current work mode : basic modules or macro-modules.

When the List of Modules is displayed, the work mode is : basic modules.

When the List of Macro-modules is displayed, the work mode is : macro-modules.

Note : The work mode can also be selected by double clicking on the corresponding icon.

___________________________________________________________________________

3 / 1 0

XTEL-MOD Operating Modes 3

___________________________________________________________________________

3.4-2 Select Database

The Database function enables the user to select the working database (Main, Project or External) and to display its contents.

The working database (basic modules or macro-modules) is selected by choosing the corresponding option in the menu :

• System : system database

• Project : project database (selected by default)

• External : external database.

When an external database is selected, a dialog box appears in order to specify the drive and the path used to access the external database in the data entry field. For example : a:\EXTBASE1\MOD (tree structure must end in

\MOD).

___________________________________________________________________________

3 / 1 1

___________________________________________________________________________

3.4-3 Selective Access to Basic Modules or Macro-modules

The Display function enables the user to list only the basic modules or macro-modules which correspond to one or all the values of a given criterion. Two criteria are automatically implemented : creation date and version level. Five further criteria can be added by the user.

The criteria are created using the Display Criteria function. The criteria values are specific to each basic module or macro-module and are entered when the basic modules or macro-modules are created (see Section 3.5-1).

The Display function enables the user to access the "CRITERIA LIST" dialog box, which is used to select the criteria to be included.

Note

Two additional items are displayed by the Display function :

• "Macro-module" in the case of basic modules. This item enables all basic modules contained in a given macro-module to be listed.

• "Modules" in the case of macro-modules. This item enables all macromodules containing a given module to be listed.

___________________________________________________________________________

3 / 1 2

XTEL-MOD Operating Modes 3

___________________________________________________________________________

When a criterion to be included is selected :

Validate validates the selection and displays the"CRITERIA

VALUES” dialog box illustrated opposite.

Select the criterion value.

Validate validates the selection and only lists the basic modules or the macro-modules corresponding to the selected criterion value.

Note

Whatever criterion is selected, the list of basic module and macro-module names is arranged in alphabetical order.

___________________________________________________________________________

3 / 1 3

___________________________________________________________________________

3.4-4 Creating Display Criteria

The Display Criteria function enables a maximum of 5 display criteria for a module database to be defined. A criterion is a string of up to 8 alphanumeric characters. The

B entered when these modules are created or modified.

Display Criteria dialog box

Value :

Create :

Delete :

Validate :

Cancel :

Data field for entry of the criterion.

Adds the criterion entered to the list of criteria in the Delete field.

Deletes the criterion selected in the Delete list.

Validates all modifications made.

Cancels all modifications made.

___________________________________________________________________________

3 / 1 4

XTEL-MOD Operating Modes 3

___________________________________________________________________________

3.5

Definition Menu

3.5-1 Basic Module Creation

This function enables the user to create basic modules from the PL7-3 source files of the station in which XTEL-MOD is being executed.

Access

Access level Project field Station field

Module database Project Main External Project Main External accessible

The "Create" function in the Definition menu displays the dialog box below :

Entering module components

The module is created by filling in the display fields of the dialog box.

Name of the program module to be created

A name of 8 alphanumeric characters by which the module and its components will be identified (after validation).

___________________________________________________________________________

3 / 1 5

___________________________________________________________________________

Source program field

Select the language of the source program (Literal, Ladder, Grafcet, or the No source option if required).

Source source files available in the selected language. Select the required source file from the list displayed.

Other sources field

Constants Clicking on the Constants button displays a dialog box with the list of constants files available. Select the required constants file from the list displayed.

Comments Clicking on the Comments button displays a dialog box with thelist of comments files available. Select the required comments file from the list displayed.

The action bar offers three commands :

• Enter criteria

Enter criteria displays a dialog box in which to enter the value of one or more criteria.

Validate validates the entry.

Cancel cancels the entry.

___________________________________________________________________________

3 / 1 6

XTEL-MOD Operating Modes 3

___________________________________________________________________________

Identification sheet

A standard identification sheet is offered by XTEL-MOD using the OS/2 text editor : E.

The standard layout can be modified or deleted. Data entry is by default using the standard OS/2 system editor commands (see the OS/2 documentation). The Editor item enables a different editor to be selected.

___________________________________________________________________________

3 / 1 7

___________________________________________________________________________

Reminder of OS/2 editor commands :

The cursor is moved by using the cursor control keys (Up, Down, Left and Right arrows).

<F10> (or <Alt>) : accesses the Edit menus.

<F1> <F9> : access to the Keys help screen.

<F1> < F11> : access to the system editor help index.

• "Sorting of constants" options (see Note)

The Options menu enables the user to select filtering of the constants or not, as required, during the creation of the module. Filtering is selected by default.

For PMX V5 and TSX V5 stations, XTEL -MOD handles the automatic recognition of the

OFB internal constants.

When all the components of the module have been entered in the "Create Basic

Module" dialog box :

Ok Runs a check on the parameters entered. If no errors are found, Ok performs the following actions :

• Creation of a new module in the current database and copying and renaming of all its component files. The newly created module has version level 0.

• The symbols used in the program source are read in the station symbol database and are retained in an .SCY file.

• Building of an .OBM file containing the OFB internal constants used in the program source.

• If a comment file is selected, filtering is performed : only those symbols that are actually used in the associated program source file are retained. If the sorting cannot be performed automatically (list of PL7-3 modules not generated for a V4 station or a V5 station has no STATION.M5M file),

XTEL-MOD displays the "Purge comment file" dialog box that enables the user to enter the PL7-3 program address (task, module) of the corresponding source file.

• If the Sorting of constants option has been selected, filtering is performed.

Only the constants which are actually used in the associated program source file are retained.

Note

• The filtering of the comments file affects the PL7-3 program address (task, module) and the labels contained in the program source.

• The table of symbols relating to the module is sorted alphanumerically. If the table is too large, a message informs the user that the sorting cannot be performed (this has no effect on the rest of the operations).

• Sorting of constants : if the program module contains an OFB MSIT or MSITN EXEC, DO

NOT USE THE SORTING OPTION, in order to maintain the save forcing situation in the constants.

___________________________________________________________________________

3 / 1 8

XTEL-MOD Operating Modes 3

___________________________________________________________________________

3.5-2 Basic Module Modification

This function enables the user to modify basic modules : name, criteria, components, identification sheet.

Access

Access level Project field Station field

Module database Project Main External Project Main External accessible

Select the program module to be modified from the list of modules in the database.

The Modification function in the Definition menu accesses the dialog box shown below :

All the commands available are identical to those in the "Create Basic Module" dialog box (see Section 3.5-1).

Note : When a module component is modified (by the selection of a different file in the displayed list), it is identified by the symbol [n]. This symbol enables the user to distinguish the source files of the station from those in the current database.

If the name of the module is modified, the user can retain the old module. When the modifications are validated, the version level is incremented and the date changed in the list of modules.

___________________________________________________________________________

3 / 1 9

___________________________________________________________________________

3.5-3 Macro-module Creation

This function enables the user to create macro-modules from the basic modules which exist in a given database.

Access

Access level

Project field Station field

Module database Project Main External Project Main External accessible

Select the display mode of the list :

• Either by using the Selection menu and the Window and List of macro-modules sub-menus

• Or by double-clicking on the MACRO-MODULE icon.

The Create function in the Definition menu accesses the dialog box shown below :

Entering macro-module components

A macro-module is created by selecting the program modules in the “Select modules

from the database” list. The modules selected are displayed in the “Modules selected” list.

Name of the macro-module to be created

3 / 2 0

XTEL-MOD Operating Modes 3

___________________________________________________________________________

The action bar offers three commands :

• Entry value

Enter the values of the criteria associated with the macro-module, (the same procedure as for basic modules, see Section 3.5-1).

• Identification sheet

Enter the identification sheet of the macro-module (the same procedure as for basic modules, see Section 3.5-1).

• Icon option

Enables the creation of a graphic icon associated with the macro-module. The screen for defining the icon is displayed after Ok (see the next section).

By default, this option is not selected.

This command runs a check on the parameters entered. If no errors are found, Ok performs the following actions :

• Merging of the tables of symbols of the various modules composing the macro-module

• If the "icon entry" option is selected, the icon associated with the macro-module is entered

• If no errors are found during these operations, the macro-module is created.

Note

The merged table is sorted alphanumerically. If the table is too large, a message informs the user that the sorting cannot be performed (this has no effect on the rest of the operations).

___________________________________________________________________________

3 / 2 1

___________________________________________________________________________

3.5-4 Definition of the graphic icon of a macro-module

The icon is a graphic representation associated with a macro-module. It represents a macro-module in the form of a "function box". The "significant" variables in a macro-

• macro-module input variables (maximum of 18)

• macro-module internal variables (maximum of 9)

• macro-module output variables (maximum of 18).

This representation can be viewed (View menu) and integrated into the documentation dossier of the macro-module (Documentation menu). When operating under PL7-3, the variables are displayed in Debug mode (see the relevant documentation).

Selection of variables : this field enables the user to select a variable from the list :

• Type : the selected button indicates the type of variable (Input, Internal or Output) shown in the list.

Each line of the list indicates the variable position, followed by the variable itself, if it has been entered. The position varies from 1 to 18 for input and output variables and from 1 to 9 for internal variables.

___________________________________________________________________________

3 / 2 2

XTEL-MOD Operating Modes 3

___________________________________________________________________________

Selected variables : this field enables the user to modify the variable selected from the list. The entry fields are initialized from the line selected from the list of variables.

• Variable : marker or symbol of the variable. Entry of this field is obligatory.

• Associated name : name with maximum of 16 characters which describes the variable. Entry of this field is optional.

Variable

Update

Delete

Cancel the variable to be entered in the corresponding field can be selected from the list displayed. If the variable selected has a symbol, this symbol will be displayed in the Variable field. If this is not the case, the variable will be represented by its object. The list contains all the macro-module variables, either with or without symbols.

The variable name can also be entered using the keyboard (in the form of a symbol or a variable).

replaces the variable name and associated name (optional) with the new names which have just been entered.

the user can delete the selected variable from the list of variables.

validates the entries and saves them in a file. If no variable names are entered or if the syntax of the variables or of the symbols entered is incorrect, an error message is displayed.

cancels all entries.

Icon Example

___________________________________________________________________________

3 / 2 3

___________________________________________________________________________

3.5-5 Macro-module Modification

This function enables the user to modify the macro-modules : name, criteria, components of the macro-module, identification sheet.

Access

Access level

Project field Station field

Module database Project Main External Project Main External accessible

Select the macro-module to be modified from the list of macro-modules in the database.

The "Modification" function in the Definition menu accesses the dialog box below :

The modules composing the selected macro-module are shown in reverse video in the

"Select modules from the database" list.

All the commands available are identical to those in the "Macro-module creation" dialog box (see Section 3.5-3).

If the name of the macro-module is modified, the user can choose to retain the old macromodule. When the modifications are validated, the version level is incremented and the date changed in the list of macro-modules.

___________________________________________________________________________

3 / 2 4

XTEL-MOD Operating Modes 3

___________________________________________________________________________

3.5-6 Basic Module or Macro-module Transfer

The transfer function enables the user to copy basic modules or macro-modules from one database to another (Project database, Main database, External database).

Access

Access level Project field Station field

Module database Project Main External Project Main External accessible

Select the module(s) or macro-module(s) to be transferred (see Multiple selection on the next page).

Transfer displays the various target databases : Main, Project and External.

Selection of the target database starts the transfer, except in the case of a transfer to an external database.

Note :

The criteria and their values are transferred to the target database as follows :

• If a criterion exists in the source database and in the target database : the values of the criteria are transferred.

• If a criterion exists in the source database but not in the target database : the criterion and its values are transferred if the number of criteria in the target database is less than five, otherwise a warning message appears.

___________________________________________________________________________

3 / 2 5

___________________________________________________________________________

Case of a transfer to an external database

In the case of a transfer to an external database, a entry of the drive and the path of the target station space.

For example : a:\EXTBASE\MOD

(the tree structure must end in \MOD).

Ok starts the transfer.

Multiple selection :

• Of several non-consecutive modules :

- With the mouse : click on the first module then for each of the other modules : press

<Ctrl> and click on the module.

- With the keyboard : select a module using the Up and Down arrows, then validate

the selection by pressing the space bar.

• Of several consecutive modules :

- With the mouse : click on the first module then press <Shift> and click on the last one.

- With the keyboard : select the first module using the Up and Down arrows, then validate the selection by pressing the space bar.

• Of all the modules in the list : press <Ctrl> and </> or select all the modules by clicking on the "All" button.

In all cases, a multiple selection can be cancelled by pressing <Ctrl> and <\> or by clicking on the "One" button.

___________________________________________________________________________

3 / 2 6

XTEL-MOD Operating Modes 3

___________________________________________________________________________

3.5-7 Basic Module or Macro-module Deletion

Access

Access level Project field Station field

Module database Project Main External Project Main External accessible

Select the basic module(s) or macro-module(s) to be deleted from the list (see Multiple selection, Section 3.5-6).

Start the Delete function from the Definition menu. For each program module or macromodule selected, the dialog box below is displayed.

Cancel

Abort deletes the selected basic module or macro-module.

in a multiple selection, cancels the Delete action on the basic module or macro-module displayed and the next one appears.

abandons the Delete request.

___________________________________________________________________________

3 / 2 7

___________________________________________________________________________

3.6

VIEW Menu

3.6-1 View Basic Modules

This function enables the user to display :

• the contents of each file comprising the basic module (program, constants, OFB internal constants, symbols, program comments)

Access

Access level Project field Station field

Module database Project Main External Project Main External accessible

Select the module to be viewed

View accesses the dialog box opposite.

Select the item required from the list displayed.

Ok displays the contents of the item.

To view the entire contents of the file, use the vertical and horizontal scroll bars.

To close the file, select Stop/Close from the system menu or use the Exit menu.

___________________________________________________________________________

3 / 2 8

XTEL-MOD Operating Modes 3

___________________________________________________________________________

Viewing a Grafcet module

<Page up> Enable the user to access the various pages (1 to 8) of the Grafcet

<Page down> chart.

<Ctrl><Tab> Enables the user to access the scroll bars. The Grafcet chart can then be scrolled using <Page up> and <Page down>.

<Tab> is used to switch from the vertical scroll bar to the horizontal scroll bar and vice versa.

Press <Ctrl><Tab> again to quit the scroll bars.

ZOOM

Displays the contents of the step or transition :

• Use the mouse to point to the element to be viewed and click on it with the left mouse button

• Or use the cursor control keys to point to the element to be viewed, press <F10> to activate the action bar, move the cursor onto Zoom or type the letter Z on the keyboard.

Press <ENTER> to display the contents of the element concerned.

RETURN

Returns to the Grafcet chart.

• Click on the right mouse button

• Or select the Return menu.

Viewing a Ladder language source module

<Page up>

<Page down> enable the user to access the Ladder networks of the module.

___________________________________________________________________________

3 / 2 9

___________________________________________________________________________

3.6-2 View Macro-modules

This function enables the following to be displayed :

• The identification sheet for the macro-module

• The contents of the icon associated with the macro-module (V5 stations only)

• The contents of the files composing each basic module or macro-module.

Access

Access level Project field Station field

Module database Project Main External Project Main External accessible

Select the macro-module to be viewed

View accesses the dialog box opposite.

Select the required item.

Ok displays the contents of the item.

To view the entire contents of the file, use the vertical and horizontal scroll bars.

To close the file, select Stop/Close from the system menu or use the Exit menu.

___________________________________________________________________________

3 / 3 0

XTEL-MOD Operating Modes 3

___________________________________________________________________________

3.7

DOCUMENTATION Menu

3.7-1 Generation of a Program Module Dossier

This function enables the user to generate a partial or complete documentation dossier for one or more basic modules.

Access

Access level Project field Station field

Module database Project Main External Project Main External accessible

The contents of the dossier of the one or more selected modules can be chosen from the items displayed :

• Identification sheet : sheet filled in on creation of the module

• Characteristics : external description of the module : name, version level, date of creation, associated criteria

• Table of symbols : can be sorted or unsorted

• Constants : list of constant words used in the module

• OFB constants : list of OFB internal constants used in the module

• Commented program : if a Literal statement or a Ladder network has associated comments, the comments will be printed before the statement or the Ladder network.

Each module dossier begins with a title page. The user can modify the contents of this page using the "Enter Title page" menu.

Each page ends with a footer which can also be modified by the user. It can be accessed by the "Enter Header" menu. Each dossier ends with an automatically generated list of

3 / 3 1

___________________________________________________________________________

The "Options" menu is used to select the display mode of the dossier symbol table : unsorted table, table sorted alphabetically by variable, table sorted alphabetically by symbol.

Ok saves the created dossier to a file which can be used by the XTEL-DOC tool :

B directory) and is called MOD.DOC.

If the Printer Output command is selected, the generated file is sent to print after the type of printer has been selected : a semi-graphic or Postscript printer can be used.

_______________________________________________________________________________

3.7-2 Generation of a Macro-module Dossier

This function enables the user to generate a partial or complete documentation dossier for one or more macro-modules.

Access

Access level Project field Station field

Module database Project Main External Project Main External accessible

The contents of the dossier of the one or more selected macro-modules can be chosen from the items displayed :

___________________________________________________________________________

3 / 3 2

XTEL-MOD Operating Modes 3

___________________________________________________________________________

• Identification sheet : sheet filled in on creation of the module

• Characteristics : external description of the macro-module : name, version level, date of creation, associated criteria, list of basic modules comprising the macro-module

• Table of macro-module symbols : can be sorted or unsorted

• Constants : list of constant words used in each basic module comprising the macromodule

• OFB constants : list of OFB internal constants used in each basic module comprising the macro-module

Note : the constant words and the OFB internal constants belong to the same item.

• Commented Program : for each basic module comprising the macro-module. If a

Literal statement or a Ladder network has associated comments, the comments will be printed before the statement or the Ladder network.

• Icon : graphic representation of the variables required for using the macro-module.

Each macro-module dossier begins with a title page. The user can modify the contents of this page using the "Enter Title page" menu.

Each page ends with a footer which can also be modified by the user. It can be accessed by the "Enter Header" menu. Each dossier ends with an automatically generated list of contents.

The "Options" menu is used to select the display mode of the dossier symbol table : unsorted table, table sorted alphabetically by variable, table sorted alphabetically by symbol.

Ok saves the created dossier to a file which can be used by the XTEL-DOC tool : standard IBM semi-graphic, portrait format. This file is stored in the project (...\Project\MOD directory) and is called MOD.DOC.

If the Printer Output command is selected, the generated file is sent to print.

___________________________________________________________________________

3 / 3 3

___________________________________________________________________________

3.7-3 View Dossier

This function displays the contents of the last documentation dossier generated.

Access

Access level

Project field Station field

Module database Project Main External Project Main External accessible

To view the entire contents of the file, use the vertical and horizontal scroll bars.

To close the file, select Stop/Close from the system menu or use the Exit menu.

_____________________________________________________________________________________

3.7-4 Print Dossier

This function prints the contents of the last documentation dossier generated on a semigraphic or Postscript printer.

Access

Access level

Module database

Project field

Project Main

Station field

External Project Main External accessible

The screen displays the list of accessible printers. The selected printer appears in reverse video.

___________________________________________________________________________

3 / 3 4

XTEL-MOD Operating Modes 3

___________________________________________________________________________

3.8

USE Menu

3.8-1 Manual Use of Basic Modules

This function enables basic modules to be used in the PL7-3 application. It retrieves the source files comprising the module and allows them to be customized.

Access

Access level Project field Station field

Module database Project Main External Project Main External accessible

After selecting the module to be used, the Manual function accesses the USE MODULE dialog box.

• For V4 type stations

• For V5 type stations

___________________________________________________________________________

3 / 3 5

___________________________________________________________________________

Entering the name of the module

Name enables the entry of the name of the source files to be retrieved and placed in the target station field. By default, the name of the basic module appears.

Comment enables a comment of up to 30 characters to be associated with the

(V4 station module used. By default, the comment displayed corresponds to the first only) three criteria associated with the module : date, version level and first optional criterion.

Validate/Ok accesses the program address window (see next page) for selecting the

PL7-3 address, in which the program module will be used.

Cancel cancels the use of the program module. None of the actions performed previously takes effect.

Entering the program address

This dialog box is used to select the task and the PL7-3 module address of the task in which the program module is to be used.

• For V4 type stations

___________________________________________________________________________

3 / 3 6

XTEL-MOD Operating Modes 3

___________________________________________________________________________

• For V5 type stations

If the module has already been used in the station, the corresponding task and module are displayed.

New module performs the reading by deletion of a PL7-3 module (MAIN, PRL, and POST).

Merge module performs the reading by merging of the selected module with the contents of the target module (the program comments files are also merged). This option is proposed by default for MAIN, PRL, and

POST.

Write protect

Cancel for V5 type stations only. This item enables the program to be protected. In this case, the program can be displayed but not modified after it has been read in the PL7-3 application.

displays the Rename Variables/Symbols dialog box before the basic module is retrieved to the target station (shown on the next page).

cancels the address that has just been entered and returns to the previous dialog box.

___________________________________________________________________________

3 / 3 7

___________________________________________________________________________

Renaming variables/symbols

The dialog box below lets the user customize the program source files, symbols and constants. It displays the table of variables of the module, whether they are symbolized or not, which are used in the program and the constants. It proposes in the form of menus

Cancel copies the source files of the basic module to the target station field, taking account of all the modifications made in this window :

• program source file

• constants source file

• OFB internal constants source file

• merging of symbols in the station symbol database

• program comments file (file "merged" if necessary).

For a V4 station, the list of modules file (.MOD) and the command file

(.MCR) are updated. For a V5 station, the command file (.M5M) is updated.

Cancels the modifications made to the variables and symbols and copies the source files of the basic module to the target station field.

For a V4 station, the list of modules file (.MOD) and the command file

(.MCR) are updated. For a V5 station, the command file (.M5M) is updated.

Aborts the use of the basic module. No source files are copied.

Abort

Note : On the screen, only the first 1000 objects are displayed. If the number of objects is more than 1000 a warning message is displayed. Modifications can be made to all the basic module variables (Search/

3 / 3 8

XTEL-MOD Operating Modes 3

___________________________________________________________________________

• Replace menu

Display variables/symbols

This function displays the dialog box below which allows the parameters to be modified one by one : variables, symbol or associated comment. If the selected variables has no associated symbol, a warning message will appear in place of the dialog box.

Ok validates the modifications and updates the corresponding files (program, symbol, constant).

Search/Replace function

This function displays the dialog box (see next page) which enables a search, or search and replace, to be performed in the program source, symbols and comments files of the following elements :

• Variables, symbols, symbol sub-strings

• Label.

The search/replace can be performed in two modes :

Automatic mode automatic search and replace of the elements.

Manual mode search which stops and asks for confirmation of each element encountered. Yes performs a replacement and continues the search. No continues the search without replacing the element.

Cancel interrupts the process.

After selecting the type of element to be searched or replaced (variables, symbols, symbol sub-strings, or labels) and the replacement mode (automatic or manual), enter the following in the fields provided :

• The element to be searched for, in the case of a search

• The element to be searched for and the new element, in the case of a search/replace.

___________________________________________________________________________

3 / 3 9

___________________________________________________________________________

Ok Executes the search or search/replace operation.

Note : The Search/Replace of symbol sub-strings applies to all files of the module and also to the program source file. This function must be therefore be used with care and it is recommended that this kind of Search/Replace is conducted in manual mode.

Multiple object replacement function

This function accesses the automatic replacement of certain types of objects in the various source files.

The objects concerned are :

• Internal bits (Bi)

• Internal words (Wi, DWi)

• Constant words (CWi, CDWi)

• Rack-mounted discrete I/O modules and intelligent I/O modules (moving)

• Remote discrete I/O modules (moving)

• Macro-steps (renumbering)

• Labels (moving)

• OFBs (renumbering)

• Standard function blocks : timer, monostable, up/down counter, register, text, control

(renumbering).

___________________________________________________________________________

3 / 4 0

XTEL-MOD Operating Modes 3

___________________________________________________________________________

Replacement of internal bits

Reassignment of a consecutive group of internal bits.

Replacement of internal words or internal double words

Reassignment of a consecutive group of internal words.

Replacement of constant words or constant double words

Reassignment of a string of words.

___________________________________________________________________________

3 / 4 1

___________________________________________________________________________

Moving rack-mounted I/O

Move all the bit objects and input/output words (I..,

O.., IW..,OW..) relating to the module moved.

Source = current module address

Target = new module address

Moving remote I/O

Move all the objects of the same type, relating to the remote I/O module which has been moved.

Element name = object type (RI, RO, RD, etc).

Source = current module address : connection point on FIPIO and module number

(0 = base or 1 = extension).

Target = new module address : connection point and module number (0 or 1).

___________________________________________________________________________

3 / 4 2

XTEL-MOD Operating Modes 3

___________________________________________________________________________

Renumbering macrosteps

All the bits and words associated with the old macro-step are modified automatically.

XM0 --> XM2

X0,i --> X2,i

X0,i,V --> X2,i,V

Moving labels

Renumbers a series of program labels.

Source = number of the first and last labels of the series to be renumbered.

Target = number of the first destination label.

Renumbering an OFB

All the elements associated w i t h a n o l d O F B a r e modified automatically.

___________________________________________________________________________

3 / 4 3

___________________________________________________________________________

Renumbering a standard function block

All the bits and words associated with the old

B monostable, up/down counter, register, text or control are modified automatically.

Note : the multiple replacement of labels only occurs in modules programmed in Literal or Ladder language.

In the case of a macro-module, the "Options" menu can be used to select where the multiple replacement will be performed : in all the modules comprising a macro-module or only in the merged modules.

• View Menu

(see section 3.6-1)

View displays a dialog box which accesses the display of all module components :

• program source (.LIT,

.LAD, .GR7 file)

• constants source (.CST

file)

• OFB internal constants source (.OBM file)

• symbol table source

(.SCY file)

• program comments

(.COM file)

• identification sheet (.FRM

file),

• documentation dossier

(MOD.DOC file).

___________________________________________________________________________

3 / 4 4

XTEL-MOD Operating Modes 3

___________________________________________________________________________

• Define menu (see Section 3.8-1)

Definition enables the user to rename the source files and modify the program address after replacements have already been made in the module. In the case of a macro-module, this menu also defines the basic module which will trigger the update of the variables of the animated icon.

This menu accesses three sub-menus :

• Name which enables renaming of the source files to be retrieved in the target station field.

• Program address which enables redefinition of the task (MAST, FAST, AUX, etc) and module address (CHART, PRL, POST, etc.) in which the module is to be used.

• Select module for photo (for macro-modules only) : defines the basic module

(belonging to the macro-module) at the end of which the variables of the animated icon are updated. The icon animation can be accessed by PL7-3 in debug mode.

• Options menu

This menu enables the user to select the following :

- Sort objects enables the displayed list to be organized by an alphanumeric sort on the first five characters of the objects or on the characters before the comma (",") if there are less than five.

___________________________________________________________________________

3 / 4 5

___________________________________________________________________________

- Merge SDBASE enables the module symbols to be merged automatically with the station symbol database. This process is performed after the module has been used. There are three merge modes :

- Record those of the station symbol database

Non-erase : in case of conflict, the module object/symbols do not overwrite those of the station symbol database

Dialog : in case of conflict, a dialog box appears to enable the user to select the objects/symbols to be retained : objects/symbols of modules or of station symbol database.

if this item is activated, the replace commands which have been implemented are saved. This occurs by default.

- Recall record...

accesses a dialog box which enables a series of replacements

(which were saved after being used previously) to be implemented

- Delete record...

automatically.

accesses a dialog box which enables a series of replacements

(which were saved after being used previously) to be deleted.

___________________________________________________________________________

3 / 4 6

XTEL-MOD Operating Modes 3

___________________________________________________________________________

3.8-2 Manual Use of Macro-modules

This function enables macro-modules to be used in the PL7-3 application being developed. It retrieves the source files constituting each module or macro-module while allowing the user to customize them.

Access

Access level Project field Station field

Module database Project Main External Project Main External accessible

Select the macro-module to be used, the Manual function accesses the USE MACRO-

MODULE dialog box.

Entering the name of the macro-module

Name enables the name the macro-module will have in the target station field to be entered (up to 8 characters). By default, the name is that of the macro-module in the database.

Comment enables a comment to be associated with the macro-module used (up to

30 characters). By default, the comment displayed shows the first three criteria associated with the macro-module : the version level, date, and first optional criterion.

Ok accesses a window which enables selection, for each program module constituting the macro-module, of the PL7-3 program address in which it will be retrieved.

Cancel cancels the use of the current macro-module, none of the actions performed previously takes effect.

___________________________________________________________________________

3 / 4 7

___________________________________________________________________________

Entering the program addresses

This dialog box gives the list of basic modules constituting the macro-module and displays the program addresses already entered for these modules.

Select a basic module from the list displayed.

Enter name enables the name to be entered which the program module to be retrieved will have in the target station field. By default, the name is that of the basic module.

Note : if a program module is used at various program addresses, its name must be different each time it is used.

Enter program address enables the program address (task/module) assigned to the basic module in the PL7-3 application to be entered. If the module has already been used in the station field, the corresponding task and module are displayed.

Note : A program address must be entered for each basic module that has a program source file or a program comments file.

Module sequencing ...

accesses a dialog box which enables the various program code modules to be organized before being merged into the PL7-3 application.

Ok when all the program addresses have been entered, this key creates the correspondence between the various basic modules and their PL7-3 addresses and updates the program comment files depending on the program addresses entered. It also accesses the Rename objects/

symbols screen which enables the user to customize the variables defined in the various source files.

Cancel cancels the addresses which have just been entered and returns to the

3 / 4 8

XTEL-MOD Operating Modes 3

___________________________________________________________________________

Rename objects/symbols (see Section 3.8-1).

Note : In the Use phase (basic module or macro-module) XTEL-MOD does not check the coherence of the objects with the PL7-3 configuration of the target station. This check is performed by PL7-3 during the automatic reading (see PL7-3 Operating

Modes).

In case of conflict, the user is recommended to abandon read mode by the command <Ctrl> <W>.

_______________________________________________________________________________________

3.8-3 Automatic Use of a Basic Module or Macro-module

From the Use menu, the Automatic menu displays a dialog box which can be used to select when a basic module or macro-module is updated in the PL7-3 application. The update is implemented from the renamed items which were saved when used previously

(Record option in the Rename objects/symbols screen).

Ok executes the following operations :

• select program address

• rename variables

• merge symbols with station symbol database (erase mode).

During this process a message indicates that an operation is under way. If an error occurs during the process, a message is displayed and the update is interrupted.

cancels the update and returns to the main screen.

Cancel

___________________________________________________________________________

3 / 4 9

___________________________________________________________________________

3.8-4 Use RESET

From the Use menu, the Use RESET item displays the following dialog box :

• V5 type stations

If no file name is entered :

Ok the command file is destroyed. If Delete is selected, all the source files relating to the command file are also destroyed.

If a file name is entered :

Ok the command file is saved under the name entered and the old command file is destroyed. If Delete is selected, all the source files relating to the old command file are also destroyed.

___________________________________________________________________________

3 / 5 0

XTEL-MOD Operating Modes 3

___________________________________________________________________________

3.8-5 Command File

This enables the contents of the command file read by PL7-3 to be displayed, for automatic insertion of the modules used. The format of this file is different for V4 and V5 stations. In both cases :

= indicates that the module has been read by the PL7-3 application.

> indicates that the module has not been read by the PL7-3 application.

• V4 type stations

The following information is specified for each module :

• name

• type : LIT, LAD or GR7

• PL7-3 address corresponding to the instantiation of the module task

• BOT if the module has been merged or NEW if it has not

• CST SYM if there are constants (read by PL7-3, symbols given priority)

• COM if there are program comments

• a comment starting with "--" gives the name of the generic module as well as the version level and the date of creation or of the last modification.

___________________________________________________________________________

3 / 5 1

___________________________________________________________________________

• V5 type stations

The command file contains the description, in the form of a table, of the basic modules used in the station. The following information is specified for each basic module :

• STATUS : the READ information indicates that the basic module has been read by the

PL7-3 application

• MACRO MODULE : name of the macro-module to which the basic module belongs

• BASIC MODULE : name of the basic module

• LANGUAGE : type of basic module (LIT, LAD or GR7)

• TASK / MODULE : PL7-3 address

• PROGRAM READ : MERGE if the basic module is merged or NEW if it is not

• AUTHORIZATION : R if the basic module is write-protected (read only), RW if the basic module is not write-protected

• CONSTANT READ : if there are constants, SYM for a PL7-3 read with symbols given priority or VAR for a PL7-3 read with markers given priority

• SOURCE : MOD if the basic module has been instantiated by XTEL-MOD

• COMMENT : name, version and date of creation (or of last modification) of the generic module.

___________________________________________________________________________

3 / 5 2

XTEL-MOD Operating Modes 3

___________________________________________________________________________

3.8-6 Modules Used

This is only available for V4 type stations. A list of all the modules already transferred to the station field by the Use command is displayed (or during creation, the list of program source files generated by PL7-3 is displayed). The format of this list is as follows : the task/module assignment specified for each module used, any comments

(those comments entered in the first screen of the Use function), the version level and the creation date of the module :

___________________________________________________________________________

3 / 5 3

___________________________________________________________________________

3.9

Error Messages

In section 3.9 Error Messages the left-hand column lists probable causes and the righthand column lists corrective actions.

Not enough memory

The selected action requires more memory space than is available.

Not enough RAM memory. Stop the execution of other programs running simultaneously.

Error on reading a file

Error on opening a file

Error on closing a file

Error on writing a file

Error on deleting a file

Error on copying a file

Problem of accessing a file No direct action is possible.

Restart the current action.

Read error on module file

Problem of access to the module directory file.

Not enough space on disk(ette)

Writing to the disk or diskette has been requested but there is not enough space available.

Write-protected diskette

Request to write to an external database stored on a write-protected diskette.

Printer not connected

Request to print, but no printer is connected.

Wrong language code

The language code of the Grafcet does not correspond to one of the known languages (Literal, Ladder, Grafcet).

No sort done : File too long

The list of objects and symbols cannot be alphabetically sorted as it is too long.

Check the state of the file.

Delete the files on the disk or diskette.

Remove the write protection.

Connect the printer

Check the contents of the file, regenerate the Grafcet file.

No action.

___________________________________________________________________________

3 / 5 4

XTEL-MOD Operating Modes 3

___________________________________________________________________________

Cannot merge symbols : File too long

In creation or modification of a macro-module, Too many symbols for the macro-module, the symbol tables of each module of the macro-module are merged to form the main regenerate a correct macro-module.

symbol table of the macro-module; this table cannot contain more than 5000 symbols.

Cannot merge symbol file, repeated definitions

In creation or modification of a macro-module, The coherence of the symbol table the symbol tables of each module of the cannot be guaranteed, regenerate a correct macro-module.

macro-module are merged to form the main symbol table of the macro-module; two or more definitions of objects or symbols have been found.

Incorrect symbol file format

Problem of access to the symbol table.

Check the state of this file and regenerate it if necessary.

Incorrect (macro-)module directory file format

Problem of access to the directory of modules (or macro-modules).

Check the state of this file and regenerate it if necessary.

Incorrect .MOD file format

Incorrect constant file format

Incorrect OFB constant file format

Incorrect comments file format

Problem of access to this file Check the state of this file and regenerate it if necessary.

Cannot load MOD.DLL file

After starting XTEL-MOD, the functions of this program cannot be accessed

(screens, dialog boxes, etc).

Blank file

The file concerned is empty

Reinstall XTEL-MOD.

No action.

Error on replacement

The modification requested cannot be executed.

Cannot create directory

The directory function could not be created on disk (or diskette).

Check the contents of the files concerned.

Either there is not enough space remaining on the disk (or diskette) or its a system problem.

Invalid drive

3 / 5 5

___________________________________________________________________________

SDBASE does not exist or is already used!

The symbols editor of the station is in use; access to the symbols database of the station is therefore forbidden.

Cannot find editor xxx

The selected editor is not present in the machine.

Close the symbols editor and continue.

Select a different editor.

Incorrect basic module name

Syntax errors in the name of the module (illegal characters, etc)

Incorrect macro-module name

Syntax errors in the name of the macro-module (illegal characters, etc)

Module name must conform.

Macro-module name must conform.

No program file : No address to enter

The current does not contain the source program, there is therefore no PL7-3 address to enter.

Transfer impossible

The source and target spaces of the transfer are identical.

No action.

Select a target space that is different from the source space.

Transfer interrupted : A component of module xxx does not exist

Problem during the transfer of a module

(or macro-module).

Check the existence of each of the components of the module (or macro-module).

No module entered

An action has been requested, but no module has been selected from the list of modules.

Select a module and restart the action.

No program comments file purge, it is retained as a whole

During module creation or modification, if a comments file is present it is purged.

This message is displayed if the «Cancel» button was selected on the screen used to enter the purge address.

No action.

No criteria

An action on the list of criteria has been requested, but the list is empty.

Check the list of criteria.

___________________________________________________________________________

3 / 5 6

XTEL-MOD Operating Modes 3

___________________________________________________________________________

Incorrect value

Incorrect syntax in the value of the display criterion (illegal characters, etc).

Display criteria value must conform.

Criterion name exists

The display criterion selected for creation already exists.

Enter a display criterion that is not already in the list.

Wrong criterion name

Incorrect syntax in the value of the display criterion (illegal characters).

Too many criteria

Creation of a 6th criterion.

Display criteria name must conform.

As the number of display criteria is limited to five, delete one before adding another.

Length error

The length entered for the table is incorrect.

Incompatible objects

The entry fields of the objects do not contain entities of the same type.

Enter a new length.

Enter compatible objects.

No such field

The directory entered does not exist.

No such dedicated field

The directory entered does not correspond to a function field.

Enter a new directory.

Directory name must conform.

A module must have at least one component

No component of the module has been entered

Enter at least one component (source file, constants or comments).

Blank entry field

One of the entry fields has not been filled in.

Enter a number in the corresponding field.

Enter a numerical value

Incorrect syntax of the number of the

SR or XM.

Enter a numerical value in the corresponding field.

___________________________________________________________________________

3 / 5 7

___________________________________________________________________________

Incompatible with external database

The selected module database is the external Select another database.

database. The action requested is not allowed on this database.

Incompatible multiple selection

Several modules (or macro-modules) have been selected, but the action can be performed on only one.

Select one module (or macro-module).

The object entered is not a PL7-3 object

The object entered does not correspond to a PL7-3 object.

The symbol should not be a PL7-3 object

The symbol entered corresponds to a

PL7-3 object.

No string replaced

The element to be replaced has not been found.

No table objects replaced

The element of the table to be replaced has not been found.

Enter a PL7-3 object.

Enter a new object.

No action.

Non-existent file

Problem in the file to be opened.

Check the existence of the file. If necessary, regenerate the file.

Illegal criterion

The criterion entered is «Version» or

«Date».

Enter another criterion as the «Version» and «Date» criteria are always present by default.

PL7-3 function not selected

The PL7-3 function does not exist in the station.

Install PL7-3 in the station.

Symbol xxx already exists and symbolizes object yyy. Do you want to replace it?

The replacement of a symbol by a symbol that already exists is requested. During merging of the table of symbols of the module

(or macro-module) with the SDBASE, a symbol is present both in the module (or macro-module) and in the symbol database of the station.

Decide whether or not to make the replacement.

___________________________________________________________________________

3 / 5 8

XTEL-MOD Operating Modes 3

___________________________________________________________________________

Symbol xxx already exists and is symbolized by object yyy. Do you want to replace it ?

The replacement of a symbol by a symbol which already exists is requested.

Decide whether or not to make the replacement.

Object xxx already exists and is symbolized by object yyy. Do you want to replace it ?

The replacement of an object by an object which already exists and which is symbolized by the same symbol is requested.

Decide whether or not to make the replacement.

This Object and this Symbol already exist. Do you want to replace it ?

The replacement of an object by an object which already exists and which is symbolized by another symbol is requested.

Decide whether or not to make the replacement.

Inadequate access rights

The user does not have adequate access rights to run XTEL-MOD,

(program min. required).

Change the user's access rights.

XTEL-MOD must be declared first at project level

XTEL-MOD has been started at station level when it does not exist at project level.

Declare XTEL-MOD at project level.

No symbol assigned : operation not allowed

An object cannot be replaced if no symbol is assigned to the object.

Assign a symbol in PL7-3 or modify the object using the «Search/Replace» function.

Type of object not allowed

The object entered is not compatible.

Cannot find file

Problem of accessing a file.

Enter another object.

Cannot automatically purge program comments : enter program comments address to be retained

During the creation or modification of a module, if a comments file is present, it is purged. The name of the program source file relating to the comments file is not present in the .MOD file (V4 station) or the .M5M file

(V5 station) of the station.

Enter the PL7-3 address which will be used to purge the comments file.

Check that the file is present.

Empty step

When viewing a Grafcet file, the action which has been zoomed on is empty.

No action.

___________________________________________________________________________

3 / 5 9

___________________________________________________________________________

Empty step

When viewing a Grafcet file, the action which has been zoomed on is empty.

No action.

Empty macro-step B

When viewing a Grafcet file, the macrostep which has been zoomed on is empty.

No action.

System error

One of the functions of the WPM interface has a fault (this message should not appear).

No action.

Criteria xxx of the modules were not transferred

A transfer of modules has been made and the number of criteria of the source database plus that of the target database is more than 5; certain criteria have not been able to be transferred.

No action.

Criteria xxx of the macro-modules were not transferred

A transfer of macro-modules has been made and the number of criteria of the source database plus that of the target database is more than 5;

No action.

certain criteria have not been able to be transferred.

Basic module name already used : first use the DELETE option before attempting to use this module name

The module entered already exists.

Enter a new module name or start by deleting the existing module.

Macro-module name already used : first use the DELETE option before attempting to use this macro-module name

The macro-module entered already exists.

Enter a new macro-module name or start by deleting the existing macro-module.

Do you want to retain module xxx ?

A module has been modified. Do you want to retain the old module?

Decide whether to duplicate the module or not.

Attention : indexed constants were not processed

During the creation or modification of a module, the option «Sorting of Constants» has been requested and the program source file contains indexed constants.

No action.

___________________________________________________________________________

3 / 6 0

XTEL-MOD Operating Modes 3

___________________________________________________________________________

Incorrect module address : rack 0..F

In the «Move rack-mounted I/O» function, the address entered for the rack is incorrect.

Enter a value between 0 and F.

Incorrect module address : module 0..7

In the «Move rack-mounted I/O» function, the address entered for the module is incorrect.

Enter a value between 0 and 7.

Incorrect macro-step number : XM 0..63

In the «Renumber macro-step» function, the number entered for the macro-step is incorrect.

Enter a value between 0 and 63.

This module already used at the same address. Do you want to continue ?

The module being used already exists in the station.

Continue or abort.

Cannot use : a module with the same name is already used at a different address

The module being used already exists in the station, but at a different PL7-3 address.

Modify address or abort.

This macro-module with the same components already used. Do you want to continue ?

The macro-module being used already exists in the station.

Continue or abort.

Cannot use : this macro-module with the same components has already been used

The macro-module being used already exists in the station, but with different components.

Modify the components or abort.

Enter internal word type objects : Wi or DWi

The objects entered in the function

«Replace internal multiple-word objects» are not of the correct type.

Enter internal word type objects.

Enter internal constant type objects : CWi or CDWi

The objects entered in the function

«Replace internal multiple-word objects» are not of the correct type.

Enter internal constant type objects.

Error in the type of markers

The objects entered in the replace function are not of the same type.

Enter objects of the same type.

___________________________________________________________________________

3 / 6 1

___________________________________________________________________________

Enter internal bit type objects : Bi

The objects entered in the function

«Replace internal multiple-bit objects» are not of the correct type.

Syntax error in the symbol entered

The syntax of the symbol entered for replacement is not correct.

Enter internal bit type objects.

Re-enter the symbol with its correct syntax.

Syntax error in the label entered : label Li with i between 1 and 999

The syntax of the labels entered in the

«Search/Replace» function is not correct.

Re-enter the labels with their correct syntax.

Cannot modify : module name already exists

A module has been renamed with a module name that already exists.

Enter another module name.

Wrong macro-module name

Syntax error in the name of the macro-module entered.

Enter a correct macro-module name.

A macro-module must have at least one component

No macro-module component has been entered.

Enter at least one component (module).

Cannot create : objects are symbolized more than once or symbols are used more than once

During the merging of the symbol tables Regenerate correct modules before of the modules comprising the macro-module, creating the macro-module.

double definitions of objects or symbols have been found.

Cannot modify : objects are symbolized more than once or symbols are used more than once

During the merging of the symbol tables Regenerate correct modules before of the modules comprising the macro-module, modifying the macro-module.

double definitions of objects or symbols have been found.

Cannot modify : the macro-module name entered exists

A macro-module has been renamed with a macro-module name which already exists.

Enter another macro-module name.

All program addresses must be entered

Certain modules in a macro-module have not been «positioned» in the application.

Enter the PL7-3 addresses of the remaining modules.

___________________________________________________________________________

3 / 6 2

XTEL-MOD Operating Modes 3

___________________________________________________________________________

Do you want to retain macro-module xxx ?

A macro-module has been modified, do you want to retain the old one?

Decide whether or not to duplicate the macro-module.

Module xxx is referenced by macro-modules. Proceed to delete ?

The deletion of a module has been requested and this module is contained in one or more macro-modules.

Continue or abort.

Attention : one or more comments were shortened during program comment file merge

No action.

2 comments files have been merged

(Use with the "Merge Module" option) and the merging of 2 of these comments has exceeded the 10 lines permitted.

No value assigned to this criterion !

No value has yet been entered for the criterion selected for the display filter.

Filter on another criterion or enter values for the criterion concerned.

Wrong source file name

One of the «Literal», «Ladder» or

«Grafcet» buttons has been clicked on,

but no program file has been selected.

Macro-module not entered

An action has been requested, but no macro-module has been selected from the list of macro-modules.

Replacement(s) made

The number of elements replaced by the

«Search/Replace» function is displayed.

Select a program file from the list proposed, or click on the «No source» button.

Select a macro-module, then start the action.

No action.

Element(s) found

The number of elements found by the

«Search/Replace» function is displayed.

No action.

Symbol file was modified; to ensure macro-module symbol coherence, select

Modify for each macro-module that references this module

The symbol file of a module has been modified and the module is contained in one or more macro-modules. The merging of the symbol tables of the modules of each macro-module will be updated by selecting

Modify for each of these macro-modules.

Select Modify for each macro-module that contains the modified module.

___________________________________________________________________________

3 / 6 3

___________________________________________________________________________

A number of identical program addresses were entered

Certain modules in the macro-module have been «positioned» in the same place in the application.

Enter a different PL7-3 address for each module.

Confirm deletion of command file xxx of station xxx?

The «Use RESET» function has been requested, but without saving of the file to be deleted.

Enter a file name in order to save the command file, or continue.

Wrong file name

The name of the file entered to save the command file is incorrect. (syntax error or the name entered is the name of the station).

Enter a correct file name.

Comments file xxx does not exist in the station. It is the comments file of the module which is retained

When using the program module or macromodule, merging has been requested and the target program comments file does not exist.

No action.

Incomplete list displayed : file too big

The list of objects and symbols cannot be displayed because it is too long.

No action.

Cannot use : the command file is already open

When using the program module or macromodule, the command file is being read or written by PL7-3.

End the current PL7-3 operation before continuing.

Cannot move

In the "Move labels" function, the time for the labels to move is too long for the selected destination label.

Enter a shorter time for the labels, or a smaller destination label.

Incorrect connection point : 1 ... 62 and 64 ... 255

In the "Move remote I/O" function, the module address entered is not correct.

Enter a value between 1 and 62 or between

64 and 255.

Incorrect module number : 0, 1

In the "Move remote I/O" function, the module number entered is not correct.

Enter 0 or 1.

___________________________________________________________________________

3 / 6 4

XTEL-MOD Operating Modes 3

___________________________________________________________________________

All modules must be selected

When the function for organizing the modules in a macro-module is being used, all modules must be selected.

Select all the modules in the list displayed or abort.

Incorrect timer number : T 0..127

Incorrect monostable number : M 0..31

Incorrect up/down counter number : C 0..255

Incorrect register number : R 0..127

Incorrect text number : TXT 0..63

Incorrect control number : CTRL 1..7

In the replacement function for a block, the values entered for the block numbers are not correct.

Enter the values included in the indicated time range.

Error reading SDBASE

During the creation or modification of a module, access to the station symbol database has failed.

Check the state of the symbol database before continuing.

Incorrect marker

While the list of objects and symbols is being compiled, a syntax error in one of the objects is detected.

Incorrect XTEL environment

For V5 type stations : there is a problem accessing the station directory.

Check the contents of the various source files and regenerate them if necessary.

Check the operation of the Software

Workshop.

Syntax error in the command file

The station command file (STATION.M5M) is faulty.

Incorrect format of .HIS file

During the update of a program module or a macro-module, the file containing all commands used in the previous instantiation cannot be read.

Check the contents and regenerate if necessary.

Delete this file using the "Init save" menu available in the Rename objects/symbols screen, then regenerate it by manual re-instantiation of the program module or macro-module

Function cannot be used in this station : no save is performed for this element

The update of a program module or macromodule has been requested but the rename command in the previous instantiation has not been saved.

No action.

___________________________________________________________________________

3 / 6 5

___________________________________________________________________________

Incorrect graphic icon file format

The format of the file containing the graphic representation of a macro-module is not correct.

Variable name already used

In the enter a graphic icon for a macromodule function, the variable being entered already exists in one of the 3 lists of variables.

Regenerate the icon.

Modify the variable entered.

Enter a PL7-3 label or a symbol

In the enter a graphic icon for a macromodule function, the entry field "Variable" does not contain a PL7-3 object or a symbol.

Enter a PL7-3 object or a symbol, or select the "Variable" button to perform the entry.

One or more variables are not components of the macro-module

After the components of a macro-module have been modified, the graphic icon contains variables which no longer exist in the new macro-module.

Modify the variables which are represented by a "*" label in the displayed lists, and validate.

Confirm deletion of application source files?

In the Use/ Use RESET function, request for confirmation of deletion of source files.

Label xxx is already used in the program. Continue (label xxx will not be replaced) ?

In the Use/ Replace multiple objects/ Move labels function, indicates that the move creates an existing label.

Label xxx is already used in the program

In the Use/ Search replace function, indicates request for replacement of a label by an existing label.

It is to be used without taking into account the renaming performed in this screen.

Confirm this action ?

In the Use function, request for confirmation when Cancel and not Quit is pressed to quit the function. In fact, Cancel begins the function without taking the renaming into account.

Marker, symbol or comment too long

Marker, symbol or comment read in a file or entered is too long.

Marker entered has OFB syntax, but this OFB is not installed on the workstation

In the Use/ Replace multiple objects/ OFB number function, the name of the OFB entered does not correspond to an OFB installed on the workstation.

___________________________________________________________________________

3 / 6 6

XTEL-MOD Operating Modes 3

___________________________________________________________________________

Cannot replace between two different OFB types

In the Use/ Search replace function, this message indicates that it is impossible to replace an

OFB with a different type of OFB. Only the OFB number can be replaced.

To replace an OFB, use OFB Number Replace multiple objects mode

In the Use/ Search replace function, replacing an OFB with an OFB of the same type (for example PIDF0 with PIDF1) is only possible in Replace multiple objects mode and it affects all the objects from the OFB involved in the replacement.

OFB constants file does not exist on the station - Creation of basic module interrupted

In the Create Module and Modify Module functions, this message is shown when source program uses OFB internal constants and the corresponding .OBC files are not all present in the station.

___________________________________________________________________________

3 / 6 7

___________________________________________________________________________

3 / 6 8

Hello! I'm an AI assistant trained on the XTEL-MOD Reference Manual. I understand how to create, modify, view, and use program modules and macro-modules within your PL7-3 applications. Ask me anything about modular application construction, operating modes, or specific functions related to the X-TEL Software Workshop.

Show related prompts

Assistant typing

Assistant is out of keyboard. Please, try again later.

It looks like you''ve reached a document that is written in multiple languages, including one that isn''t your native language. You can use the following links to temporarily hide pages without the language you prefer.

Key features

Automatic reading of symbol tables for program and macro-modules.
Extends "replace multiple objects" function for function blocks (timers, counters, registers, etc.).
Enables relocation of remote I/O, labels, and renumbering of OFBs.
Enhanced command file (.M5M) for automatic integration into PL7-3 applications.
Write-protection for program module code.
Graphic representation of macro-modules using icons.
Documentation dossier management for modules.
Automatic updating in the station.

Frequently asked questions

XTEL-MOD provides an option for managing the program module library database within the X-TEL Software Workshop, aiding in the reuse of tested program subsets.

XTEL-MOD is compatible with Telemecanique multifunction PLCs running V2, V3, V4, or V5 level software, including the TSX series.

XTEL-MOD allows the use of PL7-3 functional entities in the form of program modules or macro-modules.

Some enhancements include automatic reading of symbol tables, extended 'replace multiple objects' function, relocation of remote I/O and associated objects and words

Contents Divider E

Section 1

Section 1

Section 2

Section 3

Section 3

What is the purpose of XTEL-MOD?

What versions of PLCs is XTEL-MOD compatible with?

What types of functional entities can be managed by XTEL-MOD?

What are some enhancements in TXT L MDD V52 software?

Related

Schneider Electric PL7-2 Languages User Guide

Telemecanique PL7-3 Converter Guide | AI & PDF

Schneider Electric SCM Communication, PL7COM 5.0 User Guide

Schneider Electric Software Workshop X-TEL 6.0 User Guide

Schneider Electric Process Control, PL7PMS 5.0 User Guide

Schneider Electric Software Workshop - Tools X-TEL, MINI X-TEL 6.0 User Guide

Schneider Electric Software Workshop, MINI X-TEL 5.0 User Guide

Schneider Electric Integrated Man-Machine Dialog PL7 MMI 37, 5.2 User Guide

Schneider Electric XTEL User Guide

SHARP EL-6750, EL-6790, EL-6850, EL-6890, ZQ-190, ZQ-195, ZQ-520, ZQ-540, YO-190, YO-195, YO-520, YO-540 User's Guide

Schneider Electric XTEL User Guide

Schneider Electric Backup240, principle and functionalities User Guide