gtps4m3eSystem Generation

UFTFTI

The UFTFTI macro is used by the offline FACE table generation program to define UFT/FTI characteristics for use by FARF4, FARF5, and FARF6. It is not necessary to code UFTFTI statements for a FARF3-only FACE table. UFTFTI also defines the FARF migration stage, as well as the default address dispense mode, and provides a means to attach a single user data structure related to the entire FACE table.

For each UFT, the length (in bits) of the FTI is defined. Each UFT/FTI-length combination is coded as an ordered pair. UFT/FTI pairs defined for FARF6 are independent from UFT/FTI pairs defined for FARF4 and FARF5.

There are two FARF stages: FARF3/4 and FARF4/5. FARF3/4 allows both FARF3 and FARF4 address to coexist in the database. FARF4/5 allows both FARF4 and FARF5 address to coexist in the database. FARF6 addresses are dispensed in either stage and are independent of dispense mode.

There are two possible default address dispense modes: FARF3 and FARF4. The allowable subsets of address dispense modes for a particular FACE table directly correspond to the address formats allowed for the table's migration stage.

Format




UFTI, UFTIX=(list)
Specifies a list of UFT-value/FTI-length combinations expressed as ordered pairs.

Each UFT is expressed as a decimal number from 0 to 63. The FTI-length is the length in bits of the FTI field for any address using this particular UFT (fixed or pools, FARF4 or FARF5). Each FTI length is expressed as a decimal number

If the dispensing mode is FARF34 and the database is only to be defined in terms of FARF3 addresses, it is not necessary to code the UFTI parameter.

A total of 64 UFT/FTI pairs can be coded. Because the assembler has a limit of 255 characters in a sublist (about 32 UFT/FTI pairs), both UFTI and UFTIX are provided to avoid assembly errors. Code UFT/FTI pairs on the UFTI parameter first until you reach the 255-character limit and then use the UFTIX parameter.

The following is an example of a valid UFT/FTI length combination.

UFTFTI    UFTI=((0,10),(1,2),(2,25))

This UFTI specification specifies three UFTs 0, 1, and 2, and their associated FTI lengths. There are 210 or 1024 FTIs associated with UFT 0, 22 or 4 FTIs with UFT 1, and 225 or 33,554,432 FTIs with UFT 2. Moreover the specification defines the number of records that can be defined with each UFT and FTI, since six bits of an address are devoted to the UFT and the number specified by UFTI= indicates the number of bits devoted to FTIs. For UFTI=(0,10) we have:

32 bits  -  (6 bits UFT  + 10 bits FTI)
  =  32 - 16 = 16 bits FARF5 ordinal numbers
 
16 bits - 2 bits for FARF4 = 14 bits FARF4 ordinal numbers

16 bits for FARF5 addresses and 14 bits for FARF4 addresses (removing the FARF4 control bits from the total).

UFTI6=(uft,fti)
Specifies a list of UFT-value/FTI-length combinations expressed as ordered pairs. These are the UFT/FTI pairs that are used for FARF6 addressing only. These pairs are independent of the pairs used for FARF4 and FARF5 addressing.

Each UFT is expressed as a decimal number from 1 to 65535. The FTI-length is the length, in bits, of the FTI field for a FARF6 address using this particular UFT. Each FTI length is expressed as a decimal number from 8 to 24. A UFT value of 0 is illegal. To reduce the amount of storage required by the FACE table, define the lowest UFT values first.

STAGE
Specify one of the following:

FARF34
A migration stage from FARF3 to FARF4. A FACE table that supports both FARF3 and FARF4 address dispense modes is generated. This is the default.

FARF45
A migration stage from FARF4 to FARF5. A FACE table that supports both FARF4 and FARF5 address dispense modes is generated.
Note:
FARF6 addresses are dispensed in both FARF34 and FARF45 address modes.

MODE=FARF3|FARF4|FARF5
The MODE parameter defines the default address dispense mode for dispensing FARF addresses (for fixed and pool record types). This attribute can be changed online by command ZMODE. If MODE is not coded, the default dispensing mode in STAGE=FARF34 is FARF3 and in STAGE=FARF45 it is FARF4.

UFACDATA=label
The UFACDATA parameter attaches user data at the FACE table level. The label must be a valid entry point in the user data, as it results in a VCON in the FACE table. The VCON is resolved by the MVS linkage editor. The effect of this mechanism is to extend the information provided in the FACE table by allowing user specified data to be associated with a particular FACE table.

The CTSD, CONK, and IRCCR symbols are reserved and must not be used.

Examples

None.

References

None.