Verify Communications (VFYCMN)

Where allowed to run: Interactive environments (*INTERACT *IPGM *IREXX *EXEC)
Threadsafe: No
Parameters
Examples
Error messages

The Verify Communications (VFYCMN) command shows the Select a Line to Test display, which can be used to verify that communications equipment is operating properly.

Depending on the user's system configuration, the following tests can be run:

Restriction: This command is shipped with public *EXCLUDE authority and the QPGMR, QSYSOPR, QSRV, and QSRVBAS user profiles have private authorities to use the command.

Top

Parameters

Keyword Description Choices Notes
VFYTYPE Verification type *REMOTE, *LOCAL Optional, Positional 1
RCPNAME Remote control point Name Optional
NETID Network ID Name, *NETATR Optional
USERID User ID Name Optional
PASSWORD Password Character value, X'', *NONE Optional
Top

Verification type (VFYTYPE)

Specifies the type of verification. You may verify that local or remote communications hardware is operating correctly.

Note: You cannot do remote analysis if the IBM System Manager for i5/OS program is not installed.

This is a required parameter.

The possible values are:

*LOCAL
Communications hardware is checked to verify that it is operating correctly on this iSeries.
*REMOTE
Communications hardware is checked to verify that it is operating correctly on another iSeries system that is enrolled as a service requester.
Top

Remote control point (RCPNAME)

Specifies the remote control point name for the service requester system where the remote verification is done.

Note: This parameter is valid only if *REMOTE is specified for the Verification type prompt (VFYTYPE parameter).

Top

Network ID (NETID)

Specifies the network identifier (ID) for the service requester system where the remote verification is done.

Note: This parameter is valid only if *REMOTE is specified for the Verification type prompt (VFYTYPE parameter).

The possible values are:

*NETATR
The network ID of the service provider is used.
network-ID
Specify the network ID.
Top

User ID (USERID)

Specifies the user identifier (ID) used to access the remote system.

Note: This parameter is valid only if *REMOTE is specified for the Verification type prompt (VFYTYPE parameter).

Top

Password (PASSWORD)

Specifies the password used to access the remote system.

Note: This parameter is valid only if *REMOTE is specified for the Verification type prompt (VFYTYPE parameter).

The possible values are:

*NONE
No password is needed to access the remote system because the remote system has a security level of 10.
password
Specify the password.
Top

Examples

Example 1: Show Select a Line to Test Panel

VFYCMN

This command shows the Select a Line to Test panel.

Example 2: Checking a Remote System

VFYCMN   VFYTYPE(*REMOTE)

This command shows the panel which prompts for the remaining values of the command. After you specify the appropriate values, remote analysis begins.

Example 3: Accessing a Remote System Using a Password

VFYCMN   VFYTYPE(*REMOTE)  RCPNAME(RCH38377)  USERID(JON)
         PASSWORD(ABC123)

This command shows the display which prompts for the remaining values of the command. After you specify the appropriate values beyond the ones specified on the command example, remote analysis begins.

Example 4: Accessing a Remote System Without a Password

VFYCMN   VFYTYPE(*REMOTE)  RCPNAME(RCH38377)  USERID(JON)

This command is similar to the preceding example except that the PASSWORD parameter is not specified. The same prompt display is shown, however, the system assumes that the remote system has a security level of 10, that is, it does not use passwords. Another prompt display appears after this command is specified. After the user specifies the appropriate values on this display, remote analysis begins.

Example 5: Checking a Local System

VFYCMN   VFYTYPE(*LOCAL)

This command begins analysis on the local device. The remaining parameters do not appear on the display.

Top

Error messages

*ESCAPE Messages

CPF2B3C
Licensed program &1 not installed.
Top