gtpo1m7aOperations

ZIMAG DEFINE-Define a TPF Image

Use this command to define an empty image or to redefine an existing image.

You define an image by associating an initial program load (IPL) area and a program area with the image. You redefine an image by changing the IPL area, program area, or both areas that are already associated with the image.

Note:
A core image restart area (CIMR) is also associated with the image. You do not have to specify the CIMR because there is a one-to-one correspondence between images and CIMR areas.

Requirements and Restrictions

You must disable an existing image before you can redefine it. Use the ZIMAG DISABLE command to disable the image.

Format




image
is the 5- to 8-character alphanumeric name of the image. TPF01 is a reserved name used only for image 1.
Note:
When redefining an image you must use the existing image name.

Number n
is the image number (or CIMR area) you want to associate with the image. The valid range for this number is 1-8. All the image numbers may not be available, depending on your system configuration.

IPL i
is the initial program load (IPL) area number you want to associate with the image. The valid range for this number is 1-4. All the IPL area numbers may not be available, depending on your system configuration.
Note:
You can specify this parameter only for the basic subsystem (BSS).

PROGram p
is the program area number you want to associate with the image. The valid range for this number is 1-8. All the program area numbers may not be available, depending on your system configuration.

Additional Information

Examples

In the following example, the IMAGEABC image is defined as image number 1, which consists of IPL area 2, program area 5, and CIMR area 1.

+--------------------------------------------------------------------------------+
|User:   ZIMAG DEF IMAGEABC NUM 1 IPL 2 PROG 5                                   |
|                                                                                |
|System: IMAG0001I 19.39.59 IMAGE 1 DEFINED                                      |
|        IMAGE NAME IMAGEABC                                                     |
|        IPL AREA 2                                                              |
|        PROGRAM AREA 5                                                          |
+--------------------------------------------------------------------------------+

In the following example, the IMAGEABC image is redefined to use IPL area 3. The program area remains the same.

+--------------------------------------------------------------------------------+
|User:   ZIMAG DEF IMAGEABC NUM 1 IPL 3                                          |
|                                                                                |
|System: IMAG0002I 19.39.59 IMAGE 1 REDEFINED                                    |
|        IMAGE NAME IMAGEABC                                                     |
|        IPL AREA 3 - WAS 2                                                      |
|        PROGRAM AREA 5 - WAS 5                                                  |
+--------------------------------------------------------------------------------+

Related Information

See TPF System Installation Support Reference and TPF System Generation for more information about TPF images.