The domains are set up in an existing MAREN network. For this purpose MAREN V12.5 and higher must be operating on all systems in the network.
Planning
Before domains are set up the following questions must be answered:
Which systems of the MAREN network should be combined to form a domain? What should the domains be called?
On which systems should the ADA work?
Are all reserved tapes assigned to the specified domain or do some/all belong to the standard domain?
Are all free tapes assigned to the standard domain or do some/all belong to other domains?
Example
A slightly modified form of the constellation in "Domain concept" is taken as an example for this section:
System01 forms the domain DomAAA.
System02 and System03 form the domain DomBBB.
System04 forms the domain DomCCC.
Reserved tapes always belong to the domains concerned. The free tapes belong to the standard domain. Only the domain DomCCC can also contains free tapes.
Procedure
Proceed as described below when you set up domains. Keep to the sequence of the steps. Use the MARENADM administrator program on the system on which the ADA is to continue working.
For the procedure described it is assumed that reserved and free tapes already exist in an existing MAREN network.
- Enable operation with domains. You use the following statement here:
//MODIFY-GLOBAL-PARAMETERS DOMAIN-PROTECTION=*ACTIVE Restart the MARENCP, MARENUCP and MARENADM programs on all the systems.
After these two steps MAREN distinguishes between Domain Administrators (DAs) and All-Domain Administrators (ADAs). Here the ADA can initially enter statements on all systems in the MAREN network.
- Define domains and assign systems to the domains.
The MODIFY-DOMAIN-ASSIGNMENT statement assigns a system to a domain. At the same time a new domain is defined if the name of a domain which does not currently exist is specified.
Example
The domains DomAAA, DomBBB and DomCCC are defined with the statements below. At the same time the systems System01, System02, System03 and System04 are assigned to the relevant domains://MODIFY-DOMAIN-ASSIGNMENT HOST=System01,NEW-DOMAIN=DomAAA
//MODIFY-DOMAIN-ASSIGNMENT HOST=System02,NEW-DOMAIN=DomBBB
//MODIFY-DOMAIN-ASSIGNMENT HOST=System03,NEW-DOMAIN=DomBBB
//MODIFY-DOMAIN-ASSIGNMENT HOST=System04,NEW-DOMAIN=DomCCC
The MODIFY-DOMAIN-ASSIGNMENT statement can also be used to assign a system which already belongs to one domain to another (“new”) domain. Release selected systems for the All-Domain Administrator (ADA).
The ALL-DOMAIN-ADMIN and HOST operands in the MODIFY-MAREN-PARAMETERS statement determine the systems on which the ADA may work. Either individual systems or all systems in a domain can be specified here. As soon as (at least) one system has been released for the ADA, the ADA can no longer work on systems which have not been explicitly released for him/her.
The subsequent MODIFY-GLOBAL-PARAMETERS statement with the ALL-DOMAIN-ADM-PASSW operand defines whether the ADA must legitimate himself/herself with a password.
Example
The ADA works on all systems of the domain DomBBB:
//MODIFY-MAREN-PARAMETERS HOST=*ALL-FROM-DOMAIN(DOMAIN=DomBBB),ALL-DOMAIN-ADMIN=*ALLOWEDThe password for the ADA is: A4M
//MODIFY-GLOBAL-PARAMETERS ALL-DOMAIN-ADM-PASSW=A4MLegitimate yourself and log on as the ADA.
To do this the administrator quits MARENADM with the HOLD-PROGRAM statement, enters the ADA password in BS2000 with the ADD-PASSWORD command and returns to MARENADM using the RESUME-PROGRAM command. You then log on as the ADA with the MODIFY-ADMINISTRATION-SCOPE DOMAIN=*ALL statement.
Assign reserved tapes to domains (optional).
After the domains have been defined, all previously reserved (and the free) tapes belong to the standard domain. Using the MODIFY-VOLUME-ATTRIBUTES statement (VOLUME= and SELECT=*RESERVED operands) the ADA assigns reserved tapes to another domain.
Example
For this example it is assumed that a file exists for each domain which contains the tapes which are to be assigned to the domain (cf. INPUT-FILE operand in the MODIFY-VOLUME-ATTRIBUTES statement). For the domain DomAAA this is the file VOLAAA, for DomBBB the file VOLBBB, and for DomCCC the file VOLCCC. (Naturally the tapes can also be selected in a different way.) The ADA then assigns the reserved tapes to the domains using the following statements:
Assign free tapes to domains (optional).
Free tapes normally belong to the standard domain. Using the MODIFY-VOLUME-ATTRIBUTES statement (VOLUME and SELECT=*FREE operands) the ADA assigns free tapes to another domain.
Using the subsequent MODIFY-DOMAIN-PARAMETERS statement (DOMAIN and FREE-VOLUMES=*FROM-OWN-DOMAIN operands) the ADA defines that these free tapes will be used for future reservations. This definition is also effective for the release and initialization of tapes. Thus the release or initialization of tapes results in them either being put in the standard domain or remaining in their own domain.
Example
For this example it is assumed that free tapes with the numbers V001 through V199 exist in the standard domain. The ADA now assigns these to the domain DomCCC:
//MODIFY-VOLUME-ATTRIBUTES VOLUME=*INTERVALL(*FIRST=V001,TO=V199),SELECT=*FREE(NEW-DOMAIN=DomCCC)Subsequently the ADA defines that these free tapes can only be used in the domain DomCCC:
//MODIFY-DOMAIN-PARAMETERS DOMAIN=DomCCC,FREE-VOLUMES=*FROM-OWN-DOMAIN