Code_Aster ®
Version
8.2
Titre :
Procédure DEBUT
Date :
31/01/06
Auteur(s) :
J.P. LEFEBVRE Clé
:
U4.11.01-I1 Page
: 1/8
Organisme(s) : EDF-R&D/AMA
Manuel d'Utilisation
Fascicule U4.1- : Gestion
Document : U4.11.01
Procédure DEBUT
1 But
Affecter les ressources mémoire, disque et fichiers.
L'exécution est constituée d'un ensemble de commandes commençant par DEBUT et se terminant par
FIN [U4.11.02], (voir aussi la procédure POURSUITE [U4.11.03]).
La commande DEBUT qui est exécutée, dès sa lecture par le Superviseur, effectue les tâches
suivantes :
·
définition des unités logiques des fichiers utilisés en impression,
·
définition des caractéristiques des bases de données (gérées par JEVEUX) et allocation des
fichiers associés,
·
lecture des catalogues des éléments et des commandes.
La syntaxe apparemment complexe de cette procédure ne doit pas inquiéter l'utilisateur ; son appel
avec les opérandes par défaut, suffisant dans la plupart des cas, est : DEBUT ( )
Les opérandes sont à utiliser dans le cas d'études nécessitant une taille des fichiers "bases de
données" plus importante ou pour dérouter les différents fichiers sur des numéros d'unité logique
différents des numéros affectés par défaut.
Les commandes placées avant DEBUT, si elles sont syntaxiquement correctes, sont ignorées.
Manuel d'Utilisation
Fascicule U4.1- : Gestion
HT-62/06/004/A
Code_Aster ®
Version
8.2
Titre :
Procédure DEBUT
Date :
31/01/06
Auteur(s) :
J.P. LEFEBVRE Clé
:
U4.11.01-I1 Page
: 2/8
2 Syntaxe
DEBUT
(
PAR_LOT
=
/
'OUI',
[DEFAUT]
/
'NON',
IMPR_MACRO
=
/
'NON',
[DEFAUT]
/
'OUI',
BASE = _F ( FICHIER =
/ 'GLOBALE',
/
'VOLATILE',
/ |
LONG_ENRE = lenr , [I]
|
NMAX_ENRE = nenr , [I]
|
LONG_REPE = lrep , [I]
),
CODE
=
_F
(
NOM
=
nom
code,
[K8]
UNITE
= | 15
,
[DEFAUT]
| unitd,
[I]
NIV_PUB_WEB = / 'INTERNET' ,
/
'INTRANET'
,
VISU_EFICAS
=
/
'OUI',
[DEFAUT]
/
'NON',
),
IMPRESSION
=
F ( FICHIER
=
nomlocal
[l_Kn]
UNITE
=
uniti
,
[l_I]
),
ERREUR = _F ( ERREUR_F=
/ 'ABORT',
[DEFAUT]
/
'EXCEPTION',
DEBUG = _F
(
JXVERI
= / 'OUI',
/
'NON',
ENVIMA
=
'TEST', [l_Kn]
JEVEUX
= / 'OUI',
/
'NON',
),
MEMOIRE
=
_F(
GESTION
=
/
'RAPIDE',
[DEFAUT]
/ 'COMPACTE',
TYPE_ALLOCATION = / ty,
[I]
/
1,
[DEFAUT]
TAILLE
=
ta,
[I]
PARTITION
=
pa,
[R]
TAILLE_BLOC
=
/
800.,
[DEFAUT]
/
tbloc,
[R]
),
RESERVE_CPU
=
_F(
/VALE
=
vale [R]
/POURCENTAGE = pcent
[R]
BORNE = / bv,
[R]
/
180. [DEFAUT]
)
)
Manuel d'Utilisation
Fascicule U4.1- : Gestion
HT-62/06/004/A
Code_Aster ®
Version
8.2
Titre :
Procédure DEBUT
Date :
31/01/06
Auteur(s) :
J.P. LEFEBVRE Clé
:
U4.11.01-I1 Page
: 3/8
3 Opérandes
3.1 Opérande
PAR_LOT
PAR_LOT
=
Mode de traitement des commandes :
'OUI' :
(option par défaut) ; le superviseur analyse toutes les commandes avant d'en
demander l'exécution.
'NON' :
après avoir analysé une commande le superviseur demande son exécution
puis passe à l'analyse (et à l'exécution) de la commande suivante (traitement
commande par commande).
3.2 Mot
clé
IMPR_MACRO
IMPR_MACRO
=
Autorise ou non les affichages produits par les macros dans le fichier de message. La lecture
des fichiers de message peut être pénible quand elle contient la totalité des échos des sous-
commandes générées par la macro elle-même. Par défaut, seul l'écho des commandes
explicitement appelées par l'utilisateur dans son jeu de commandes apparaîtra.
3.3 Mot
clé
BASE
BASE
=
La fonctionnalité de ce mot clé est de redéfinir les valeurs des paramètres des fichiers
d'accès direct associés aux "bases de données" dans le cas où l'on ne désire pas utiliser
ceux fixés par défaut.
Valeurs par défaut des paramètres associés aux bases de données.
GLOBALE
NMAX_ENRE
15728
LONG_ENRE
100 K mots
LONG_REPE
2000
VOLATILE
NMAX_ENRE
15728
LONG_ENRE
100 K mots
LONG_REPE
2000
LOCALE
NMAX_ENRE
512
LONG_ENRE
100 K mots
LONG_REPE
2000
Le mot vaut 8 octets sur plate-forme 64 bits sous TRU64 et IRIX 64, 4 octets sur plate-forme
32 bits sous SOLARIS, HP-UX et WINDOWS-NT, LINUX.
Sous TRU64, avec les valeurs par défaut, la procédure DEBUT allouera un fichier d'accès
direct d'au plus 15728 enregistrements de 100 Kmots (le K vaut 1024) pour la base
'GLOBALE'.
Manuel d'Utilisation
Fascicule U4.1- : Gestion
HT-62/06/004/A
Code_Aster ®
Version
8.2
Titre :
Procédure DEBUT
Date :
31/01/06
Auteur(s) :
J.P. LEFEBVRE Clé
:
U4.11.01-I1 Page
: 4/8
Remarque :
La taille réelle du fichier est dynamique ; elle dépend du volume d'informations à stocker
effectivement. Mais cette taille est limitée par les conditions d'exploitation et un
paramètre défini parmi les valeurs caractérisant la plate-forme. Sur la plate-forme de
référence TRU64 la taille maximum est fixée à 12 Go. Cette valeur peut être modifiée en
passant un argument sur la ligne de commande de l'exécutable derrière le mot clé
max_base taille où taille est une valeur réelle mesurée en Mo.
Sur les plates-formes 32 bits, la taille maximum est fixée à 2.047 Go (2 147 483 647),
mais le code gère plusieurs fichiers pour aller au delà de cette limite lorsque le paramètre
max_base est passé en argument.
3.3.1 Opérande
FICHIER
FICHIER
=
Nom symbolique de la base considérée.
3.3.2 Opérandes
LONG_ENRE / NMAX_ENRE / LONG_REPE
Définition des paramètres de la base de données (fichiers d'accès direct).
/
|
LONG_ENRE
=
lenr
lenr est la longueur des enregistrements en Kmots des fichiers d'accès directs
utilisés.
Remarque :
Le gestionnaire de mémoire JEVEUX utilise ce paramètre pour déterminer
deux types d'objets : les gros objets qui seront découpés en autant
d'enregistrements que nécessaire, et les petits objets qui seront accumulés
dans un tampon de la taille d'un enregistrement avant d'être déchargé.
|
NMAX_ENRE
=
nenr
nenr est le nombre d'enregistrements par défaut, cette valeur est déterminée à
partir de LONG_ENRE et d'un paramètre d'exploitation sur la plate-forme de référence
TRU64 fixé à 12 Go (12 884 901 888 octets) pour la taille maximale du fichier
associé à une base de données, si cette valeur n'a pas été modifiée par l'utilisation
du mot-clé max_base sur la ligne de commande de l'exécutable.
Remarque :
Les deux opérandes LONG_ENRE et NMAX_ENRE doivent être utilisés avec
précaution, un mauvais usage pouvant conduire à l'arrêt brutal du
programme par saturation des fichiers d'accès direct. La cohérence entre
la taille maximale du fichier et la valeur résultant du produit des deux
paramètres LONG_ENRE et NMAX_ENRE est vérifiée en début d'exécution.
|
LONG_REPE
=
lrep
lrep est la longueur initiale du répertoire (nombre maximal d'objets adressables par
JEVEUX), elle est gérée dynamiquement par le gestionnaire de mémoire qui étend
la taille du répertoire et de tous les objets système associés au fur et à mesure des
besoins.
Remarque :
Le choix par l'utilisateur de modifier ces différents paramètres, ou d'indiquer
une valeur derrière le paramètre max_base détermine de façon définitive
certaines caractéristiques de la base GLOBALE qui ne peuvent plus être
modifiées en POURSUITE.
Manuel d'Utilisation
Fascicule U4.1- : Gestion
HT-62/06/004/A
Code_Aster ®
Version
8.2
Titre :
Procédure DEBUT
Date :
31/01/06
Auteur(s) :
J.P. LEFEBVRE Clé
:
U4.11.01-I1 Page
: 5/8
3.4 Mot
clé
CODE
CODE
=
Définition d'un nom pour l'ensemble d'une étude.
3.4.1 Opérande
NOM
NOM = nom code
Nom d'identification de l'étude, ce nom est au plus de 8 caractères.
3.4.2 Opérande
UNITE
UNITE = unitc
Numéro de l'unité logique positif, associé à l'écriture "condensée" des commandes.
Valeur par défaut UNITE = 15.
Remarque :
Cette possibilité est notamment utilisée par tous les tests de validation pour conserver
une image des commandes utilisées par chacun d'eux [V1.02.00].
Il est possible de donner un nom à son étude, sans déclencher l'impression des
commandes en indiquant UNITE = 0.
3.4.3 Opérande
NIV_PUB_WEB
NIV_PUB_WEB = 'INTRANET'
Indicateur de niveau de publication. Signifiant que le test est uniquement diffusable sur le
réseau interne.
NIV_PUB_WEB = 'INTERNET'
Indique que le test est diffusable tel quel sur le réseau externe.
VISU_EFICAS = 'OUI'
Indique que le fichier de commandes peut être ouvert sans problème avec l'outil EFICAS. Ce
mot-clé est essentiellement utilisé pour les tests et à des fins de recette des nouvelles
versions de l'outil.
VISU_EFICAS = 'NON'
Signale la présence de source python dans le fichier de commandes ne permettant pas son
édition avec l'outil EFICAS.
3.5 Mot
clé
IMPRESSION
IMPRESSION
=
Définition des unités logiques des fichiers utilisés en impression.
3.5.1 Opérande
FICHIER
FICHIER
=
Liste de noms symboliques de fichiers.
Manuel d'Utilisation
Fascicule U4.1- : Gestion
HT-62/06/004/A
Code_Aster ®
Version
8.2
Titre :
Procédure DEBUT
Date :
31/01/06
Auteur(s) :
J.P. LEFEBVRE Clé
:
U4.11.01-I1 Page
: 6/8
3.5.2 Opérande
UNITE
UNITE = uniti
Numéro de l'unité logique associée aux fichiers de la liste.
Si uniti est négatif ou nul, il n'y a pas d'impression sur ce(s) fichier(s).
Par défaut :
FICHIER
UNITE
'ERREUR' 9
'MESSAGE' 6
'RESULTAT' 8
'MED' 80
La définition de l'association nom de fichier, numéro d'unité logique alimente la structure de
données interne au code qui est généré par la commande DEFI_FICHIER [U4.12.03].
3.6 Mot
clé
ERREUR
ERREUR =
Permet de récupérer une erreur de type <F> pour effectuer un traitement particulier, ce
mécanisme a été mis en place pour vérifier l'émission de message d'erreur dans les tests de
non-régression du code. Il est aussi intéressant de pouvoir récupérer proprement la main
dans certaines macros (Stanley ou outils métiers) sans s'arrêter brutalement en erreur fatale.
3.6.1 Opérande
ERREUR_F
ERREUR_F
=
`ABORT' le comportement du code est inchangé et le code s'arrête en imprimant une
remontée d'erreur.
`EXCEPTION' on lève l'exception aster.FatalError (code 20) et on revient au
comportement standard en cas d'erreur (`ABORT')
3.7 Mot
clé
DEBUG
DEBUG
=
Option de déboggage (réservée aux développeurs et à la maintenance du code).
3.7.1 Opérande
JXVERI
JXVERI
=
Permet de contrôler l'intégrité des segments de la mémoire entre deux exécutions de
commandes consécutives.
Par défaut l'exécution s'effectue sans "DEBUG".
3.7.2 Opérande
ENVIMA
ENVIMA = 'TEST'
Permet d'imprimer dans le fichier RESULTAT les valeurs des paramètres définis dans le
progiciel ENVIMA caractérisant la machine [D5.01].
Manuel d'Utilisation
Fascicule U4.1- : Gestion
HT-62/06/004/A
Code_Aster ®
Version
8.2
Titre :
Procédure DEBUT
Date :
31/01/06
Auteur(s) :
J.P. LEFEBVRE Clé
:
U4.11.01-I1 Page
: 7/8
3.7.3 Opérande
JEVEUX
JEVEUX
=
Permet d'activer le mode de fonctionnement en debug du gestionnaire de mémoire
JEVEUX : déchargements sur disque non différés et affectation des segments valeurs à
une valeur indéfinie [D6.02.01].
3.8 Mot-clé
MEMOIRE
Permet de modifier le mode de gestion de la mémoire. Lors de l'allocation en mémoire d'un segment
de valeurs, il est possible soit d'effectuer une recherche de place en provoquant des déchargements
sur disque (GESTION = 'COMPACTE'), ce qui permet d'utiliser moins d'espace mémoire mais au
prix de nombreux accès disque, soit de rechercher de façon prioritaire les zones libres ou
correspondant à des accès en lecture seule (GESTION = 'RAPIDE').
3.8.1 Opérande
GESTION
GESTION =
'COMPACTE': permet d'activer le mode d'allocation mémoire le plus économe en place totale.
'RAPIDE' : permet d'activer le mode d'allocation mémoire privilégiant un accès rapide.
3.8.2 Opérande
TYPE_ALLOCATION
TYPE_ALLOCATION = ty
1 : gestion standard de mémoire, on ne distingue pas les objets à allouer,
2 : les objets systèmes de collection sont alloués en fin de zone mémoire de façon à éviter
d'éparpiller ces derniers et de trop fractionner les zones susceptibles d'accueillir de gros
objets,
3 : même type d'allocation que précédemment, mais s'appliquant sur un critère de taille des
objets,
4 : la zone mémoire est partitionnée en deux, une zone est réservée à l'allocation des petits
objets.
3.8.3 Opérande
TAILLE
TAILLE = taille en mots (unité d'adressage en entier) définissant les petits objets utilisée pour un
type d'allocation 3 ou 4.
3.8.4 Opérande
PARTITION
PARTITION = rapport entre la taille de la zone mémoire utilisée pour l'allocation des "gros" objets et la
zone totale.
Cette zone est située en fin de segmentation, les objets systèmes propres à JEVEUX sont alloués
dans la partition réservée au "petits" objets.
Remarque :
Si l'une des partitions est saturée, on revient à un mode de gestion standard de la mémoire
(TYPE_ALLOC = 1).
Manuel d'Utilisation
Fascicule U4.1- : Gestion
HT-62/06/004/A
Code_Aster ®
Version
8.2
Titre :
Procédure DEBUT
Date :
31/01/06
Auteur(s) :
J.P. LEFEBVRE Clé
:
U4.11.01-I1 Page
: 8/8
3.8.5 Opérande
TAILLE_BLOC
Ce mot clé, autrefois placé sous SOLVEUR dans les commandes globales, est utilisé pour définir la
taille des blocs de la matrice.
TAILLE_BLOC =
On peut choisir la taille des blocs de la matrice de rigidité (tbloc). Cette taille est donnée en
kiloR8 (1 kiloR8 = 1024 réels). Ce paramètre influe sur le nombre d'opérations d'entrée / sortie et
donc sur le temps d'assemblage et de résolution. Par défaut cette valeur est fixée à 800 kiloR8,
soit 8 enregistrements par défaut sur le fichier d'accès direct associé à la base JEVEUX.
3.9 Mot-clé
RESERVE_CPU
Permet de réserver une part du temps CPU attribué au job pour terminer proprement l'exécution en
cas d'arrêt par manque de temps CPU détecté par une commande Aster. Ce mécanisme n'est utile
que dans le cas d'une exécution batch de Code_Aster. La valeur de cette réserve peut être indiquée
en valeur absolue ou bien sous forme d'un pourcentage du temps CPU total. Cette valeur est bornée
par la valeur du mot clé BORNE.
3.9.1 Opérande
VALE
Valeur exprimée en secondes soustraite au temps CPU total, sur lequel certaines commandes
globales se base pour arrêter proprement l'exécution.
3.9.2 Opérande
POURCENTAGE
Pourcentage soustrait au temps CPU total, sur lequel certaines commandes globales se base pour
arrêter proprement l'exécution.
3.9.3 Opérande
BORNE
Valeur maximale de la réserve de temps, valant par défaut 180 secondes.
4 Exemple
d'utilisation
L'utilisation standard de cette procédure est :
DEBUT
(
)
Manuel d'Utilisation
Fascicule U4.1- : Gestion
HT-62/06/004/A
Document Outline