DISPLAY SRCHINFO command


Display summary information about outstanding subarea and APPN searches:

                                 .-,--LIST--=--SUMMARY-.   
>>-DISPLAY-- --NET--,--SRCHINFO--+---------------------+-------->

                         (3)                                    
   .-,--TYPE--=--SUBAREA-----.                                  
   |                  (2)    |                                  
   +-,--TYPE--=--APPN--------+                                  
   |                 (1)     |                                  
   +-,--TYPE--=--ALL---------+                            (4)   
>--+-------------------------+--+-----------------------+------->
   '-,--TYPE--=--+-ALL-----+-'  +-,--FROMCP--=--cp_name-+       
                 +-APPN----+    '-,--TOCP--=--cp_name---'       
                 '-SUBAREA-'                                    

>--+---------------------------+-------------------------------->
   +-,--FROMSSCP--=--sscp_name-+   
   '-,--TOSSCP--=--sscp_name---'   

   .-,--MAX--=--DSPLYDEF_start_option_value-.   
>--+----------------------------------------+------------------><
   '-,--MAX--=--+-*------------------+------'   
                '-number_of_searches-'

Notes:

TYPE=ALL is the default when the HOSTSA and NODETYPE start options are specified.
TYPE=APPN is the default when the NODETYPE start option is specified without the HOSTSA start option.
TYPE=SUBAREA is the default when the HOSTSA start option is specified without the NODETYPE start option.
These operands are valid with TYPE=APPN or TYPE=ALL.


Display detailed information about outstanding subarea and APPN searches:

>>-DISPLAY-- --NET--,--SRCHINFO--------------------------------->

>--+--------------------------------------------+--------------->
   +-,--DLU--=--lu_name--+--------------------+-+   
   |                     '-,--OLU--=--lu_name-' |   
   +-,--OLU--=--lu_name--+--------------------+-+   
   |                     '-,--DLU--=--lu_name-' |   
   +-,--LU1--=--lu_name--+--------------------+-+   
   |                     '-,--LU2--=--lu_name-' |   
   '-,--LU2--=--lu_name--+--------------------+-'   
                         '-,--LU1--=--lu_name-'     

                                          (3)     
                    .-,--TYPE--=--SUBAREA-----.   
                    |                  (2)    |   
                    +-,--TYPE--=--APPN--------+   
                    |                 (1)     |   
                    +-,--TYPE--=--ALL---------+   
>--,--LIST--=--ALL--+-------------------------+----------------->
                    '-,--TYPE--=--+-ALL-----+-'   
                                  +-APPN----+     
                                  '-SUBAREA-'     

                             (4)   
>--+-----------------------+------------------------------------>
   +-,--FROMCP--=--cp_name-+       
   '-,--TOCP--=--cp_name---'       

>--+---------------------------+-------------------------------->
   +-,--FROMSSCP--=--sscp_name-+   
   '-,--TOSSCP--=--sscp_name---'   

   .-,--MAX--=--DSPLYDEF_start_option_value-.   
>--+----------------------------------------+------------------><
   '-,--MAX--=--+-*------------------+------'   
                '-number_of_searches-'

Notes:

TYPE=ALL is the default when the HOSTSA and NODETYPE start options are specified.
TYPE=APPN is the default when the NODETYPE start option is specified without the HOSTSA start option.
TYPE=SUBAREA is the default when the HOSTSA start option is specified without the NODETYPE start option.
These operands are valid with TYPE=APPN or TYPE=ALL.


Display search information about a specific search request:

>>-DISPLAY-- --NET--,--SRCHINFO--------------------------------->

                                                        (3)     
                                  .-,--TYPE--=--SUBAREA-----.   
                                  |                  (2)    |   
                                  +-,--TYPE--=--APPN--------+   
                                  |                 (1)     |   
                                  +-,--TYPE--=--ALL---------+   
