z/OS Communications Server: SNA Diagnosis Vol 1, Techniques and Procedures
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


FINDDSIB

z/OS Communications Server: SNA Diagnosis Vol 1, Techniques and Procedures
GC27-3667-00

Use FINDDSIB to scan the ATCVT DSSIB queue for DSSIBs that meet specified selection criteria. The following information are displayed for each DSSIB selected:
  • DSSIB address
  • Procedure correlation identifier (PCID) of the request
  • Owning SSCP name
  • Real name of the destination logical unit
  • Real network ID of the destination logical unit
  • Alias name of the destination logical unit
  • Alias network ID of the destination logical unit
  • Adjacent SSCP in the originating direction

FINDDSIB has no required selection operands. If you enter no value for all selection operands, all DSSIBs are eligible for selection.

To select specific DSSIBs, you may enter a value for any of the selection operands below. All entered values must be present in the correct position within a DSSIB for it to be selected. For example, if you specify both a real name and an alias name, only DSSIBs with the specified real name in the RNAME position and the specified alias name in the ALIAS position are eligible for selection.

If you enter no value for a selection operand, DSSIBs with any value in that position are eligible for selection.

Use the Process positional operand to set the number of eligible DSSIBs that will actually be selected and displayed (all of them or just the first one encountered).

Operands

PCID
Specify 2–16 hexadecimal digits in the form X'x…' for the PCID associated with the DSRLST request. Specify an even number of digits, otherwise the high-order 4 bits are assumed to be 0. If the PCID entered is fewer than 16 digits, then it is right-aligned, and a match occurs with all DSSIBs with PCIDs whose rightmost digits match the specified digits. The specified PCID is not padded with any characters.
Owning SSCP
The owning SSCP name should be 1–8 alphanumeric characters. If it contains fewer than 8 characters, the leftmost characters are compared.
Real name
The real name should be 1–8 alphanumeric characters. If it contains fewer than 8 characters, the leftmost characters are compared.
Real network ID
The real network ID should be 1–8 alphanumeric characters. If it contains fewer than 8 characters, the leftmost characters are compared.
Alias name
The alias name of the DLU resource should be 1–8 alphanumeric characters. If it contains fewer than 8 characters, the leftmost characters are compared.
Alias network ID
The alias network ID of the DLU resource should be 1–8 alphanumeric characters. If it contains fewer than 8 characters, the leftmost characters are compared.
Adjacent SSCP
The adjacent SSCP in the originating direction should be 1–8 alphanumeric characters. If it contains fewer than 8 characters, the leftmost characters are compared.
Process
Use First to display the first DSSIB that meets the selection criteria. Otherwise, all DSSIBs that meet the selection criteria are displayed.
Routing in progress
Use Check RTIP to display only DSSIBs that indicate "routing in progress" ("routing in progress" is indicated when bit DSSRTIP is on). Otherwise, FINDDSIB does not check for "routing in progress" (that is, the DSSRTIP bit is ignored).

Use the following syntax as an alternative to the panel interface.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-FINDDSIB--+---------------------+---------------------------->
             '- --PCID--(--pcid--)-'   

>--+-----------------------------+------------------------------>
   '- --OSSCP--(--owning_sscp--)-'   

>--+---------------------------+-------------------------------->
   '- --RNAME--(--real_name--)-'   

>--+----------------------------+------------------------------->
   '- --NRNID--(--real_netid--)-'   

>--+----------------------------+------------------------------->
   '- --ALIAS--(--alias_name--)-'   

>--+-----------------------------+------------------------------>
   '- --ALNID--(--alias_netid--)-'   

                                      .- --ALL---.   
>--+-------------------------------+--+----------+-------------->
   '- --ASSCP--(--adjacent_sscp--)-'  '- --FIRST-'   

   .- --NORTIP-.   
>--+-----------+-----------------------------------------------><
   '- --RTIP---'   

Sample output

FINDDSIB
 
                        FINDDSIB Analysis
 DSSIB         PCID        OSSCP    RNAME    NRNID    ALIAS    ALNID    ASSCP
-------- ---------------- -------- -------- -------- -------- -------- -------
05A13498 F0871BD0A7E3DF8C XYZSCP05 TSO105   XYZNET   TSO105   XYZNET   ABCNET
DSSIBs processed:                         1
DSSIBs matching search criteria:          1

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014