gtpo1m7fOperations

ZIMAG KEYPT-Managing Keypoints

Use this command to do the following:

Requirements and Restrictions

Format




Notes:

  1. The BP parameter is valid only when you specify the MOVE parameter.

Move image
replaces keypoints in the working keypoint area with the appropriate keypoints from the keypoint staging area of the specified image, where image is the 5- to 8-character alphanumeric name of the image. The original keypoints in the working keypoint area are copied to the keypoint backup area before they are replaced.

Restore
replaces keypoints in the working keypoint area with the appropriate keypoints from the keypoint backup area.

Delete
deletes keypoints from the keypoint backup area.

KPT keypoint
is the name of a keypoint you want to move, restore, or delete. Valid keypoints are CTK0, CTK1, CTK2, CTK3, CTK4, CTK5, CTK6, CTK9, CTKA, CTKB, CTKC, CTKD, CTKE, CTKI, CTKM, and CTKV.

KPT ALL
moves, restores, or deletes all of the keypoints in the keypoint staging area.
Note:
If you specify the CPU id parameter, only the processor unique keypoints are moved, restored, or deleted.

CPU id
moves, restores, or deletes only processor unique keypoints for the specified processor, where id is the 1-character alphanumeric CPU ID of the processor.

CPU ALL
moves, restores, or deletes both processor shared and processor unique keypoints for all processors.

BP
allows you to move keypoints from a keypoint staging area of an image that is disabled.

Additional Information

Examples

Processor shared keypoints CTK3 and CTKV are moved from the keypoint staging area of the VEQUALV image to the working keypoint area in the following example. This example assumes that the command was entered on processor B. All other processors (C in this example) must be stopped before continuing.

+--------------------------------------------------------------------------------+
|User:   ZIMAG KEYPT MOVE VEQUALV KPT CTK3.CTKV CPU ALL                          |
|                                                                                |
|System: IMAG0021I 17.25.26 THE FOLLOWING PROCESSORS MUST BE STOPPED -           |
|          PROC-C                                                                |
|        IMAG0022I 17.25.26 ENTER - ZIMAG KEYPT CONTINUE - OR - ZIMAG KEYPT ABORT|
|                                                                                |
|User:   ZIMAG KEYPT CONT                                                        |
|                                                                                |
|System: IMAG0012I 17.25.26 CONTINUING WITH - ZIMAG KEYPT MOVE                   |
|        IMAG0011I 17.25.26 KEYPOINTS OVERLAID IN THE WORKING AREA               |
|         THE FOLLOWING PROCESSORS MUST BE IPLED -                               |
|         PROC-B                                                                 |
|         PROC-C                                                                 |
+--------------------------------------------------------------------------------+

All processor unique keypoints for processor C are moved from the keypoint staging area of the VEQUALV image to the working keypoint area in the following example. This example assumes that the command was entered on processor B.

+--------------------------------------------------------------------------------+
|User:   ZIMAG KEYPT MOVE VEQUALV KPT ALL CPU C                                  |
|                                                                                |
|System: IMAG0021I 17.25.26 THE FOLLOWING PROCESSORS MUST BE STOPPED -           |
|         PROC-C                                                                 |
|        IMAG0022I 17.25.26 ENTER - ZIMAG KEYPT CONTINUE - OR - ZIMAG KEYPT ABORT|
|                                                                                |
|User:   ZIMAG KEYPT CONT                                                        |
|                                                                                |
|System: IMAG0012I 17.25.26 CONTINUING WITH - ZIMAG KEYPT MOVE                   |
|        IMAG0011I 17.25.26 KEYPOINTS OVERLAID IN THE WORKING AREA               |
|         THE FOLLOWING PROCESSORS MUST BE IPLED -                               |
|         PROC-C                                                                 |
+--------------------------------------------------------------------------------+

Processor unique keypoint CTK1 for processor B is restored from the keypoint backup area to the working keypoint area. This example assumes that the command was entered on processor B.

+--------------------------------------------------------------------------------+
|User:   ZIMAG KEYPT REST KPT CTK1 CPU B                                         |
|                                                                                |
|System: IMAG0022I 17.25.26 ENTER - ZIMAG KEYPT CONTINUE - OR - ZIMAG KEYPT ABORT|
|                                                                                |
|User:   ZIMAG KEYPT CONT                                                        |
|                                                                                |
|System: IMAG0013I 17.25.26 CONTINUING WITH - ZIMAG KEYPT RESTORE                |
|        IMAG0011I 17.25.26 KEYPOINTS OVERLAID IN THE WORKING AREA               |
|         THE FOLLOWING PROCESSORS MUST BE IPLED -                               |
|         PROC-B                                                                 |
+--------------------------------------------------------------------------------+

All processor unique keypoints for processor C are deleted from the keypoint backup area in the following example.

+--------------------------------------------------------------------------------+
|User:   ZIMAG KEYPT DELETE KPT ALL CPU C                                        |
|                                                                                |
|System: IMAG0014I 19.39.59 KEYPOINTS REMOVED FROM THE BACKUP AREA               |
+--------------------------------------------------------------------------------+

Processor shared keypoint CTK6 is deleted from the keypoint backup area in the following example.

+--------------------------------------------------------------------------------+
|User:   ZIMAG KEYPT DEL KPT CTK6 CPU ALL                                        |
|                                                                                |
|System: IMAG0014I 19.39.59 KEYPOINTS REMOVED FROM THE BACKUP AREA               |
+--------------------------------------------------------------------------------+

Related Information