ZGLBL GLOBAL INITIALIZE: Initialize z/TPF format-2 global data

Use this command to initialize the contents of a specified format-2 global record in main storage and on DASD.

Last updated

Changed in 2022.
Changed for PUT11
Changed for PUT08.
Added for PUT00.

Requirements and restrictions

You can enter this command only when the z/TPF system is in 1052 state or higher.
You can enter this command only from the prime CRAS.

Format

From global parameters

globalname

The 1- to 8-character name of the format-2 global record to be initialized. This parameter is case sensitive.

SOurce

Specifies the source of the data for the initialization that is to be performed, where:

INputdeck: Indicates that the initialization data is contained in a global data input deck.
ASDEFined: Indicates that there is no global data input deck to initialize the specified global record from. The global record can be initialized without specific data, but initialized based on its defined attributes. The z/TPF system will assign main storage and DASD resources to the global record using the specified size, if applicable. If a format-1 global is in migration state, no physical storage is obtained; however, the format-2 global attribute table (FGAT) entry is initialized for use.
ZERO: Indicates that the entire global record will be cleared in main storage and on DASD, if appropriate, by using the specified size.
GLobal: Indicates that the initialization data will be copied from a previously initialized global record.

INput-ddname

Specifies the location of the global data input deck, where ddname is a valid 1- to 16-character alphanumeric data definition name.

SIze-size

Specifies the size of the global record, where size is the size of the record in number of bytes (in hexadecimal), which must be greater than zero.

PRoc

Specifies the processor in a loosely coupled (LC) complex where the format-2 global record resides, where:

localid: The current processor ID that the command is currently running from.
procid: The 1-character processor ID of the processor where the global record resides.
ALL: Indicates that the request is for all processors in the loosely coupled z/TPF complex.

SSU

Specifies the subsystem user (SSU) where the global record resides, where:

currentssu: The current subsystem user name that the command is currently running from.
ssuname: The 1- to 4-character subsystem user name.
ALL: Indicates the request is for all subsystem users in the specified subsystem.

SSUGroup-groupname

Specifies the subsystem user group where the global record resides, where groupname is the 1- to 8-character subsystem user group name. The SSUGROUP and SSU parameters are mutually exclusive.

IS

Specifies the I-stream where the global record resides, where:

isnumber: The 1- to 2-digit I-stream number.
ALL: Indicates the request is for all I-streams in the tightly coupled z/TPF complex.

FROMGLobal-globalname

Specifies the name of a previously initialized global record to copy the global data from, where globalname is the 1- to 8-character name assigned to the format-2 global record.

FROMProc

Specifies the processor in a loosely coupled complex where the global record to copy from resides, where:

localid: The current processor ID that the command is currently running from.
procid: The 1-character processor ID of the processor where the global record resides.

FROMSsu

Specifies the subsystem user (SSU) where the global record to copy from resides, where:

currentssu: The current subsystem user name that the command is currently running from.
ssuname: The 1- to 4-character subsystem user name.

FROMIs-isnumber

Specifies the I-stream where the global record to copy from resides, where isnumber is the 1- to 2-digit I-stream number.

Additional information

Online help information is available for this command. To display the help information, enter one of the following commands:
- ZGLBL HELP
- ZGLBL ?
The z/TPF system will prompt you to enter the ZGLBL CONTINUE or ZGLBL CANCEL command to continue or end the function if any copy of the global record has already been initialized.
The global record initialization occurs immediately.
The maximum allowable size for a keypointable or a synchronizable format-2 global record is directly related to the maximum number of commit buffers that can be used in a single transaction, which is 25 percent of the number of I/O control blocks (IOBs) allocated for the active memory configuration. The maximum size, in bytes, for a keypointable or synchronizable format-2 global record is equal to (the number of IOBs ÷ 4) × 3999.
If the global record is defined as processor shared, SSU shared, and/or I-stream shared, the global record will be initialized for all corresponding processors, SSUs, and/or I-streams in the z/TPF complex.
If the global record is defined as processor unique, SSU unique, and/or I-stream unique, the global record will be initialized for the specified processor, SSU, and/or I-stream. Enter the ZGLBL GLOBAL INITIALIZE command again if it is necessary to copy the global data to additional processors, SSUs, and/or I-streams. The ALL parameter can be used to initialize the global record for all processors, SSUs and/or I-streams.
To initialize the copy of the global for a specific subsystem user group, specify the group name with SSUGROUP parameter. You cannot use the SSU parameter.
If the global record is defined as user-controlled, the global initialization user exit (UGLI) will be called to perform the initialization function.
Enter the ZDSMG DEFINE command to define the data definition that identifies the location of the global data input deck that the initialization will take place from.
After the global record is defined with the ZGLBL GLOBAL DEFINE command, the global record must be initialized by entering the ZGLBL GLOBAL INITIALIZE command before it can be used or referenced by applications.
If a previously initialized global record is being reinitialized with this command, the previous version of the global data will be saved on DASD until the expiration time limit that you specify for the fixed-file records has elapsed or they are released by entering the ZGLBL GLOBAL RELEASE command. The main storage for the previous version will not be released until there are no ECBs referencing it.
If the global record is defined as a format-1 global in migration state, user exit UGLM is called to determine the address and size of the global data.
When initializing a SSU-shared, processor-shared, or I-stream-shared format-2 global record, you must specify either SSU-ALL, PROC-ALL, or IS-ALL respectively; or omit the parameters altogether.
When initializing a format-1 global in migration state, you must use the SOURCE-ASDEFINED parameter and the SIZE parameter cannot be specified.
The z/TPF system provides two versions (Linux® and MVS) of an unsupported tool called GLINIT that you can use with this command and the SOURCE-INPUTDECK parameter. This tool will create an input deck that includes the mandatory 128-byte header and the global data. It also puts the global name and size of the global data into the header (using the mandatory GLOBAL and SIZE parameters) as well as any of the optional parameters, such as SSU, SSUGROUP, PROC or IS. If you understand and agree that the GLINIT tool is unsupported, you can download it. Information about the header and how to use this tool (both Linux and MVS versions) can be found in the glinit.readme file and the man page on Linux.
To display the attributes and data of a format-2 global record, enter the ZDGBL command and specify the appropriate parameter.
If you specify SOURCE-GLOBAL and the SIZE parameter, and if the specified value for the SIZE parameter is greater than the size of the specified format-2 global record, the data after the existing format-2 global data is set to x'00'.
If you specify SOURCE-GLOBAL and the SIZE parameter, and if the specified value for the SIZE parameter is less than the size of the specified format-2 global record, the current size of the format-2 global record is used.

