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 -D 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 et les Ecrans 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 en -W 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 et les Ecrans le nombre
de Macros écrasées en -P 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 et les Ecrans le nombre
de Macros écrasées en -W 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 (ex: F12,F15 ou F12 F15 ou F12, F15).