|
|
| Gestion de la liste d'objets |
La plupart des commandes présentes dans l'outil ont pour rôle de gérer la liste des objets d'une liste.
La liste des commandes est fournie ci-dessous.
Chaque commande est ensuite reprise et expliquée.
La touche d'invite (F4) est évidemment utilisable sur chaque commande.
|
| Commande |
Commentaire |
| CRTOBJPF |
Crée un fichier liste d'objets, et y ajoute tous les objets d'une bibliothéque, ou ajoute les objets d'une bibliothéque à un membre de fichier liste existant. |
| ADDOBJPF |
Ajoute la description d'un objet à une liste existante. |
| DLTOBJPF |
Supprime un objet défini par sa bibliothéque, son nom et son type, d'une liste d'objets. |
| PRTOBJPF |
Imprime le contenu d'une liste. |
|
|
La commande CRTOBJPF |
Cette commande permet de créer un nouveau fichier liste d'objet, ou un nouveau membre dans un fichier existant, et facultativement d'ajouter au membre de fichier liste, tous les objets d'un bibliothèque.
Elle permet également d'ajouter à un fichier liste d'objets existant tous les objets contenus dans une bibliothèque spécifiée.
Les paramètres de la commande sont décrits ci-dessous :
|
| Paramètre |
Type |
Texte |
Commentaire |
| OBJPF |
*CHAR 10 |
Nom du fichier |
Nom du fichier liste d'objets à créer ou à alimenter |
| LIB |
*CHAR 10 |
Nom bibliothéque |
Nom de la bibliothéque contenant le fichier liste, ou dans laquelle créer ce fichier |
| MBR |
*CHAR 10 |
Nom du membre |
Nom de membre à créer ou existant. Ce paramètre est facultatif. Par défaut, à la création d'un fichier, le nom de membre est égal au nom de fichier. A l'utilisation d'un fichier liste existant, le premier membre défini est utilisé. |
| LIBS |
*CHAR 10 |
Bibliothèque source |
Paramètre facultatif à mentionner pour ajouter au fichier liste d'objets créé par la commande ou préexistant la liste des objets contenus dans cette bibliothèque. |
|
|
La commande ADDOBJPF |
Cette commande permet d'ajouter un objet à une liste d'objet. Elle permet d'ajouter des objets un par un à une liste.
A la première utilisation de cette commande dans le travail actif, les paramètres concernant le fichier liste de l'ajout sont mémorisés, et peuvent être réutilisés dans des exécutions successives.
L'utilisation de la commande peut être facilitée en définissant une option utilisateur PDM, comme celle décrite plus loin.
Les paramètres de la commande sont décrits ci-dessous :
|
| Paramètre |
Type |
Texte |
Commentaire |
| BIBLIO |
*NAME |
Nom de bibliothèque |
Paramètre obligatoire, définissant la bibliothèque de l'objet. Si on utilise *LIBL ou *CURLIB, la commande recherche l'objet défini par les deux paramètres suivants et place dans le fichier liste la bibliothèque dans lequel l'objet réside |
| OBJET |
*NAME |
Nom objet |
Nom de l'objet à ajouter à la liste |
| TYPE |
*CHAR 8 |
Type de l'objet |
Paramètre obligatoire et devant correspondre à un type connu dans le système AS/400(par exemple *FILE ou *PGM. |
| DESC |
*CHAR 50 |
Description |
Paramètre facultatif non utilisé par les commandes, destiné à identifier les objets, par exemple dans l'impression des listes d'objets |
| LIBPTF |
*NAME |
Bibliothéque de la liste |
Paramètre obligatoire définissant la bibliothèque contenant le fichier liste d'objets.
3 valeurs spéciales sont possibles : *LIBL et *CURLIB pour laisser le système rechercher la bibliothèque contenant la liste, et *SAME pour utiliser le fichier liste cible d'une commande précédente. |
| OBJPF |
*NAME |
Nom fichier liste |
Paramètre obligatoire sauf si utilisation de *SAME pour le paramètre précédent, et indiquant le nom du fichier liste d'objet à alimenter. |
| MBRPF |
*NAME |
Membre fichier liste |
Paramètre facultatif permettant d'indiquer le membre dans lequel ajouter la description de l'objet dans le cas où le fichier liste est multi-membres.
La valeur spéciale *FIRST peut être indiquée. C'est également la valeur par défaut. |
| ATTRB |
*CHAR 10 |
Attribut |
Paramètre facultatif permettant de préciser l'attribut d'un objet (par exemple PF-DTA pour un fichier, RPG pour un programme).
L'attribut n'est pas contrôlé. Il peut être utilisé comme filtre lors de l'utilisation de la commande RUNMNYCMD pour ne sélectionner que les objets correspondants au type et à l'attribut demandés. |
| FRMLIB |
*NAME |
Bibliothèque origine |
Paramètre facultatif et non utilisé par les commandes standards décrites dans cet outil. |
|
|
La commande DLTOBJPF |
Cette commande permet de supprimer un objet, défini par sa bibliothèque, son nom et son type, de la liste d'objets spécifiée.
Elle ne supprime que l'enregistrement correspondant à l'objet dans la liste, l'objet lui-même n'étant pas touché par la commande.
Les paramètres de la commande sont décrits ci-dessous :
|
| Paramètre |
Type |
Texte |
Commentaire |
| LIBPTF |
*NAME |
Bibliothèque de la liste |
Paramètre obligatoire égal au nom de la bibliothèque contenant la liste d'objets.
Les valeurs spéciales *LIBL, *CURLIB et *SAME peuvent être utilisées. *SAME indique qu'on utilise le fichier liste d'objets courant (cible des commandes précédentes). |
| OBJPF |
*NAME |
Nom fichier liste |
Paramètre obligatoire si on a pas indiqué *SAME au paramètre précédent, et fixant le nom du fichier liste d'objets dans lequel on veut supprimer un enregistrement. |
| MBRPF |
*CHAR 10 |
Nom du membre |
Dans le cas d'un fichier liste d'objets multi-membres, permet de sélectionner celui à utiliser dans la commande. *FIRST est la valeur par défaut pour ce paramètre. |
| LIBOB |
*NAME |
Bibliothèque de l'objet |
Paramètre obligatoire correspondant à la bibliothèque de l'objet à supprimer de la liste. |
| OBJET |
*NAME |
Nom de l'objet |
Paramètre obligatoire égal au nom de l'objet à supprimer de la liste. |
| TYPE |
*CHAR 10 |
Type de l'objet |
Paramètre obligatoire correspondant au type de l'objet à supprimer de la liste. |
|
|
La commande PRTOBJPF |
Cette commande permet d'imprimer la liste des objets définis dans une liste d'objets.
Son but est purement documentaire
La liste est imprimée dans l'ordre du chemin d'accés c'est à dire triée par bibliothéque, nom et type d'objet.
On peut filtrer le contenu de la liste imprimée
Les paramètres de la commande sont décrits ci-dessous :
|
| Paramètre |
Type |
Texte |
Commentaire |
| LIB |
*CHAR 10 |
Nom bibliothéque |
Nom de la bibliothéque contenant le fichier liste à imprimer |
| FILE |
*CHAR 10 |
Nom du fichier |
Nom du fichier liste d'objets à imprimer |
| MBR |
*CHAR 10 |
Nom du membre |
Nom du membre à préciser si le fichier est multi-membres et que l'on veut imprimer le contenu d'un membre qui n'est pas le premier.
la valeur spéciale *FIRST peut être indiquée pour sélectionner le premier membre, et c'est la vaelur par défaut du paramètre. |
| TYPE |
*CHAR 8 |
Type d'objets |
Paramètre facultatif à mentionner pour n'imprimer que la liste des objets du type indiqué. |
| ATTRB |
*CHAR 10 |
Attribut objets |
Paramètre facultatif à indiquer en complément du paramètre TYPE si on souhaite limiter la liste aux objets possédant l'attribut spécifié. |
COM1
COM2
COM3 |
*CHAR 50 |
Commentaires |
Ces paramètres permettent d'imprimer une à trois zones de commentaire en haut de page sur la liste, à des fins de documentation. |
|
|
Option utilisateur de PDM pour la commande ADDOBJPF |
L'ajout d'objets un à un à une liste est une opération fastidieuse, même en utilisant le paramètre *SAME pour indiquer le nom du fichier liste.
Si on travaille à partir de la liste des objets de PDM, la définition d'une option utilisateur simplifie considérablement les choses.
Il suffit en effet de taper l'abrégé choisi pour la commande au regard du ou des objets à placer dans la liste pour réaliser l'ajout, avec extraction de tous les paramètres nécessaires.
Une option utilisateur nommée AO (Ajout Objet) peut être définie comme ci-dessous :
|
| ? ADDOBJPF |
LIBPTF(*SAME) |
| |
?*MBRPF(*FIRST) |
| |
?*BIBLIO(&L) |
| |
?*OBJET(&N) |
| |
?*TYPE(&T) |
| |
?*DESC(&X) |
| |
?*ATTRB('&A') |
| |
?*FRMLIB(&L) |
|
On peut faire de même pour la commande DLTOBJPF, de façon à pouvoir supprimer facilement des objets d'une liste.
|
|
|
|
| © Thierry Seunevel (2004) |
www.seusoft.com |
|
|