Examples

The following example reinitializes global record _GLBTEST in the WP1 subsystem from the global data input deck represented by the data definition name GLOBDATA. ZGLBL CONTINUE or ZGLBL CANCEL are only displayed if at least one copy of the global record has already been initialized.

User:   WP1/ZGLBL GL INIT _GLBTEST SOURCE-INPUTDECK INPUT-GLOBDATA

System: GLBL0017A ENTER ZGLBL CONTINUE OR ZGLBL CANCEL. 
        IF ZGLBL CONTINUE IS NOT ENTERED, THE SYSTEM 
        WILL CANCEL THIS ACTION IN 5 MINUTES.

User:   ZGLBL CONTINUE

System: GLBL0015I CONTINUING WITH - ZGLBL GLOBAL INITIALIZE
        GLBL0200I FORMAT-2 GLOBAL RECORD _GLBTEST INITIALIZED SUCCESSFULLY

The following example displays the characteristics of global record __glf201 and shows that the size of the global record is changed from 1024 hex bytes to 4000 hex bytes.

User:   zdgbl __glf201

System: CSMP0097I 11.14.33 CPU-B SS-BSS SSU-HPN IS-01
        DGBL0020I 11.14.33 GLOBAL RECORD DISPLAY
          GLOBAL DATA INFORMATION
            GLOBAL NAME:       __glf201
            MEMORY ADDRESS:    0000000014E32FD8
            SIZE(HEX BYTES):   0000000000001024
            GDR RECORD TYPE:   #IF2G
            1ST GDR ORDINAL:   0000000000000000
            NBR GDR ORDINALS:  0000000000000002
            SUBSYSTEM USER:    HPN
            PROCESSOR ID:      B
            ISTREAM NUMBER:    1
          GLOBAL CONTROL INFORMATION
            GCR RECTYPE:       #IF2GCR
            GCR ORDINAL:       0000000000000005
            LOCATION:          31BIT
            PROTECTED:         NO
            LOAD TIME:         RESTART
            SUBSYSTEM USER:    SHARED
            PROCESSOR:         SHARED
            ISTREAM:           SHARED
            KEYPOINTABLE:      NO
            SYNCHRONIZED:      NO
            CONTROLED BY:     SYSTEM
        END OF DISPLAY

User:   zglbl global initialize __glf201 source-global fromglobal-__glf201 size-4000

System: CSMP0097I 11.15.09 CPU-B SS-BSS SSU-HPN IS-01
        GLBL0212E 11.15.09 AT LEAST ONE COPY OF GLOBAL __glf201 IS ALREADY INITIALIZED

        CSMP0097I 11.15.09 CPU-B SS-BSS SSU-HPN IS-01
        GLBL0017A 11.15.09 ENTER ZGLBL CONTINUE OR ZGLBL CANCEL. 
                           IF ZGLBL CONTINUE IS NOT ENTERED, THE SYSTEM 
                           WILL CANCEL THIS ACTION IN 5 MINUTES.

User:   zglbl continue

System: CSMP0097I 11.15.14 CPU-B SS-BSS SSU-HPN IS-01
        GLBL0200I 11.15.14 FORMAT-2 GLOBAL RECORD __glf201 SUCCESSFULLY INITIALIZED

User:   zdgbl __glf201
  
System: CSMP0097I 11.15.20 CPU-B SS-BSS SSU-HPN IS-01
        DGBL0020I 11.15.20 GLOBAL RECORD DISPLAY
          GLOBAL DATA INFORMATION
            GLOBAL NAME:       __glf201
            MEMORY ADDRESS:    0000000014FE4000
            SIZE(HEX BYTES):   0000000000004000
            GDR RECORD TYPE:   #IF2G
            1ST GDR ORDINAL:   00000000000000C5
            NBR GDR ORDINALS:  0000000000000005
            SUBSYSTEM USER:    HPN
            PROCESSOR ID:      B
            ISTREAM NUMBER:    1
          GLOBAL CONTROL INFORMATION
            GCR RECTYPE:       #IF2GCR
            GCR ORDINAL:       0000000000000041
            LOCATION:          31BIT
            PROTECTED:         NO
            LOAD TIME:         RESTART
            SUBSYSTEM USER:    SHARED
            PROCESSOR:         SHARED
            ISTREAM:           SHARED
            KEYPOINTABLE:      NO
            SYNCHRONIZED:      NO
            CONTROLLED BY:     SYSTEM
        END OF DISPLAY