| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Verify Link Supporting LPDA-2 (VFYLNKLPDA) command allows you to run any of the LPDA-2 tests and to receive the results in a format you specify.
Restriction: This command is shipped with public *EXCLUDE authority and the QPGMR, QSYSOPR, QSRV, or QSRVBAS user profiles have private authorities to use the command.
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| LINE | Line | Name | Required, Positional 1 |
| TEST | Test | *DCELINSTS, *DCELINTST, *ANZLIN, *SNDRCV | Optional |
| LCLDCEADR | Local DCE address | 01-FB, *LCL | Optional |
| RMTDCEADR | Remote DCE address | 01-FB, *ANY | Optional |
| OUTPUT | Output | Optional | |
| SEQCOUNT | Number of sequences | 1-3, 1 | Optional |
| DTEPORT | Remote DTE port | A, B, C, D | Optional |
| DTERTY | DTE retry | *NO, *YES | Optional |
| DCERTY | DCE retry | *NO, *YES | Optional |
| VRYLNKSTS | Link status after test | *SAME, *ON, *OFF | Optional |
| Top |
Specifies the name of the line (nonswitched *SDLC) on the link to be tested.
This is a required parameter.
| Top |
Specifies which of the four tests is to be run.
The possible values are:
| Top |
Specifies the local data circuit-terminating equipment (DCE) address. By convention, bits 4-7 of this byte indicate the Link Segment Level (LSL) of the local DCE and remote DCE. Bits 0-3 are used to uniquely identify a local DCE among several on the same LSL. The address is set in the local DCE during configuration and should follow this convention.
Note: X'00' is not a valid address for a local DCE.
The possible values are:
| Top |
Specifies the remote data circuit-terminating equipment (DCE) address.
This parameter must be specified if you are testing a multipoint link.
The possible values are:
Note: Multipoint tributary DCEs will not respond to an address of *ANY.
| Top |
Specifies whether the output from the command is displayed at the requesting work station or printed with the job's spooled output.
The possible values are:
| Top |
Specifies the number of sequences to transmit for the send/receive test. A sequence is a group of 16 blocks, with the block length dependent on the configuration of the DCE.
The possible values are:
| Top |
Specifies the data terminal equipment (DTE) port of the remote DCE for which status will be returned. This parameter is valid only when working with line status and line testing of DCEs. This parameter is meaningful only for multiple port DCEs.
The possible values are:
| Top |
Specifies that this command is a retry of a link operation from the system DTE to the local DCE due to a bad response or no response received from the local DCE.
The possible values are:
| Top |
Specifies whether the local DCE should retry the command to the remote DCE if a bad response or no response is received from the remote DCE.
The possible values are:
| Top |
Specifies the desired status of the link (varied on or varied off) after the test completes.
Note: After running a test on a manually switched link, the link should in most cases be left varied on to allow further information to be received on the same connection. If the switched link is varied off, the failing connection will be lost and no further analysis can be done.
The possible values are:
| Top |
Example 1: Checking Line Status
VFYLNKLPDA LINE(LINE1) DTEPORT(B)
This command retrieves the DCE line status from synchronous data link control (SDLC) line, LINE1, and displays the status. The remote DCEs DTE line connection status of port B is returned if the user is verifying a multiport DCE. An error message will be returned if the remote DTE has only a single port, for example, port A. The default VRYLNKSTS(*SAME) causes the line named LINE1 to return to the status prior to the test.
Example 2: Analyzing a Line
VFYLNKLPDA LINE(LINE2) TEST(*ANZLIN) OUTPUT(*PRINT)
LCLDCEADR(02) VRYLNKSTS(*ON)
This command analyzes the SDLC line, LINE2. The second LSL is used; the lower four bits of the local DCE address (LCLDCEADR) are 2. The results are sent to a spooled file. After the test, LINE2 remains varied on to allow for more testing.
Example 3: Testing Sending and Receiving Capabilities
VFYLNKLPDA LINE(LINE3) TEST(*SNDRCV) SEQCOUNT(3)
RMTDCEADR(21) DCERTY(*YES)
This command tests the sending and receiving capabilities on the multipoint line, LINE3. Three sequences of 16 blocks are sent between the local (control) DCE and the remote (tributary) DCE with the address of X'21'. If the local DCE fails to receive a response on the first attempt, the local DCE will retry this command to the remote DCE.
| Top |
*ESCAPE Messages
| Top |