DMPSYSOBJ

La commande Vider objet système (DMPSYSOBJ) est utilisée principalement pour diverses tâches d'analyse des incidents. Elle vide le contenu ou les attributs d'objets système de l'interface machine (MI) dans un fichier imprimante spoule nommé QPSRVDMP. Tout objet MI stocké dans un contexte quelconque ou adressable via un objet stocké dans un contexte peut être vidé. The Dump System Object (DMPSYSOBJ) command is used primarily for various problem analysis tasks. It dumps the contents or attributes of machine interface (MI) system objects to a spooled printer file named QPSRVDMP. Any MI object that is stored in any context or that is addressable through an object stored in a context can be dumped.

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 chaque objet à vider. object operational (*OBJOPR) authority for each object to be dumped.
  • droit d'exécution (*EXECUTE) sur la bibliothèque de chaque objet à vider. execute (*EXECUTE) authority to the library of each 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

Objet (OBJ)

Indique les objets système à vider. Vous pouvez indiquer le nom d'un objet spécifique, le nom générique d'un groupe d'objets, l'espace de contrôle de processus du travail, le contexte machine ou tous les objets d'un contexte. Si un nom de bibliothèque est indiqué, la bibliothèque est vidée, mais pas les objets qu'elle contient. Si QTEMP est indiqué ici avec soit *LIB dans le paramètre Type d'objet (OBJTYPE), soit 04 dans le paramètre Type d'objet interne (TYPE) et 01 dans le paramètre Sous-type d'objet interne (SUBTYPE), le contexte temporaire du travail associé au travail à partir duquel cette commande est entrée, ou au travail en cours de maintenance à la suite de la commande Démarrer travail de service (STRSRVJOB), est vidé. Dans les deux cas, la valeur du paramètre Contexte ou bibliothèque (CONTEXT) est ignorée. Specifies which of the system objects are to be dumped. The name of a specific object, the generic name of a group of objects, the process control space of the job, the machine context, or all of the objects in a context can be specified. If a library name is specified, the library is dumped, but not the objects in it. If QTEMP is specified here along with either *LIB on the Type d'objet (OBJTYPE) parameter, or 04 on the Type d'objet interne (TYPE) parameter and 01 on the Sous-type d'objet interne (SUBTYPE) parameter, then the temporary job context associated with the job that this command is entered from, or the job being serviced as a result of the Start Service Job (STRSRVJOB) command, is dumped. In either case, the Contexte ou bibliothèque (CONTEXT) parameter value is ignored.

*PCS

The process control space of the current job or that of the job being serviced as a result of the Start Service Job (STRSRVJOB) command is dumped. *PCS specified here can be used with the Positions hexadécimales (OFFSET) parameter and the Zone d'espace à clicher (SPACE) parameter to dump objects in the job structure. If *PCS is specified, the following parameters are ignored:

• Type d'objet (paramètre OBJTYPE). Type d'objet (OBJTYPE parameter).
• Sous-type d'objet interne (paramètre SUBTYPE). Sous-type d'objet interne (SUBTYPE parameter).
• Type d'objet interne (paramètre TYPE). Type d'objet interne (TYPE parameter).
• Contexte ou bibliothèque (CONTEXT parameter).

*MCHCTX

Le contexte machine (qui contient la liste des objets du contexte) est vidé. Si *MCHCTX est indiqué ici, tous les autres paramètres de cette commande sont ignorés. The machine context (which contains a list of the objects in the context) is dumped. If *MCHCTX is specified here, all the other parameters in this command are ignored.

*ALL

Tous les objets système du contexte indiqué sont vidés s'ils répondent aux exigences indiquées dans le paramètre OBJTYPE ou dans les paramètres TYPE et SUBTYPE. All the system objects in the specified context are dumped if they match the requirements specified on either the OBJTYPE parameter or the TYPE and SUBTYPE parameters.

nom-générique

Indiquez le nom d'objet générique qui identifie le groupe d'objets système à vider. Un nom d'objet peut comporter jusqu'à 30 caractères. Specify the generic object name that identifies the group of system objects to dump. An object name can have as many as 30 characters in it.

nom

Specify the name of the object that is to be dumped. A maximum of 30 characters can be entered. If more than one object has the same name, all objects having that name and matching the attributes specified are dumped.

Si un objet spécifique est vidé, des valeurs doivent être indiquées pour l'un des groupes de paramètres suivants : If a specific object is being dumped, values should be specified for on one of the following groups of parameters:

• CONTEXT, TYPE et SUBTYPE CONTEXT, TYPE, and SUBTYPE
• CONTEXT et OBJTYPE CONTEXT and OBJTYPE

Contexte ou bibliothèque (CONTEXT)

Indique dans quel contexte ou quelle bibliothèque se trouvent les objets à vider. Specifies in which context or library the objects to be dumped are located.

