Академический Документы
Профессиональный Документы
Культура Документы
Orange Service
DOCUMENTATION SYNON
Page 1 / 17
Auteur : rdas
Documentation SYNON
Orange Service
1.1.1
1.1.2
1.2
1.3
1.4
1.4.1
Champs alphabtiques......................................................................................................................5
1.4.2
Champs numriques..........................................................................................................................5
1.5
3.2
LA FONCTION DE LECTURE........................................................................................................................8
STRUCTURE GNRALE..............................................................................................................................9
4.2
LES CONTEXTES........................................................................................................................................9
5. MESSAGES.......................................................................................................................................................11
6. LES INSTRUCTIONS......................................................................................................................................12
6.1 CALCULS........................................................................................................................................................12
6.2 AFFECTATIONS...............................................................................................................................................12
6.3 PROGRAMMES................................................................................................................................................12
6.4 AUTRES..........................................................................................................................................................12
7. ETATS ET FONCTIONS UTILISATEURS...................................................................................................13
7.1 FORMATS DTAT...........................................................................................................................................13
7.2 LES CONTEXTES DTAT.................................................................................................................................13
8. LES FONCTIONS BATCH.............................................................................................................................14
Page 2 / 17
Auteur : rdas
Documentation SYNON
Orange Service
Page 3 / 17
Auteur : rdas
Documentation SYNON
Orange Service
REFERS TO : dclaration dune relation de rfrence entre deux fichiers. Les zones cl du fichier auquel on
se rfre sont ramenes dans le fichier qui fait rfrence en tant quattributs. On parle de cls trangres
(FK) ; ex : Commande REFERS TO Client les identifiants du fichier Client (Code client) deviennent
attributs du fichier Commande.
OWNED BY : dclaration dune relation parent - enfant entre 2 fichiers. La cl du fichier matre fait partie de
la cl primaire du fichier Owned by ; ex : Ligne_de_commande OWNED BY Commande le fichier
Ligne_de_commande aura comme cl N commande / N ligne (# relation dappartenance).
INCLUDES : cette relation vous permet dinclure la structure de donnes du fichier STR dans un autre
fichier. Elle est utilise principalement pour des structures fixes et le fichier de droite ne possde pas
d'identifiant (Type STR) ; ex : Client INCLUDES Adresse, Commande INCLUDES Audit.
DEFINED AS : dclaration dun fichier ; ex : Salle DEFINED AS Salle. Il ne faut pas oublier de supprimer
cette relation si l'on veut supprimer l'entit.
EXTENDED BY : cette relation permet dans une relation de type un un optionnelle, entre 2 fichiers, de
virtualiser des zones de lextension dans le fichier tendu ; ex : Client EXTENDED BY Client_tranger,
pour la migration de la cl il faudra galement dfinir la relation : Client_tranger OWNED BY Client
Rflexivit : relation o un fichier se rfre lui-mme ; ex : Docteur Refers to Docteur.
1.1.2
ATTRIBUT
Relations tendues Texte Pour : ajoute du texte une relation. Utilisable seulement avec les relations Owned
by et Refers to ; ex : Docteur Refers to Docteur Pour Superviseur Superviseur Code Docteur FK.
1.2
-
Remarque : La diffrence entre les fichiers REF et CPT se fait au niveau des traitements proposs par SYNON.
Pour les deux types, SYNON propose les 3 fonctions internes et en plus pour le type REF, SYNON met
Page 4 / 17
Auteur : rdas
Documentation SYNON
Orange Service
disposition la fonction de slection et celle de mise jour intractive. Sinon, au niveau de la gnration; il n'y a
aucune diffrence.
1.3
1.4
1.4.2
-
1.5
-
Champs alphabtiques
Champs numriques
PCT : Pourcentage. Il s'agit juste d'un format, aucun calcul n'est li ce type, par dfaut : 5,2.
QTY : Quantit. Utilis pour des quantits ou des poids, par dfaut : 5,0.
NBR : Nombre. Utilis pour des n (facture par ex) ou comme compteur ou encore pour du numrique pur,
par dfaut : 5,0.
PRC : Prix. Par dfaut : 7,2.
VAL : Valeur. Pour les montants, par dfaut : 9,2. Code diton CR/DB par dfaut.
TME : Time (HH:MM:SS). Par dfaut : 6,0 (non modifiable).
DTE : Date. Format interne : SAAMMJJ (7,0) et format externe : JJMMAA (6,0). SYNON se charge du
passagge d'interne en externe et inversement.
D8 : idem DTE mais format interne : SSAAMMJJ.
DT : idem DTE mais format interne : SSAA-MM-JJ (alphabtique).
Page 5 / 17
Auteur : rdas
Documentation SYNON
Orange Service
Page 6 / 17
Auteur : rdas
Documentation SYNON
Orange Service
3. Les fonctions
3.1
Une fonction est une liste de traitements sur un fichier ou une zone. Elle peut tre :
- externe : implmente comme un programme LHN indpendant, doit tre gnre. Ex : EDTRCD
- interne : agit comme une sous-routine appele par une fonction externe, elle est incorpore dans le
source des fonctions externes, ne se gnre pas. Ex : CRTOBJ, CHGOBJ, DLTOBJ
Une fonction est compose :
- de paramtres
- d'un cran/tat (0,1)
- d'un diagramme d'action.
Les types de fonctions interactives peuvent tre classes selon le nombre denregistrements taits en mme
temps :
- 1 seul enregistrement : RCD (fiche)
- Plusieurs : FIL (liste)
- 1 transaction (1+N) : TRN (entte + liste).
Type
Affichage
MAJ
DSPRCD
EDTRCD
PMTRCD
EDTFIL
Style
1
N
1+N
DSPFIL
SELRCD
DSPTRN
EDTTRN
3.2
Ils sont utiliss pour passer des valeurs entre 2 fonctions. Pour en dfinir un, il faut le spcifier au niveau de la
fonction appele et renseigner :
- son nom
- son utilisation :
en entre (I) : une valeur est passe lappel de la fonction, aucune valeur nest renvoye.
en sortie (O) : une valeur est renvoye quand la fonction sachve, aucune valeur initiale.
en entre / sortie (B) : une valeur est passe lappel de la fonction, une valeur est renvoye
quand la fonction sachve.
Aucun (N) : aucune valeur nest passe, aucune valeur nest renvoye. Si lutilisation est en
entre, le paramtre devient une variable locale, si de plus le rle est Map, il apparat sur la
conception dcran.
- son rle :
Transposition (MAP) : il est automatiquement dplac dans une zone correspondante de
lcran. Place une zone X sur un cran.
Restrictif (RST) : il est utilis pour restreindre le nombre denregistrements lus. Il doit tre zone
cl dans lordre du chemin daccs. Lit uniquement les enregistrements dont la cl est = la
valeur du paramtre.
Positionneur (POS) : il est utilis pour se positionner sur un enregistrement du chemin daccs.
Lit uniquement les enregistrements dont la cl est >= la valeur du paramtre.
Variable (VRY) : il peut avoir une longueur variable. Trs utile pour une interface avec des
programmes non Synon. Permet aux longueurs de zones paramtres dtre diffrentes.
Page 7 / 17
Auteur : rdas
Documentation SYNON
Orange Service
Chargement statique
-
Affiche les zones du CdA mais il n'y a pas de traitements effectus (sauf F4), tout est programmer. Ce type de
fonction est utile pour des zones non fichier, exemple : Date dbut date fin pour slection sur une dition.
3.4
La fonction de lecture
Le RTVOBJ est une fonction interne, son fonctionnement varie suivant son chemin d'accs et le rle de ses
paramtres. Il n'y a pas d'itration (boucle) programmer c'est la fonction qui s'en charge. Le contexte utilis est
le contexte DB1.
On prendra comme exemple, pour les diffrents types de lecture, le fichier Ligne_de_commande avec pour cl le
n commande et le n ligne.
Il y a 3 types de lecture :
Squentielle : c'est la cl qui dtermine l'ordre de lecture et il n'y a pas de paramtre. Exemple :
tous les enregistrements sont lus dans l'ordre n commande, n ligne.
Squentielle avec galit sur cl : on utilise les paramtres en rle restrictif (RST). Exemple : le n
commande est pass en paramtres, on lit donc toutes les lignes relatives ce n commande.
Egalit sur cl : on passe la cl en paramtre restrictif (RST) et on ne lit qu'un enregistrement.
Exemple: le n commande et le n ligne sont passs, on ne lit donc que l'enregistrement (s'il existe)
concern.
Remarque : si les paramtres sont passs en mode positionnement (POS), on se positionne et on lit jusqu' la fin
du fichier.
Page 8 / 17
Auteur : rdas
Documentation SYNON
Orange Service
4. Diagramme daction
4.1
Structure gnrale
Un diagramme daction est compos dune suite de blocs pr-construits. Il existe 3 types de blocs :
- une Squence excute une liste dactions
- un bloc dItration spcifie que les actions qui sy trouvent doivent tre excutes autant de fois
quune condition est vraie (instruction REPEAT WHILE)
- un bloc de Condition spcifie une condition et une srie dactions qui doit tre excute si la
condition est vraie (instruction CASE).
4.2
Les Contextes
Le but dun contexte est de distinguer quelle version de la zone doit tre utilise. Les contextes disponibles
peuvent tre groups en 5 catgories :
- Base de donnes
DB1 : contient les zones du 1er ou de lunique format du chemin daccs auquel est
rattache la fonction. Il est disponible dans tous les types de fonction lisant ou mettant
jour un fichier ou un tableau.
DB2 : contient les zones du 2nd format dun chemin daccs SPAN (utilis dans les
fonctions EDTTRN et DSPTRN).
- Ecran / Etat
KEY : disponible pour les fonctions EDTRCD et DSPRCD. Toutes les zones de lcran cl
seront disponibles.
DTL : disponible pour les fonctions EDTRCD, DSPRCD et PMTRCD. Toutes les zones de
lcran dtail seront disponibles.
CTL et RCD : pour les fonctions EDTFIL, DSPFIL et SELRCD. Les zones disponibles
dpendent du type de fonction et du chemin daccs utilis.
2ND / 3RD : contient les zones du second/troisime cran.
CUR : se rfre au format en cours de traitement dans la fonction dtat.
NXT : se rfre au format suivant le format CUR.
- Fonction
PAR : zones ayant t dfinies comme paramtres dune fonction.
WRK : toute zone du dictionnaire peut tre utilise comme zone de travail.
NLL : utilis si on ne veut pas "utiliser" la zone.
LCL : comme le contexte WRK mais en local (# global).
- Littral
CND : condition utilise comme valeur de zone, en gnral pour les zones statut. Elles sont
soit des valeurs soit des listes pour les zones statut et des comparaisons ou des intervalles
pour les non-statut.
CON : constante ou valeur littrale.
- Systme
JOB : contient les zones systme donnant des informations sur lexcution dun travail. On
ne peut pas ajouter de zones supplmentaires dans ce contexte.
PGM : les zones de ce contexte sont des zones qui contrlent lexcution dune fonction.
Fonctions possibles :
*Mode de programme : Mode en cours.
*Code retour : Statut dachvement.
*Recharger sous-fichier : Recharger sous-fichier partir de la BDD.
*Enregistrement slectionn : Dterminer si un enregistrement lu dun fichier doit
tre utilis dans la fonction.
*Limite de balayage : Spcifier combien denregistrements devront tre lus durant
la boucle Lecture/Chargement.
*Diffrer confirmation : Suspendre le traitement de confirmation incluant tout
traitement ultrieur.
Page 9 / 17
Auteur : rdas
Documentation SYNON
Orange Service
Page 10 / 17
Auteur : rdas
Documentation SYNON
Orange Service
5. Messages
Un message est compos :
- dun nom.
- dun type (INF, ERR, CMP, STS, EXC, RTV).
- dun texte de 1er niveau qui est par dfaut le nom du message.
- dun texte de 2me niveau appel quand lutilisateur fera aide sur un message.
- de paramtres ventuellement insrs dans le texte de 1er et 2me niveau.
Il existe 6 types de fonctions de message :
- les messages dinformation : ils ne requirent pas daction et ne suspendent pas le traitement
(SNDINFMSG).
- les messages derreur : ils requirent des actions pour corriger lerreur et suspendent donc le traitement
(SNDERRMSG).
- les messages dachvement dexcution : ils sont renvoys la fonction appelante (SNDCMPMSG).
- les messages de statut : donnent des informations sur lvolution dun traitement interactif trs long
(SNDSTSMSG).
- excuter message : permet dexcuter une requte (en gnral, une commande CL) de la fonction
appelante. Elle est dfinie comme le texte de 2nd niveau de la fonction de message (EXCMSG).
- rcuprer message : rcupre le contenu de zones dans la description du message. Elle peut tre utilise
pour transfrer une chane de caractres dun fichier BDD dans une zone ou concatner 2 chanes ou
plus de diffrentes zones et les placer dans une zone de texte. (RTVMSG).
Page 11 / 17
Auteur : rdas
Documentation SYNON
Orange Service
6. Les instructions
6.1 Calculs
-
6.2 Affectations
-
*MOVE : Affectation d'une zone dans une autre si les deux zones sont de mme type. Pour
l'alphanumrique, c'est un MOVE LEFT et pour le numrique un MOVE RIGHT.
*CVTVAR : affectation pour deux zones de type diffrent. Tester pour le cadrage !
*MOVE ALL : Place un contexte dans un autre (sauf pour le contexte WRK). Pour cela, SYNON fait
correspondre les noms des zones.
6.3 Programmes
-
*COMMIT, *ROLLBACK.
*QUIT : sortir d'une squence, ou dans le cas d'un fonction interne, sortir de la fonction interne.
*EXITPGM : sortir du programme, on peut prciser le code retour.
6.4 Autres
-
Page 12 / 17
Auteur : rdas
Documentation SYNON
Orange Service
En-tte dtat standard (HDR) : affiche le titre de ltat, le n de page, la date et lheure.
Haut de page (TOP) : affiche les zones qui seront imprimes sur chaque page au mme endroit que
lentte de page.
Format de 1re page (1PG) : affiche les informations spcifiques de la 1 re page. Souvent utilis pour
rappeler qui a demand ldition, le nombre dexemplaires ainsi que les paramtres et leurs valeurs en
entre.
En-tte cl 1 (1HD) : affiches les zones relatives au niveau de cl du chemin daccs.
En-tte cl 2 (2HD) : affiches les zones relatives au niveau de cl du chemin daccs.
Ligne de dtail (RCD) : affiche toutes les zones du chemin daccs sauf les cls qui apparaissent dans
les formats prcdents.
Total cl 1 (3TL) : affiche habituellement les totaux de ce niveau de cl.
Total cl 2 (4TL) : affiche habituellement les totaux de ce niveau de cl.
Totaux gnraux (ZTL) : affiche les totaux de tous les formats prcdents.
Fin dtat (FTR) : affiche le bas de page qui est imprim sur la dernire page.
Page 13 / 17
Auteur : rdas
Documentation SYNON
Orange Service
Page 14 / 17
Auteur : rdas
Documentation SYNON
Orange Service
9.2 Recherches
Pour retrouver le lien entre une fonction et un fichier, utiliser la touche de fonction F17=Services, puis les
options 8 Afficher tous les chemins d'accs et 9 Afficher toutes les fonctions .
Attention, lorsque lon demande le raffichage du sous-fichier, la demande de confirmation est automatiquement
ractive.
Page 15 / 17
Auteur : rdas
Documentation SYNON
Orange Service
donc crer un PRTFIL sur Ligne_de_commande et un PRTOBJ sur Commentaire, puis en se plaant devant le
PRTFIL on va utiliser l'option 'T=Structure' et venir insrer le PRTOBJ au niveau du dtail.
Dans la fonction RTVOBJ, au niveau du point utilisateur "Traitement si enregistrement introuvable" s'il n'y
a pas de code saisi, le programme passe quand mme dans le point utilisateur "Traitement de sortie",
contrairement ce que l'on peut croire en lisant le source SYNON.
Dans la fonction EDTFIL, au niveau du point utilisateur "Traiter touches de commande de fonctions", aprs
le test du F9 (*Mode rviser), l' *OTHERWISE est en fait un *FIN. Le point "Traiter touches de
commande" est donc toujours excut quand on rentre dans ce pav.
Page 16 / 17
Auteur : rdas
Documentation SYNON
Orange Service
Page 17 / 17
Auteur : rdas