GLOBALZONE entry (global zone)

The GLOBALZONE entry contains processing-related information for SMP/E. It is also used by SMP/E as an index to target and distribution zones, either in the same CSI or a different CSI data set. The GLOBALZONE entry is created by UCLIN and must be defined before you can do any other processing for that global zone.

Subentries

These are the subentries for the GLOBALZONE entry as they appear in the LIST output:

FMID

lists the function SYSMODs for which SMP/E is to receive service.

The UCL operand is FMID(sysmod_id…).

The SYSMOD ID must contain seven alphanumeric characters.

OPTIONS

is the name of the OPTIONS entry in the global zone that should be used in processing this global zone. For more information, see OPTIONS entry (global zone).

The UCL operand is OPTIONS(name).

The name can contain from one to eight alphanumeric characters.
This name can be overridden by using the OPTIONS parameter on the SET command. For more information about the SET command, see SMP/E for z/OS Commands.
If no OPTIONS entry name is specified, SMP/E uses a set of default utility values when processing the global zone. For more information, see OPTIONS entry (global zone).

SREL

lists the system releases to be supported in this global zone.

The UCL operand is SREL(srel…).

The SREL must contain four alphanumeric characters, usually one alphabetic character followed by three numerics. These are the SRELs defined by IBM®:

System: SREL
DB2®: P115
CICS®: C150
IMS™: P115
MVS™: Z038
NCP: P004

Note: Although you can support multiple products with different SREL values from one global zone, those products are still subject to all other restrictions related to combining products in one zone. The most common reason for not being able to combine products is common element names. For example, modules or macros with the same name are found in both products, but reside in different libraries.

UPGLEVEL

indicates the highest SMP/E release level that is allowed to make incompatible changes to the global zone. Before making an incompatible change to the global zone, SMP/E will check the UPGLEVEL value for that zone. If the release level of SMP/E is higher than the zone's UPGLEVEL value, SMP/E will not make the incompatible change.

The UPGLEVEL value is in the form vr.pp, where vr represents the version and release of SMP/E and pp represents the PTF level of SMP/E.

There is no UCL support for this subentry. When a zone is created by SMP/E using the UCLIN command or the Administration dialog, SMP/E sets the UPGLEVEL subentry value for that zone to the level of SMP/E used to create the zone. The UPGRADE command is used to change the UPGLEVEL subentry value for a zone.

ZDESC

is a user-written description for this zone.

The UCL operand is ZONEDESCRIPTION(text).

The zone description can be in single-byte characters (such as English alphanumeric characters) or in double-byte characters (such as Kanji).
The zone description can contain up to 500 bytes of data, including blanks. (For double-byte data, the 500-byte maximum includes all shift-in and shift-out characters, as well as the double-byte characters.) Extra blanks are deleted. All data beyond column 72 is ignored, including blanks.
The zone description cannot be only blanks.
If parentheses are included in the text, they must be in matched pairs.

ZONEINDEX

identifies all the target zones and distribution zones associated with this global zone. This list is used by SMP/E to determine the data set in which the zone resides and the type of zone.

For ADD and REP statements, the UCL operand is ZONEINDEX((name,dsn,type)…).

Note: You cannot use REP to replace a single zone in the ZONEINDEX list. REP will cause the entire list of zones to be replaced. Instead, you must first delete the zone from the ZONEINDEX list, and then add the zone to the list with the new SMPCSI data set name.

For DEL statements, the UCL operand is ZONEINDEX((name)…).

ZONEINDEX can also be specified as ZINDEX.
name is the name of the zone. The name can contain from one to seven alphanumeric characters (A through Z, 0 through 9) or national characters ($, #, @). The first character must be alphabetic.
dsn is the fully qualified name of the data set in which the zone resides.
type is the zone type, either TARGET or DLIB.

The ZONEINDEX is only a pointer to a zone. Changes you make to a ZONEINDEX do not affect the associated zone. Therefore, you cannot add, rename, or delete a zone by simply adding, replacing, or deleting its ZONEINDEX. However, these are some other commands you can use:

Adding a zone: To add a zone, you can use the following commands, depending on the particular situation:
- UCLIN to add a ZONEINDEX, then UCLIN to define the DZONE or TZONE entry
- ZONECOPY
- ZONERENAME
- ZONEEXPORT, UCLIN for the ZONEINDEX, and ZONEIMPORT
Renaming a zone: To rename a zone, you must use the following command:
- ZONERENAME
Deleting a zone: To delete a zone, you can use the following commands, depending on the particular situation:
- ZONEDELETE
- ZONEEXPORT

For more information about any of these commands, see the topic on that command.

LIST Examples

To list all the GLOBALZONE entry, you can use the following commands:

SET      BDY(GLOBAL)        /* Set to global zone.      */.
LIST     GLOBALZONE         /* List GLOBALZONE entry.   */.

Figure 1 is an example of LIST output for a GLOBALZONE entry.

Figure 1. GLOBALZONE entry: sample LIST output

PAGE nnnn  - NOW SET TO zzzzzz ZONE nnnnnnn  DATE mm/dd/yy TIME hh:mm:ss SMP/E 36.nn SMPLIST OUTPUT

GLOBAL        GZONE ENTRY


  NAME

GLOBAL    ZONEINDEX       = TGT1      TARGET   SYS1.TGT.SMPCSI.CSI
                            TGT2      TARGET   SYS1.TGT.SMPCSI.CSI
                            DLIB1     DLIB     SYS1.DLIB.SMPCSI.CSI
                            DLIB2     DLIB     SYS1.DLIB.SMPCSI.CSI
          ZDESC           = ZONE DESCRIPTION FOR GLOBAL ZONE
          SREL            = Z038      I115      P115      R020
          FMID            = JXY1102   FXY1121   FXY1122   FXY1123
          OPTIONS         = OPTGBL

UCLIN Examples

You can use the ADD, REP, and DEL UCL statements to change subentries in the GLOBALZONE entry. When you use UCLIN to update a GLOBALZONE entry, keep these points in mind:

After the UCLIN changes are made, the GLOBALZONE entry must contain at least one of these subentries: FMID, OPTIONS, SREL, or ZONEINDEX. Otherwise, there is not enough information in the entry for SMP/E to use the entry.
If a DEL statement deletes all the existing subentries in the entry, SMP/E deletes the entire entry.

The following examples are provided to help you use the GLOBALZONE entry.