Use this command to do the following:
- Physically copy the image pointer record (CTKX) from a source image to a
target image.
- Physically or logically copy core image restart area (CIMR) components
from a source image to a target image. Dump override tables can also be
copied along with CIMR components. See the last bullet in Requirements and Restrictions for more information.
- Physically copy initial program load (IPL) areas or program areas from a
source image to a target image.
If you perform a logical copy, the target image simply
references the components in the source image. If you perform a
physical copy, the components are actually copied to the target
image and there is no reference to the components in the source image.
Requirements and Restrictions
- The target image must be disabled.
- When copying IPL areas or program areas:
- The source image must be enabled.
- The target image cannot be referenced by an enabled image.
- The contents of the program areas are not validated before they are
copied. In addition, the compatibility of the programs with the IPAT on
the target image is not verified.
- You can copy CIMR components to a target image only after you load or copy
CTKX to that target image.
- You can copy CIMR components from the source image only if the components
exist as physical copies in the source image, not logical copies.
- You can physically copy CIMR components from the source image only if the
sizes of the components in the source image are smaller than or equal to the
allocated sizes of the components in the target image.
- You cannot copy the CPS0, ACPL, ICDF and USR1 components in a nonbasic
subsystem.
- You must specify both the COMPONENTS ALL and PHYSICAL parameters to copy
dump override tables for all genned processors.
Format
- simage
- is the 5- to 8-character alphanumeric name of the source image.
- timage
- is the 5- to 8-character alphanumeric name of the target image.
- CTKX
- physically copies CTKX from the source image to the target image.
All existing logical references to CIMR components are preserved.
- COmponents
- copies one or more CIMR components from the source image to the target
image.
- component
- is the name of a CIMR component that you want to copy to the target
image. Valid components in the basic subsystem (BSS) are: CPS0,
FCTB, RIAT, SIGT, ICDF, ACPL, IPAT, USR1, and USR2. Valid components in
nonbasic subsystems are: FCTB, RIAT, SIGT, IPAT, and USR2.
- ALL
- copies all the CIMR components from the source image to the target
image. Keep in mind that CIMR components are copied from the source
image only if:
- The components are physical copies in the source image, not logical
copies.
- The sizes of the components in the source image are smaller than or equal
to the allocated sizes of the components in the target image.
- This parameter is specified along with the PHYSICAL parameter. When
both the ALL and PHYSICAL parameters are specified the dump override tables
are copied from the source image to the target image.
- LOGical
- logically copies CIMR components from the source image to the target
image.
- PHYsical
- physically copies CIMR components from the source image to the target
image. Physical copies overwrite any existing logical copies in the
target image. If this parameter is specified along with the COMPONENTS
ALL parameter, the dump override tables are copied from the source image to
the target image.
- IPL
- physically copies the IPL areas from the source image to the target
image.
- PROGram
- physically copies the program areas from the source image to the target
image. Program version (PVR) records and ADATA file (APRG) records are
also copied if they exist on both the source image and the target
image.
- Note:
- The E-type loader structures are initialized on the target image when
the program areas are copied from the source image.
- BP
- allows you to copy program areas when the target image has fewer program
records allocated than the source image.
Additional Information
Online help information is available for this command. To display
the help information, enter one of the following:
ZIMAG HELP
ZIMAG ?
Examples
CTKX is physically copied from the IMAGE001 image to the IMAGE003 image in
the following example.
+--------------------------------------------------------------------------------+
|User: ZIMAG COPY IMAGE001 IMAGE003 CTKX |
| |
|System: IMAG0007I 19.39.59 COPY FROM IMAGE001 TO IMAGE003 COMPLETE |
+--------------------------------------------------------------------------------+
The CPS0 and RIAT CIMR components are logically copied from the IMAGE001
image to the IMAGE003 image in the following example.
+--------------------------------------------------------------------------------+
|User: ZIMAG COPY IMAGE001 IMAGE003 COMP CPS0.RIAT LOGICAL |
| |
|System: IMAG0007I 19.39.59 COPY FROM IMAGE001 TO IMAGE003 COMPLETE |
+--------------------------------------------------------------------------------+
Related Information
See TPF System Installation Support Reference and
TPF System Generation for more information about TPF
images.