Creating a FACILITY for z/OSMF

Document ID : KB000103332
Last Modified Date : 25/06/2018
Show Technical Document Details
Issue:
How do you creating a FACILITY for z/OSMF?
Resolution:
Creating the FACILITY is really not different than the other applications done in he past. Only the names and program names are different. 

To create a z/OSMF FACILITY to CA Top Secret, you will need to rename one of the unused USERnn facilities in TSS. 

The following example assumes facility USER12 is free and has not already beeen previously used. 

TSS MODI FAC(USER12=NAME=ZOSMF) 
where 'ZOSMF' is what you want to call the facility 
TSS MODI FAC(ZOSMF=INITPGM=yyy) 
where 'yyy' is the first 3 characters of the program that starts the 
started task 
TSS MODI FAC(ZOSMF=zzzzz) 
where 'zzzzz' is any other facility control option you want to change 
(ie MODE=WARN, etc) 

The TSS MODI command is only valid until the next recycle of TSS. 
To make the changes permanent, add the following to the TSS parameter 
file: 

FAC(USER12=NAME=ZOSMF) 
FAC(ZOSMF=INITPGM=yyy) 
FAC(ZOSMF=MODE=FAIL) 

Once you have the facility defined, assign the FACILITY to the z/OSMF started task: 

TSS ADD(stcacid) MASTFAC(ZOSMF) 

where 'stcacid' is the acid in the STC table associated with the procname that starts the started task 'ZOSMF' is the facility name used above 

After adding the MASTFAC, you will need to recycle the started task in order to pick up the changes. 

To authorize users to signon and use z/OSMF, authorize the acid the following command: 

TSS ADD(acid) FAC(ZOSMF) 

where 'acid' is either the user acid, an attached profile, or the ALL record if you want all users to be allowed 'ZOSMF' is the facility name used above.