Aller au contenu

FNDSTRPDM2

Rechercher chaîne avec liste

En bref

La commande FNDSTRPDM2 (Rechercher chaîne avec liste) vous permet de rechercher des chaînes de type caractère ou hexadécimal dans des membres de fichiers physiques source ou dans des membres de fichiers physiques de données.

Syntaxe minimale

FNDSTRPDM2 STRING(…)

Paramètres

Astuce : dans une session 5250, tapez FNDSTRPDM2 puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QPDA)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande FNDSTRPDM2 (Rechercher chaîne avec liste) vous permet de rechercher des chaînes de type caractère ou hexadécimal dans des membres de fichiers physiques source ou dans des membres de fichiers physiques de données.

Paramètres

Mot-clé Description Valeurs possibles Remarques
STRING Rechercher 'chaîne' Valeur caractère Obligatoire, positionnel 1
FILE Fichier Nom d'objet qualifié Facultatif, positionnel 2
Qualificatif 1: Fichier Nom, QAUOSR2
Qualificatif 2: Bibliothèque Nom, QPDA
MBR Membre Nom, QAUOMB2 Facultatif, positionnel 3
OPTION Opération à exécuter Liste d'éléments Facultatif, positionnel 4
Élément 1: Option Valeur caractère, *EDIT, *COPY, *DLT, *DSP, *PRT, *RNM, *DSPD, *SAVE, *CHGT, *CMPR, *CMPL, *MOD, *MRG, *RUNP, *SDA, *DFU, *RLU, *NONE
Élément 2: Invite *NOPROMPT, *PROMPT
COL Colonnes à explorer Liste d'éléments Facultatif
Élément 1: De la colonne Valeur caractère, 1, *RCDLEN
Élément 2: A la colonne Valeur caractère, *RCDLEN
CASE Distinction majusc/minusc *IGNORE, *MATCH Facultatif
PRTMBRLIST Imprimer liste *NO, *YES Facultatif
PRTRCDS Imprimer enregistrements Valeurs uniques: *NONE
Autres valeurs: Liste d'éléments
Facultatif
Élément 1: Nombre à trouver Valeur caractère, '*ALL ', *ALL
Élément 2: Format d'impression *CHAR, *HEX, *ALTHEX
Élément 3: Marquer enregistrement *MARK, *NOMARK
Élément 4: Dépassement d'enregistrement *FOLD, *TRUNCATE
PARM Paramètres Valeur caractère Facultatif

Rechercher 'chaîne' (STRING)

Indique la chaîne à rechercher.

Ce paramètre est obligatoire.

valeur-alphanumérique
Indiquez, entre apostrophes, la chaîne à rechercher. Elle peut être de type caractère ou hexadécimal.

Fichier (FILE)

Indique le fichier source physique qui contient le membre comportant la liste de recherche.

Qualificatif 1 : Fichier

QAUOSR2
Le membre contenant la liste de recherche se trouve dans le fichier physique QAUOSR2.
nom
Indique le nom du fichier source physique qui contient le membre comportant la liste de recherche.

Qualificatif 2 : Bibliothèque

QPDA
Le fichier contenant le membre de la liste de recherche se trouve dans la bibliothèque QPDA.
nom
Indiquez le nom de la bibliothèque dans laquelle le fichier spécifié doit être recherché.

Membre (MBR)

Indique le membre de fichier qui contient la liste de recherche.

QAUOMB2
Le membre QAUOMB2 contient la liste de recherche.
nom
Indiquez le nom du membre qui contient la liste de recherche.

Indique les arguments de recherche dans la liste de recherche.

#lib
Nom de bibliothèque aux positions 1 à 10 sous l'en-tête #lib.
#file
Nom de fichier aux positions 12 à 21 sous l'en-tête #file.
#member
Nom de membre aux positions 23 à 32 sous l'en-tête #member. Les noms génériques *all pour tous les membres ou ABC* avec des noms commençant par ABC peuvent être utilisés.

