Rational Developer for System z


Leçon 1.1 : personnalisation du PDS RAM en ajoutant une action personnalisée et des paramètres à ce modèle

Cette leçon vous guidera brièvement dans l'ajout d'une action personnalisée HowTo et de ses quatre paramètres : value, string1, string2, et option, au PDS RAM.
Ces paramètres et ces actions sont ajoutés au PDS RAM en fournissant les informations appropriées au fichier CRA0VDEF. Pour en savoir plus sur les étapes de cette leçon, voir CARMA Developer's Guide, Chapter 4. Customizing a RAM API using the CAF.
  1. Commencez par répertorier les actions que vous voulez étendre vers l'API du gestionnaire RAM. Pour cet exemple, vous allez ajouter une action personnalisée HowTo avec les attributs suivants :
    • Nom : HowTo
    • Description : fournit un exemple d'implémentation de projets de plug-in avec points d'extension.
    • ActionID : 100
    • ID RAM : 00
    • Liste de paramètres : value, string1, string2, option
    • Liste de valeurs de retour :
    Conseil : Si vous utilisez le modèle de PDS sans personnalisation, les valeurs suivantes pour l'ID d'action et l'ID RAM devraient être correctes. Cependant, si vous avez ajouté ou supprimé des gestionnaires RAM, des actions personnalisées ou des paramètres, assurez-vous que l'ID d'action est le prochain et que l'ID RAM correspond au modèle de PDS RAM. .
  2. Dans la description de l'action personnalisée HowTo ci-dessus, des paramètres et des valeurs de retour sont répertoriés. Tous doivent être également définis dans le gestionnaire RAM. Leurs descriptions sont les suivantes :
    • Nom : value
    • Description : valeur numérique à un chiffre
    • ID de paramètre : 000
    • ID Ram : 00
    • Type : chaîne
    • Longueur : 1
    • Constant : non
    • Valeur par défaut : aucune
    • Invite : Saisissez une valeur à un chiffre :
    • Nom : string1
    • Description : une chaîne de texte
    • ID de paramètre : 001
    • ID RAM : 00
    • Type : chaîne
    • Longueur : 10
    • Constant : non
    • Valeur par défaut : aucune
    • Invite : Saisissez une courte chaîne de texte :
    • Nom : string2
    • Description : une chaîne de texte
    • ID de paramètre : 002
    • ID RAM : 00
    • Type : chaîne
    • Longueur : 10
    • Constant : non
    • Valeur par défaut : aucune
    • Invite : Saisissez une courte chaîne de texte :
    • Nom :option
    • Description : option oui ou non
    • ID de paramètre : 003
    • ID RAM : 00
    • Type : chaîne
    • Longueur : 1
    • Constant : non
    • Valeur par défaut : aucune
    • Invite : Oui ou non ?
  3. Le fait de connaître leurs actions, paramètres et descriptions vous permettra de créer des déclarations à inclure dans les fichiers de configuration. Chaque action et paramètre sera défini(e) sur sa propre ligne et ses métadonnées particulières seront spécifiées dans une longueur d'octet prédéfinie.
    Conseil : Vous pouvez également prédéfinir les actions et paramètres sans utiliser les tailles d'octet prédéfinies pour les métadonnées en utilisant les onglets comme délimiteurs. Veillez à consulter CARMA Developer's Guide, Chapter 4. Customizing a RAM API using the CAF pour en savoir plus sur ce format alternatif.

    Pour cet exemple, en utilisant les tailles d'octet prédéfinies, l'action personnalisée HowTo est déclarée comme suit :

    A00100  000,001,002,003|

    Pour chaque paramètre respectif, la déclaration est :

    P00000  STRING          1               N
    P00001  STRING          10              N
    P00002  STRING          10              N
    P00003  STRING          1               N
    Remarque : Pour les actions et les paramètres, les huit premiers octets de l'enregistrement s'appellent la clé d'enregistrement.
  4. Vérifiez qu'aucune connexion n'est active entre le modèle de PDS RAM, CARMA et le système hôte avant de poursuivre.
  5. Vous devez ajouter ces informations à FEK.SFEKVSM2(CRA0DEF) et vérifier que toutes les clés d'enregistrement sont dans l'ordre alphanumérique. Utilisez le script situé de FEK.#CUST.JCL(CRA$VDEF) à REPRO FEK.SFEKVSM2(CRA0DEF).
  6. Ensuite, pour chaque action et paramètre que vous allez définir dans le fichier CRA0VDEF, vous devez définir une déterminer correspondante dans le fichier CRA0VSTR contenant toute information en rapport avec les langues sur l'action ou le paramètre.
    Pour cet exemple, l'action personnalisée serait définie dans le fichier CRA0VSTR comme suit :
    EN_US   00037A00100  HowTo           Pour démonstration. Ne fait rien.
    Pour chaque paramètre respectif dans le modèle, les définitions sont :
    EN_US   00037P00000  value                           Saisissez une valeur à un chiffre.
    EN_US   00037P00001  string1                         Saisissez une courte chaîne de texte.
    EN_US   00037P00002  string2 	                       Saisissez une courte chaîne de texte.
    EN_US   00037P00003  option                          Oui ou non ?
    Remarque : Pour les actions et les paramètres, les vingt et un premiers octets de l'enregistrement s'appellent la clé d'enregistrement.
  7. Vous devez ajouter ces informations à FEK.SFEKVSM2(CRA0VSTR) et vérifier que tous les enregistrements sont dans l'ordre alphanumérique. Utilisez le script situé de FEK.#CUST.JCL(CRA$VSTR) à REPRO FEK.SFEKVSM2(CRA0VSTR).

Références


Conditions d'utilisation | Commentaires en retour



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