L'entité Micro-pattern Statique
Cette entité permet d'insérer des lignes de code en appelant le micro-pattern dédié au Kit de Développement de Logiciels dans le code d'un Programme ou Copybook COBOL, ou d'un Code Source. Ce micro-pattern particulier est le Micro-pattern Statique RPPMPF. Quand l'instance appelante est générée à nouveau, l'appel du Micro-pattern Statique est remplacé par les lignes de code correspondantes.
Dans le Micro-pattern Statique, vous déclarez des blocs de code. Chaque bloc est constitué d'un identifiant auquel vous associez une ou plusieurs lignes de code. Ces lignes de code peuvent contenir des paramètres.
Quand vous appelez le Micro-pattern Statique RPPMPF dans le code d'une instance, vous devez spécifier le bloc. Si les lignes de code contiennent des paramètres, vous devez préciser leur valeur pour cet appel. Vous pouvez appeler le Micro-pattern Statique en l'insérant à partir de la vue Fragments, catégorie Fragments du SDK RPP Micro-pattern.
- La première ligne contient les éléments suivants :
- *!, qui représente le début de l'appel du Micro-pattern Statique. Le * doit être présent en colonne 7, réservée aux commentaires dans le code COBOL, et le ! doit être présent en colonne 8.
- Le Micro-pattern Statique RPPMPF.
- Les informations permettant de préciser le bloc à insérer. La
valeur de chaque information pour cet appel est indiquée entre guillemets,
après un signe égal. Les éléments suivants sont indiqués :
- Le projet et éventuellement le package dans lesquels le Micro-pattern Statique est stocké. Si le package n'existe pas, "" est indiqué.
- Le nom du Micro-pattern Statique, choisi lors de sa création.
- L'identifiant du bloc inséré, défini dans l'onglet Blocs de Micro-pattern du Micro-pattern Statique.
*!RPPMPF Project="myproj" Package="mypkg" Name="mpname" Id="blockid"
où myproj est le nom du projet, mypkg est le nom du package, mpname est le nom du Micro-pattern Statique et blockid est l'identifiant du bloc.
- Si la ligne de code contient des paramètres, la valeur de ces
paramètres est indiquée sur des lignes suite de la façon suivante
:
*- Param1="param1_value" Param2="param2_value"
- Si des lignes de code de l'identifiant sont associées à une balise, elles sont insérées à la fin de cette balise. Les balises sont contenues dans l'onglet Source du Squelette. Si l'option Unique a été sélectionnée pour une balise dans l'onglet Blocs de Micro-pattern du Micro-pattern Statique, le code associé à cette balise ne sera inséré qu'une fois, quel que soit le nombre d'appels du Micro-pattern Statique dans le code.
- Si des lignes de code de l'identifiant ne sont pas associées à
une balise, elles sont insérées à l'endroit de l'appel du Micro-pattern
Statique RPPMPF. Après la regénération, les lignes
insérées sont présentes dans la vue Structure du code généré sous
la forme :
RPPMPF_myproj_mypkg_mpname_blockid_nn
où myproj est le nom du projet, mypkg est le nom du package, mpname est le nom du Micro-pattern Statique, blockid est l'identifiant du bloc et nn est le numéro d'itération de l'insertion, si le même appel est inséré plusieurs fois dans le même code.