Code_Aster ®
Version
8.2
Titrate:
Procedure BEGINNING


Date:
31/01/06
Author (S):
Key J.P. LEFEBVRE
:
U4.11.01-I1 Page
: 1/8

Organization (S): EDF-R & D/AMA
Handbook of Utilization
U4.1- booklet: Management
Document: U4.11.01

Procedure BEGINNING

1 Goal

To allocate the resources memory, disc and files.

The execution consists of a whole of commands starting with DEBUT and ending in
FIN [U4.11.02], (see also procedure POURSUITE [U4.11.03]).

The command DEBUT which is carried out, as of its reading by Superviseur, carries out the tasks
following:

·
definition of the logical units of the files used in impression,
·
definition of the characteristics of the data bases (managed by JEVEUX) and allowance of
associated files,
·
reading of the catalogs of the elements and the commands.

The apparently complex syntax of this procedure should not worry the user; its call
with the operands by defect, sufficient in the majority of the cases, is: DEBUT ()

The operands are to be used studies in the case of requiring a size of the files “bases of
data " more important or to divert the various files on numbers of logical unit
different from the numbers affected by defect.

The commands placed before DEBUT, if they are syntactically correct, are ignored.
Handbook of Utilization
U4.1- booklet: Management
HT-62/06/004/A

Code_Aster ®
Version
8.2
Titrate:
Procedure BEGINNING


Date:
31/01/06
Author (S):
Key J.P. LEFEBVRE
:
U4.11.01-I1 Page
: 2/8

2 Syntax

DEBUT



(
PAR_LOT
=
/
“OUI”,
[DEFAUT]
/
“NON”,
IMPR_MACRO
=
/
“NON”,
[DEFAUT]
/
“OUI”,




BASE = _F (FILE =
/“GLOBALE”,
/
“VOLATILE”,












/ |
LONG_ENRE = lenr, [I]













|
NMAX_ENRE = nenr, [I]













|
LONG_REPE = lrep, [I]







),




CODE
=
_F
(
NOM
=
name
code,
[K8]








UNITE
= | 15
,
[DEFAUT]












| unitd,
[I]








NIV_PUB_WEB =/“INTERNET”,
/
“Intranet”
,








VISU_EFICAS
=
/
“OUI”,
[DEFAUT]
/
“NON”,







),



IMPRESSION
=
F (FILE
=
nomlocal
[l_Kn]











UNITE
=

uniti
,
[l_I]









),



ERROR = _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
=
your,
[I]









PARTITION
=
Pa,
[R]










TAILLE_BLOC
=
/
800.,
[DEFAUT]
/
tbloc,
[R]








),



RESERVE_CPU
=
_F (
/VALE
=
vale [R]











/POURCENTAGE = pcent

[R]










BORNE =/bv,
[R]
/
180. [DEFAUT]

)
)
Handbook of Utilization
U4.1- booklet: Management
HT-62/06/004/A

Code_Aster ®
Version
8.2
Titrate:
Procedure BEGINNING


Date:
31/01/06
Author (S):
Key J.P. LEFEBVRE
:
U4.11.01-I1 Page
: 3/8

3 Operands

3.1 Operand
PAR_LOT


PAR_LOT
=

Mode of processing of the commands:

“OUI”:
(default option); the supervisor analyzes all the commands before in
to ask the execution.
“NON”:
after having analyzed a command the supervisor asks for his execution
then passes to the analysis (and the execution) of the following command (processing
order by command).

3.2 Word
key
IMPR_MACRO


IMPR_MACRO
=

Authorize or not the displays produced by the macros in the file of message. Reading
files of message can be painful when it contains the totality of the echoes of under
commands generated by macro itself. By defect, only the echo of the commands
explicitly called by the user in his command set will appear.

3.3 Word
key
BASE


BASE
=

The functionality of this key word is to redefine the values of the parameters of the files
random accesses associated the “data bases” if one does not wish to use
those fixed by defect.

Default values of the parameters associated with the data bases.

GLOBALE

NMAX_ENRE
15728
LONG_ENRE
100 K words
LONG_REPE
2000
VOLATILE

NMAX_ENRE
15728
LONG_ENRE
100 K words
LONG_REPE
2000
LOCALE

NMAX_ENRE
512
LONG_ENRE
100 K words
LONG_REPE
2000

The word is worth 8 bytes out of platform 64 bits under TRU64 and IRIX 64, 4 bytes on platform
32 bits under SOLARIS, HP-UX and WINDOWS-NT, LINUX.

Under TRU64, with the default values, procedure DEBUT will allocate a file of access
direct of with more the 15728 recordings of 100 Kmots (K is worth 1024) for the base
“GLOBALE”.
Handbook of Utilization
U4.1- booklet: Management
HT-62/06/004/A

Code_Aster ®
Version
8.2
Titrate:
Procedure BEGINNING


