MESS

Contents


mess is used to access a language file holding Adonix service messages or the message file for the application (if there is one).

 

Syntax

   mess( exp_num, exp_chap, exp_lan )

 

Parameters

Element

Description

Restrictions

exp_num

Integer expression giving the number of the message in the section

exp_num >= 0

exp_chap

Integer expression giving the number of the message section.

exp_chap >= 0

exp_lan

Integer expression indicating which message file should be used.

0 <= exp_lan <= 1

 

Examples

# Display message 'Please wait, printing in progress'
    Infbox mess (24, 2)

   # Display title of the second section, defined in the file
   # application message (for a set of texts this will be the
   # list of input characters)
    Infbox mess (2, 0, 1)

  # Display system text set Yes/No.
  # This set, that can be used by the format "LS31", is therefore read from file
  # message in section 31: the list of keys is in message 0,
  # and the rest of the text is in the following messages.
    Infbox "List of codes :"- mess(0,31)
    For I = 1 to len(
mess(0, 31))
           Infbox mid$(
mess(0, 31), I, 1)-":"- mess(I, 31)
    Next I

 

Description and comments

mess gives access to Adonix service messges or those which may have been specifically defined for the application. Message files are arranged in sections with a group of messages for each chapter.

The value 0 will be given to exp_lan to access the Adonix message file and value 1 otherwise; this argument is optional and is set 0 by default. The text of the message depends on the language used.

The result is a Char type.

 

Comments

Service messages are stored in the file in the lan sub-directory of the installation directory. The name of this file is given by the Adonix system variable messname. By default, this is the std file, but the name of a language file may be given when Adonix is started up, using the syntax adonix -l nom_lan nom_appli.

The number of messages per section depends on the section; it may vary from one version of Adonix to another, and existing messages may themselves be modified.

There is a correspondence between the number of the chapter where a set of translatable texts is stored and the number of the system text used in the input formats associated with this set.

The application messages file is an Adonix table. Its name is given by the variable [S]adxtms.

The errmes$ function, that gives the error message associated with an error code, corresponds to section 13 of the Adonix message file. There is therefore full equivalence between errmes$(I) and mess(I, 13).

 

Associated errors

Error

Description

ERMODE (10)

One of the arguments is not of the type required.

ERDOM (50)

One of the arguments is strictly negative.

 

Associated key words

MESSNAME - ERRMES$ - ADXTMS - ADXMBM


CONTENTS


Copyright © Sage 1999 - 2007