z/OS MVS Programming: Resource Recovery
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Using registration services

z/OS MVS Programming: Resource Recovery
SA23-1395-00

Registration services allow a resource manager to define itself to the operating system. A resource manager is a program that controls and manages access to a resource.

Examples of resource managers are a database manager that works with RRS to protect resources, a work manager that uses the context services component, and a communications resource manager that handles protected communications, such as Advanced Program-to-Program Communication/MVS (APPC/MVS).

Note: The resource manager here is different from an RTM resource manager, which is related to the operating system's recovery termination management (RTM) and runs during termination processing.

As part of registration, a resource manager identifies itself and its exit routines, if any, to exit managers, which have registered with the system. An exit manager invokes an exit routine when a specific event occurs. Examples of exit managers are context services and resource recovery services.

The registration services are:

Callable service Description
Register_Resource_Manager Register a resource manager.
Retrieve_Resource_Manager_Data Retrieve resource manager global data.
Set_Exit_Information Identify resource manager and its exit routines, if any, to an exit manager.
Unregister_Resource_Manager Unregister a resource manager.

For information on the calls, see Callable registration services.

An authorized resource manager can provide an exit routine to be invoked to notify the resource manager about events related to registration, such as when an exit manager becomes registered or unregistered, or when your resource manager exit routines have become unset. Although the notification exit routine is optional, it is a good idea to provide one; it can report events that are important to your resource manager. The registration services exit routine is:

Exit routine

Exit Number in:
Hexadecimal
(Decimal)
Equate Symbol

Event
NOTIFICATION

1
(1)
CRG_NOTIFICATION_
    EXIT

An exit manager has become registered or unregistered.

NOTIFICATION exit routine describes the routine.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014