DLT entry for directory services locate (Part 1)
- Entry:
- DLT
- VIT option:
- SSCP
- Event:
- Sending out a Locate Search
- VIT processing module:
- ISTRACSC
- Control is returned to:
- ISTDRSDL
This trace record is written when VTAM®'s directory services component forwards a locate search to some adjacent node.
Note: This trace record has been reformatted because of
an increase in the size of the task vector field.
- Byte (hex)
- Contents
- 00–02
- Record ID: C"DLT"
- 03
- 0
- 04
- ID is the primary address space ID (ASID). This field is 0 if the ASID is greater than X'FF'.
- 05–07
- 0
- 08–0F
- The task vector bits indicate the possible tasks for this locate search. The hex values listed below are in the task vector field of this entry and the task vector results field of the DLT2 entry.
- 08
-
- Vector
- Description
- X'80'
- Null task
- X'40'
- Directory services management exit
- X'20'
- Directory services database query
- X'10'
- Topology and routing services database query
- X'08'
- Forward to network node server
- X'04'
- One hop if directory services database is found
- X'02'
- One hop if control vector X'0E' is received for request
- X'01'
- Nonverify attempt
- 09
-
- Vector
- Description
- X'80'
- Directed because of network node destination LU hierarchy received on a search request
- X'40'
- Directed if directory services database is found
- X'20'
- Directed if the topology and routing services valid route selection CV is returned
- X'10'
- Resource Discovery Search
- X'08'
- Directed to a directory server
- X'04'
- Directed to a higher function directory server
- X'02'
- Directed to a directory server retry
- X'01'
- Directed to a gateway node
- 0A
-
- Vector
- Description
- X'80'
- Sequential directed search to alternate directory servers
- X'40'
- Sequential directed search to interchange nodes
- X'20'
- Subarea system resolution table (SRT) cache search
- X'10'
- Subarea search after a positive cache search
- X'08'
- Subarea search after a positive directory services database query
- X'04'
- Subarea search after a negative or no cache search
- X'02'
- Domain broadcast search
- X'01'
- Originate network broadcast search
- 0B
-
- Vector
- Description
- X'80'
- Forward network broadcast not originated by this node
- X'40'
- One-hop search request because of end node destination LU hierarchy received on a search request
- X'20'
- A cross-subnetwork directed search because of information received on the original request
- X'10'
- A cross-network directed search because of information found in the directory services database
- X'08'
- A directed search because of information found in the topology and routing services database
- X'04'
- Sequential directed search with the intent of finding the resource cross-subnetwork
- X'02'
- Generic cache search
- X'01'
- A directed search because of a SEARCH_RPY interprocess signal following a positive CACHE_SEARCH_RPY interprocess signal
- 0C
-
- Vector
- Description
- X'80'
- A directed search because of a SEARCH_RPY interprocess signal following a positive directory services database query
- X'40'
- A subarea search because of a SESS_INIT_INFO_RPY interprocess signal
- X'20'
- Database query after an RDS
- X'10'
- Sequential directed search to other network nodes in the generic resource configuration
- X'08'
- Final subarea search after resource not found in APPN with SSEARCH = APPNFRST
- 0D–0E
- 0
- 0F
-
- Vector
- Description
- X'01'
- Post processing
- 10–13
- Caller's return address
- 14–15
- The node role for this search. More than 1 bit can be on.
- Code
- Description
- X'80'
- CP originating LU
- X'40'
- CP destination LU
- X'20'
- NN originating LU
- X'10'
- NN destination LU
- X'08'
- Owning directory server
- X'04'
- Alternate directory server
- X'02'
- Intermediate network server
- X'01'
- Intermediate network node directed
- Position
- Description
- X'80'
- Intermediate network node broadcast
- 16
- Return code from the directory services management exit
- 17
- Terminating condition indicates why the search ended
- Code
- Description
- X'00'
- Processing can continue.
- X'04'
- Positive reply can be returned to parent.
- X'08'
- Gateway reply has been received.
- X'0C'
- Directory server reply has been received.
- X'10'
- An error was detected by a task called from the sequencer.
- X'14'
- Cleanup is pending after all replies are received from the search phase (CP session outage).
- X'18'
- A directed search was performed because of wildcard information, and a wildcard was returned. No further searching will be done.
- X'20'
- An alternate directory server had an unknown (neg cache) entry.
- X'24'
- Directory services management exit routine specified no search for this request.
- X'28'
- An error was detected during generic cache search task.
- X'32'
- This search kicked off an RDS which returned a negative reply. No more searching should be done for this search.
- X'34'
- IOPURGE occurred during verification after RDS found resource.
- X'36'
- Directed search failed after RDS found resource.
- 18–1B
- Address of the locate control block for this search.
- 1C–1F
- Sense code.