NEWS Device Solicitation Procedures › $NWLPDA2 Procedure

$NWLPDA2 Procedure

This procedure records or changes configuration or coupler parameters, changes the functional characteristics of the modem, or runs on-line diagnostic tests for an LPDA-2 device. You can also obtain this data by selecting option 7 of the NEWS Device Support menu. The following operands are required to execute this procedure.

$NWLPDA2    { DISPLAY={ CONFIG | COUPLER } |
              CHANGE={ CONFIG | COUPLER } | 
              SPEED={ FULL | BACKUP } | 
              DIAL [ =(num1,num2,prefix) ] |
              DISC | CONTACT={ OPEN | CLOSE | QUERY } | 
              TEST={ LA | MS | TR(n) } }
              STATION=node_name
              NCP=ncp_name
            [ LEVEL={ 1 | 2 } ]
            [ MODEM={ LOCAL | REMOTE | BROADCAST } ] 
            [ FILE={ YES | NO | ONLY } ] 
            [ LINK=link_name | SSCP=SSCP_name ]

Operands: $NWLPDA2 Procedure

DISPLAY = { CONFIG | COUPLER }

Displays the modem's configuration parameters or the coupler's configuration parameters for the modem.

CHANGE = { CONFIG | COUPLER }

Changes the modem configuration parameters or the coupler configuration parameters for the modem.

Note: The CHANGE operand is valid only if executed from a full-screen environment and FILE=ONLY is not specified.

SPEED = { FULL | BACKUP }

Sets the modem's transmission speed to FULL or BACKUP.

DIAL [ = ( num1, num2, prefix ) ]

Establishes SNBU connections using the phone numbers stored in the configuration fields or the supplied prefix and extensions. If the prefix and extensions are supplied, the total length of the numbers (including pauses) must not be greater than 41 characters.

DISC

Disconnects the line at the remote modem.

CONTACT = { OPEN | CLOSE | QUERY }

Opens or closes the modem's built-in relay or reports the status of the built-in relay (open or closed) and whether or not electric current is flowing through the sensor.

TEST = { LA | MS | TR(n) }

Performs modem diagnostic tests as described by the following options:

LA

Performs a line analysis test.

MS

Performs Modem and Line Status test or Modem Self-test.

TR(n)

Performs a test-pattern exchange between the local and remote modem to determine the line quality and number of transmission errors. n is the number of sequences of 16 blocks of data to exchange. n + 1 sequences are sent.

STATION=nodename

Specifies the network name of the device to which the request is sent.

NCP=ncpname

Specifies the name of the NCP in which the station is located.

LEVEL = { 1 | 2 }

Determines where the command is sent. The primary link is indicated by 1 and the tailed link by 2.

MODEM = { LOCAL | REMOTE | BROADCAST }

Identifies the type of modem to receive the command:

LOCAL

Indicates the command is sent to the local modem.

REMOTE

Indicates the command is sent to the remote modem.

BROADCAST

Indicates the command is sent to all secondary modems. This parameter is valid only when used in conjunction with the SPEED and DISC operands.

FILE = { YES | NO | ONLY }

Directs how the returned results of the command are processed.

YES

Indicates the results of the command are displayed and sent to CNMPROC.

NO

Indicates the results of the command are displayed and not sent to CNMPROC.

ONLY

Indicates the results of the command are sent to CNMPROC only.

LINK

Specifies the name of the link to the region on the system in which the node name is located.

SSCP

Specifies the name of the SSCP controlling the node to be solicited.

Examples: $NWLPDA2 Procedure

EXEC $NWLPDA2 DISPLAY=COUPLER STATION=STATION1 NCP=NCP1+
            FILE=YES
EXEC $NWLPDA2 SPEED=FULL STATION=STATION1 NCP=NCP1+
    MODEM=REMOTE
EXEC $NWLPDA2 CHANGE=CONFIG STATION=STATION1 NCP=NCP1

Return Variables: $NWLPDA2 Procedure

&RETCODE

0

Batch process completed. This simply means that a command was sent to the controller and a response was received from the controller.

8

Processing error.