GLOBAL

CMS Commands

global.helpcmd.txt
GLOBAL                                                    CMS Transient command

Use the GLOBAL command to identify which CMS, CMS/DOS, or OS libraries are to
be searched for macros, copy files, subroutines, or DOS executable phases when
processing subsequent CMS commands.  The format of the GLOBAL command is:
+----------+------------------------------------------------------------------+
| GLOBAL   | MACLIB|TXTLIB|DOSLIB  [libname1... libname8]                     |
+----------+------------------------------------------------------------------+
where:

MACLIB   precedes the specification of macro libraries that are to be searched
         for macros and copy files during the execution of language processor
         commands.  The macro libraries may be CMS files or OS data sets.  If
         you specify an OS data set, a FILEDEF command must be issued for the
         data set before you issue the GLOBAL command.

TXTLIB   precedes the specification of text libraries to be searched for
         missing subroutines when the LOAD or INCLUDE command is issued, or
         when a dynamic load occurs (that is, when an OS SVC 8 is issued).

         Note:  Subroutines that are called by dynamic load should (1) contain
         only VCONs that are resolved within the same text library member or
         (2) be resident in storage throughout the processing of the original
         CMS LOAD or INCLUDE command.  Otherwise, the entry point is
         unpredictable.

DOSLIB   precedes the specification of DOS simulated core image libraries (that
         is, CMS/DOS phase libraries) to be searched for missing phases.  This
         operand does not apply to system or private core image libraries
         residing on DOS/VS disks.  DOSLIB can be specified regardless of
         whether the CMS/DOS environment is active or not.

libname1...
         are the filenames of up to 8 libraries of the specified filetype
         (MACLIB, TXTLIB, or DOSLIB).  The libraries are searched in the order
         in which they are named.  If no filenames are specified, the command
         cancels any previous GLOBAL command for this filetype.


Usage Notes:

1.  A GLOBAL command remains in effect for an entire CMS session unless it is
    explicitly canceled or reissued.  If a program failure forces you to IPL
    CMS again, you must reissue the GLOBAL command.

2.  There are no default libraries; if you wish to use the same libraries
    during every terminal session, place the GLOBAL command(s) in your PROFILE
    EXEC.

3.  If you want to use an OS library during the execution of a language
    processor, you can issue a GLOBAL command to access the library, as long as
    you have defined the library via the FILEDEF command.  If you want to use
    that library for more than one job, however, you should use the PERM option
    on the FILEDEF command, since the language processors clear nonpermanent
    file definitions.

4.  You can find out what libraries have been specified by issuing the QUERY
    command with the MACLIB, TXTLIB, DOSLIB, or LIBRARY operands.  (The LIBRARY
    operand requests a display of all libraries.)

5.  For information on creating and/or manipulating CMS libraries, see the
    discussion of the MACLIB, TXTLIB, and DOSLIB, commands.