z/OS Communications Server: IP Programmer's Guide and Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Using ENF event code 80 to listen for rpcbind events

z/OS Communications Server: IP Programmer's Guide and Reference
SC27-3659-02

The rpcbind server uses ENF event code 80 to send signals when rpcbind completes initialization or when rpcbind is stopping. Authorized RPC applications can use the ENFREQ LISTEN service to detect rpcbind server events. On the ENFREQ service, specify the X'80000000' event qualifier and the listener user exit routine that is to receive control after the specified event occurs. The specified listener user exit receives control when the rpcbind server completes initialization or when the rpcbind server is stopping.

Requirement: The RPC application must be authorized. The listener user exit must run as an SRB.
To listen for ENF event code 80, specify the qualifying events on the BITQUAL parameter, which specifies one of the following qualifiers:
  • A 32-byte field
  • A hexadecimal constant
  • A register consisting of the address of a 32-byte field that contains a bit-mapped qualifier defining the event
The qualifier is mapped by the mapping macro EZAENF80. The BITQUAL value for the status change event is ENF80_RPC_EVENT in EZAENF80. The EZAENF80 macro is in SYS1.MACLIB. See EZAENF80 Parameter list for ENF event code 80 listen exits for the mapping of ENF80 and ENF80_RPC control blocks.
When the listener user exit is driven, the ENF80 and ENF80_RPC control blocks are provided. The exit can use ENF80_RPC_FLAGS to determine whether the rpcbind server is initializing or stopping. The job name of the rpcbind server is also provided.
  • If ENF80_RPCINIT is on, the rpcbind server is initializing. The RPC application can register with this new rpcbind server.
  • If ENF80_RPCTERM is on, the rpcbind server is stopping. All RPC registrations are removed. The RPC application issues a message to indicate that RPC services are no longer available.

If the RPC application does not need to know whether the rpcbbind server is running, issue the ENFREQ REQUEST=DELETE request to delete the listen request.

For information about ENFREQ and listener exits, see:

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014