gtps4m2u | System Generation |
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:
- 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.
- 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.
- 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.
- 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