gtpo1m19Operations

ZAPAT-Alter Program Allocation Table

Use this command to change the allocation parameters of a program in the file copy or the core (main storage) copy of the program allocation table (PAT).

If you change the file copy of the PAT:

If you change the core copy of the PAT:

Requirements and Restrictions

Format




Notes:

  1. You can also separate the parameters with a comma (,).

progname
is a 4-character alphanumeric program name.

Type
changes the residency of the program:

CR
specifies that the program is core resident.

FR
specifies that the program is file resident.

This parameter is valid only when changing the file copy of the PAT.

CLass
changes the residency characteristics of a program to one of the following classes. See Table 2 for a summary of the residency characteristics that can be assigned to core resident and file resident programs.

This parameter is valid only when changing the file copy of the PAT.

SHARED
specifies that the program is a shared program. That is, all ECBs share the same key-protected copy of the program, but not all ECBs see the program at the same address. In addition, ECBs that are not currently using the program may not be able to see the program.

Both core resident and file resident programs can be assigned SHARED class.

COMMON
specifies that the program is a common program. That is, all ECBs share the same key-protected copy of the program and all ECBs see the program at the same address.

Both core resident and file resident programs can be assigned COMMON class.

UNPROTECTED
specifies that the program is an unprotected program. That is, all ECBs share the same unprotected storage copy of the program, and all ECBs see the program at the same address. This class is intended for self-modifying programs.

Only file resident programs can be assigned UNPROTECTED class.

ISUNIQUE
specifies that the program is an I-stream unique program. That is, all ECBs using the program on a specific I-stream share the same unprotected storage copy of the program, and all ECBs see the program at the same address. This class is intended for self-modifying, I-stream unique programs.

Only file resident programs can be assigned ISUNIQUE class.

PRIVATE
specifies that the program is a private program. That is, an ECB is supplied with a new storage copy of the program each time the ECB enters the program.

Only file resident programs can be assigned PRIVATE class.

Mode
changes the addressing mode in which the program is entered:

24BIT
specifies that the program is entered in 24-bit addressing mode.

31BIT
specifies that the program is entered in 31-bit addressing mode.

This parameter is valid only when changing the file copy of the PAT.

Copy
specifies which version of the PAT to change:

F
changes the file copy.

C
changes the core copy.

B
changes both the core and the file copy.

See Table 3 for a summary of the allocation parameters that can be changed in the file copy and the core copy of the PAT.

NO
turns off the following allocation parameters.

KEY0
specifies that the program can change the protection key to 0 using the CINFC W macro. This parameter is valid when you change both the core and the file copy of the PAT.

MONTC
specifies that the program can enter supervisor state using the MONTC macro. This parameter is valid when you change both the core and the file copy of the PAT.

RESTRICT
specifies that the program can issue restricted macros. This parameter is valid when you change both the core and the file copy of the PAT.

CMB
specifies that the program can obtain common storage blocks. This parameter is valid when you change both the core and the file copy of the PAT.

PRELOAD
specifies that the program is brought into main storage before 1052 state. This parameter is valid when you change both the core and the file copy of the PAT.

Notes:

  1. Only core resident programs can be assigned the PRELOAD allocation parameter.

  2. The number of programs that are assigned the PRELOAD allocation parameter should be minimized for performance reasons.

DBUG
specifies that the program is available to be debugged using the TPF Assembler Debugger for VisualAge Client. This parameter is valid when you change both the core and the file copy of the PAT. All programs are assumed to be available for debugging unless NODBUG is specified. The NODBUG parameter is available only for programs that are allocated as 31-bit core resident or file resident with a class of SHARED or COMMON.

Additional Information

Examples

In the following example, the program residency of the CVAA program is changed from shared to common. IMAGEABC is the active image.

