Setting up File Manager to use a template repository

A template repository is a VSAM file that contains cross-references of data sets, CICS® files (including CICS® TS and CICS® TD queues), path names, and WebSphere MQ queue names to their respective templates.

There are three ways to identify the template repository to a File Manager session. The methods are evaluated in the following order and the first specification is used for the rest of the session.

Specifying the repository data sets using PARMLIB options

You can specify one or more repository data sets in the PARMLIB member. Use this method to connect users to a repository data set name and to mandate templates or views for specified users.
  • Use the <U userid1, userid2, … useridn> tag to connect specified users to a repository data set name.
  • Use the <X xfacilit.profile> tag to apply the rule to all users who have read access or more to a specified XFACILIT profile.

Enter the repository definitions in order from the most specific to the most general. The first definition that matches the current user will be used.

Figure 1. Syntax

1  REPOS? DSN=dsname
2.1! MANDATORY=NO
2.1 MANDATORY=YES
2.1! RESTRICT=NO
2.1 RESTRICT=YES

Where:

DSN
The name of the repository data set.
MANDATORY
Specify YES if the repository identifies resources for the user that have templates or views that are to be used to anonymize or scramble the data.
Note: To enable dynamic scrambling through the TESTMASK command the resource entry must be marked as mandatory.
RESTRICT
Specify YES to restrict usage to the resources specified in the repository.

Example 1

Enter this PARMLIB definition to set up a mandatory repository for three users and default repository for the rest.

<U FRED, BOBBYB, BIILBO>
REPOS DSN=MASK.CREDIT.CARDS.REPOS,MANDATORY=YES
</U> 
REPOS DSN=DEFAULT.REPOS

Example 2

Enter this PARMLIB definition to set up a mandatory repository for any user having read access or more to the MY.MANDATED.USERS XFACILIT class profile.

<X MY.MANDATED.USERS>
REPOS DSN=MASK.CREDIT.CARDS.REPOS,MANDATORY=YES
</X> 
REPOS DSN=DEFAULT.REPOS

Allocating TPREPOS

The ddname TPREPOS can be allocated to a TSO/ISPF session or specified as a DD card to a batch job.

JCL:
//DD TPREPOS DISP=SHR,DSN=hlq.TEMPLATE.REPOSTRY 
TSO command:
'ALLOC FI(TPREPOS) DA('hlq.TEMPLATE.REPOSTRY') SHR REUSE'

You can also add a DD specification to the CONFIG=FM for File Manager tasks that require the ADFzCC server :

TPREPOS=FMN.TEMPLATE.REPOSTRY