Date:
31/01/06
Author (S):
Key J.P. LEFEBVRE
:
U4.11.01-I1 Page
: 4/8

Note:

The real size of the file is dynamic; it depends on the volume of information to store
indeed. But this size is limited by the conditions of operating and one
parameter preset among the values characterizing the platform. On the platform of
reference TRU64 the maximum size is fixed at 12 Go. This value can be modified in
placing an argument on the line of order of executable behind the key word ­
max_base size where size is an actual value measured out of Mo.
On the platforms 32 bits, the maximum size is fixed at 2.047 Go (2 147.483.647),
but the code manages several files to go beyond this limit when the parameter
­ max_base passed in argument.

3.3.1 Operand
FICHIER



FICHIER
=

Reference symbol of the base considered.

3.3.2 Operands
LONG_ENRE/NMAX_ENRE/LONG_REPE

Definition of the parameters of the data base (files of random access).

/
|
LONG_ENRE
=
lenr

lenr is the length of the recordings in Kmots of the files of random accesses
used.

Note:

The manager of memory JEVEUX uses this parameter to determine
two types of objects: the large objects which will be cut out in as much
recordings that necessary, and the small objects which will be accumulated
in a buffer of the size of a recording before being discharged.

|
NMAX_ENRE
=
nenr

nenr is the number of recordings per defect, this value is given with
to start from LONG_ENRE and an operating parameter on the platform of reference
TRU64 fixed at 12 Go (12 884.901.888 bytes) for the maximum size of the file
associated a data base, if this value were not modified by the use
key word ­ max_base on the line of ordering of the executable one.

Note:

Two operands LONG_ENRE and NMAX_ENRE must be used with
precaution, a bad use which can lead to the brutal stop of
program by saturation of the files of random access. Coherence enters
maximum size of the file and the value resulting from the product of both
parameters LONG_ENRE and NMAX_ENRE is checked at the beginning of execution.

|
LONG_REPE
=
lrep


lrep is the initial length of the repertory (a maximum number of addressable objects by
JEVEUX), it is managed dynamically by the manager of memory which extends
size of the repertory and all the system objects progressively associated with
needs.

Note:

The choice by the user to modify these various parameters, or to indicate
a value behind the parameter ­ max_base determines in a final way
certain characteristics of base GLOBALE which cannot be any more
modified in POURSUITE.
Handbook of Utilization
U4.1- booklet: Management
HT-62/06/004/A

Code_Aster ®
Version
8.2
Titrate:
Procedure BEGINNING


Date:
31/01/06
Author (S):
Key J.P. LEFEBVRE
:
U4.11.01-I1 Page
: 5/8

3.4 Word
key
CODE


CODE
=

Definition of a name for the whole of a study.

3.4.1 Operand
NOM



NOM = name codes

Name of identification of the study, this name is with more than 8 characters.

3.4.2 Operand
UNITE



UNITE = unitc

Number of the logical unit positive, associated the “condensed” writing of the commands.

Default value UNITE = 15.

Note:

This possibility is in particular used by all the tests of validation to preserve
an image of the commands used by each one of them [V1.02.00].
It is possible to give a name to its study, without starting the impression of
commands while indicating UNITE = 0.

3.4.3 Operand
NIV_PUB_WEB


NIV_PUB_WEB = “INTRANET”

Level gauge of publication. Meaning that the test is only diffusable on
internal network.

NIV_PUB_WEB = “INTERNET”

Indicate that the test is diffusable just as it is on the external network.



VISU_EFICAS = “YES”

Indicate that the command file can be open without problem with tool EFICAS. It
key word is primarily used for the tests and at ends of receipt of the news
poured tool.



VISU_EFICAS = “NOT”

Announce the presence of python source in the command file not allowing sound
edition with tool EFICAS.

3.5 Word
key
IMPRESSION

IMPRESSION
=

Definition of the logical units of the files used in impression.

3.5.1 Operand
FICHIER


FICHIER
=

List reference symbols of files.
Handbook of Utilization
U4.1- booklet: Management
HT-62/06/004/A

Code_Aster ®
Version
8.2
Titrate:
Procedure BEGINNING


Date:
31/01/06
Author (S):
Key J.P. LEFEBVRE
:
U4.11.01-I1 Page
: 6/8

3.5.2 Operand
UNITE


UNITE = uniti

Number of the logical unit associated the files of the list.

If uniti is negative or null, there is no impression on this (S) file (S).
By defect:

FICHIER
UNITE
“ERREUR” 9
“MESSAGE” 6
“RESULTAT” 8
“MED” 80

The definition of association file name, logical number of unit feeds the structure of
data internal with the code which is generated by command DEFI_FICHIER [U4.12.03].

3.6 Word
key
ERREUR


ERREUR =