>--,--SID--=--session_identifier--+-------------------------+--->
                                  '-,--TYPE--=--+-ALL-----+-'   
                                                +-APPN----+     
                                                '-SUBAREA-'     

   .-,--MAX--=--DSPLYDEF_start_option_value-.   
>--+----------------------------------------+------------------><
   '-,--MAX--=--+-*------------------+------'   
                '-number_of_searches-'

Notes:

TYPE=ALL is the default when the HOSTSA and NODETYPE start options are specified.
TYPE=APPN is the default when the NODETYPE start option is specified without the HOSTSA start option.
TYPE=SUBAREA is the default when the HOSTSA start option is specified without the NODETYPE start option.

Abbreviations

Operand	Abbreviation
DISPLAY	D
SID	PCID

Purpose

The DISPLAY SRCHINFO command displays information about outstanding APPN and subarea search requests.

Note: The DISPLAY SRCHINFO,LIST=ALL and the DISPLAY SESSIONS,LIST=ALL commands will not always show the same session identifiers (SIDs). There are sessions (for example, INQUIRE APPSTAT) that do not involve sessions. When session setup has progressed beyond the search for the DLU, the SID of the session will not appear in the DISPLAY SRCHINFO output.

Operands

DLU=lu_name

Specifies the name of a destination LU. Display results for both subarea and APPN are limited by specifying this operand.

lu_name can be specified as a network-qualified name. If you do not specify the network identifier, VTAM® uses the identifier of the host from which you are issuing the command.

You can specify wildcard values for this operand. For more information about using wildcards, see Using wildcard names.

FROMCP=cp_name

Specifies the name of a control point (CP).

cp_name can be specified as a network-qualified name. If you do not specify the network identifier, VTAM uses the identifier of the host from which you are issuing the command.

You can specify wildcard values for this operand. For more information about using wildcards, see Using wildcard names.

FROMSSCP=sscp_name

Specifies the name of a subsystem control point (SSCP).

The value specified for sscp_name cannot be a network-qualified name.

You can specify wildcard values for this operand. For more information about using wildcards, see Using wildcard names.

LIST

Specifies the level of detail to display.

LIST=SUMMARY: For TYPE=SUBAREA or TYPE=ALL, displays summary information concerning outstanding CDINIT, DSRLST, and INIT_OTHER CD (IOCD) search requests. For TYPE=APPN or TYPE=ALL, displays summary information concerning the number of outstanding search requests with all adjacent control points (CPs).
LIST=ALL: For TYPE=SUBAREA or TYPE=ALL, displays more detailed information about outstanding CDINIT, DSRLST, and INIT_OTHER CD (IOCD) search requests, including the RU and the PCID. For TYPE=APPN or TYPE=ALL, displays more detailed information about the number of outstanding search requests with all adjacent CPs, including the PCID.

LU1=lu_name

Specifies the name of a logical unit. If this operand is specified, the information displayed is limited to outstanding search requests sent to or received from the specified LU.

lu_name can be specified as a network-qualified name. If you do not specify the network identifier, VTAM uses the identifier of the host from which you are issuing the command.

You can specify wildcard values for this operand. For more information about using wildcards, see Using wildcard names.

LU1 and LU2 can be used in place of DLU and OLU when it is not known which partner is the destination or originating LU.

LU2=lu_name

Specifies the name of a logical unit.

lu_name can be specified as a network-qualified name. If you do not specify the network identifier, VTAM uses the identifier of the host from which you are issuing the command.

You can specify wildcard values for this operand. For more information about using wildcards, see Using wildcard names.

LU1 and LU2 can be used in place of DLU and OLU when it is not known which partner is the destination or originating LU.

MAX

Specifies the maximum number of searches that VTAM displays for this command.

MAX=*

Specifies that the value of the DSPLYMAX start option is used to limit the display output.

MAX=number_of_searches