Opération à exécuter (OPTION)

Indique l'option PDM à exécuter sur chaque membre pour lequel une occurrence de la chaîne recherchée a été trouvée. Ce paramètre se compose de deux éléments, l'un servant à sélectionner une option et le second à demander un écran d'invite. L'option à exécuter peut être toute option PDM correcte pour le type de fichier ou toute option utilisateur définie dans votre fichier d'options en cours. Les options admises ne sont pas les mêmes pour les fichiers physiques source et pour les fichiers physiques de données.

Ce paramètre est obligatoire.

Elément 1 : Option

*NONE
Aucune option n'est exécutée sur le membre contenant la chaîne recherchée. Choisissez cette valeur pour imprimer la liste des membres ou des enregistrements contenant la chaîne recherchée.

Options de la liste de membres de fichiers physiques source

*EDIT
Vous permet d'éditer un ou plusieurs membres à l'aide de SEU.
*CHGT
Vous permet de modifier certains attributs d'un ou de plusieurs des membres.
*CMPL
Vous permet de compiler un ou plusieurs membres. Le système crée un objet en fonction du membre compilé. La compilation s'effectue en mode interactif ou par lots, selon les informations indiquées à l'écran MODIFICATION DES VALEURS PAR DEFAUT ou dans la commande CHGPDMDFT.

Les types de membres suivants peuvent être compilés : BAS, BAS36, BAS38, C, CBL, CBLLE, CBL36, CBL38, CICSC, CICSCBL, CICSCBLLE, CICSSQLCBL,CLD, CLLE, CLP, CLP38, CMD, CMD38, CPP, DSPF, DSPF36, DSPF38, FTN, ICFF, LF, LF38, MENU, PAS, PF, PF38, PLI, PLI38, PNLGRP, PRTF, PRINT38, QRY38, RMC, RPG, RPGLE, RPG36, RPG38, RPT, RPT36, RPT38, SPADCT, SQLC, SQLCPP, SQLCBL, SQLCBLLE, SQLFTN, SQLPLI, SQLRPG, SQLRPGLE et TBL.

Lorsque PDM compile un programme à l'aide des commandes de création appropriées, le nom de l'objet à créer est toujours celui indiqué comme nom du membre source. Vous pouvez remplacer le paramètre de nom d'objet par un autre en demandant l'affichage de l'invite correspondante ou en indiquant le paramètre correct sur la ligne de commande. PDM vérifie si ce nom existe déjà. Si c'est le cas, il affiche l'écran CONFIRMATION DE COMPILATION D'UN MEMBRE, qui vous donne la possibilité de supprimer l'objet existant.

Remarque :Cet écran ne s'affiche pas si O (ou *YES) est indiqué en regard de l'invite Remplacement objet de l'écran MODIFICATION DES VALEURS PAR DEFAUT (ou dans la commande CHGPDMDFT).

Si vous avez attribué une valeur spéciale au paramètre de nom d'objet, PDM ne vérifie pas si l'objet existe déjà. Par exemple, si vous compilez un programme RPG et indiquez *CTLSPEC en regard de l'invite Programme, PDM n'effectue pas cette vérification.

