27.12.2012 Views

z/VM: CP Commands and Utilities Reference - z/VM - IBM

z/VM: CP Commands and Utilities Reference - z/VM - IBM

z/VM: CP Commands and Utilities Reference - z/VM - IBM

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

H<strong>CP</strong>LDR<br />

PUNCH<br />

requests the object files be punched on the punch at virtual address 00D. A <strong>CP</strong><br />

CLOSE comm<strong>and</strong> is issued when all of the object files have been punched.<br />

TAPE<br />

requests the output of object files be placed on a tape drive at virtual address<br />

182.<br />

OS<br />

indicates the program may contain OS macros <strong>and</strong> therefore should be run only<br />

when CMS/DOS is not active. OS is the default.<br />

ALL<br />

indicates that one or more of the following are true about the program:<br />

v It contains CMS macros <strong>and</strong> must be capable of running regardless of<br />

whether CMS/DOS is active<br />

v It contains no VSE or OS macros<br />

1836 z/<strong>VM</strong>: <strong>CP</strong> <strong>Comm<strong>and</strong>s</strong> <strong>and</strong> <strong>Utilities</strong> <strong>Reference</strong><br />

v It preserves the value of the DOS flag on entry into the CMS nucleus, <strong>and</strong>, if<br />

it modifies that value, resets it on exit<br />

v It does its own setting of the DOS flags.<br />

Note: The ALL option is primarily for use by CMS system programmers. CMS<br />

system routines know which environment is active <strong>and</strong> preserve <strong>and</strong><br />

reset the DOS flag in the CMS nucleus.<br />

DOS<br />

indicates the program contains VSE macros; CMS/DOS must be active (that is,<br />

SET DOS ON must have been previously invoked) for this program to run.<br />

AMODE<br />

specifies the addressing mode in which the program will be entered. The<br />

AMODE defined by this option is placed in the header record of the MODULE<br />

file being created.<br />

If you specify RMODE but do not specify AMODE, the AMODE for the<br />

MODULE is determined from the following default criteria:<br />

v If you specify RMODE ANY, the AMODE specification defaults to AMODE 31.<br />

v If you specify RMODE 24, the AMODE defaults to the AMODE of the entry<br />

point determined by the LOAD process.<br />

If you specify neither AMODE nor RMODE, the AMODE for the module defaults<br />

to 31.<br />

The valid AMODE values <strong>and</strong> their meanings are as follows:<br />

24 This entry point is to receive control in 24-bit addressing mode.<br />

31 This entry point is to receive control in 31-bit addressing mode.<br />

ANY tells H<strong>CP</strong>LDR that the specified entry point is capable of operating in<br />

either 24-bit or 31-bit addressing mode. It will receive control in the<br />

addressing mode of its caller. If the module is run by name from the<br />

comm<strong>and</strong> line or from an exec, it will receive control in 31-bit<br />

addressing mode.<br />

CLEAN<br />

tells CMS to clean the module from memory at the end of its execution. This<br />

option will only work for modules running under CMS. CLEAN is the default for<br />

relocatable modules.

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!