Rational Programming Patterns met à votre disposition des
modèles de règles pour créer des règles qui contiennent des paramètres.
Les règles paramétrables ne sont pas proposées en standard
pour l'analyse des entités de design et pour la révision des
sources COBOL. Vous devez au préalable ajouter une règle et définir
les valeurs de ses paramètres pour qu'elle soit disponible dans
Software Analyzer.
Mise en oeuvre
Pour utiliser une règle paramétrable,
vous devez d'abord la définir en utilisant un des modèles proposés
dans les Préférences du Software Analyzer.
- Sélectionnez .
- Cliquez sur le bouton Ajouter une règle.
- Dans l'assistant de création qui s'ouvre, sélectionnez
la catégorie dans laquelle la règle sera ajoutée et cliquez sur Suivant.
- Sélectionnez le modèle à utiliser pour la règle et cliquez sur Suivant.
- Affectez des valeurs aux paramètres du modèle et cliquez sur Terminer.
- La règle que vous venez de définir apparaît dans la liste des Règles
personnalisées en cours de la fenêtre des Préférences.
Cliquez sur OK pour valider cette création.
La nouvelle règle s'ajoute automatiquement aux autres
règles disponibles dans l'outil Software Analyzer.
Pour
ensuite lancer une analyse du code COBOL en prenant en compte cette
nouvelle règle de contrôle qualité,
vous devez au préalable définir une configuration d'analyse au niveau
du Software Analyzer.
Pour une information complète sur le Software
Analyzer, consultez l'aide en ligne de Rational Developer for System
z, dans la rubrique Révision du code COBOL de la section Développement.
Modèles de règles d’analyse des entités de design
Les
modèles de règles spécifiques à Rational Programming Patterns pour
l’analyse des entités de design sont les suivants :
- Au moins une Macro doit être appelée par une entité Ecran
- Paramètres : la liste des Macros et la gravité
- Cette règle vérifie qu’au moins une des Macros de la liste donnée
en paramètre est bien appelée dans un Ecran.
- Les Macros de type batch ne doivent pas être appelées dans les
Ecrans
- Paramètres : la liste des Macros et la gravité
- Cette règle vérifie que les Macros batch données en paramètre
ne sont pas appelées dans un Ecran.
- Les Macros obsolètes ne doivent pas être appelées
- Paramètres : la liste des Macros et la gravité
- Cette règle vérifie qu'aucune des Macros obsolètes données en
paramètre n’est appelée dans un Programme ou un Ecran.
- Nombre d’appels de Structure de Données
- Paramètres : le seuil de normalité, la déviance et la gravité
- Cette règle vérifie que le nombre de lignes -CD dans un Programme
ne dépasse pas le seuil de déviance.
- Nombre d’appels de Macro
- Paramètres : le seuil de normalité, la déviance et la gravité
- Cette règle vérifie dans les Programmes ou les Ecrans que le nombre
total de Macros appelées ne dépasse pas le seuil de déviance.
- Nombre d’appels de Segment
- Paramètres : le seuil de normalité, la déviance et la gravité
- Cette règle vérifie dans les Ecrans que le nombre total de lignes
-CS ne dépasse pas le seuil de déviance.
- Nombre d’appels de Segment en définition
- Paramètres : le seuil de normalité, la déviance et la gravité
- Cette règle vérifie dans les Ecrans que le nombre total de lignes
-CS de numéro de ligne 00 ne dépasse pas le seuil de déviance.
- Nombre de lignes de commentaire
- Paramètres : le seuil de normalité, la déviance et la gravité
- Cette règle vérifie dans les Programmes, Ecrans ou Etats que le
nombre de lignes de documentation technique (lignes -GC) dépasse le
seuil de déviance.
- Nombre de lignes de conditionnement
- Paramètres : le seuil de normalité, la déviance et la gravité
- Cette règle vérifie que le nombre de lignes de conditionnement
dans les lignes de composition de type E dans un
Etat ne dépasse pas le seuil de déviance.
- Nombre de Structures de Données avec une organisation différente
- Paramètres : le seuil de normalité, la déviance et la gravité
- Cette règle vérifie dans les Programmes que le nombre de lignes
-CD avec ayant une organisation différente de W et L ne
dépasse pas le seuil de déviance.
- Pour chaque Macro, au moins une Macro de la liste doit être appelée
- Paramètres : la liste des Macros appelées, la liste des Macros
obligatoires et la gravité
- Cette règle vérifie que si une des Macros de la liste en premier
paramètre est appelée dans un Programme ou un Ecran, une des Macros
de la liste des Macros obligatoires doit également être appelée.
Modèles de règles de révision du code spécifique COBOL
Les
modèles de règles spécifiques à Rational Programming Patterns pour
la révision du code spécifique COBOL sont les suivantes :
- RPP / Comptage des lignes spécifiques
- Paramètres : le nombre maximal de lignes spécifiques et la gravité.
- Cette règle comptabilise le nombre de lignes de code spécifique
- RPP / Eviter d'appeler la routine spécifiée
- Paramètres : le nom de routine à éviter et la gravité
- RPP / Eviter d'imbriquer les instructions IF au-delà
d'un nombre spécifié de niveaux
- Paramètres : le nombre maximal de niveaux de IF imbriqués
et la gravité
- RPP / Eviter d'inclure le copybook spécifié
- Paramètres : le nom du copybook à éviter et la gravité
- RPP / Eviter d'utiliser les directives de compilation spécifiées
- Paramètres : différentes directives (BASIS, CBL, COPY, EJECT, REPLACE, SERVICE
LABEL, SERVICE RELOAD, SKIP, TITLE)
et la gravité
- RPP / Fonctions et sous-fonctions spécifiques interdites dans
l’intervalle des fonctions spécifiées
- Paramètres : l’intervalle des fonctions (code fonction de début
et code fonction de fin séparés par un espace) et la gravité
- Cette règle vérifie que dans les Programmes, Ecrans et Serveurs,
il n’existe pas de fonctions et sous-fonctions spécifiques dans l’intervalle
des fonctions donné en paramètre. La règle ne s’applique pas aux Macros.
- RPP / EXEC SQL : Eviter SELECT * dans la zone
de WORKING
- Paramètres : le seuil de normalité, la déviance et la gravité
- Cette règle vérifie qu'il n'existe pas d'ordre SELECT
* sauf SELECT * COUNT dans les zones de
travail dans un Programme ou un Ecran. La règle ne s’applique pas
aux Macros.
- RPP / GDI : Eviter l’opérateur GDI hors Macro
- Paramètres : le seuil de normalité, la déviance et la gravité
- Cette règle vérifie que dans les Programmes ou les Ecrans, le
nombre d'utilisation des opérateurs GDI ne dépasse pas le seuil de
déviance. La règle ne s’applique pas aux Macros.
- RPP / L’ordre EXEC CICS LINK est autorisé uniquement
pour les fonctions spécifiées
- Paramètres : la liste des fonctions et la gravité
- Cette règle vérifie que dans les Ecrans il n'existe pas d’ordres LINK utilisés
en dehors des fonctions données en paramètre. La règle ne s’applique
pas aux Macros.
- RPP / La clause END est requise pour certaines
instructions COBOL
- Paramètres : différentes instructions (IF, EVALUATE, READ, SEARCH, STRING, CALL)
et la gravité
- RPP / La PROCEDURE DIVISION ne doit pas dépasser
un nombre de lignes donné
- Paramètres : le nombre maximal de lignes en PROCEDURE
DIVISION et la gravité
- RPP / Nombre de Macros écrasées en PROCEDURE DIVISION
- Paramètres : le seuil de normalité, la déviance et la gravité
- Cette règle vérifie que dans les Programmes, Ecrans et Serveurs,
le nombre de Macros écrasées en PROCEDURE DIVISION ne
dépasse pas le seuil de déviance.
- RPP / Nombre de Macros écrasées en LINKAGE
- Paramètres : le seuil de normalité, la déviance et la gravité
- Cette règle vérifie que dans les Programmes, Ecrans et Serveurs,
le nombre de Macros écrasées en LINKAGE SECTION ne
dépasse pas le seuil de déviance.
- RPP / Nombre de Macros écrasées en WORKING
- Paramètres : le seuil de normalité, la déviance et la gravité
- Cette règle vérifie que dans les Programmes, Ecrans et Serveurs,
le nombre de Macros écrasées en WORKING-STORAGE SECTION ne
dépasse pas le seuil de déviance.
- RPP / Se conformer aux conventions de nommage pour les fichiers
COBOL
- Paramètres : le masque pour les fichiers COBOL et la gravité
- RPP / SYNCPOINT est autorisé uniquement pour
les Macros spécifiées
- Paramètres : la liste des Macros et la gravité
- Cette règle vérifie que dans les Ecrans, l'ordre SYNCPOINT n’est
utilisé que dans les Macros données en paramètre.
- RPP / Un PERFORM en ligne ne peut pas dépasser
un nombre donné de lignes
- Paramètres : le nombre maximal de lignes dans un PERFORM en
ligne et la gravité
- RPP / Utiliser des commentaires pour décrire chaque paragraphe
- Paramètres : l'emplacement des commentaires et la gravité
- RPP / Utiliser des commentaires pour décrire chaque section
- Paramètres : l'emplacement des commentaires et la gravité
- RPP / Utiliser le préfixe spécifié pour les noms de condition
- Paramètres le préfixe des noms de condition et la gravité
Remarque : - En paramètres de certaines règles, le Seuil de normalité et
la Déviance représentent les bornes de valeurs
en dehors desquelles la règle n’est pas respectée. Si le seuil de
normalité est fixé à 0, seul la déviance est prise en compte.
- Pour indiquer en paramètres de règle une liste d’instances, vous
pouvez saisir les valeurs de la liste séparées par une virgule ou
un espace ou une virgule+espace (par exemple : F12,F15 ou F12 F15
ou F12, F15).