Specifies the maximum number of searches that VTAM displays for this command. The valid range is 1–value of DSPLYMAX. The default is the value specified for the DSPLYDEF start option.

Specifying MAX limits the display output; VTAM searches only for the number of instances that you have specified. When that number is found, VTAM does not search any further. This saves processing time for the command and gives you control over the amount of display output generated by the command.

For TYPE=ALL, the MAX operand is applied separately to the subarea and APPN displays.

OLU=lu_name

Identifies the LU that is the origin of a search request.

lu_name can be specified as a network-qualified name. If you do not specify the network identifier, VTAM uses the identifier of the host from which you are issuing the command.

You can specify wildcard values for this operand. For more information about using wildcards, see Using wildcard names.

SID=session_identifier

Identifies the session ID (SID) of a specific search to be displayed. The SID is also known as the procedure-correlation identifier (PCID). Both subarea and APPN information will be provided, based on the TYPE operand.

If you specify the SID operand, do not specify LIST.

The SID may be obtained from the output of DISPLAY SRCHINFO,LIST=ALL (search-related requests) or DISPLAY SESSIONS,LIST=ALL (session-related requests).

TOCP=cp_name

Identifies an adjacent CP for a search request.

cp_name can be specified as a network-qualified name. If you do not specify the network identifier, VTAM uses the identifier of the host from which you are issuing the command.

You can specify wildcard values for this operand. For more information about using wildcards, see Using wildcard names.

TOSSCP=sscp_name

Identifies the destination SSCP for a search request.

You can specify wildcard values for this operand. For more information about using wildcards, see Using wildcard names.

TYPE

Identifies the type of information required.

TYPE=ALL: Indicates that both APPN and subarea search information will be displayed. TYPE=ALL is the default for interchange nodes and migration data hosts.
TYPE=APPN: Indicates that APPN search information will be displayed. Subarea search information will not be displayed.
TYPE=SUBAREA: Indicates that subarea search information will be displayed. APPN search information will not be displayed.

Resulting display

Specifying the DLU operand limits the display to outstanding search requests sent to the specified LU.

Specifying the OLU operand limits the display to outstanding search requests sent from the specified LU.

Specifying the FROMCP operand limits the display to outstanding search requests sent from the specified CP.

Specifying the FROMSSCP limits the display to the outstanding search requests sent from the specified SSCP.

Specifying the LU1 or LU2 operand limits the display to the outstanding search requests sent to or received from the specified LU.

Specifying the TOCP operand limits the display to the outstanding search requests sent to the specified CP.

Specifying the TOSSCP operand limits the subarea information displayed to those search requests targeted for a particular SSCP.

Examples

Displaying summary of outstanding search requests.

d net,srchinfo,list=summary
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = SRCHINFO
IST1520I SUBAREA SEARCH INFORMATION:
IST1521I   TOSSCP   NAME   CDINIT    DSRLST    IOCD   INITOT     TOTAL
IST1522I   SSCP1A               0         1       0        2         3
IST1525I   TOTAL NUMBER OF OUTSTANDING SEARCHES =          3
IST1454I 1 SSCP NAME(S) DISPLAYED
IST924I -------------------------------------------------------------
IST1526I APPN SEARCH INFORMATION:
IST1527I   TOCP   NAME       TYPE  STATUS   BROADCAST DIRECTED   TOTAL
IST1528I   NETA.SSCPAA        NN    OPEN            2        1       3
IST1525I   TOTAL NUMBER OF OUTSTANDING SEARCHES =          3
IST1454I 1 CP NAME(S) DISPLAYED
IST314I END

Displaying detail information about outstanding requests.

