GENMOD NOSTR SYSTEM DOS ALL !21g: If a program running in the user area calls a
transient routine that was generated with the 5TR option,
the user area storage pointers will be reset. This reset
condition could cause errors upon return to the original
program (for example, when OS macros are
issued in the user program) • indicates that, when the MODULE is loaded, free storage
pointers are not reset for any storage currently in use. NOSTR is the default setting if the MODULE file is to be
loaded at a location other than the default load address.
indicates that when the MODULE file is subsequently
loaded, it is to have a storage protect key of zero.
indicates that the program may contain macros and,
therefore, should be executed only when eMS/DOS is not
active.
indicates that the program contains DOS macros; CMS/DOS must be active (that is, SET DOS ON must have been
previously invoked) in order for this program to execute. (See Usage Note 2).
indicates that the program: • Contains CMS macros and must be capable of running
regardless of whether CMS/DOS is active or not • Contains no DOS or as macros • Preserves and resets the DOS flag in the eMS nucleus • Does its own setting of DOS flags The ALL option is primarily for use by eMS system
programmers. CMS system routines are aware of which
environment is active and will preserve and reset the DOS flag in the CMS nucleus.
1. The GENMOD command is usually invoked following the LOAD command,
and possibly the INCLUDE command. For example, the sequence:
load myprog
genmod testprog
loads the file MYPROG TEXT into virtual storage and creates a
nonrelocatable load module named TESTPROG MODULE. TESTPROG may now
be invoked as a user-written command from the environment.
2. The execution of MODULE files created from programs is not
supported and may give undesirable results. GENMOD is intended for
use with the LOAD command, not the FETCH command. Storage initialization for FETCH is different from that for LOAD. 3. Before the file is written, undefined symbols are set to location
zero and the common reference control section is initialized. The
undefined symbols are not retained as unresolved symbols in the MODULE Therefore, once the file is generated, those
references cannot be resolved and may cause undesirable results
during execution. VM/37Q eMS Command and Macro Reference

GENMOD 4. If you load a program into the transient area you should issue the GENMOD command with the NOSTR option. Be careful if the program
uses as GETMAIN or FREEMAIN macros because your program, plus the
amount of storage obtained via GETMAIN, cannot exceed two pages
(8192 bytes). It is recommended that you do not use GETMAIN macros
in programs that execute in the transient area.
S. A transient module (loaded with the ORIGIN TRANS option) that was
generated with the SYSTEM option is written on disk as a record with a maximum length of 8192 bytes.
6. If you are using FORTRAN under CMS, use FROM MAIN as an option to
avoid undesirable results.
7. If FROM is not specified in the GENMOD command, the load point of
the module generated (the beginning virtual storage location) is
the address of fn, if fn is an external name occurring in the loaded text; otherwise, it is the first CSECT in the load map. The
entry point for execution is determined according to the hierarchy
outlined in Usage Note 4 of the LOAD command and is not necessarily
the same as the load point. If your loaded text had external
references or library statements ahead of the first CSECT, your GENMOD command must name the load point explicitly as fn or as the FROM entry operand to load your program properly. 8. If you are using PLII under CMS, use FROM PLISTART as an option to
avoid undesirable results.
None. DMSMOD003E INVALID OPTION 'option' RC=24 DMSMJDOOSE NO {FROMITO} ENTRY SPECIFIED RC=24 DMSMOD021E ENTRY POINT 'name' NOT FOUND RC=40 DMSMOD032E INVALID FILETYPE 'ft' RC=24 DMSMOD031E DISK 'mode' IS READ/ONLY RC=36 DMSMOD040E NO FILES LOADED RC=40 DMSMOD010E INVALID PARAMETER 'parameter' RC=24 INVALID USE OF !FROM! AND !TO! OPTIONS RC=24 DMSMOD10SS ERROR Inn' WRITING FILE 'fn ft fm' ON DISK RC=100 DMSSTT048E INVALID MODE 'mode' RC=24 DMSSTT069E DISK 'mode' NOT ACCESSED RC=36
Section 2. CMS Commands 103