gtps4m3hSystem Generation

UTPROT

The UTPROT macro is used to specify names to the table of utility interface programs which are to be entered during a utility processor ownership assignment or release. This macro may be submitted for fifty utilities.

UTPROT is required in a loosely coupled environment when the system being generated is a base only system or the basic subsystem of a multiple database function (MDBF) environment.

This macro will create the macro UIPROT in stage II to be used exclusively by program CNPO.

Format




UTIL=utility name
Identifies the system utility to be controlled via the processor resource ownership table by subsystem user, for example recoup, capture/restore, pool support. This is a 4-character unique utility identifier to be used with the utility interface program table in the program segment CNPO.

PGMNM=xxxx
Specifies the utility interface segment to be entered during a utility processor ownership assignment or release. xxxx is a 4-character interface segment. It is used to validate and set up tables for the utility support as desired.

UTCOM='user comments'
This parameter is optional and is provided for user comments. The user's comments must be enclosed in quotes and cannot be more than 35 characters in length.

XCHK=NO|YES
Specifies whether the utility interface segments are to be checked with the real time program tables created by SIP (SPPGML). This parameter should only be coded on the first UTPROT macro.

Notes:

  1. If the user specifies YES, all programs defined in this macro will be checked with the real time program tables. This will substantially increase the time required for generation. If this parameter is specified as NO, the user must be certain that the utility interface segments coded in this macro are also included in the real time program tables in the program list macro (SPPGML).

  2. Because the validation of input program names will substantially increase the time of the system generation, the default is no.

Examples

The following example specifies three system utilities to be controlled via the program resource ownership table. The respective utility interface segments to be entered during a utility processor ownership assignment or release have also been coded. The XCHK parameter has been coded NO since the validation of program names will SUBSTANTIALLY INCREASE the time of the system generation.

UTPROT  UTIL=CAP0,PGMNM=BXXX,UTCOM='TPF CAPTURE UTILITY0',XCHK=NO
UTPROT  UTIL=CAP1,PGMNM=BXXX,UTCOM='TPF CAPTURE UTILITY1'
UTPROT  UTIL=CAP2,PGMNM=BXXX,UTCOM='TPF CAPTURE UTILITY2'

References

None.