Rational Programming Patterns

Saisie du code dans l'éditeur COBOL de Macro

L'éditeur de COBOL de la Macro permet de créer ou de maintenir le source COBOL de vos Macros. Il convient de respecter la syntaxe de la saisie indiquée dans cette page.

Les identifiants

Les instructions COBOL doivent être introduites par des identifiants afin de permettre leur placement en début de programme, en WORKING-STORAGE SECTION ou en PROCEDURE DIVISION. Les identifiants doivent être saisis dans la marge de gauche, de la colonne 1 à 6. Les numéros de lignes doivent être insérés sur la ligne à la suite de la ligne qui contient l'identifiant. Les lignes de la Macro seront insérées aux emplacements correspondant aux identifiants.

La ligne identifiante est une ligne sur laquelle on définit l'emplacement en zone de travail (en working) ou les informations relatives à la fonction/sous-fonction. Si votre Macro contient une ligne orpheline, c'est-à-dire une ligne qui n'est pas précédée d'une ligne identifiante, un message apparaît pour vous en avertir.

Important : Toute ligne identifiante ou attribut doit être saisie en majuscules. Le numéro de ligne est sur 3 caractères et peut être paramétré uniquement sur les 2 premiers caractères. Vous pouvez saisir des caractères alphanumériques en WORKING-STORAGE SECTION, et numériques en PROCEDURE DIVISION.
Tableau 1. Identifiants pour la zone de début de programme
Paragraphes générés Identifiant
  B$n$n
Commentaire API COBOL B__01
Commentaire PAF B__05
PROGRAM-ID B__10
AUTHOR B__20
DATE-COMPILED B__30
ENVIRONMENT DIVISION B__40
CONFIGURATION SECTION B00
SOURCE-COMPUTER B0000
OBJECT-COMPUTER B0010
SPECIAL-NAMES B0020
INPUT-OUTPUT SECTION B01
FILE-CONTROL B01
SELECT FF-FICHIER B01FF
I-O-CONTROL B0100
Est réservé à la ligne 'DATA DIVISION' B60
Est réservé à la ligne 'FILE SECTION' B99
Réécriture de la clause FD pour le fichier FF B9*FF
Tableau 2. Dans les zones de travail et de lien (faut-il mettre zone de lien ou Linkage Section ?
Identifiant Commentaire
WXX XX correspond à l'emplacement en working. Peut être paramétré.
Tableau 3. Description des traitements (fonctions, sous-fonctions)
Identifiant Commentaire
FXXYY XX est le code fonction, YY est le code sous-fonction. Peuvent être paramétrés
Les indices peuvent être définis de différentes façons. Pour qu'ils soient générés sous le niveau 01 des indices automatiques, vous devez saisir les identifiants suivants. Attention, le niveau indiqué pour ces indices doit être 05 :
Tableau 4. Indices générés sous niveau 01
Identifiant Commentaire
IXXYY Equivaut à la dimension de table à renseigner dans la zone working.

XX = 2 caractères, YY= 2 caractères

Equivaut à une dimension de table. Les indices L, R, et M peuvent y être saisis : IXXYYM initialisé à la valeur maximale et IXYYL et IXXYYR initialisés à zéro.

JXXYY XX= code fonction, YY= code sous-fonction

Equivaut à un indice utilisé dans une boucle DO.

Pour qu'ils soient générés sous un niveau 01 de votre choix, vous devez les saisir sous un identifiant Wxx (se reporter au tableau 2.

Remarque : Tous les indices sont générés sous le même niveau indices. Vous pouvez également définir des indices sous l'identifiant Wxx. Voir exemples figure 1 et figure 3
Remarque : Il existe des contrôles sur les identifiants, le contrôle des paramètres pour le placement des fonctions/sous-fonctions (excepté le paramètre REF=). Si une erreur est détectée, une croix rouge s'affiche dans la colonne de gauche de l'éditeur et l'entité est marquée en erreur dans l'espace de travail. En conséquence, la génération des programmes appelant la Macro n'est plus possible.

Règles de saisie

Exemples

Figure 1. Indices sous le niveau 01 des indices automatiques dans la Macro:
Identifiants pour la génération des indices sous le niveau 01 des indices automatiques
Figure 2. Indices sous le niveau 01 dans la partie générée du programme:
Indices sous le niveau 01 dans la partie générée du programme.
Figure 3. Indices sous un niveau 01 dans la zone de travail dans la Macro:
Indices sous un niveau 01 dans la zone de travail dans la Macro
Figure 4. Indices sous un niveau 01 de la zone de travail dans la partie générée du programme
Indices sous un niveau 01 dans la zone de travail dans la partie générée du programme
Figure 5. Exemple de saisie
Exemple de saisie
Figure 6. Supprimer une section ou un paragraphe en début de programme

Cas spécifique du début de programme : l'attribut 'ACTION=R' permet de supprimer une section ou un paragraphe.

Supprimer une section ou un paragraphe en début de programme

Conditions d'utilisation | Commentaires en retour

Ce centre de documentation utilise la technologie Eclipse. (http://www.eclipse.org)