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.
- 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. .
- 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 ?
- 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.
- 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.
- 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).
- 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.
- 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).