MODIFY NCP command

Abbreviations

Purpose

The MODIFY NCP command is used to send a request to NCP to run the specified command for the specified resource.

Operands

procname

The procedure name for the command. If procname in the START command was specified as startname.ident, where startname is the VTAM® start procedure and ident is the optional identifier, either startname.ident or ident can be specified for procname.

If procname in the START command was startname, startname must be specified for procname.

ID=ncp_name

Specifies an active NCP.

COMMAND

Specifies the command for NCP to run.

COMMAND=TRSWITCH

Specifies the Token-Ring Path switch request command.

The TRSWITCH command requests NCP to initiate non-disruptive route switch (NDRS) processing for the resource. The resource indicated by the RESNM parameter must be an active NCP Token Ring Interface (NTRI) subarea (PU4) physical unit connected to a 3745 through a bridged network. If no error messages are received at the system console, then VTAM has sent the request to NCP via a SETCV RU. If NCP cannot initiate NDRS processing for the resource, the SETCV command will be rejected and the following message will be displayed at the system console:

IST242I SETCV COMMAND FAILED FOR ID = nodename SENSE = code

If NCP successfully initiates NDRS processing and a route to the physical unit is found, NCP generates a "Token-Ring Path Switch Notification" Generic Alert. This Alert contains the routing information for the route chosen.

RESNM=resource_name

Specifies the target resource name for the command. It must be a valid resource within the NCP major node indicated by the ID parameter.