DMPOBJ

Clicher un objet

En bref

La commande Vider objet (DMPOBJ) vide le contenu ou les attributs de l'objet du système d'exploitation indiqué dans un fichier imprimante spoule nommé QPSRVDMP. The Dump Object (DMPOBJ) command dumps the contents or attributes of the specified operating system object to a spooled printer file named QPSRVDMP.

DMPOBJ se lit DMP (Vider (dump)) + OBJ. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

DMPOBJ OBJ(…) OBJTYPE(…)

Paramètres

OBJ Objet obligatoire
OBJTYPE Type d'objet obligatoire

Astuce : dans une session 5250, tapez DMPOBJ 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 : Non

La commande Vider objet (DMPOBJ) vide le contenu ou les attributs de l'objet du système d'exploitation indiqué dans un fichier imprimante spoule nommé QPSRVDMP. La possibilité de vider le contenu ou les attributs dépend du type d'objet. Si l'utilisateur a indiqué SPOOL(*NO) dans la commande CHGPRTF ou OVRPRTF, la sortie n'est pas mise en spoule mais imprimée directement ; et, si l'imprimante n'est pas disponible, cette commande remplace le travail d'impression et met la sortie en spoule. Lorsque l'utilisateur indique SPOOL(*NO) dans l'une des deux commandes ci-dessus, il doit indiquer QPSRVDMP comme fichier imprimante. Toute bibliothèque ou tout objet stocké dans une bibliothèque peut être vidé, mais un seul objet peut être indiqué à la fois dans cette commande. The Dump Object (DMPOBJ) command dumps the contents or attributes of the specified operating system object to a spooled printer file named QPSRVDMP. Whether the contents or attributes can be dumped depends on the object type. If the user had specified SPOOL(*NO) on either the CHGPRTF command or the OVRPRTF command, then the output is not spooled but printed directly; and, if the printer is not available, then this command overrides the print job and spools the output. When the user specifies SPOOL(*NO) on one of the two commands above, the user must specify QPSRVDMP as the printer file. Any library or object that is stored in a library can be dumped, but only one object can be specified at a time on this command.

Restrictions:

Cette commande est livrée avec le droit public d'exclusion (*EXCLUDE) et les profils utilisateur QSRV et QSRVBAS sont livrés avec des droits privés pour utiliser cette commande. This command is shipped with exclude (*EXCLUDE) public authority and the QSRV and QSRVBAS user profiles are shipped with private authorities to use this command.
You must have all object (*ALLOBJ) special authority or the following object authorities:
- droit d'exploitation de l'objet (*OBJOPR) sur l'objet à vider. object operational (*OBJOPR) authority for the object to be dumped.
- droit d'exécution (*EXECUTE) sur la bibliothèque de l'objet à vider. execute (*EXECUTE) authority to the library of the object to be dumped.
Si vous ne possédez pas le droit spécial *ALLOBJ, seuls les objets pour lesquels vous avez des droits sont vidés. If you do not have *ALLOBJ special authority, only those objects that you have authority for are dumped.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
OBJ	Objet	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: Objet	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB, QTEMP
OBJTYPE	Type d'objet	ALRTBL, AUTL, BNDDIR, CFGL, CHTFMT, CLD, CLS, CMD, CNNL, COSD, CRG, CRQD, CSI, CSPMAP, CSPTBL, CTLD, DEVD, DIR, DOC, DTAARA, DTADCT, DTAQ, EDTD, EXITRG, FCT, FILE, FLR, FNTRSC, FNTTBL, FORMDF, FTR, GSS, IGCDCT, IGCSRT, IGCTBL, IMGCLG, IPXD, JOBD, JOBQ, JOBSCD, JRN, JRNRCV, LIB, LIND, LOCALE, MEDDFN, MENU, MODD, MGTCOL, MODULE, MSGF, MSGQ, M36, M36CFG, NODL, NTBD, NWID, NWSCFG, NWSD, OUTQ, OVL, PAGDFN, PAGSEG, PDFMAP, PDG, PGM, PNLGRP, PRDAVL, PRDDFN, PRDLOD, PSFCFG, QMFORM, QMQRY, QRYDFN, RCT, SBSD, SCHIDX, SPADCT, SQLPKG, SQLUDT, SQLXSR, SRVPGM, SSND, SVRSTG, S36, TBL, TIMZON, USRIDX, USRPRF, USRQ, USRSPC, WSCST	Obligatoire, positionnel 2

Objet (OBJ)