*NONE

L'objet indiqué dans le paramètre Objet (OBJ) ne se trouve dans aucun contexte. *NONE n'est valide que si *PCS ou *MCHCTX est indiqué ou pris par défaut pour le paramètre OBJ, ou si QTEMP est indiqué pour OBJ avec soit *LIB pour le paramètre OBJTYPE, soit 04 pour le paramètre TYPE et 01 pour le paramètre SUBTYPE. The object specified on the Objet (OBJ) parameter is not in any context. *NONE is valid only if *PCS or *MCHCTX is specified or defaulted for the OBJ parameter, or if QTEMP is specified on the OBJ along with either *LIB for the OBJTYPE parameter, or 04 for the TYPE parameter and 01 for the SUBTYPE parameter.

*MCHCTX

Les objets à vider se trouvent dans le contexte machine. Les types d'objets du système d'exploitation suivants, dont les noms d'objets système sont indiqués entre parenthèses, ne peuvent résider que dans le contexte machine : bibliothèque (contexte), profil utilisateur, description d'unité, description de ligne, description d'interface réseau et description de contrôleur. *MCHCTX n'est valide que si l'un de ces cinq types d'objets est vidé. The objects to dump are in the machine context. The following operating system object types, whose system object names are given in parentheses, can reside only in the machine context: library (context), user profile, device description, line description, network interface description, and controller description. *MCHCTX is valid only if one of these five object types is dumped.

nom

Indiquez le nom du contexte contenant les objets à vider. Le nom d'une bibliothèque, telle que QGPL ou QTEMP, peut être indiqué. Si QTEMP est indiqué, les objets à vider se trouvent dans le contexte temporaire du travail associé au travail à partir duquel cette commande est entrée, ou au travail en cours de maintenance à la suite de la commande Démarrer travail de service (STRSRVJOB). Specify the name of the context containing the objects being dumped. The name of a library, such as QGPL or QTEMP, can be specified. If QTEMP is specified, the objects to dump are in the temporary job context associated with the job that this command is entered from or the job being serviced as a result of the Start Service Job (STRSRVJOB) command.

Type d'objet interne (TYPE)

Indique le type d'objets MI à vider. Specifies the type of MI objects to dump.

*ALL

Tous les types d'objets du contexte indiqué qui portent le nom indiqué (s'il est utilisé) sont vidés. All object types in the specified context that have the specified name (if used) are dumped.

MI-system-object-type-in-hex

Indiquez la valeur hexadécimale qui précise le type d'objets système à vider. La valeur doit être indiquée avec ses deux caractères, mais elle n'a pas besoin d'être placée entre apostrophes. Specify the hexadecimal value that specifies the type of system objects to dump. The value must be specified with both characters, but it does not have to be enclosed in apostrophes.

Sous-type d'objet interne (SUBTYPE)

Indique le sous-type des objets MI indiqués à vider, ou indique que tous les sous-types sont vidés. Ce paramètre n'est valide que si le paramètre Type d'objet interne (TYPE) est également indiqué. Specifies the subtype of the specified MI objects to dump, or specifies that all subtypes are being dumped. This parameter is valid only if the Type d'objet interne (TYPE) parameter is also specified.

*ALL

Tous les sous-types des objets indiqués sont vidés. All the sub-types of the specified objects are dumped.

MI-system-object-subtype-in-hex

Indiquez le sous-type spécifique des objets système à vider. Les sous-types sont compris entre 00 et FF. Toutefois, le sous-type indiqué doit correspondre à un objet MI réellement présent dans le contexte indiqué. Si *ALL est indiqué pour le paramètre TYPE, un sous-type spécifique ne peut pas être indiqué. Specify the specific subtype of the system objects to dump. The subtypes are in the range of 00 through FF. However, the subtype specified must be for an MI object actually in the specified context. If *ALL is specified on the TYPE parameter, a specific subtype cannot be specified.

Type d'objet (OBJTYPE)

Indique le type d'objet des objets du système d'exploitation dont les objets système MI associés doivent être vidés. Si un type d'objet est indiqué, des valeurs ne peuvent être indiquées ni pour le paramètre Type d'objet interne (TYPE) ni pour le paramètre Sous-type d'objet interne (SUBTYPE). Specifies the object type of the operating system objects to have their associated MI system objects dumped. If an object type is specified, values cannot be specified on either the Type d'objet interne (TYPE) parameter or the Sous-type d'objet interne (SUBTYPE) parameter.

*ALL

Les objets MI indiqués de tous les types d'objets du système d'exploitation sont vidés. The specified MI objects of all operating system object types are dumped.

operating-system-object-type

Specify the Operating System object type for the objects 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/.

Positions hexadécimales (OFFSET)

