MODIFY-CSECT-ATTRIBUTES - Modify CSECT attributes

The MODIFY-ELEMENT substatement MODIFY-CSECT-ATTRIBUTES modifies CSECT attributes.

This substatement must be used for object modules (R-type members) only.

At the beginning of the MODIFY-ELEMENT statement, the operands are preset to the value immediately following *UNCHANGED.

Format

MODIFY-CSECT-ATTRIBUTES                                                                                                                      

NAME = *ALL / <c-string 1..8 with-low> / <text 1..8>

,VISIBLE = *UNCHANGED / *YES / *NO

,READ-ONLY = *UNCHANGED / *YES / *NO

,PAGE-ALIGNMENT = *UNCHANGED / *YES / *NO

,RESIDENCY-MODE = *UNCHANGED / 24 / *ANY

,ADDRESSING-MODE = *UNCHANGED / 24 / 31 / *ANY

Operands

NAME = *ALL / <c-string 1..8 with-low> / <text 1..8>
Name of the CSECT whose attributes are to be modified. All CSECTs or a specific CSECT can be specified.

VISIBLE = *UNCHANGED / *YES / *NO
Masking (visibility) of the program interface. The preset value is *YES.

VISIBLE = *YES
The specified control sections are not masked (see the “Binder Loader / Starter” manual [13 (Related publications)]). A secondary name record is created for these sections, and the names are entered in the directory of secondary names.

VISIBLE = *NO
The specified control sections are masked. No secondary name record is created for these sections, and the names are not entered in the directory of secondary names. Any secondary name record which may exist is deleted.

If all control sections of an object module are masked, a library member without a secondary name entry is created. This object module can be located via the primary name only.

The module name can, however, be derived from the initial control section name with the aid of all ESD records, since masked control sections are also used in this case.

The linkage editor cannot process object modules which only have masked control sections, e.g. when an object module is excluded with the autolink function. The VISIBLE operand can also be used on ENTRYs.

READ-ONLY = *UNCHANGED / *YES / *NO
Specifies the write protection. The preset value is *YES.

READ-ONLY = *YES
Indicates that only read access to the specified control sections is permitted while the program is executing.

READ-ONLY = *NO
Enables write access to the specified control sections even while the program is executing.

PAGE-ALIGNMENT = *UNCHANGED / *YES / *NO
Specifies the page alignment. The preset value is *YES.

PAGE-ALIGNMENT = *YES
Indicates that the specified control sections are to be aligned on a page boundary, i.e. the load address should be a multiple of decimal 4096 or hexadecimal 1000.

PAGE-ALIGNMENT = *NO
Does not take page boundaries into account. The control sections always start at the next doubleword address produced during the linkage process.

RESIDENCY-MODE = *UNCHANGED / 24 / *ANY
Specifies the residency mode. The preset value is 24.

RESIDENCY-MODE = 24
Indicates that the specified control sections are to be loaded to the address area below the 16-Mbyte limit.

RESIDENCY-MODE = *ANY
No limitation exists.

ADDRESSING-MODE = *UNCHANGED / 24 / 31 / *ANY
Specifies the addressing mode. The preset value is 24.

ADDRESSING-MODE = 24
Indicates that the specified control sections are to be executable in 24-bit mode.

ADDRESSING-MODE = 31
Indicates that the specified control sections are to be executable in 31-bit mode.

ADDRESSING-MODE = *ANY
Any execution mode.