DCPOBJ (Decompress Object)

DCPOBJ Command syntax diagram

 

Purpose

The Decompress Object (DCPOBJ) command decompresses programs, panel groups, menus, display files, printer files, modules, and service programs.

• Compressed Objects are objects that consume less storage space than decompressed objects. When a compressed object is used or a compressed program is called, a decompressed version of the object automatically becomes available to the user.
  
• Decompressed Objects are objects that use the system storage space allocated to them and are in a final, ready-to-use state.
  
• Temporarily Decompressed Objects are temporarily decompressed copies of compressed objects. The system allocates storage space for the temporary copies until the system or the user determines that the temporary storage space needs to be reclaimed.

  Temporary storage is automatically reclaimed when:

  • The RCLTMPSTG command is run
    
  • The next initial program load (IPL) is run
    
  • The object is used often enough to cause the system to permanently decompress it

  When an object is permanently decompressed, the compressed version of the object is destroyed as well as any temporary forms of the object; however, compressed versions remain intact as long as the objects are temporarily decompressed.

Restriction: The user must have *USE authority to the objects specified on the command and execute authority to the library containing the objects.

 

Required Parameters

OBJ

Specifies the qualified name of the object to be decompressed.

The name of the object can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

*USRLIBL: Only the libraries in the user portion of the job's library list are searched.

*ALL: All libraries in the system, including QSYS, are searched.

*ALLUSR Libraries

library-name: Specify the name of the library to be searched.

*ALL: All compressed objects in the specified library are decompressed.

generic*-object-name: Specify the generic name of the object. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*. The asterisk substitutes for any valid characters. A generic name specifies all objects with names that begin with the generic prefix for which the user has authority. If an asterisk is not included with the generic (prefix) name, the system assumes it to be the complete object name. If the complete object name is specified, and multiple libraries are searched, multiple objects can be decompressed only if *ALL or *ALLUSR library values can be specified for the name. For more information on the use of generic names, refer to generic names.

object-name: Specify the name of the object that is decompressed.

OBJTYPE

Specifies the type of the object to be decompressed.

*ALL: All compressed menus, panel groups, display and printer device files, programs, modules, and service programs with the specified object name are decompressed.

*FILE: The compressed file with the specified object name is decompressed (display and printer files only).

*MENU: The compressed menu with the specified object name is decompressed.

*MODULE: The compressed module with the specified object name is decompressed.

*PGM: The compressed program with the specified object name is decompressed.

*PNLGRP: The compressed panel group with the specified object name is decompressed.

*SRVPGM: The compressed service program with the specified object name is decompressed.

 

Optional Parameters

PGMOPT

Specifies, for *PGM and *SRVPGM objects, the program option that indicates whether the entire program (instruction stream and observability tables) or only the instruction stream is decompressed.

*ALL: The entire program or service program is decompressed.

*INS: Only the instruction stream of the program or service program is decompressed.

Example for DCPOBJ

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

This command decompresses all compressed display and printer files in library QGPL.

Error messages for DCPOBJ

*ESCAPE Messages

CPF2110

Library &1 not found.

CPF2113

Cannot allocate library &1.

CPF2176

Library &1 damaged.

CPF3B01

Cannot compress or decompress object &1 in &2.

CPF3B02

Cannot compress or decompress file &1 in &2.

CPF3B05

No objects decompressed.

CPF3B06

&1 objects decompressed; &3 not decompressed; &8 not included.

CPF3B08

Cannot allocate object &1 in &2.

CPF8108

Device file or save file &4 in &9 damaged.

CPF812E

Module &4 in &9 damaged.

CPF8129

Program &4 in &9 damaged.

CPF813D

Service program &4 in &9 damaged.

CPF815D

*M36 object &4 in &9 damaged.

CPF815E

*M36CFG object &4 in &9 damaged.

CPF8150

Panel group &4 in &9 damaged.

CPF8151

Menu &4 in &9 damaged.

CPF9570

Error occurred creating or accessing debug data.

CPF9802

Not authorized to object &2 in &3.

CPF9803

Cannot allocate object &2 in library &3.

CPF9804

Object &2 in library &3 damaged.

CPF9806

Cannot perform function for object &2 in library &3.

CPF9807

One or more libraries in library list deleted.

CPF9808

Cannot allocate one or more libraries on library list.

CPF9811

Program &1 in library &2 not found.

CPF9812

File &1 in library &2 not found.

CPF9821

Not authorized to program &1 in library &2.

CPF9822

Not authorized to file &1 in library &2.

CPF9838

User profile storage limit exceeded.