CL Command Reference - CPROBJ
CL Command List > CPROBJ Reference
Description:
The Compress Object (CPROBJ) command allows you to compress 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:
¨C The RCLTMPSTG command is run
¨C The next initial program load (IPL) is run
¨C 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.
Restrictions:
1. The user must have *OBJMGT authority to the object specified and *EXECUTE authority to the library containing the object.
2. Objects that were saved with storage freed cannot be compressed or decompressed.
3. Objects that are compressed cannot be saved for a release prior to Version 2, Release 1 of the operating system.
4. Programs without a valid validation value are not compressed.
5. Programs that were created before Version 1, Release 3 of the operating system and have not been retranslated (using the Change Program (CHGPGM) command) can not be compressed because no validation value has been generated.
6. A program, service program, or module that was created prior to Version 3, Release 6 of the operating system must be retranslated before the object can be compressed. Retranslate the object using the CHGPGM, CHGSRVPGM, or CHGMOD commands.
7. To compress a system program, the user must end all active subsystems.
8. To prevent abnormal end of a program, the program must not be running in the system when it is compressed.
Examples:
CPROBJ OBJ(QGPL/*ALL) OBJTYPE(*FILE)
This command compresses all display and printer files in library QGPL.