FETCH
FETCH Use the FE!CH command in CMS/DOS to load an executable phase into
storage for execution. The format of the FETCH command is:
r
1 FETch , phasename ((options ••• () ]] [ START] I , [COMP] I [ORIGIN hexloc] L- phasename is the name of the phase to be loaded into virtual storage. CMS searches for the phase: • In a DOS/VS private core image library, if IJSYSCL has been
defined • In eMS DOSLIBs that have been identified with the GLOBAL command • In the DOS/VS system core image library, if you specified
the mode letter of the DOS/VS system residence on the SET DOS ON command line START specifies that once the phase is loaded into storage,
execution should begin immediately.
CaMP specifies that
should contain
Note 5.)
when the phase is to be executed,
the address of its entry point.
register 1 (See Usage ORIGIN hexloc
fetches the program and loads it at the location specified by
hexloc; this location must be in the CMS user area. The
location, hexloc, is a hexadecimal number of up to eight
characters. (See Usage Note 6.)
1. If you do not use the START option, FETCH displays a message at your terminal indicating the name of the phase and the storage
location of its entry point. At this time, you can set address
instruction stops for testing. To continue, issue the START command to initiate execution of the phase just loaded.
2 • The fetch routine is also invoked by supervisor
instructions 1, 2, 4, or 65. The search order for
phases is the same as listed above.
call (SVC) executable
3. If you want to fetch a phase from a private core image library, you
must issue an ASSGN command for the logical unit SYSCLB and define
the library in a DLBL command using the ddname IJSSYCL. For
example:
assgn sysclb c
dlbl ijsyscl c dsn core image lib (sysclb perm Section 2. CMS Commands 87

FETCH 4. Phases fetched from DOS core image libraries must have been
link-edited with ACTION REL.
5. CMS uses the COMP option when it fetches the DOS PL/I compiler
because that compiler expects register 1 to contain its entry point
address. This option is not required when you issue the FETCH command to load your own programs. When CMS starts executing a phase that has COMP specified, the DMSLI07401 BEGINS ••• message is not displayed.
6. The ORIGIN option is used by the CMS/VSAM installation EXEC procedure to load nonsharable modules on a segment boundary. It is
not required when you issue the FETCH command to load your own
programs, unless you want to load them at a location other than 20000. 7 The FETCH command should only be used with the START command to
execute a DOS program. It should not be used with GENMOD to
attempt to create an executable CMS module file. DMSFET710I PHASE 'phase' ENTRY POINT AT LOCATION xxxxxx
This message is issued when the
indicates the virtual storage
loaded. DMSLI07401 EXECUTION BEGINS ••• START option is not specified. It
address at which the phase was
This message is issued when the START option is specified; it
indicates that program execution has begun. DMSFCH104S ERROR 'nn' READING FILE 'fn ft fm' FROM DISK RC=100 DMSFCH10QS VIRTUAL STORAGE CAPACITY EXCEEDED RC=104 DMSFCH113S DISK (cuu) NOT ATTACHED RC=100 DMSFCH115E PHASE LOAD POINT LESS THAN 'address' RC=40 DMSFCH411S INPUT ERROR CODE "nn" ON '{SYSRESISYSCLB}' R:=100 DMSFCH777S DOS PARTITION TOO SMALL TO ACCOMMODATE FETCH REQUEST RC=104 DMSFET003E INVALID OPTION 'option' RC=24 DMSFET004E PHASE 'phase' NOT FOUND RC=28 DMSFET029E INVALID PARAMETER 'parameter' IN THE OPTION 'ORIGIN' FIELD RC=24 DMSFET070E INVALID PARAMETER 'parameter' RC=24 DMSFET098E NO PHASE NAME SPECIFIED RC=24 CMS/DOS ENVIRONMENT NOT ACTIVE RC=40 DMSLI0055E NO ENTRY POINT DEFINED RC=40 88 IBM VM/370 CMS Command and Macro Reference