d net,srchinfo,list=all
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = SRCHINFO
IST1520I SUBAREA SEARCH INFORMATION:
IST1523I       OLU                DLU                SID       RU
IST1524I   NETA.APPL1        NETA.SSCP1A       ****NA****      DSRLST
IST1524I   NETA.APPL2        NETA.SSCP1A       ****NA****      INITOT
IST1524I   NETA.SSCP1A       NETA.SSCP1A       ****NA****      INITOT
IST1454I 3 PAIR(S) DISPLAYED
IST924I -------------------------------------------------------------
IST1526I APPN SEARCH INFORMATION:
IST1529I       OLU                DLU                SID       LOCATE
IST1530I   NETA.SSCP1A       NETA.SSCP2A       EAABEEC3C6093893     1
IST1530I   NETB.SSCP7B       NETA.NETAPPL2     C2BB19BCF437741D     1
IST1530I   NETB.SSCP7B       NETA.NETAPPL1     C2BB19BCF437741C     1
IST1525I   TOTAL NUMBER OF OUTSTANDING SEARCHES =          3
IST1454I 3 PAIR(S) DISPLAYED
IST314I END

Displaying outstanding information about a specific request.

d net,srchinfo,sid=eaabeec3c6093891
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = SRCHINFO
IST1520I SUBAREA SEARCH INFORMATION:
IST1531I   SID = EAABEEC3C6093891         CP(OLU) = SSCP1A
IST1532I   OLU = NETA.APPL1               DLU = NETA.NETAPPL1
IST1540I   SEARCH STATUS = PDSRLST        SSCP(OLU) = SSCP1A
IST1539I   PCID MODIFIER = 00000000000000000000
IST1534I   SSCP/CP IN OLU DIRECTION = NETA.SSCP1A
IST1533I   SEARCH CONCENTRATED = NO       RDS = NO
IST1705I   SORDER = ADJSSCP FROM START OPTION
IST1705I   SSCPORD = PRIORITY FROM START OPTION
IST894I    ADJSSCPS TRIED  FAILURE SENSE   ADJSSCPS TRIED  FAILURE SENSE
IST895I    SSCP2A          08420000
IST1454I 1 ADJSSCP(S) DISPLAYED
IST1537I   AWAITING REPLY FROM THE FOLLOWING NODE(S):
IST1538I      NETA.ISTAPNCP
IST924I -------------------------------------------------------------
IST1526I APPN SEARCH INFORMATION:
IST1531I   SID = EAABEEC3C6093891         CP(OLU) = NETA.SSCP1A
IST1532I   OLU = NETA.APPL1               DLU = NETA.NETAPPL1
IST1539I   PCID MODIFIER = 10000000000000000000
IST1545I   NODE ROLE VECTOR = X'A000'
IST1541I   LOCATES PENDING =          0   CURRENT TASK = X'0B'
IST1533I   SEARCH CONCENTRATED = YES      RDS = NO
IST1534I   SSCP/CP IN OLU DIRECTION = NETA.SSCP1A
IST1535I   REPLY RETURNED TO ORIGINATING CP = NO
IST1536I   CONCENTRATED BEHIND C2BB19BCF437741C 22100000000000000000
IST924I -------------------------------------------------------------
IST1531I   SID = C2BB19BCF437741C         CP(OLU) = NETB.SSCP7B
IST1532I   OLU = NETB.SSCP7B              DLU = NETA.NETAPPL1
IST1539I   PCID MODIFIER = 22100000000000000000
IST1545I   NODE ROLE VECTOR = X'2000'
IST1541I   LOCATES PENDING =          1   CURRENT TASK = X'17'
IST1533I   SEARCH CONCENTRATED = NO       RDS = YES
IST1548I   BROADCAST = YES                DIRECTED = NO
IST1534I   SSCP/CP IN OLU DIRECTION = NETB.SSCP7B
IST1535I   REPLY RETURNED TO ORIGINATING CP = NO
IST1537I   AWAITING REPLY FROM THE FOLLOWING NODE(S):
IST1538I      NETA.SSCPAA
IST1543I   REQUESTS CONCENTRATED BEHIND THIS SEARCH =     1
IST314I END