Vous pouvez configurer l'éditeur LPEX z Systems ® pour qu'il fonctionne avec des sous-projets UNIX z/OS® . Vous pouvez créer un fichier d'aide de macros utilisateur qui mappe les noms de macros sélectionnés à des pages d'aide spécifiques. Ce mappage indique la page d'aide en ligne qui s'ouvre lorsque vous sélectionnez un nom de macro et que vous appuyez sur F1.
A propos de cette tâche
Vous pouvez utiliser l'analyseur HLASM pour accéder à l'aide personnalisée que vous créez pour l'utiliser avec le produit. L'analyseur syntaxique HLASM est une extension de l'analyseur syntaxique LPEX HLASM.Le fichier d'aide de macros utilisateur est un fichier texte qui peut utiliser n'importe quel nom de fichier et n'importe quelle extension. Par exemple, zoshlas2.hlp. Si vous avez créé une aide personnalisée pour vos propres macros personnalisées, vous pouvez utiliser le fichier toc.xml que vous avez créé pour votre aide personnalisée afin d'associer automatiquement des noms de macro aux pages d'aide correspondantes.
Procédure
Pour créer un fichier d'aide de macros utilisateur, procédez comme suit:
- A l'aide d'un éditeur de texte tel que LPEX, créez un fichier pour stocker le mappage entre les noms de macro et les fichiers d'aide en ligne.
- Pour chaque macro à mapper à une page d'aide en ligne, entrez le mappage entre le nom de la macro utilisateur et la page d'aide à ouvrir lorsque vous sélectionnez ce nom de macro et appuyez sur F1.
Utilisez le format suivant :
macro_name=help_path
- nom_macro
- Code opération de la macro que vous souhaitez mapper à une page d'aide en ligne, telle que CLST. Vous devez spécifier le nom de la macro en majuscules. Si l'analyseur HLASM est configuré pour autoriser la spécification de noms de macro en minuscules, ces noms sont convertis en majuscules avant que l'analyseur ne recherche une correspondance.
- chemin_aide
- Page d'aide à ouvrir pour la macro sélectionnée. Vous devez spécifier le chemin d'aide au format suivant:
/plugin_name/path/file_name
Vous devez spécifier la barre oblique (/) avant le nom du plug-in, par exemple:/com.ibm.uss.projects.doc/topics/comparelogicalstring.html
Si la page d'aide que vous souhaitez mapper est une page externe, utilisez le format suivant:http://<url>
Par exemple :http://www.companyxyz.com/software/macros.htm
La ligne résultante s'affiche comme illustré dans l'exemple suivant:CLST=/com.ibm.uss.projects.doc/topics/comparelogicalstring.html
- Enregistrez le fichier, puis fermez-le.
- Effectuez l'une des opérations suivantes :
- Pour configurer le fichier d'aide de la macro utilisateur pour les membres MVS, ajoutez le nom de votre fichier d'aide de la macro utilisateur à la liste de la section Fichiers d'aide de la macro utilisateur F1 de la page de préférences de l'analyseur HLASM. Pour plus d'informations sur la page de préférences, voir les rubriques connexes.
- Pour configurer le fichier d'aide de macros utilisateur pour z/OS UNIX System Services, ajoutez le nom de votre fichier d'aide de macros utilisateur à la liste de la section User Macro F1 Help Files de l'onglet HLASM de la page de préférences Options de l'éditeur . Pour plus d'informations sur la définition des options HLASM, voir les rubriques connexes.
Etape suivante
Si vous modifiez ce fichier, vous devez le recharger pour que l'analyseur syntaxique puisse relire le fichier et charger les nouvelles définitions. Pour recharger le fichier d'aide de macros utilisateur, cliquez avec le bouton droit de la souris sur le fichier et sélectionnez Recharger les macros utilisateur F1 Fichiers d'aide.