gtps4m2uSystem Generation

GLOBAL

The GLOBAL macro is used to specify the required size of the main storage global areas. You should refer to TPF System Installation Support Reference for information about global areas before providing inputs to this macro.

The GLOBAL macro is required.

Format




Notes:

  1. When the GLOBAL macro is coded in a non-MDBF (multiple database function) environment, the SSU... parameters can only be coded with one value each. For an MDBF user, up to 94 individual values may be coded. The number of values specified should be equal to the number of subsystem users defined in the SSDEF macro.
    Note:
    The maximum number of subsystem users per subsystem is 94. The maximum number of subsystem users in the entire system is 126. The total number of subsystems plus subsystem users must be less than or equal to 128.

  2. Due to the limitation of the macro language, only 255 characters can be input on a parameter. Therefore, if the total subsystem user global definitions exceed 255 characters (including syntax), it will be necessary to code succeeding GLOBAL macro statements.

  3. If either the SSUXSHRx or SSUXUNQx parameters is coded with a non-zero value then an extended global area will be defined in upper main storage just below the CIO area. This area will be equal in size to the sum of the total specified in all SSUXSHRx parameters, plus the number of I-streams times the total specified in all SSUXUNQx parameters.

  4. A Global Attribute Table (GAT) will always be generated. The main storage address portion of each global directory entry will always consist of 4 bytes.

SSUIUNQx=(n1-n94)
Specifies the maximum number of 4K-byte blocks required to contain the I-stream unique primary globals and global directories for a given global area x, where x = 1, 2 or 3. All values coded for SSUIUNQx must be nonzero. The size of each unique global area will be the same on all I-streams. The valid range is 1-65 535.

SSULMOD=(n1-n94)
Specifies the core load mode number for each subsystem user to be stored in keypoint 'A'. (Refer to notes above.)

The load mode specified in program test vehicle (PTV) test units overrides this value.

These numbers are treated as hexadecimal values, and the valid range is X'0'-X'FF'. See TPF System Installation Support Reference for more information about core load mode numbers.

SSUISHRx=(n1-n94)
Specifies the number of 4K-byte blocks required to contain the I-stream shared primary global records for global area x, where x = 1, 2 or 3. The default value is zero. The valid range is 1-65 535.
Note:
For the first or only subsystem user in the TPF system (the BSS), the value coded for SSUISHR3 must specify enough storage to contain the RCAT. In addition, if SLC support is genned in the system, the value coded for SSUISHR2 must specify enough storage to contain the special program records. Refer to the TPF System Installation Support Reference for more information.

SSUXSHRx=(n1-n94)
Specifies the number of 4K-byte blocks required to contain the I-stream shared extended global records for global area x, where x = 1, 2 or 3. The default value is zero. The value(s) specified will be added to the values coded for SSUXUNQx to calculate the size of the extended global areas reserved for the main I-stream's extended globals. The valid range is 1-65 535.

SSUXUNQx=(n1-n94)
Specifies the maximum number of 4K-byte blocks required to contain the I-stream unique extended globals for a given global area x, where x = 1, 2 or 3. The default value is zero. The value(s) specified will be used as the size of the extended global areas reserved for the application I-streams. The valid range is 1-65 535.

AMSGRC=NO|YES
Application message recovery is to be supported. See the TPF Data Communications Services Reference for more information about application recovery.

RCYTO=5|n
Application message recovery CRET timeout value in seconds, where n=any valid number from 1 to 255. This parameter is not valid if AMSGRC=NO. See the TPF Data Communications Services Reference for more information about application recovery.

ARPKP=YES|NO
Defines if application recovery package keypointing is to take place. See the TPF Data Communications Services Reference for more information about application recovery.

KEYUPD=1|n
Specifies the time for controlling the frequency of global keypoint updating. Time is specified in second increments with a minimum of 1 second and a maximum of 60 seconds.

Examples

TPF system with MDBF support: The following specifies the size of the three global areas in memory for a system with two subsystem users. Both subsystem users have the same size I-stream unique primary areas (6,6; 2,2; 2,2), but the second subsystem user requires less storage for its I-stream shared records (1,0,1), and has no shared global 2 records. The two subsystems have different load modes (8,9). In addition, the same I-stream unique extended global areas are defined (5,5; 1,1; 3,3), but the second subsystem has no I-stream shared extended globals at all. Application message recovery is not required.

GLOBAL     SSUISHR1=(4,1),SSUISHR2=(3,0),SSUISHR3=(3,1),    x
           SSUIUNQ1=(6,6),SSUIUNQ2=(2,2),SSUIUNQ3=(2,2),    x
           SSUXSHR1=(3,0),SSUXSHR2=(1,0),SSUXSHR3=(1,0),    x
           SSUXUNQ1=(5,5),SSUXUNQ2=(1,1),SSUXUNQ3=(3,3),    x
           SSULMOD=(8,9)

TPF system without MDBF support: The following specifies the size of the I-stream shared and I-stream unique areas for global areas 1, 2, and 3, and the core load mode number. The total size of the I-stream shared area below 16M will be 3 + 5 + 4 = 12 4K-byte blocks, and the size of the I-stream unique area will be 6 + 10 + 8 = 24 4K-byte blocks. Because all extended global parameters are omitted, the system will be generated without extended globals, but a GAT will still be created. Application message recovery will be supported with the RCYTO and ARPKP parameters defaulting to 5 seconds, and YES, respectively. The global keypoints will be updated every 3 seconds.

GLOBAL     SSUISHR1=3,SSUISHR2=5,SSUISHR3=4 ,               x
           SSUIUNQ1=6,SSUIUNQ2=10,SSUIUNQ3=8,               x
           SSULMOD=7,AMSGRC=YES,KEYUPD=3

References