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