+--------------------------------------------------------------------------------+
|User:   ZAPAT CVAA CLASS-COMMON                                                 |
|                                                                                |
|System: APAT0101I 11.34.30  BEGIN DISPLAY OF FILE COPY FOR IMAGE IMAGEABC       |
|         PROGRAM          CVAA                                                  |
|                                                                                |
|         VERSION          JW                                                    |
|         TYPE             FILE RESIDENT                                         |
|         BASE PAT SLOT    0172DA80                                              |
|         LINKAGE TYPE     TAR                                                   |
|         CLASS            SHARED                                                |
|         FILE ADDRESS     2F800CF7                                              |
|         ADDRESSING MODE  31BIT                                                 |
|         AUTHORIZATION    NONE                                                  |
|                                                                                |
|        ALTERED TO -                                                            |
|         PROGRAM          CVAA                                                  |
|                                                                                |
|         VERSION          JW                                                    |
|         TYPE             FILE RESIDENT                                         |
|         BASE PAT SLOT    0172DA80                                              |
|         LINKAGE TYPE     TAR                                                   |
|         CLASS            COMMON                                                |
|         FILE ADDRESS     2F800CF7                                              |
|         ADDRESSING MODE  31BIT                                                 |
|         AUTHORIZATION    NONE                                                  |
|                                                                                |
|                                                                                |
|        DISPLAY OF PAT SLOTS FOR CVAA                                           |
|                                                                                |
|        VERSN LOADSET  ACT NUM STATUS      FILE ADDR TYPE LINK PAT ADDR         |
|        ----- -------- ------- ----------- --------- ---- ---- --------         |
|          TP  MKING        13  SELECT ACT  3F801CFE   FR  BAL  01567018         |
|          TP  TPUENTE       6  ACTIVE      3FD809A7   FR  TAR  01635B80         |
|          JW  BASE          0  ACTIVE      2F800CF7   FR  TAR  0172DA80         |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

In the following example, the KEY0 and MONTC allocation parameters are changed in both the core and file copy of the PAT. The CVIC program can now change the protection key to 0 and enter supervisor state.

Note:
Because CVIC is a transfer program of CVIA, the allocation parameters of the parent program (CVIA) are changed rather than the allocation parameters of CVIC. There are three versions of CVIA active: the base version and two versions that were activated by the E-type loader.
+--------------------------------------------------------------------------------+
|User:   ZAPAT CVIC COPY-B KEY0 MONTC                                            |
|                                                                                |
|System: APAT0101I 11.34.30  BEGIN DISPLAY OF FILE COPY FOR IMAGE IMAGEABC       |
|         PROGRAM          CVIA PARENT OF CVIC                                   |
|                                                                                |
|         VERSION          MG                                                    |
|         TYPE             CORE RESIDENT                                         |
|         BASE PAT SLOT    0172EB80                                              |
|         LINKAGE TYPE     TAR                                                   |
|         CLASS            COMMON                                                |
|         FILE ADDRESS     3F800CF7                                              |
|         ADDRESSING MODE  31BIT                                                 |
|         AUTHORIZATION    NONE                                                  |
|                                                                                |
|        ALTERED TO -                                                            |
|         PROGRAM          CVIA PARENT OF CVIC                                   |
|                                                                                |
|         VERSION          MG                                                    |
|         TYPE             CORE RESIDENT                                         |
|         BASE PAT SLOT    0172EB80                                              |
|         LINKAGE TYPE     TAR                                                   |
|         CLASS            COMMON                                                |
|         FILE ADDRESS     3F800CF7                                              |
|         ADDRESSING MODE  31BIT                                                 |
|         AUTHORIZATION    KEY0 MONTC                                            |
|                                                                                |
|        BEGIN DISPLAY OF CORE COPY FOR IMAGE IMAGEABC                           |
|         PROGRAM          CVIA PARENT OF CVIC                                   |
|                                                                                |
|         VERSION          MG                                                    |
|         TYPE             CORE RESIDENT                                         |
|         BASE PAT SLOT    0172EB80                                              |
|         LINKAGE TYPE     TAR                                                   |
|         CLASS            COMMON                                                |
|         FILE ADDRESS     3F800CF7                                              |
|         ADDRESSING MODE  31BIT                                                 |
|         AUTHORIZATION    NONE                                                  |
|                                                                                |
|        ALTERED TO -                                                            |
|         PROGRAM          CVIA PARENT OF CVIC                                   |
|                                                                                |
|         VERSION          MG                                                    |
|         TYPE             CORE RESIDENT                                         |
|         BASE PAT SLOT    0172EB80                                              |
|         LINKAGE TYPE     TAR                                                   |
|         CLASS            COMMON                                                |
|         FILE ADDRESS     3F800CF7                                              |
|         ADDRESSING MODE  31BIT                                                 |
|         AUTHORIZATION    KEY0 MONTC                                            |
|                                                                                |
|        DISPLAY OF PAT SLOTS FOR CVIA                                           |
|                                                                                |
|        VERSN LOADSET  ACT NUM STATUS      FILE ADDR TYPE LINK PAT ADDR         |
|        ----- -------- ------- ----------- --------- ---- ---- --------         |
|          IK  GRATEFUL     13  ACTIVE      3FD80777   CR  BAL  01568018         |
|          JG  JGARCIA       6  SELECT ACT  3FD807A7   CR  TAR  0166BCC0         |
|          MG  BASE          0  ACTIVE      3F800CF7   CR  TAR  0172EB80         |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

Related Information

See TPF Main Supervisor Reference and TPF System Installation Support Reference for more information about the program allocation table (PAT).