Indique l'objet à vider. Seuls les objets stockés dans des bibliothèques peuvent être vidés. La commande DMP peut être utilisée pour vider des objets stockés dans des répertoires. Specifies the object to be dumped. Only objects that are stored in libraries can be dumped. The DMP command can be used to dump objects stored in directories.

Ce paramètre est obligatoire. This is a required parameter.

Qualificatif 1: Objet

nom: Indiquez le nom de l'objet à vider. Specify the name of the object to be dumped.

Qualificatif 2: Biblio

*LIBL: Toutes les bibliothèques de la liste de bibliothèques de l'unité d'exécution en cours sont recherchées jusqu'à ce que la première occurrence soit trouvée. All libraries in the library list for the current thread are searched until the first match is found.

*CURLIB: La bibliothèque en cours du travail est utilisée pour localiser l'objet. Si la liste de bibliothèques ne comporte aucune entrée de bibliothèque en cours, QGPL est utilisée. The current library for the job is used to locate the object. If no current library entry exists in the library list, QGPL is used.
nom: Indiquez le nom de la bibliothèque dans laquelle se trouve l'objet. Specify the name of the library where the object is located.

Type d'objet (OBJTYPE)

Indique le type d'objet de l'objet du système d'exploitation à vider. N'importe lequel des types d'objets peut être indiqué. Specifies the object type of the operating system object being dumped. Any one of the object types can be specified.

Ce paramètre est obligatoire. This is a required parameter.

object-type: Specify the object type of the object to be dumped.
Pour afficher la liste complète des types d'objets lors de l'invite de cette commande, placez le curseur sur la zone de ce paramètre et appuyez sur F4 (Invite). Pour une description des types d'objets, consultez « Object types » dans la collection de rubriques CL de la catégorie Programmation de l'IBM i Information Center à l'adresse http://www.ibm.com/systems/i/infocenter/. To see a complete list of object types when prompting this command, position the cursor on the field for this parameter and press F4 (Prompt). For a description of the object types, see "Object types" in the CL topic collection in the Programming category in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/.

Exemples

Exemple 1 : Vidage du contenu d'un fichier Example 1: Dumping File Contents

DMPOBJ   OBJ(ORDENT/ORDERIN)  OBJTYPE(*FILE)

Cette commande vide le contenu du fichier nommé ORDERIN stocké dans la bibliothèque ORDENT. This command dumps the contents of the file named ORDERIN that is stored in the ORDENT library.

Exemple 2 : Vidage d'un programme Example 2: Dumping a Program

DMPOBJ   OBJ(MYPROG)  OBJTYPE(*PGM)

Cette commande vide la première copie du programme MYPROG trouvée dans la liste de bibliothèques. Le vidage est placé en spoule dans le fichier de sortie imprimante QPSRVDMP. This command dumps the first copy of the program MYPROG that is found in the library list. The dump is spooled to the printer output file QPSRVDMP.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPF3560: Le travail en cours de maintenance n'est pas en cours d'exécution. Job being serviced not running.
CPF3561: Le contexte &8 &9 &7 est introuvable. Context &8 &9 &7 not found.
CPF3562: L'objet &7 est introuvable. Object &7 not found.
CPF3673: Vous n'êtes pas autorisé à la bibliothèque &7. Not authorized to library &7.
CPF3909: La commande de service ne sera pas traitée. Service command will not be processed.
CPF3918: La demande de service a été annulée. Service request canceled.
CPF3925: Impossible d'ouvrir le fichier &1. Cannot open file &1.
CPF3935: Le travail en cours de maintenance s'est terminé pendant le vidage. Job being serviced ended during dump.
CPF3946: Contexte endommagé. Context damaged.
CPF3947: La bibliothèque &7 n'est pas disponible. Library &7 not available.
CPF3948: La bibliothèque &3 a déjà été supprimée. Library &3 previously deleted.
CPF3949: La bibliothèque &7 est endommagée. Library &7 damaged.
CPF3950: Le message d'erreur &2 a été reçu pour le fichier &1. La demande a pris fin. Error message &2 received for file &1. Request ended.
CPF3951: Le fichier &1 ne peut pas être remplacé temporairement par le nom de fichier &2. File &1 cannot be overridden by file name &2.
CPF3967: Le vidage n'a pas démarré car le travail en maintenance n'est pas en cours d'exécution. Dump not started because serviced job not running.
CPF3968: Le vidage n'a pas démarré car le travail en maintenance a fini de s'exécuter. Dump not started because serviced job completed running.
CPF3969: Erreur lors de la fermeture du fichier &1. La sortie peut être incomplète. Error during close of file &1. Output may not be complete.