CRTDUPOBJ
Créer un objet dupliqué
En bref
La commande CRTDUPOBJ (Créer un objet dupliqué) permet de copier un objet ou un groupe d'objets.
CRTDUPOBJ se lit CRT
(Créer) + DUPOBJ.
Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.
Syntaxe minimale
CRTDUPOBJ OBJ(…) FROMLIB(…) OBJTYPE(…)
Paramètres
-
OBJObjet d'origine obligatoire -
FROMLIBBibliothèque d'origine obligatoire -
OBJTYPEType d'objet obligatoire -
TOLIBBibliothèque de destination -
NEWOBJNouvel objet -
ASPDEVDepuis l'unité ASP -
TOASPDEVVers l'unité ASP -
DATADuplication des données -
CSTDupliquer des contraintes -
TRGDupliquer des déclencheurs -
FILEIDID de fichiers en double -
ACCCTLContrôle d'accès en double
Astuce : dans une session 5250, tapez CRTDUPOBJ 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 QSYS)
Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Oui
La commande CRTDUPOBJ (Créer un objet dupliqué) permet de copier un objet ou un groupe d'objets. Elle ne crée pas un double exact des fichiers. Le nouvel objet doit être renommé s'il est créé dans la bibliothèque contenant l'objet d'origine. S'il est créé dans une bibliothèque différente de celle contenant l'objet d'origine, il peut conserver le nom de l'objet d'origine. Vous pouvez copier un groupe d'objets connexes en indiquant un nom d'objet générique, ou en spécifiant *ALL ou plusieurs types d'objet. Lors de la copie d'un groupe d'objets connexes, vous devez préciser une autre bibliothèque dans laquelle les nouveaux objets seront créés. Vous pouvez indiquer si des données des fichiers physiques ou sauvegarde doivent être copiées. Vous pouvez également préciser si des contraintes, des déclencheurs, des contrôles d'accès de ligne ou des contrôles d'accès de colonne associés à un fichier base de données existant doivent être joints au nouveau fichier et si les identificateurs de niveau fichier ou de niveau membre d'un fichier base de données existant doivent être copiés dans le nouveau fichier base de de données.
Remarque :La valeur du paramètre Droits pour objets créés (CRTAUT) indiqué dans la commande CRTLIB (Créer une bibliothèque) pour la bibliothèque de destination n'est pas utilisée pour l'objet en double. Les droits publics et privés sur l'objet en double sont identiques à ceux de l'objet d'origine, à cette seule exception. Si, en ne dupliquant pas un déclencheur INSTEAD OF, le nouveau fichier base de données perd la fonction d'insertion, de mise à jour ou de suppression de l'ancien fichier, les droits d'insertion, de mise à jour ou de suppression correspondants sur l'ancien fichier ne seront pas accordés au nouveau fichier. Le propriétaire de l'objet en double correspond au profil de l'utilisateur qui émet la commande ou au profil de groupe si le profil de l'utilisateur émettant la commande est un profil utilisateur membre qui a indiqué que le profil de groupe doit être le propriétaire.
Lors de la duplication d'un fichier à l'aide de la commande CRTDUPOBJ, le format du fichier existant indiqué au paramètre Objet d'origine (OBJ) est utilisé pour le nouveau fichier créé indiqué au paramètre Nouvel objet (NEWOBJ). Lorsque le nombre maximal (environ 32 000) d'objets fichier de même format est atteint, le nouveau fichier crée un nouveau format au lieu de partager celui du fichier d'origine.
Remarque :Tous les fichiers dont le format est identique sont considérés comme liés entre eux et sont regroupés dans la même liste de sauvegarde lors d'une opération de sauvegarde.
Lorsqu'un fichier logique est copié dans une autre bibliothèque, deux cas distincts sont à considérer pour déterminer le fichier sous-jacent du fichier :
- Le fichier logique et son fichier physique sous-jacent figurent à l'origine dans la même bibliothèque. Un double du fichier physique doit alors être créé dans la nouvelle bibliothèque avant que le fichier logique soit dupliqué. Une fois les deux doubles créés, le nouveau fichier physique devient le fichier sous-jacent du fichier logique.
- Le fichier logique et son fichier physique sous-jacent figurent à l'origine dans des bibliothèques différentes. Il n'est alors pas nécessaire de dupliquer le fichier physique avant de dupliquer le fichier logique ; le fichier physique sous-jacent est celui du fichier logique d'origine. A la différence du premier cas, même si le fichier physique est copié dans la nouvelle bibliothèque avant le fichier logique, le fichier logique dupliqué a pour fichier sous-jacent le fichier physique d'origine et non le fichier physique dupliqué.
Lorsque la commande CRTDUPOBJ crée un fichier base de données, vous pouvez utiliser le paramètre Dupliquer des contraintes (CST) pour indiquer si des contraintes associées au fichier existant doivent être associées au fichier nouvellement créé. De la même façon, vous pouvez utiliser le paramètre Dupliquer des déclencheurs (TRG) pour indiquer si des déclencheurs associés au fichier existant doivent être associés ou non au fichier nouvellement créé. Il existe des considérations spéciales concernant la duplication des déclencheurs. Par exemple, la duplication sera différente selon que le programme de déclenchement associé au fichier existant figurait dans la même bibliothèque que celui-ci. Vous pouvez également utiliser le paramètre ID de fichiers en double (FILEID) pour indiquer si les identificateurs de niveau fichier et de niveau membre du fichier existant doivent être utilisés ou non pour le fichier nouvellement créé. Vous pouvez utiliser le paramètre Contrôle d'accès en double(ACCCTL) pour indiquer si des contrôles d'accès de ligne ou des contrôles d'accès de colonne associés au fichier existant doivent être associés ou non au fichier nouvellement créé. Remarque : Il existe une considération à prendre en compte concernant la duplication des contrôles d'accès de ligne ou des contrôles d'accès de compte. Ainsi, la duplication d'un fichier avec des contrôles d'accès ne modifie pas le nom de la bibliothèque des fichiers référencés par les contrôles d'accès de ligne ou de colonne si la commande duplique le fichier dans une autre bibliothèque.
Remarque :Pour en savoir plus, reportez-vous au manuel Rubrique Base de données de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.
Lorsque l'objet en cours de duplication possède un type admissible à la journalisation, deux méthodes existent pour qu'il démarre automatiquement la journalisation après sa création.
- Si la bibliothèque destination est journalisée, les règles d'héritage du journal pour la bibliothèque déterminent si la journalisation est lancées pour l'objet.
- Si la bibliothèque destination contient une zone de données nommée QDFTJRN, l'objet lance automatiquement la journalisation en fonction du contenu de la zone de données QDFTJRN.
Remarque :La zone de données QDFTJRN supplante les règles d'état de la journalisation et d'héritage de journal de la bibliothèque destination.
Remarque :La prise en charge de la zone de données QDFTJRN ne sera pas suivie dans les prochaines versions.
Utilisez la commande DSPLIBD (Afficher la description de la bibliothèque) pour afficher les informations journalisées sur la bibliothèque. Pour plus d'informations sur le lancement de la journalisation d'une bibliothèque, reportez-vous à la commande (STRJRNLIB) .
Remarque :Pour en savoir plus sur la journalisation, reportez-vous au manuel Ensemble de rubriques Journal Management de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.
Restrictions :
- Vous devez disposer de droits d'utilisation (*USE) et de gestion (*OBJMGT) sur l'objet existant.
- Vous devez disposer de droits d'utilisation (*USE) et d'ajout (*ADD) sur la bibliothèque du nouvel objet.
- Vous devez disposer du droit de gestion de liste d'autorisation (*AUTLMGT) si l'objet est une liste d'autorisation.
- Vous devez disposer du droit d'opération (*OBJOPR) sur l'objet pour la commande CRTSAVF (Créer un fichier sauvegarde) afin de créer un fichier sauvegarde en double. Le contenu du fichier sauvegarde est copié lorsque *YES est indiqué pour le paramètre Duplication des données (DATA).
- Lorsqu'un objet doit être dupliqué, il est créé dans le même pool de mémoire secondaire (ASP) que la bibliothèque de destination.
- Si *YES est indiqué pour le paramètre Duplication des données (DATA) lorsque la commande CRTDUPOBJ est exécutée pour créer une copie du fichier, le nouveau fichier dupliqué est verrouillé (blocage similaire à un verrouillage exclusif *EXCL sans délai d'attente) pendant la durée de la copie, tout accès étant impossible. Toute fonction lancée pendant la copie et se référant au nouveau fichier dupliqué provoque un verrouillage du poste de travail jusqu'à la fin de la copie. Vous trouverez ci-après des exemples de fonctions ne devant pas être utilisées avec le nouveau fichier tant que la copie n'est pas terminée :
- WRKACTJOB (Option 11- Verrouillages ; Option 8 - WRKOBJLCK)
- DSPDBR
- DSPFD
- DSPFFD
- DSPJOB (Option 12 - Verrouillages ; F10 - Verrouillages d'enregistrement du travail ; Option 14 - Fichiers ouverts)
- DSPLIB (bibliothèque contenant le nouveau fichier dupliqué)
- DSPOBJD
- WRKOBJLCK
- DSPRCDLCK
- Toute autre fonction se rapportant au nouveau fichier dupliqué
- Lors de la copie d'un fichier base de données ou sauvegarde et lorsque la mémoire nécessaire à la bibliothèque d'origine provient d'un pool de mémoire secondaire principal ou secondaire (ASP), la mémoire nécessaire à la bibliothèque de destination doit provenir soit d'un ASP présent dans le même groupe d'ASP que pour la bibliothèque d'origine, soit d'un ASP système (ASP 1) ou utilisateur de base (ASP 2-32). La copie d'un fichier base de données ou sauvegarde d'un groupe d'ASP vers un autre groupe d'ASP n'est pas prise en charge.
- Lors de la création d'un objet dupliqué de type *GSS, *FNTRSC, *FORMDF, *OVL, *CSI, *PAGDFN ou *PAGSEG, la longueur du nom du nouvel objet ne peut pas dépasser 8 caractères.
- Les objets du domaine utilisateur, *USRSPC (espace utilisateur) et *USRIDX (index utilisateur) peuvent uniquement être copiés dans des bibliothèques admises par la valeur système QALWUSRDMN (admettre les objets du domaine utilisateur dans une bibliothèque). Toutefois, l'objet utilisateur n'est pas concerné par cette restriction s'il a été créé sous la forme d'un objet de domaine système.
Paramètres
| Mot-clé | Description | Valeurs possibles | Remarques |
|---|---|---|---|
| OBJ | Objet d'origine | Nom générique, nom, *ALL | Obligatoire, positionnel 1 |
| FROMLIB | Bibliothèque d'origine | Nom, *LIBL, *CURLIB | Obligatoire, positionnel 2 |
| OBJTYPE | Type d'objet | Valeurs uniques: *ALL Autres valeurs (jusqu'à 57 répétitions): *ALRTBL, *AUTL, *BNDDIR, *CHTFMT, *CLD, *CLS, *CMD, *CRQD, *CSI, *CSPMAP, *CSPTBL, *DTAARA, *FCT, *FILE, *FNTRSC, *FNTTBL, *FORMDF, *FTR, *GSS, *IGCDCT, *IGCSRT, *JOBD, *JOBQ, *LOCALE, *MEDDFN, *MENU, *MGTCOL, *MODULE, *MSGF, *MSGQ, *M36CFG, *NODGRP, *NODL, *OUTQ, *OVL, *PAGDFN, *PAGSEG, *PDFMAP, *PDG, *PGM, *PNLGRP, *PRDAVL, *PRDDFN, *PRDLOD, *PSFCFG, *QMFORM, *QMQRY, *QRYDFN, *SBSD, *SCHIDX, *SRVPGM, *SSND, *TBL, *USRIDX, *USRSPC, *VLDL, *WSCST |
Obligatoire, positionnel 3 |
| TOLIB | Bibliothèque de destination | Nom, *FROMLIB, *SAME, *CURLIB | Facultatif, positionnel 4 |
| NEWOBJ | Nouvel objet | Nom, *OBJ, *SAME | Facultatif, positionnel 5 |
| ASPDEV | Depuis l'unité ASP | Nom, *, *CURASPGRP, *SYSBAS | Facultatif |
| TOASPDEV | Vers l'unité ASP | Nom, *ASPDEV, *, *CURASPGRP, *SYSBAS | Facultatif |
| DATA | Duplication des données | *NO, *YES | Facultatif |
| CST | Dupliquer des contraintes | *YES, *NO | Facultatif |
| TRG | Dupliquer des déclencheurs | *YES, *NO | Facultatif |
| FILEID | ID de fichiers en double | *NO, *YES | Facultatif |
| ACCCTL | Contrôle d'accès en double | *ALL, *ROW, *COL, *NONE | Facultatif |
Objet d'origine (OBJ)
Indique un ou plusieurs objets à dupliquer.
Ce paramètre est obligatoire.
- *ALL
- Tous les objets de la bibliothèque pour lesquels vous disposez de droits et qui ont le même type que celui indiqué pour le paramètre Type d'objet (OBJTYPE) sont dupliqués.
- nom-générique
- Indiquez un groupe d'objets à dupliquer dans la bibliothèque indiquée. Le nom d'objet générique doit contenir une chaîne de caractères suivie d'un astérisque (*), par exemple, ABC*. Un nom générique définit tous les objets qui commencent par le même préfixe que le nom de l'objet générique sur lequel vous disposez des droits d'accès appropriés.
- nom
- Indiquez le nom de l'objet à dupliquer.
Bibliothèque d'origine (FROMLIB)
Indique la bibliothèque contenant les objets à dupliquer.
Ce paramètre est obligatoire.
- *LIBL
- La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.
Remarque :*LIBL ne peut être indiqué que pour un objet et un type d'objet spécifique.
- *CURLIB
- La bibliothèque en cours de l'unité d'exécution est utilisée pour trouver les objets à dupliquer. Si aucune bibliothèque n'est précisée, la bibliothèque QGPL est prise par défaut.
- nom
- Indiquez le nom de la bibliothèque dans laquelle les objets à dupliquer doivent être recherchés.
Type d'objet (OBJTYPE)
Indique le type de l'objet à dupliquer. Ce paramètre peut être indiqué sous la forme d'une valeur particulière ou d'une liste d'un ou plusieurs types d'objet.
Pour obtenir la liste complète des types d'objet, placez le curseur dans la zone de ce paramètre et appuyez sur F4 (Invite). Pour obtenir une description des types d'objet, reportez-vous à "Types d'objet" dans Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.
Ce paramètre est obligatoire.
Valeurs uniques
- *ALL
- Tous les types d'objet dont le nom est indiqué figurant dans la bibliothèque précisée et sur lesquels vous disposez de droits sont dupliqués. Si *ALL est également indiqué pour le paramètre Objet d'origine (OBJ), tous les objets de la bibliothèque indiquée sur lesquels vous disposez de droits et dont le type permet la copie sont dupliqués.
Autres valeurs
- type-objet
- Indiquez une ou plusieurs valeurs pour les types d'objet à dupliquer.
Bibliothèque de destination (TOLIB)
Bibliothèque dans laquelle l'objet dupliqué doit être créé.
Remarque :Si la bibliothèque se trouve dans un ASP, le type de l'objet à copier doit être admis par l'ASP dans lequel l'objet va être créé. Si ce type d'objet n'est pas admis dans un ASP, un message d'erreur s'affiche.
- *FROMLIB
- La bibliothèque contenant le nouvel objet possède le même nom que celle qui contient l'objet d'origine. Il ne s'agit pas forcément de la même bibliothèque que celle qui contient l'objet d'origine. Si les paramètres Depuis l'unité ASP (ASPDEV) et Vers l'unité ASP (TOASPDEV) décrivent la même unité ASP, il s'agit alors de la même bibliothèque. Dans ce cas, le nouvel objet ne doit pas avoir le même nom que l'objet d'origine et doit être rebaptisé à l'aide du paramètre Nouvel objet (NEWOBJ). Si les paramètres ASPDEV et TOASPDEV décrivent des unités ASP différentes, il s'agit d'une autre bibliothèque (ayant le même nom que la bibliothèque d'origine) dans une autre unité ASP.
- *SAME
- Reportez-vous à la valeur *FROMLIB ci-avant. *SAME et *FROMLIB ont la même fonction.
- *CURLIB
- La bibliothèque en cours de l'unité d'exécution qui contiendra le nouvel objet. Si aucune bibliothèque n'est précisée, la bibliothèque QGPL est prise par défaut. Si *CURLIB est indiqué pour ce paramètre, soit le paramètre Vers l'unité ASP (TOASPDEV) doit avoir pour valeur *, soit le paramètre TOASPDEV doit avoir la valeur *ASPDEV et le paramètre Depuis l'unité ASP (ASPDEV) la valeur *.
- nom
- Indiquez le nom de la bibliothèque qui contiendra le nouvel objet.
Nouvel objet (NEWOBJ)
Indique le nom du nouvel objet. Un nom doit être indiqué si *SAME ou *FROMLIB est précisé pour le paramètre Bibliothèque de destination (TOLIB) et si la même unité ASP est indiquée pour les deux paramètres Depuis l'unité ASP (ASPDEV) et Vers l'unité ASP (TOASPDEV). Les noms des membres d'un fichier base de données à dupliquer restent inchangés dans le nouveau fichier.
- *OBJ
- Le nouvel objet porte le même nom que l'objet d'origine. Si ce paramètre est indiqué, le nouvel objet et l'objet d'origine doivent résider dans des bibliothèques différentes.
- *SAME
- Reportez-vous à la valeur *OBJ ci-avant. *SAME et *OBJ ont la même fonction.
- nom
- Indiquez le nom du nouvel objet.
Depuis l'unité ASP (ASPDEV)
Indique le nom de l'unité ASP possédant la mémoire nécessaire à la bibliothèque contenant l'objet à dupliquer (paramètre Bibliothèque d'origine (FROMLIB)). Si la bibliothèque est située dans un ASP qui ne fait pas partie de l'espace de nom de la bibliothèque de l'unité d'exécution, ce paramètre doit être indiqué pour être sûr que l'objet concerné par la copie est correct. Si ce paramètre est utilisé lorsque *LIBL ou *CURLIB est indiqué pour le paramètre FROMLIB, la valeur * est la seule valeur admise.
- *
- La recherche de la bibliothèque s'effectue dans tous les ASP présents dans l'espace de nom de bibliothèque de l'unité d'exécution. Il s'agit de l'ASP système (ASP 1), de tous les ASP utilisateur de base définis(ASP 2 à 32) et, si l'unité d'exécution dispose d'un groupe d'ASP, des ASP principaux et secondaires du groupe d'ASP de l'unité d'exécution.
- *CURASPGRP
- Si l'unité d'exécution dispose d'un groupe ASP, la recherche portera sur les ASP primaire et secondaire du groupe ASP de l'unité pour trouver la bibliothèque. La recherche ne s'effectue ni dans l'ASP système (ASP 1) ni dans les ASP utilisateur de base définis (ASP 2-32). Si aucun groupe d'ASP n'est associé à l'unité d'exécution, une erreur est signalée.
- *SYSBAS
- La bibliothèque est recherchée dans l'ASP système (ASP 1) et dans tous les ASP utilisateur de base définis (ASP 2-32). Les ASP principaux et secondaires ne sont pas concernés par cette recherche, même si l'unité d'exécution possède un groupe d'ASP.
- nom
- Indiquez le nom de l'ASP principal ou secondaire dans lequel rechercher la bibliothèque. L'ASP principal ou secondaire doit être activé (via la mise en fonction de l'unité ASP) et être à l'état 'Disponible'. La recherche ne s'effectue ni dans l'ASP système (ASP 1) ni dans les ASP utilisateur de base définis (ASP 2-32).
Remarque :Pour indiquer un nom d'ASP spécifique, vous devez disposer du droit d'utilisation (*USE) sur chaque ASP du groupe d'ASP.
Vers l'unité ASP (TOASPDEV)
Indique le nom de l'unité ASP possédant la mémoire nécessaire à la bibliothèque contenant le nouvel objet (paramètre Bibliothèque de destination (TOLIB)). Si la bibliothèque est située dans un ASP qui ne fait pas partie de l'espace de nom de la bibliothèque de l'unité d'exécution, ce paramètre doit être indiqué pour être sûr que l'objet est copié dans la bonne bibliothèque. Si ce paramètre est utilisé lorsque *CURLIB est indiqué pour le paramètre TOLIB, TOASPDEV(*) ou TOASPDEV(*ASPDEV) doit être précisé et le paramètre Depuis l'unité ASP (ASPDEV) doit avoir la valeur *.
- *ASPDEV
- La bibliothèque est recherchée dans l'unité ASP indiquée au paramètre ASPDEV.
- *
- La recherche de la bibliothèque s'effectue dans tous les ASP présents dans l'espace de nom de bibliothèque de l'unité d'exécution. Il s'agit de l'ASP système (ASP 1), de tous les ASP utilisateur de base définis(ASP 2 à 32) et, si l'unité d'exécution dispose d'un groupe d'ASP, des ASP principaux et secondaires du groupe d'ASP de l'unité d'exécution.
- *CURASPGRP
- Si l'unité d'exécution dispose d'un groupe ASP, la recherche portera sur les ASP primaire et secondaire du groupe ASP de l'unité pour trouver la bibliothèque. La recherche ne s'effectue ni dans l'ASP système (ASP 1) ni dans les ASP utilisateur de base définis (ASP 2-32). Si aucun groupe d'ASP n'est associé à l'unité d'exécution, une erreur est signalée.
- *SYSBAS
- La bibliothèque est recherchée dans l'ASP système (ASP 1) et dans tous les ASP utilisateur de base définis (ASP 2-32). Les ASP principaux et secondaires ne sont pas concernés par cette recherche, même si l'unité d'exécution possède un groupe d'ASP.
- nom
- Nom de l'ASP principal ou secondaire dans lequel rechercher la bibliothèque. L'ASP principal ou secondaire doit être activé (via la mise en fonction de l'unité ASP) et être à l'état 'Disponible'. La recherche ne s'effectue ni dans l'ASP système (ASP 1) ni dans les ASP utilisateur de base définis (ASP 2-32).
Remarque :Pour indiquer un nom d'ASP spécifique, vous devez disposer du droit d'utilisation (*USE) sur chaque ASP du groupe d'ASP.
Duplication des données (DATA)
Indique si les enregistrements de données des fichiers physiques base de données ou des fichiers sauvegarde sont copiés dans le nouvel objet. Les membres des fichiers physiques base de données sont copiés, que les données qu'ils contiennent soient copiées ou non.
- *NO
- Les enregistrements de données des membres des fichiers physiques base de données ou des fichiers sauvegarde ne sont pas copiés dans le nouvel objet.
- *YES
- Les enregistrements de données des membres des fichiers physiques base de données ou des fichiers sauvegarde sont copiés dans le nouvel objet.
REMARQUES :
- Un fichier ne peut pas être copié alors qu'il est mis à jour par un autre travail.
- Les numéros relatifs d'enregistrement du nouveau fichier sont identiques à ceux du fichier d'origine.
Dupliquer des contraintes (CST)
Indique si les contraintes associées aux fichiers physiques base de données existants sont copiées dans les fichiers nouvellement créés. La valeur spécifiée n'est pas utilisée pour les objets qui ne sont pas des fichiers physiques base de données.
- *YES
- Les contraintes associées aux fichiers physiques base de données existants sont copiées dans les fichiers nouvellement créés.
- *NO
- Les contraintes associées aux fichiers physiques base de données existants ne sont pas copiées dans les fichiers nouvellement créés.
Dupliquer des déclencheurs (TRG)
Indique si les déclencheurs associés aux fichiers base de données existants sont copiés dans les fichiers nouvellement créés. La valeur indiquée n'est pas utilisée pour les objets qui ne sont pas des fichiers base de données.
Remarque :Il existe des considérations spéciales concernant la duplication des déclencheurs. Par exemple, la duplication sera différente selon que le programme de déclenchement associé au fichier existant figurait dans la même bibliothèque que celui-ci. Pour en savoir plus, reportez-vous au manuel Rubrique Base de données de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.
- *YES
- Les déclencheurs associés aux fichiers base de données existants sont copiés dans les fichiers nouvellement créés.
- *NO
- Les déclencheurs associés aux fichiers base de données existants ne sont pas copiés dans les fichiers nouvellement créés.
ID de fichiers en double (FILEID)
Indique si les identificateurs de niveau fichier et de niveau membre du fichier base de données existant seront utilisés pour le fichier nouvellement créé. La valeur indiquée n'est pas utilisée pour les objets qui ne sont pas des fichiers base de données.
- *NO
- Les identificateurs de niveau fichier et de niveau membre du fichier base de données existant ne seront pas utilisés pour le fichier nouvellement créé. Les identificateurs de niveau fichier et de niveau membre du fichier nouvellement créé seront générés par le système ; par exemple, 1070224092922.
- *YES
- Les identificateurs de niveau fichier et de niveau membre du fichier base de données existant seront utilisés pour le fichier nouvellement créé. La présence de deux fichiers base de données possédant des identificateurs de niveau fichier et de niveau membre identiques peut avoir une incidence sur les opérations de base de données. Cette valeur est utilisable uniquement lorsqu'un fichier base de données en double exact est attendu.
Contrôle d'accès en double (ACCCTL)
Indique si les contrôles d'accès de ligne ou de colonne associés à un fichier physique base de données existant sont copiés dans les fichiers nouvellement créés. La valeur spécifiée n'est pas utilisée pour les objets qui ne sont pas des fichiers physiques base de données.
- *ALL
- Tous les contrôles d'accès de ligne et de colonne associés à un fichier physique base de données existant sont copiées dans le fichier nouvellement créé. Si le fichier base de données en cours de copie comporte un droit ou des masques actifs et que le paramètre DATA(*YES) est spécifié, les contrôles d'accès de colonne et les contrôles d'accès de ligne doivent être copiés.
- *ROW
- Les contrôles d'accès de ligne associés à un fichier physique base de données existant sont copiés dans le fichier nouvellement créé. Si le fichier base de données en cours de copie comporte des masques actifs et que le paramètre DATA(*YES) est spécifié, les contrôles d'accès de ligne doivent être copiés.
- *COL
- Les contrôles d'accès de colonne associés à un fichier physique base de données existant sont copiées dans le fichier nouvellement créé. Si le fichier base de données en cours de copie comporte des droits actifs et que le paramètre DATA(*YES) est spécifié, les contrôles d'accès de colonne doivent être copiés.
- *NONE
- Aucun des contrôles d'accès de ligne ou de colonne associés à un fichier physique base de données existant n'est copié dans le fichier nouvellement créé. Si le fichier base de données en cours de copie comporte des droits ou des masques actifs, le paramètre DATA(*NO) doit être spécifié.
Exemples
Exemple 1 : Duplication d'un fichier base de données avec les enregistrements de données, les contraintes et les déclencheurs
CRTDUPOBJ OBJ(FILEA) FROMLIB(LIB1) OBJTYPE(*FILE)
TOLIB(LIB2) DATA(*YES)
Le fichier nommé FILEA de la bibliothèque LIB1 est dupliqué dans la bibliothèque LIB2. Les droits accordés au fichier FILEA de la bibliothèque LIB1 sont accordés au fichier FILEA créé dans la bibliothèque LIB2. Les enregistrements de données, les contraintes et les déclencheurs associés au fichier FILEA de la bibliothèque LIB1 sont copiés dans le fichier FILEA créé dans la bibliothèque LIB2. De nouveaux identificateurs de niveau de fichier et de niveau membre sont générés pour le fichier FILEA créé dans la bibliothèque LIB2. Cela signifie que les identificateurs de niveau fichier et de niveau membre du fichier FILEA de la bibliothèque LIB2 ne sont pas les mêmes que ceux du fichier FILEA de la bibliothèque LIB1.
Exemple 2 : Duplication d'un fichier base de données sans les enregistrements de données, les contraintes et les déclencheurs, et conservation des mêmes identificateurs de niveau fichier et de niveau membre
CRTDUPOBJ OBJ(FILEB) FROMLIB(LIB3) OBJTYPE(*FILE) NEWOBJ(FILEDUP)
DATA(*NO) CST(*NO) TRG(*NO) FILEID(*YES)
Le fichier appelé FILEB dans la bibliothèque LIB3 est dupliqué dans LIB3 et renommé FILEDUP. Les enregistrements de données, les contraintes et les déclencheurs associés au fichier FILEB de la bibliothèque LIB3 ne sont pas copiés dans le fichier FILEDUP créé dans la bibliothèque LIB3. Les identificateurs de niveau fichier et de niveau membre du fichier FILEDUP créé dans la bibliothèque LIB3 sont identiques à ceux du fichier FILEB de la bibliothèque LIB3. Les droits accordés pour FILEB sont octroyés au nouveau fichier FILEDUP créé dans la bibliothèque LIB3 avec l'exception suivante. Si, en ne dupliquant pas un déclencheur INSTEAD OF, le nouveau fichier base de données FILEDUP perd la fonction d'insertion, de mise à jour ou de suppression de l'ancien fichier base de données FILEB, les droits d'insertion, de mise à jour ou de suppression correspondants de l'ancien fichier ne seront pas accordés au nouveau fichier.
Messages d'erreur
Messages *ESCAPE
- CPFB8ED
- La description d'unité &1 est incorrecte pour l'opération.
- CPF2105
- Objet &1 de &2 type *&3 non trouvé.
- CPF2109
- NEWOBJ doit être *SAME lorsque le paramètre OBJ est *ALL ou un nom générique.
- CPF2110
- Bibliothèque &1 non trouvée.
- CPF2113
- Impossible d'allouer la bibliothèque &1.
- CPF2116
- DATA(*YES) indiqué, mais *ALL ou *FILE absent de la liste OBJTYPE.
- CPF2122
- Limite mémoire dépassée pour le profil utilisateur &1.
- CPF2123
- Aucun objet du nom ou du type indiqué dans la bibliothèque &2.
- CPF2130
- &1 objet(s) dupliqué(s). &2 objet(s) non dupliqué(s).
- CPF2151
- Erreur de l'opération sur &2 de &1 type *&3.
- CPF2152
- Les objets de type *&1 ne peuvent pas être créés dans QTEMP.
- CPF2155
- Valeur *LIBL non admise pour FROMLIB.
- CPF216C
- Valeur TOASPDEV non autorisée avec TOLIB(*CURLIB).
- CPF216D
- Paramètre TOLIB, NEWOBJ ou TOASPDEV incorrect.
- CPF2160
- Objet de type *&1 incorrect pour la fonction demandée.
- CPF2162
- Duplication non admise pour tous les objets de la bibliothèque &1.
- CPF2173
- Valeur pour ASPDEV incorrecte avec valeur spéciale pour bibliothèque.
- CPF2176
- Bibliothèque &1 endommagée.
- CPF218C
- &1 n'est pas un ASP principal ou secondaire.
- CPF2182
- Non autorisé à utiliser la bibliothèque &1.
- CPF2185
- Paramètre TOLIB, TOASPDEV ou NEWOBJ incorrect.
- CPF2186
- L'objet &1 ne peut pas être créé dans la bibliothèque &2.
- CPF9806
- Impossible d'exécuter fonction pour objet &2 de &3.
- CPF9814
- Unité &1 non trouvée.
- CPF9825
- Accès non autorisé à l'unité &1.
- CPF9827
- L'objet &1 ne peut pas être créé ou déplacé dans la bibliothèque &2.
- CPF9833
- *CURASPGRP ou *ASPGRPPRI indiqué et unité d'exécution en cours sans groupe d'ASP.
© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.