Use this command to change the allocation characteristics assigned to
unallocated programs when the unallocated programs are loaded and activated
using the E-type loader.
Requirements and Restrictions
The parameters for this command must be entered in the specified
order.
Format
- CR
- specifies that unallocated programs are treated as core resident
programs.
- FR
- specifies that unallocated programs are treated as file resident
programs.
- SHared
- specifies that unallocated programs are treated as shared programs.
That is, all ECBs share the same key-protected storage copy of the unallocated
program, but not all ECBs see the unallocated program at the same
address.
Both core resident and file resident programs can be defined as shared
programs.
- COmmon
- specifies that unallocated programs are treated as common programs.
That is, all ECBs share the same key-protected storage copy of the unallocated
program, and all ECBs see the unallocated program at the same address.
Both core resident and file resident programs can be defined as common
programs.
- UNprotected
- specifies that unallocated programs are treated as unprotected
programs. That is, all ECBs share the same unprotected storage copy of
the unallocated program, and all ECBs see the unallocated program at the same
address. This parameter is intended for self-modifying programs.
Only file resident programs can be defined as unprotected programs.
- ISunique
- specifies that unallocated programs are treated as I-stream unique
programs. That is, all ECBs using an unallocated program on a specific
I-stream share the same unprotected storage copy of the program, and all ECBs
see the unallocated program at the same address. This parameter is
intended for self-modifying, I-stream unique programs.
Only file resident programs can be defined as I-stream unique
programs.
- PRivate
- specifies that unallocated programs are treated as private
programs. That is, an ECB is supplied with a new storage copy of an
unallocated program each time the ECB enters the unallocated program.
Only file resident programs can be defined as private programs.
- 24bit
- specifies that unallocated programs are entered in 24-bit mode.
- 31bit
- specifies that unallocated programs are entered in 31-bit mode.
- Key0
- specifies that unallocated programs can change the protection key to
0.
- NOKey0
- specifies that unallocated programs cannot change the protection key to
0.
- Montc
- specifies that unallocated programs can enter supervisor state.
- NOMontc
- specifies that unallocated programs cannot enter supervisor state.
- Restrict
- specifies that unallocated programs can issue restricted macros.
- NORestrict
- specifies that unallocated programs cannot issue restricted macros.
- Cmb
- specifies that unallocated programs can obtain common storage
blocks.
- NOCmb
- specifies that unallocated programs cannot obtain common storage
blocks.
Additional Information
- Online help information is available for this command. To display
the help information, enter one of the following:
ZOLDR HELP
ZOLDR ?
- All changes take effect immediately. The next time an unallocated
program is activated, it assumes the new allocation characteristics.
- If you activate a loadset that contains an unallocated program, and that
unallocated program is also contained in another loadset that was activated
before you changed the allocation characteristics using the ZOLDR
ALTER command, the unallocated program is not assigned the new program
allocation characteristics. Instead, it is assigned the allocation
characteristics of the unallocated program that is contained in the other
loadset.
Therefore, to ensure that unallocated programs are assigned the most recent
allocation characteristics when you activate a loadset, deactivate all the
other loadsets that contain a version of the unallocated program before you
activate the new loadset.
- The values changed using the ZOLDR ALTER PROGCHAR command affect all
subsystems.
Examples
The allocation characteristics assigned to unallocated programs are changed
in the following example.
+--------------------------------------------------------------------------------+
|User: ZOLDR ALTER PROGCHAR FR SHARED 24BIT NOKEY0 NOMONTC NORESTRICT NOCMB |
| |
|System: OLDR1016I 19.39.59 CELA - ALTER REQUEST RECEIVED |
| OLDR5006I 19.39.59 CLDT - VALUES ALTERED SUCCESSFULLY |
| OLD VALUES - FR SHARED 31BIT NOKEY0 NOMONT NORESTRICT CMB |
| NEW VALUES - FR SHARED 24BIT NOKEY0 NOMONT NORESTRICT NOCMB |
| THE NEW VALUES TAKE EFFECT IMMEDIATELY |
+--------------------------------------------------------------------------------+
Related Information
See TPF System Installation Support Reference for
more information about the E-type loader.