How And Why Is MASTFAC Used?

Document ID : KB000019040
Last Modified Date : 14/02/2018
Show Technical Document Details

Description:

CA Top Secret has a MASTFAC (Master Facility) operand. How and why is this used?

Solution:

The Master Facility (MASTFAC) is used on a region acid to associate a specific facility with all the address spaces that have that region acid. This is for both address spaces started as started tasks and address spaces started as batch jobs. Here is an example of each:

Started task
Let's say you have proc CICSDEV and it is started as a started task. In the started task table (STC table), you have added the procname with an acid of CICSD1 (TSS ADD(STC) PROCNAME(CICSDEV) ACID(CICSD1) ). You want the predefined facility of CICSTEST associated with the

CICSDEV address space. You would add CICSTEST as a MASTFAC to the region acid:

TSS ADD(CICSD1) MASTFAC(CICSTEST)

(NOTE: If the CICSDEV region is up when you issue the above command, it will need to be recycled to pick up the new MASTFAC.)

Now any user that signs on to CICSDEV will need access to FAC(CICSTEST).

Batch job:
If CICSDEV is a batch job with USER=CICSD1, then CICSD1 is the region acid for this job (since this is the acid the job will under). You want thepredefined facility of CICSTEST associated with the CICSDEV address space. You would add CICSTEST as a MASTFAC to the region acid:

TSS ADD(CICSD1) MASTFAC(CICSTEST)

(NOTE: If the CICSDEV region is up when you issue the above command, it will need to be recycled to pick up the new MASTFAC.)

Now any user that signs on to CICSDEV will need access to FAC(CICSTEST).

If there is no MASTFAC on the region acid, in order to determine which facility will be used for that address space, CA Top Secret will go through the facilities (in the facility matrix table) until the first occurrence of the first 3 letters of the initiating program (for the region) is found and we will use this as the facility. For example, with CICS, the program that starts CICS is DFHSIP, so if there is a CICS started task or batch job with no MASTFAC on the region acid, TSS will search the facilities and the first one found with INITPGM=DFH is CICSPROD, so this will be the facility associated with that CICS region.