CLOSE-MAREN-FILES Close MAREN catalog

Privilege                 ADA, DA, administrator without domains

This statement closes all opened files of the MAREN catalog. In addition, it temporarily blocks all access to the MAREN catalog via MARENCP. The administrator uses the HOST-NAME operand to specify whether the lock is to apply for his/her own system, for a particular system, or for all systems in a MAREN network.

Format

CLOSE-MAREN-FILES                                                     Alias: CL / CLMF

HOST-NAME = *OWN / *ALL / <alphanum-name 1..8> / *ALL-FROM-DOMAIN(...)
	*ALL-FROM-DOMAIN(...)
		|	DOMAIN = *STD-DOMAIN /*OWN/<alphanum-name 1..8>

Operands

HOST-NAME =
Specifies the systems for which the files of the MAREN catalog are to be closed.

HOST-NAME = *OWN
The files of the MAREN catalog are only closed for the local system. If the ADA has used the MODIFY-ADMINISTRATION-SCOPE DOMAIN=... statement to become the DA of a domain, HOST=*OWN addresses the system which was determined by the HOST operand in the MODIFY-ADMINISTRATION-SCOPE statement.

HOST-NAME = *ALL
When domains are used, the files of the MAREN catalog are closed for all systems in a DA’s own domain; for the ADA, the files of the MAREN catalog are closed for all systems.

HOST-NAME = <alphanum-name 1..8>
Name of a system. If the DA enters a system name when domains are being used, this system must belong to the DA’s own domain.

HOST-NAME = *ALL-FROM-DOMAIN (...)
The files of the MAREN catalog are closed for systems of particular domains. This operand may only be used by the ADA.

DOMAIN =
Selects the domain.

DOMAIN = *STD-DOMAIN
The files of the MAREN catalog are closed for the systems in the standard domain.

DOMAIN = *OWN
The files of the MAREN catalog are closed for the systems in the local domain. The user’s own domain is the domain of the system on which the ADA is currently working.

DOMAIN = <alphanum-name 1..8>
The files of the MAREN catalog are closed for the systems in the specified domain.

Notes

• The volume catalog and the logging file (if any) are closed.

• If the MARENADM program opened the catalog directly, the open files are likewise closed. When carrying out repair work on the MAREN catalog, all other MARENADM applications which have opened the catalog directly must be terminated or the CLOSE-MAREN-FILES statement must also be entered there.

• After the CLOSE-MAREN-FILES statement is executed, only the following MARENADM statements can be executed via the MARENCP:

  OPEN-MAREN-FILES, SHOW-MAREN-STATUS, STOP-CONTROL-PROGRAM

  All other MARENADM access attempts via MARENCP, all MAREN access, and all implicit access to the MAREN catalog via MAREN are rejected.

• The MAREN administrator uses the CLOSE-MAREN-FILES statement to prevent access to the MAREN catalog from the local system and from other systems in the MAREN network. When carrying out repair work on the MAREN catalog, the administrator must issue the CLOSE-MAREN-FILES statement for all systems in the MAREN network.

• The catalog lock is lifted by means of the OPEN-MAREN-FILES statement or by rebooting the BS2000 system. However, it is not lifted by rebooting the MARENCP control program or the MAREN subsystem.

Example

//close-maren-files host-name=*all
%	MARM118 ALL FILES OF MAREN CATALOG CLOSED When performing repair work, the MAREN administrator closes the opened files of the MAREN catalog on all systems. The MAREN catalog is temporarily locked.