Allows to recover an error of the <F> type to carry out a particular processing, it
mechanism was installed to check the emission of error message in the tests of
not-regression of the code. It is also interesting to be able to recover the hand properly
in some macros (Stanley or tools trades) without stopping brutally in fatal error.

3.6.1 Operand
ERREUR_F


ERREUR_F
=

“ABORT” the behavior of the code is unchanged and the code stops by printing one
increase of error.
“EXCEPTION” one raises the exception aster.FatalError (code 20) and one returns to
standard behavior in the event of error (“ABORT”)

3.7 Word
key
DEBUG


DEBUG
=

Option of déboggage (reserved for the developers and the maintenance of the code).

3.7.1 Operand
JXVERI



JXVERI
=

Allows to control the integrity of the segments of the memory between two executions of
consecutive commands.

By defect the execution is carried out without “DEBUG”.

3.7.2 Operand
ENVIMA



ENVIMA = “TEST”

Allows to print in file RESULTAT the values of the parameters preset in
software package ENVIMA characterizing the machine [D5.01].
Handbook of Utilization
U4.1- booklet: Management
HT-62/06/004/A

Code_Aster ®
Version
8.2
Titrate:
Procedure BEGINNING


Date:
31/01/06
Author (S):
Key J.P. LEFEBVRE
:
U4.11.01-I1 Page
: 7/8

3.7.3 Operand
JEVEUX



JEVEUX
=

Allows to activate the operating mode in debug of the manager of memory
JEVEUX: unloadings on disc not differed and assignment from the segments values with
an indefinite value [D6.02.01].

3.8 Key word
MEMOIRE

Allows to modify the mode of management of the memory. During the allowance in memory of a segment
values, it is possible is to carry out a search for place by causing unloadings
on disc (GESTION = “COMPACTE”), which makes it possible to use less memory capacity but with
price of many accesses disc, is to seek in a priority way the free zones or
correspondent with accesses in reading alone (GESTION = “RAPIDE”).

3.8.1 Operand
GESTION

GESTION =

“COMPACTE”: allows to activate the mode of most sparing memory allocation in total place.
“RAPIDE”: allows to activate the mode of memory allocation privileging a fast access.

3.8.2 Operand
TYPE_ALLOCATION

TYPE_ALLOCATION = ty

1: standard management of memory, one does not distinguish the objects to be allocated,
2: the systems objects of collection are allocated at the end of the zone memory in order to avoid
to scatter the latter and to too much split the zones likely to accommodate the large one
objects,
3: even standard of allowance that previously, but applying to a criterion of size of
objects,
4: the zone memory is partitionnée into two, a zone is reserved for the allowance of small
objects.

3.8.3 Operand
TAILLE

TAILLE = size in words (unit of addressing in entirety) defining the small objects used for one
type of allowance 3 or 4.

3.8.4 Operand
PARTITION

PARTITION = relationship between the size of the zone memory used for the allowance of the “large” objects and
total zone.
This zone is located at the end of the segmentation, the systems objects specific to JEVEUX are allocated
in the partition reserved for the “small” objects.

Note:

If one of the partitions is saturated, one returns to a mode of standard management of the memory
(TYPE_ALLOC = 1).
Handbook of Utilization
U4.1- booklet: Management
HT-62/06/004/A

Code_Aster ®
Version
8.2
Titrate:
Procedure BEGINNING


Date:
31/01/06
Author (S):
Key J.P. LEFEBVRE
:
U4.11.01-I1 Page
: 8/8

3.8.5 Operand
TAILLE_BLOC

This key word, formerly placed under SOLVEUR in the total commands, is used to define
cut blocks of the matrix.


TAILLE_BLOC =

One can choose the size of the blocks of the matrix of rigidity (tbloc). This size is given in
kiloR8 (1 kiloR8 = 1024 realities). This parameter influences the number of operations of input/output and
thus over the time of assembly and resolution. By defect this value is fixed at 800 kiloR8,
that is to say 8 recordings per defect on the file of random access associated base JEVEUX.

3.9 Key word
RESERVE_CPU

Allows to reserve a share of the time CPU allotted to the job to finish the execution properly in
case of stop for lack of time CPU detected by a Aster command. This mechanism is not useful
that in the case of an execution batch of Code_Aster. The value of this reserve can be indicated
in absolute value or in the form of a percentage of total time CPU. This value is limited
by the value of key word BORNE.

3.9.1 Operand
VALE

Value expressed in seconds withdrawn from the total time CPU, over which certain commands
total bases itself to stop the execution properly.

3.9.2 Operand
POURCENTAGE

Percentage withdrawn from the total time CPU, over which certain total commands is based for
to stop the execution properly.

3.9.3 Operand
BORNE

Maximum value of the reserve of time, being worth by defect 180 seconds.

4 Example
of use

The standard use of this procedure is:

DEBUT
(
)

Handbook of Utilization
U4.1- booklet: Management
HT-62/06/004/A

Outline document