gtpo1m7tOperations

ZKPTR-Keypoint Pointer Record Update

Use this command to update or display the keypoint pointer record during TPF system restart.

Requirements and Restrictions

You can enter this command to update the keypoint pointer record only when prompted during TPF system restart.

Format




Replace
replaces the keypoint pointer record that is on file with the pointer record built by system restart.

CAncel
cancels the TPF system IPL or restart by ending the restart entry control block (ECB) with system error 005100. The existing keypoint pointer record on file is unchanged.

COntinue
continues the TPF system IPL or restart without filing the keypoint pointer record built by system restart. The existing keypoint pointer record that is on file is unchanged.

The CONTINUE parameter is primarily intended for use when a new face table (FCTB) that is loaded with expanded keypoint records has been used to update the keypoint pointer records during an IPL and another processor is IPLed using the old FCTB. The CONTINUE parameter allows the processor on the old FCTB to continue processing. You are responsible for making sure that new keypoint records are not accessed until all processors are running on the new FCTB.

Display
displays the keypoint pointer record. If an update request is outstanding, a comparison of the existing keypoint pointer record on file and the extent table built from the current FACE table (FCTB) is displayed.

n
is the fallback extent ordinal in the range 0 - 254. The keypoint pointer record for the specified fallback extent is displayed.

Additional Information

Online help information is available for this command. To display the help information, enter one of the following:

ZKPTR HELP

ZKPTR ?

Examples

The following example updates the keypoint pointer record on file.

+--------------------------------------------------------------------------------+
|System: CVZ60002A KEYPOINT POINTER RECORD OUT OF SYNC                           |
|                  ALLOW REPLACEMENT WITH THE UPDATED RECORD                     |
|                     ZKPTR REPLACE                                              |
|                  TO ABORT THE IPL                                              |
|                     ZKPTR CANCEL                                               |
|                  TO CONTINUE THE IPL WITHOUT FILING THE RECORD                 |
|                     ZKPTR CONTINUE                                             |
|                  TO DISPLAY THE OUT OF SYNC RECORD                             |
|                     ZKPTR DISPLAY                                              |
|                                                                                |
|User:   ZKPTR REP                                                               |
|                                                                                |
|System: KPTR0001I  KEYPOINT POINTER RECORD FILE REQUESTED                       |
|        CVZ60004I  KEYPOINT POINTER RECORD FILED                                |
|                                                                                |
+--------------------------------------------------------------------------------+

In the following example, a keypoint pointer record mismatch with the FCTB is displayed.

+--------------------------------------------------------------------------------+
|System: CVZ60002A KEYPOINT POINTER RECORD OUT OF SYNC                           |
|                  ALLOW REPLACEMENT WITH THE UPDATED RECORD                     |
|                     ZKPTR REPLACE                                              |
|                  TO ABORT THE IPL                                              |
|                     ZKPTR CANCEL                                               |
|                  TO CONTINUE THE IPL WITHOUT FILING THE RECORD                 |
|                     ZKPTR CONTINUE                                             |
|                  TO DISPLAY THE OUT OF SYNC RECORD                             |
|                     ZKPTR DISPLAY                                              |
|                                                                                |
|User:   ZKPTR D                                                                 |
|                                                                                |
|System: KPTR0020I  #KEYPT   KEYPOINT POINTER RECORD OUT OF SYNC                 |
|                             FILE               FCTB                            |
|                   EX    CCHHR    K ORD     CCHHR    K ORD                      |
|                         FACE ORD  RECS     FACE ORD  RECS                      |
|                    0  0029000001     0   0029000001     0                      |
|                                0   360            0   360                      |
|                    1                     0100000001   361                      |
|                                                 720   180                      |
|                   *** END OF DISPLAY ***                                       |
|                                                                                |
+--------------------------------------------------------------------------------+

In the following example, a corrupted keypoint pointer record is displayed.

+--------------------------------------------------------------------------------+
|System: CVZ60001A KEYPOINT POINTER RECORD CORRUPTED                             |
|                  ALLOW REPLACEMENT WITH THE REBUILT RECORD                     |
|                     ZKPTR REPLACE                                              |
|                  TO ABORT THE IPL                                              |
|                     ZKPTR CANCEL                                               |
|                  TO DISPLAY THE CORRUPTED RECORD                               |
|                     ZKPTR DISPLAY                                              |
|                                                                                |
|User:   ZKPTR D                                                                 |
|                                                                                |
|System: KPTR0030I  #KEYPT   KEYPOINT POINTER RECORD CORRUPTED                   |
|                   RECORD ID   - X'0000'                                        |
|                      EXPECTED - X'C3D2'                                        |
|                   CODE CHECK  - X'00'                                          |
|                      EXPECTED - X'00'                                          |
|                   RECORD TYPE - '        ' (X'0000000000000000')               |
|                      EXPECTED - '#KEYPT  '                                     |
|                   FILED BY    - '    ' (X'00000000')                           |
|                   *** END OF DISPLAY ***                                       |
|                                                                                |
+--------------------------------------------------------------------------------+

In the following example, there is no outstanding update request and the keypoint pointer record is displayed.

+--------------------------------------------------------------------------------+
|User:   ZKPTR D                                                                 |
|                                                                                |
|System: KPTR0010I  #KEYPT   KEYPOINT POINTER RECORD                             |
|                   EX    CCHHR    K ORD  RECS   FACE ORD                        |
|                    0  0029000001     0   360          0                        |
|                    1  0100000001   360   180        720                        |
|                                                                                |
|                   FALLBACK EXTENTS:                                            |
|                   EX     CCHHR                                                 |
|                     0  084C000E01                                              |
|                     1  084E000401                                              |
|                   *** END OF DISPLAY ***                                       |
|                                                                                |
+--------------------------------------------------------------------------------+
Note:
A display of the keypoint pointer record for a fallback extent is similar to the previous example except that fallback extent pointers are not displayed.

Related Information

See TPF Migration Guide: Program Update Tapes for more information about 32-way loosely coupled processor support migration.