z/OS Communications Server: SNA Customization
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Redrive of exit for search authorization (function code X'00' with redrive bit on)

z/OS Communications Server: SNA Customization
SC27-3666-00

The exit can be redriven for authorization after the initial authorization call to reject the search or limit the scope of the search. When the exit is called for initial authorization, the DLU information might not be complete or accurate. Redriving the exit for authorization enables the exit to verify the DLU information before a directed search that could result in a session establishment is sent.

The exit indicates that it is to be redriven by setting the redrive bit in the search task options and setting return code 36 on the initial authorization call. If directory services management obtains DLU information that results in the sending of a directed search, the exit is redriven for authorization before the directed search is sent. When the exit is redriven, the initial authorization parameter list is used with the updated DLU information and the redrive bit is set to the value on to indicate that it is a redrive of the authorization function. When the NETID value is an alias and a border node is searching other networks, the DLU NETID value is updated with the NETID value of the adjacent network that is being searched. The exit cannot change the NETID value from the alias value to the real value on a redrive call.

When redriven for authorization, the exit has three options:
  • Authorize this search
  • Do not authorize this directed search but continue searching
  • Reject this search
Setting the return code to 0 authorizes the search; if the directed search fails, then searching continues. Setting the return code to 40 fails the current directed search but searching continues. For return code 0 or 40, the exit can set the redrive bit to be redriven for any additional directed searches. Setting the return code to 4 rejects the search, terminating this locate request.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014