MASK

Contents


Mask is used to declare all the masks that can be used in a routine.

Syntax

   [ Local ] Mask liste_masques

Parameters

Element

Description

Restrictions

liste_masques

List of descr_masques, separated by the character ','.

The total number of masks may not be more than 25.

descr_masque
(1)
(2)
(3)

Description of a mask in one of the following forms:
nom_d'OBJet
nom_d'OBJet classe
'=' expr_c

class indicates the abbreviation for a mask.

expr_c

Char type expression whose result is a mask name in the form of a non_d'OBJet or an absolute or relative path.

80 character maximum.

 

Examples

   # Declaring 3 masks
    Mask SAICP1 [CPT1] , =[L]NOMMSK [CPT2], ="DOSSIERA.SAICP1" [CPT3]

 

Description and comments

Mask is used to declare the masks that can be used during a routine. For this, the following may be declared:

·         an absolute or relative path (syntax 3);

·         the name of the mask if it is in the ECR directory of the current application or one of the reference applications (syntaxes 1, 2 and 3).

If a mask name and an abbreviation are given together (syntax 2), the mask may be opened by changing its abbreviation (allowing it to be opened twice, for example).

The instruction Mask closes all previously open masks. The Local Mask instruction will therefore be used in sub-programmes in preference to Mask. This declaration does not actually close files previously opened by a Mask or Local Maskcommand; however, the default list of masks then only contains masks declared by Local Mask. On return to the calling routine, the default list of masks will be found to be as it was before the sub-programme was called.

 

Associated errors

Error

Description

ERMODE (10)

The mask name is not alphanumeric.

ERTROM (42)

Too many masks opened at once.

PAFIC (20)

Mask not found.

ERCLAS ( 7)

Associated file abbreviation not found.

ERACCE (27)

Access error to mask.

 

Associated key words

FILEAFFZOMASKCOU


CONTENTS


Copyright © Sage 1999 - 2007