DCPOBJ

La commande DCPOBJ (Décomprimer un objet) permet de décomprimer définitivement les programmes, groupes de panneaux, menus, fichiers écran, fichiers imprimante, modules et programmes de service.

• Les objets comprimés occupent moins de place en mémoire que ceux qui ne le sont pas. Lorsqu'un objet ou un programme comprimé est respectivement utilisé ou appelé, l'utilisateur dispose automatiquement d'une version décomprimée de l'objet.
• Les objets décomprimés utilisent la mémoire système qui leur est allouée et sont à l'état final, prêts à être utilisés.
• Un objet décomprimé provisoirement correspond à une copie provisoirement décomprimée d'un objet comprimé. Le système alloue l'espace mémoire nécessaire aux copies provisoires tant que l'utilisateur ou le système n'indique pas que cette mémoire doit être récupérée.

  La mémoire temporaire est automatiquement récupérée lorsque :

  • la commande RCLTMPSTG est exécutée
  • l'IPL suivant est lancé
  • l'objet est utilisé suffisamment souvent pour que le système le décomprime définitivement

  Lorsqu'un objet est définitivement décomprimé, sa version comprimée est supprimée ainsi que toutes les formes temporaires de l'objet ; cependant, les versions comprimées sont conservées intactes tant que les objets sont décomprimés provisoirement.

Restriction : L'utilisateur doit disposer du droit *USE sur les objets indiqués dans la commande et du droit d'exécution sur la bibliothèque contenant les objets.

Paramètres

Objet (OBJ)

Indique le nom et la bibliothèque de l'objet à décomprimer.

Ce paramètre est obligatoire.

Les valeurs possibles sont les suivantes :

*ALL

Tous les objets de la bibliothèque indiquée dont le type figure en regard de l'invite Type d'objet (paramètre OBJTYPE) sont décomprimés.

nom-objet-générique*

Indiquez le nom générique de l'objet à décomprimer. Un nom générique est une chaîne d'un ou plusieurs caractères suivis d'un astérisque (*).

nom-objet

Indiquez le nom de l'objet à décomprimer.

Pour la bibliothèque, les valeurs possibles sont :

*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.

*USRLIBL

S'il existe un poste de bibliothèque en cours dans la liste des bibliothèques de l'unité d'exécution en cours, la recherche porte sur celle-ci ainsi que sur les bibliothèques de la partie utilisateur de la liste des bibliothèques. Dans le cas contraire, la recherche porte uniquement sur les bibliothèques de la partie utilisateur de la liste des bibliothèques.

*CURLIB

La recherche s'effectue uniquement dans la bibliothèque en cours. Si celle-ci n'est pas définie dans la liste des bibliothèques, QGPL est prise par défaut.

*ALL

La recherche porte sur toutes les bibliothèques du système, y compris QSYS.

*ALLUSR

La recherche porte sur toutes les bibliothèques utilisateur. La recherche porte sur toutes les bibliothèques dont le nom ne commence pas par la lettre Q, à l'exception des bibliothèques suivantes :

#CGULIB     #DSULIB     #SEULIB
#COBLIB     #RPGLIB
#DFULIB     #SDALIB

Bien que les bibliothèques Qxxx suivantes soient fournies par IBM, elles contiennent généralement des données utilisateur qui sont fréquemment modifiées. Par conséquent, ces bibliothèques sont considérées comme des bibliothèques utilisateur et sont donc recherchées :

QDSNX       QRCLxxxxx   QUSRDIRDB   QUSRVI
QGPL        QSRVAGT     QUSRIJS     QUSRVxRxMx
QGPL38      QSYS2       QUSRINFSKR  QWQCENT
QMGTC       QSYS2xxxxx  QUSRNOTES   QWQREPOS
QMGTC2      QS36F       QUSROND
QMPGDATA    QUSER38     QUSRPOSGS
QMQMDATA    QUSRADSM    QUSRPOSSA
QMQMPROC    QUSRBRM     QUSRPYMSVR
QPFRDATA    QUSRDIRCF   QUSRRDARS
QRCL        QUSRDIRCL   QUSRSYS

1. 'xxxxx' représente le numéro de l'ASP principal.
2. L'utilisateur peut créer une bibliothèque de nom différent, au format QUSRVxRxMx, pour chacune des éditions précédentes prises en charge par IBM, afin d'y stocker les commandes utilisateur à compiler dans un programme CL pour une édition précédente. En ce qui concerne la bibliothèque utilisateur QUSRVxRxMx, VxRxMx correspond à une version, édition et niveau de modification précédents encore admis par IBM.

