MASK |
Mask is used to declare all the masks that can be used in a routine.
[ Local ] Mask liste_masques
|
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 |
Description of a mask in one
of the following forms: |
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. |
# Declaring 3 masksMask SAICP1 [CPT1] , =[L]NOMMSK [CPT2], ="DOSSIERA.SAICP1" [CPT3]
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.
|
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. |
|
|