*CMPR
Vous permet de comparer un ou plusieurs membres.
*COPY
Vous permet de copier un ou plusieurs membres dans un ou plusieurs nouveaux membres. Ces derniers peuvent appartenir à un autre fichier et/ou une autre bibliothèque.
*DLT
Vous permet de supprimer un ou plusieurs membres du fichier.
*DSP
Vous permet d'afficher un ou plusieurs membres à l'aide de SEU.
*DSPD
Vous permet d'afficher des informations sur un ou plusieurs membres.
*MOD
Vous permet de créer un objet de module pour un type de source ILE.
*MRG
Vous permet de fusionner le membre cible avec un autre membre.
*PRT
Vous permet d'imprimer un ou plusieurs membres à l'aide de SEU.
*RNM
Vous permet de rebaptiser un ou plusieurs membres.
*RUNP
Vous permet d'exécuter un membre source de type REXX, OCL36, BASP ou BASP38. Si vous utilisez un membre dont le type ne permet pas le traitement, un message d'erreur apparaît. Pour qu'une procédure OCL36 puisse être lancée, le nom de fichier doit être QS36PRC. Le traitement s'effectue en mode interactif ou par lots, selon les informations indiquées en regard de l'invite Exécution par lots de l'écran MODIFICATION DES VALEURS PAR DEFAUT (ou dans la commande CHGPDMDFT).
*SAVE
Vous permet de sauvegarder un membre sur une disquette ou une bande.
*SDA
Vous permet d'utiliser SDA pour gérer les membres sélectionnés.
  • Si le type de membre est DSPF ou DSPF38, SDA assure la gestion d'un écran.
  • Si le type de membre est MNU, MNUDDS ou MNUCMD, SDA assure la gestion d'un menu.
  • Si le type de membre est DSPF36 ou MNU36, le menu principal SDA (environnement 36) s'affiche.
  • Si l'ancien type de membre MNU a été entré, SDA le convertit en MNUDDS.
  • Notez que les membres de menu de PDM sont de type MNUDDS pour le membre image et de type MNUCMD pour le membre source de commandes. Les deux sont liés et forment un groupe ; ainsi, en indiquant l'un des deux types, vous agissez automatiquement sur le membre associé.
*RLU
Vous permet d'utiliser RLU pour gérer les membres sélectionnés.

Options de la liste de membres de fichiers physiques de données

*CHGT
Vous permet de modifier certains attributs d'un ou de plusieurs des membres d'un fichier physique.
*CMPR
Vous permet de comparer un ou plusieurs membres.
*COPY
Vous permet de copier un ou plusieurs membres dans un ou plusieurs nouveaux membres. Ces derniers peuvent appartenir à un autre fichier et/ou une autre bibliothèque.
*DFU
Vous permet d'appeler DFU pour modifier les membres sélectionnés.
*DLT
Vous permet de supprimer un ou plusieurs membres du fichier.
*DSP
Vous permet d'afficher un ou plusieurs membres.
*DSPD
Vous permet d'afficher des informations sur un ou plusieurs membres.
*RNM
Vous permet de rebaptiser un ou plusieurs membres.
*SAVE
Vous permet de sauvegarder un membre sur une disquette ou une bande.

Option de la liste des membres définis par l'utilisateur

valeur-alphanumérique
Spécifiez le nom d'une option que vous avez définie dans votre fichier d'options actif.

Elément 2 : Invite

Cette partie du paramètre vous permet d'indiquer si vous désirez l'affichage d'un écran d'invite à chaque exécution de la commande correspondant à l'option.

*NOPROMPT
Le système n'affiche pas l'invite à chaque exécution de la commande, lorsque l'occurrence de la chaîne a été trouvée dans un membre.
*PROMPT
Le système affiche l'invite à chaque exécution de la commande, lorsque l'occurrence de la chaîne a été trouvée dans un membre.

Colonnes à explorer (COL)

Indiquez les numéros des colonnes de début et de fin de la partie de chaque enregistrement de fichier faisant l'objet de la recherche. Cela vous permet de rechercher le début, la fin ou le milieu de chaque enregistrement.

Le numéro de la colonne de début ne doit pas dépasser la longueur de l'enregistrement.

Elément 1 : De la colonne

1
La recherche commence à la colonne 1 de chaque enregistrement.
*RCDLEN
La recherche ne porte que sur la dernière colonne des enregistrements.
numéro
Indiquez la première colonne de la partie de chaque enregistrement sur laquelle porte la recherche.

Elément 2 : A la colonne

*RCDLEN
La partie de chaque enregistrement sur laquelle porte la recherche s'étend de la colonne de début spécifiée à la dernière colonne de l'enregistrement.
numéro
Indiquez la dernière colonne de la partie d'enregistrement faisant l'objet de la recherche.

Distinction majusc/minusc (CASE)

