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


Function code and related search information

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

The function codes determine which parameters VTAM® passes to the directory services management exit routine. In addition to function codes, VTAM passes search-specific information to the exit routine.

Table 1 describes:
  • The function codes that VTAM passes to the installation-wide exit routine
  • Additional search-specific information
Table 1. Function code and related search information
Byte Description
0 Function code:
X'00'
The exit routine has been called for initial search authorization.
X'01'
The exit has been called for the border node selection function.
X'02'
The exit has been called for the interchange node selection function.
X'03'
The exit has been called for the CDS selection function.
X'04'
The exit has been called for the alternate CDS selection function.
X'05'
The exit has been called for the central resource registration selection function.
X'08'
The exit is being driven the last time before being replaced; an operator issued the MODIFY EXIT command with OPTION=REPL specified.
X'09'
The exit was replaced and is being driven the first time after being reloaded.
X'FE'
The exit routine has been called to select the functions it will process. This begin function is processed only once during VTAM initialization.
X'FF'
One of two conditions exists:
  • An operator has issued the MODIFY EXIT...OPTION=INACT command; this ends the installation-wide exit. Or,
  • The exit routine has been called to perform required cleanup during VTAM termination. This end function is processed only once during VTAM termination.
 
1 Related search information:
This 3-bit network ID authenticity indicator indicates one of the following:
B'0... ....'
The CP(OLU) cannot accept a different name for the DLU on the response than what was specified on the request.
B'1... ....'
The CP(OLU) will accept a different name for the DLU on the response than what was specified on the request.
B'.0.. ....'
The resource name represents a generic name (this might not be the real name of the resource).
B'.1.. ....'
The resource name is the real name of the resource.
B'..0. ....'
The resource network ID is the real network ID of the resource.
B'..1. ....'
The resource network ID might not be the real network ID of the resource.
 
2 Related search information:

This 1-byte field specifies the number of hops that a broadcast search can traverse before terminating. 

3 Related search information
The following bit definitions indicate the role of this node:
Bit value
B'1... ....'
This node is a CP(OLU)
B'0... ....'
This node is not a CP(OLU)
B'.1.. ....'
This node is a CP(DLU)
B'.0.. ....'
This node is not a CP(DLU)
B'..1. ....'
This node is a network node(OLU)
B'..0. ....'
This node is not a network node(OLU)
B'...1 ....'
This node is a network node(DLU)
B'...0 ....'
This node is not a network node(DLU)
B'.... 1...'
This node is an origin directory server
B'.... 0...'
This node is not an origin directory server
B'.... .1..'
This node is an alternate directory server
B'.... .0..'
This node is not an alternate directory server
B'.... ..1.'
This node processes an interchange node search
B'.... ..0.'
This node does not process an interchange node search
B'.... ...1'
This node is an intermediate network node on broadcast
B'.... ...0'
This node is not an intermediate network node on broadcast
 
4 Search origin information
The following bit definitions indicate the source of the current search:
B'1... ....'
The search originated from the subarea network
B'0... ....'
The search did not originate from the subarea network
B'.1.. ....'
The search was received over an APPN subnetwork link
B'.0.. ....'
The search was not received over an APPN subnetwork link
B'..1. ....'
The search was received from an end node
B'..0. ....'
The search was not received from an end node
B'...1 ....'
The search was received from a network node
B'...0 ....'
The search was not received from a network node
B'.... 1...'
The search was received from a border node
B'.... 0...'
The search was not received from a border node
 
5 Search type information
The following bit definitions indicate the purpose of the search:
B'1... ....'
Search is a resource discovery search
B'0... ....'
Search is not a resource discovery search
B'.001 ....'
Application GDS variable is CDINIT
B'.010 ....'
Application GDS variable is IOCD
B'.011 ....'
Application GDS variable is Notify
B'.101 ....'
No Application GDS variable present
B'.... 1...'
This is a PLU-initiated search that was sent on behalf of a SLU-initiated session
B'.... 0...'
This is not a PLU-initiated search that was sent on behalf of a SLU-initiated session

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014