Indique une liste de valeurs à utiliser comme décalages pour adresser indirectement un objet unique qui est vidé. Les valeurs doivent être des valeurs hexadécimales positives ou des zéros qui, ajoutés à un pointeur, donnent des adresses valides. Si un décalage de zéro est ajouté à un pointeur système, le résultat est un pointeur vers le début de l'espace associé à l'objet adressé par le pointeur système. Specifies a list of values to use as offsets to indirectly address a single object that is being dumped. The values must be positive hexadecimal values or zeros that, when added to a pointer, result in valid addresses. If an offset of zero is added to a system pointer, the result is a pointer to the start of the space associated with the object that is addressed by the system pointer.

Valeurs uniques

*NONE

Aucun décalage n'est indiqué. L'objet localisé via le contexte est vidé. No offset is specified. The object located through the context is dumped.

Autres valeurs

X'00000000'-X'00FFFFFF'

Indiquez la liste des décalages de pointeurs à utiliser pour adresser l'objet ou l'espace à vider. Vous pouvez indiquer 50 valeurs de décalage au maximum. Specify the list of offsets to pointers to use to address the object or space to dump. A maximum of 50 offset values can be specified.

Zone d'espace à clicher (SPACE)

Indique la zone d'un espace ou d'un espace associé à vider. L'espace est désigné par le pointeur final déterminé par le paramètre Positions hexadécimales (OFFSET). Si aucune valeur n'est indiquée pour le paramètre OFFSET, le pointeur final est un pointeur système vers l'objet indiqué dans le contexte. Specifies the area of a space or associated space to be dumped. The space is pointed to by the final pointer determined by the Positions hexadécimales (OFFSET) parameter. If no value is specified for the OFFSET parameter, the final pointer is a system pointer to the specified object in the context.

Valeurs uniques

*

Si le pointeur final est un pointeur système, l'objet désigné par ce pointeur est vidé. Si le pointeur final est un pointeur d'espace, la partie de l'espace qui commence à l'emplacement désigné par ce pointeur est vidée. If the final pointer is a system pointer, the object pointed to by that pointer is dumped. If the final pointer is a space pointer, the portion of the space that starts at the location pointed to by that pointer is dumped.

Élément 1: Position hexadécimale

X'00000000'-X'00FFFFFF'

Indiquez la valeur à ajouter au pointeur final pour désigner le début de la zone à vider. La valeur indiquée doit être une valeur hexadécimale positive ou zéro et, ajoutée au pointeur final, doit donner une adresse valide. Specify the value to add to the final pointer to point to the beginning of the area to dump. The value specified must be a positive hexadecimal value or zero and, when added to the final pointer, must result in a valid address.

Élément 2: Longueur hexadécimale ou *

*

Le reste de l'espace désigné par la valeur de décalage est vidé. The rest of the space pointed to as a result of the offset value is being dumped.

X'00000000'-X'00FFFFFF'

Indiquez une valeur hexadécimale positive qui précise la longueur de la zone à vider. Si la longueur indiquée est supérieure à la longueur réelle de l'espace, seul l'espace réellement disponible est vidé. Specify a positive hexadecimal value that specifies the length of the area to dump. If the length specified is greater than the actual length of the space, only the actual space available is dumped.

Exemples

Exemple 1 : Vidage d'index Example 1: Dumping Indexes

DMPSYSOBJ  OBJ(*ALL)  CONTEXT(QTEMP)  TYPE(0E)

Cette commande vide le contenu et les attributs de tous les index du contexte temporaire du travail dans un fichier spoule en vue de leur impression. Les index MI sont identifiés par le code de type 0E. This command dumps the contents and attributes of all the indexes in the temporary job context to a spooled file for printing. MI indexes are identified by the type code 0E.

Exemple 2 : Vidage d'une description d'unité Example 2: Dumping a Device Description

DMPSYSOBJ  OBJ(WS1)  CONTEXT(*MCHCTX)  OBJTYPE(*DEVD)

Cette commande vide la description d'unité du poste de travail WS1, qui est stockée dans le contexte machine. This command dumps the device description for work station WS1, which is stored in the machine context.

Exemple 3 : Vidage de l'espace de contrôle de processus Example 3: Dumping Process Control Space

DMPSYSOBJ   OBJ(*PCS)  SPACE(0  1000)

Cette commande vide le bloc de contrôle des travaux de l'espace associé à l'espace de contrôle de processus du travail. This command dumps the work control block from the space associated with the process control space for the job.

Exemple 4 : Deux exemples d'indication de valeurs de décalage Example 4: Two Samples Specifying Offset Values

DMPSYSOBJ  OFFSET(1F0)

Cette commande vide la file d'attente de messages du travail. This command dumps the job message queue.