nom-bibliothèque

Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.

Type d'objet (OBJTYPE)

Indique le type d'objet à décomprimer. Vous pouvez indiquer *ALL, ou l'une ou plusieurs des autres valeurs possibles.

Ce paramètre est obligatoire.

Les valeurs possibles sont les suivantes :

*ALL

Tous les menus, groupes de panneaux, fichiers écran et imprimante, programmes, modules et programmes de service dont le nom et la bibliothèque figurent en regard de l'invite Objet (paramètre OBJ) sont décomprimés.

*FILE

Les fichiers écran et imprimante dont le nom et la bibliothèque figurent en regard de l'invite Objet (paramètre OBJ) sont décomprimés.

*MENU

Les menus dont le nom et la bibliothèque figurent en regard de l'invite Objet (paramètre OBJ) sont décomprimés.

*MODULE

Les modules dont le nom et la bibliothèque figurent en regard de l'invite Objet (paramètre OBJ) sont décomprimés.

*PGM

Les programmes dont le nom et la bibliothèque figurent en regard de l'invite Objet (paramètre OBJ) sont décomprimés.

*PNLGRP

Les noms de groupes de panneaux dont le nom et la bibliothèque figurent en regard de l'invite Objet (paramètre OBJ) sont décomprimés.

*SRVPGM

Les programmes de service dont le nom et la bibliothèque figurent en regard de l'invite Objet (paramètre OBJ) sont décomprimés.

Option de programme (PGMOPT)

Indique si la totalité du programme ou du programme de service ou seulement le flot d'instructions est décomprimé. Pour que ce paramètre soit correct, *PGM, *SRVPGM ou *ALL doit être indiqué en regard de l'invite Type d'objet (paramètre OBJTYPE).

Les valeurs possibles sont les suivantes :

*ALL

La totalité du programme ou du programme de service (flot d'instructions et informations observables) est décomprimée.

Remarque :Pour plus d'informations sur les informations observables, reportez-vous à l'aide sur les commandes CHGPGM et CHGSRVPGM.

*INS

Seul le flot d'instructions du programme ou du programme de service est décomprimé.

Exemples

DCPOBJ   OBJ(QGPL/*ALL)  OBJTYPE(*FILE)

Cette commande permet de décompresser tous les fichiers écran et imprimante compressés dans la bibliothèque QGPL.

Messages d'erreur

Messages *ESCAPE

CPF2110

Bibliothèque &1 non trouvée.

CPF2113

Impossible d'allouer la bibliothèque &1.

CPF2176

Bibliothèque &1 endommagée.

CPF3B01

Impossible de comprimer/décomprimer l'objet &1 de &2.

CPF3B02

Impossible de comprimer/décomprimer le fichier &1 de &2.

CPF3B05

Aucun objet décomprimé.

CPF3B06

&1 objets décomprimés ; &3 non décomprimés ; &8 non compris.

CPF3B08

Impossible d'allouer objet &1 de &2.

CPF8108

Fichier unité ou sauvegarde &4 de &9 endommagé.

CPF812E

Module &4 de &9 endommagé.

CPF8129

Programme &4 de &9 endommagé.

CPF813D

Programme de service &4 de &9 endommagé.

CPF8150

Groupe de panneaux &4 de &9 endommagé.

CPF8151

Menu &4 de &9 endommagé.

CPF9570

Erreur lors de l'accès aux données de débogage ou lors de leur création.

CPF9802

Non autorisé à l'objet &2 de &3.

CPF9803

Impossible d'allouer l'objet &2 de la bibliothèque &3.

CPF9804

Objet &2 dans bibliothèque &3 endommagé.

CPF9806

Impossible d'exécuter fonction pour objet &2 de &3.

CPF9807

Une ou plusieurs bibliothèques de la liste ont été supprimées.

CPF9808

Allocation impossible pour une ou plusieurs bibliothèques de la liste.

CPF9811

Programme &1 non trouvé dans la bibliothèque &2.

CPF9812

Fichier &1 non trouvé dans la bibliothèque &2.

CPF9821

Non autorisé au programme &1 de &2.

CPF9822

Non autorisé au fichier &1 de &2.

CPF9838

Limite mémoire du profil utilisateur dépassée.