Indique si la distinction majuscules/minuscules doit être prise en compte lors de la recherche.

*IGNORE
Vous permet de rechercher le membre de la chaîne spécifiée sans tenir compte de la casse.
*MATCH
Vous permet de rechercher l'occurrence exacte de la chaîne spécifiée.

Imprimer liste (PRTMBRLIST)

Vous permet d'indiquer si vous souhaitez imprimer la liste des membres pour lesquels une occurrence a été trouvée.

*NO
Sélectionnez cette option si vous ne souhaitez pas imprimer la liste des membres contenant une occurrence de la chaîne.
*YES
Sélectionnez cette option si vous souhaitez imprimer la liste des membres contenant une occurrence de la chaîne spécifiée.

Imprimer enregistrements (PRTRCDS)

Indique les enregistrements contenant la chaîne à imprimer.

Valeurs uniques

*NONE
Aucun enregistrement contenant la chaîne spécifiée ne sera imprimé.

Elément 1 : Nombre à trouver

*ALL
Permet d'imprimer tous les enregistrements contenant la chaîne spécifiée.
1-99999
Spécifiez le nombre d'enregistrements à imprimer contenant la chaîne spécifiée.

Elément 2 : Format d'impression

*CHAR
Permet d'imprimer les enregistrements au format alphanumérique.
*HEX
Permet d'imprimer les enregistrements au format hexadécimal superposé. Cela signifie que les valeurs hexadécimales apparaîtront au-dessous des valeurs alphanumériques.
*ALTHEX
Permet d'imprimer les enregistrements au format hexadécimal côte-à-côte.

Elément 3 : Marquer enregistrement

Vous pouvez marquer la chaîne au sein de l'enregistrement imprimé. Dans les recherches portant sur des caractères, c'est la chaîne elle-même qui sert de marque pour permettre un repérage rapide. En revanche, pour les recherches hexadécimales, la chaîne est marquée à l'aide d'astérisques.

*MARK
Permet de marquer l'occurrence de la chaîne au sein de l'enregistrement.
*NOMARK
L'occurrence de la chaîne au sein de l'enregistrement ne sera pas marquée.

Elément 4 : Dépassement d'enregistrement

Vous pouvez préciser si les données de l'enregistrement doivent être renvoyées à la ligne ou tronquées lorsqu'elles dépassent la longueur de la ligne d'impression.

*FOLD
Permet d'imprimer l'enregistrement entier sur plusieurs lignes d'impression.
*TRUNCATE
Permet d'imprimer uniquement la partie de l'enregistrement qui tient sur la ligne d'impression. Si vous indiquez *ALTHEX, seules les colonnes 1 à 32 sont imprimées ; si vous indiquez *CHAR ou *HEX, les colonnes 1 à 100 sont imprimées.

Paramètres (PARM)

Permet d'indiquer les paramètres à ajouter à la commande correspondant à la valeur spécifiée pour l'élément 1 du paramètre OPTION (Opération à exécuter).

valeur-alphanumérique
Indiquez les paramètres que vous souhaitez transmettre à la commande associée à la valeur spécifiée pour le paramètre OPTION. Par défaut, ce paramètre ne contient aucune option. Dans ce cas, aucun paramètre n'est transmis.

Exemples

FNDSTRPDM2   STRING('Ms') FILE(LIB1/MYFILE)
             MBR(SCHLIST)  CASE(*MATCH)
             OPTION(*NONE)  PRTMBRLIST(*YES)

Cette commande permet de rechercher les occurrences de la chaîne Ms dans tous les membres de fichiers de la liste de recherche. La liste de recherche figure dans le membre SCHLIST du fichier MYFILE de la bibliothèque LIB1. La recherche tient compte de la casse. Un fichier spoule est généré. Il recense tous les membres de fichiers contenant au moins un enregistrement comportant la chaîne recherchée.

Messages d'erreur

Messages *ESCAPE

PDM0055
Erreur pendant l'exécution de la commande &1.

© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.