DMPSYSOBJ  OBJ(QINTER)  CONTEXT(QSYS)  OBJTYPE(*SBSD)
           OFFSET(1D0 310 D0)

Cette commande vide l'enregistreur de vol d'un sous-système actif. This command dumps the flight recorder of an active subsystem.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPF3502

Aucun objet imprimé car aucun objet n'a été trouvé. No objects printed because no objects found.

CPF3508

La valeur SUBTYPE (&5) n'est pas autorisée. SUBTYPE (&5) value is not permitted.

CPF3523

Le décalage de départ &8 est supérieur à la taille de l'espace. Starting offset &8 greater than size of space.

CPF3534

Vous n'êtes pas autorisé à l'objet. Not authorized to object.

CPF3537

L'objet &2 est endommagé. Object &2 is damaged.

CPF3538

Impossible d'allouer l'objet. Cannot allocate object.

CPF3539

L'objet a été détruit pendant le vidage. Object destroyed while being dumped.

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.

CPF3563

La valeur de débordement du fichier &1 dans &2 est trop grande. Overflow value for file &1 in &2 too large.

CPF3566

Aucun objet vidé car aucun objet n'a été trouvé. No objects dumped because no objects found.

CPF3577

L'objet de données &7 est introuvable. Data object &7 not found.

CPF3578

L'objet de données de base &7 est introuvable. Base data object &7 not found.

CPF3642

L'adresse du pointeur de chaînage &7 n'est pas autorisée. Address of chain pointer &7 not permitted.

CPF3643

L'adresse du pointeur de chaînage &7 n'est pas alignée sur 16 octets. Address for chain pointer &7 not 16-byte aligned.

CPF3644

L'objet de base &7 n'a pas d'espace associé. Base object &7 has no associated space.

CPF3645

Vous n'êtes pas autorisé à l'objet de base &7. Not authorized to base object &7.

CPF3646

L'objet de base &2 est endommagé. Base object &2 is damaged.

CPF3647

L'objet de base &8 ou l'objet de base précédent a été détruit. Base object &8 or previous base object destroyed.

CPF3648

La zone de données de l'objet de base &2 est introuvable. Base object &2 data area not found.

CPF3649

Le pointeur de chaînage &7 n'existe pas à l'emplacement indiqué. Chaining pointer &7 does not exist at location specified.

CPF3650

Le pointeur de chaînage &7 est un pointeur d'instruction. Chaining pointer &7 is instruction pointer.

CPF3651

Le décalage est trop grand pour l'objet de base &7. Offset too large for base object &7.

CPF3652

Le décalage vers le dernier pointeur de chaînage est trop grand. Offset to last chaining pointer too large.

CPF3653

L'emplacement du dernier pointeur de chaînage n'est pas aligné sur 16 octets. Location for last chaining pointer not 16-byte aligned.

CPF3654

L'objet &2 est endommagé. Object &2 is damaged.

CPF3655

Le dernier objet de base ou l'objet final a déjà été supprimé. Last base object or final object previously deleted.

CPF3656

La zone de données de l'objet de base &2 est introuvable. Base object &2 data area not found.

CPF3663

Le numéro d'objet de base &7 est introuvable. Base object number &7 not found.

CPF3664

L'objet &2 n'a pas d'espace associé. Object &2 has no associated space.

CPF3665

Vous n'êtes pas autorisé à vider l'objet &2. Not authorized to dump object &2.

CPF3666

L'objet &2 est endommagé. Object &2 is damaged.

CPF3667

L'objet à vider a été détruit. Object to be dumped was destroyed.

CPF3668

La zone de données de l'objet &2 est introuvable. Object &2 data area not found.

CPF3669

Le pointeur final n'existe pas à l'emplacement indiqué. Final pointer does not exist at specified location.

CPF3670

Le pointeur final est un pointeur d'instruction. Final pointer is instruction pointer.

CPF3671

Le décalage de départ &8 est trop grand. Starting offset &8 too large.

CPF3672

L'objet désigné par le pointeur final est introuvable. Object specified by final pointer 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.

CPF3913

Le contexte &7 a déjà été supprimé. Context &7 previously deleted.

CPF3914

La zone de données du contexte &7 est introuvable. Context &7 data area not found.

CPF3915

Le contexte &7 est endommagé. Context &7 damaged.

CPF3916

Le contexte &7 n'est pas disponible. Context &7 not available.

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.

CPF3941

CONTEXT(*MCHCTX) et TYPE(&4) ne peuvent pas être utilisés ensemble. CONTEXT(*MCHCTX) and TYPE(&4) cannot be used together.

CPF3942

CONTEXT(*MCHCTX) et OBJTYPE(*&6) ne peuvent pas être utilisés ensemble. CONTEXT(*MCHCTX) and OBJTYPE(*&6) cannot be used together.

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.