Use this command to clear an image or initial program load (IPL) definition
from the system. This message undefines the image or IPL
area and marks it as empty.
Requirements and Restrictions
- You cannot clear an IPL area if it is referenced by an enabled
image.
- You must disable an image before you can clear it. If the image has
logical references from other images, you must also disable those other
images.
- You must use the BP parameter when clearing an image if there are logical
references to that image from other images. If you do not specify the
BP parameter when it is required, a message is displayed that indicates the
logical references exist.
Format
- image
- is the 5- to 8-character alphanumeric name of the image you want to clear
from the TPF system.
- IPL i
- is the number of the IPL area you want to clear from the TPF
system. The valid range for this number is 1 to the number of IPL areas
generated, which can be a maximum of 4.
- Note:
- You can specify this parameter only for the basic subsystem (BSS).
- BP
- clears an image that is logically referenced from other images.
These other images fall back to their physical copies of the logical
references, if they exist.
Additional Information
- Online help information is available for this command. To display
the help information, enter one of the following:
ZIMAG HELP
ZIMAG ?
- If you clear an image from the TPF system, you cannot use that image again
until you define it using the ZIMAG DEFINE command. You must also load
or copy the image pointer record (CTKX) and all core image restart area (CIMR)
components to the image.
Examples
The definition for the IMAGE001 image is cleared from the TPF system in the
following example.
+--------------------------------------------------------------------------------+
|User: ZIMAG CLEAR IMAGE001 |
| |
|System: IMAG0006I 19.39.59 IMAGE DEFINITION FOR IMAGE001 CLEARED |
+--------------------------------------------------------------------------------+
IPL area 2 is cleared from the TPF system in the following example.
+--------------------------------------------------------------------------------+
|User: ZIMAG CLEAR IPL 2 |
| |
|System: IMAG0026I 19.39.59 IPL AREA 2 CLEARED |
+--------------------------------------------------------------------------------+
Related Information
See TPF System Installation Support Reference and
TPF System Generation for more information about TPF
images.