You can control most of the functions of the NCPROUTE address space from the operator console using the MODIFY command. The following list shows the correct syntax and valid parameters for the NCPROUTE address space.
Use the MODIFY command to pass parameters to the NCPROUTE address space.
Format
>>-+-MODIFY-+--procname--,--+-------+--+-PARMS=--parms---+------> '-F------' '-QUERY-' +-PROFILE---------+ +-GATEWAYS--------+ +-GATEWAYS,DELETE-+ '-TABLES----------' >--,--C=--client-----------------------------------------------><
Parameters
- procname
- The member name of the cataloged procedure used to start the NCPROUTE server.
- QUERY
- Queries the current target client NCP name or IP address.
- parms
- Any one or more of the following separated by a space. Enclosing
the parms specified in single quotation
marks or preceding by a slash (/) is optional.
- -g
- Enable default router.
- -gq
- Disable default router.
- -f
- Flush all indirect routes known from IP routing tables.
- -fh
- Flush all indirect host routes known from IP routing tables.
- -h
- Include host routes in addition to network-specific router for the RIP responses.
- -hq
- Disable supply host routes.
- -s
- Enable supply routing information.
- -sd
- Enable supply default route only.
- -sdq
- Disable supply default route only.
- -sl
- Enable supplying of only local (directly connected) routes.
- -slq
- Disable supplying of only local (directly connected) routes.
- -sq or -q
- Disable supply routing information.
- -t
- Enable or disable traces. Up to 4 -t parms are allowed.
- -tq
- Disable all traces.
- -dp
- Enable debug packets trace.
- -dq
- Disable all debug traces.
- PROFILE
- Reread the NCPROUTE PROFILE data set.
- GATEWAYS
- Reread the NCP client GATEWAYS data set member. If ,DELETE is specified, all routes listed in the data set are deleted.
- TABLES
- Displays NCPROUTE internal IP routing and interface tables for diagnosis.
- client
- The target client NCP name or IP address. A value of 0 indicates all clients. The default will be the first client that has an established session with NCPROUTE. This parameter can be issued at once to indicate that NCPROUTE is to process modify commands for this client or for all clients. If C=0 is specified or if NCPROUTE does not have any active sessions with its clients, then only the parameters PARMS= and PROFILE are allowed to be processed.
Examples
F NCPROUT,GATEWAYS,c=NCP4
F NCPROUT,PARMS=-t -t -t -t,c=NCP1
F NCPROUT,PARMS=-tq, c=9.67.116.65
F NCPROUT,PARMS,c=10.1.1.99
F NCPROUT,PROFILE
F NCPROUT,PARMS=-tq
F NCPROUT,GATEWAYS,DELETE
F NCPROUT,PARMS,c=0
F NCPROUT,PARMS='/ -s -g'
F NCPROUT,PARMS=-h,PROFILE,GATEWAYSUsage
Consider the following when coding
the parms:
- Enclosing quotation marks for the parms are optional.
- Enclosing / for the parms is optional for example, parms=/-t -t).
- If the c= parameter cannot be specified in one command, issue the modify command with this parameter alone, following another modify command for other parameters.
- For -f or -fh parameters, only the indirect routes known by NCPROUTE are flushed:
Table 1 shows how the above
parameters affect the advertising algorithm for routes in RIP responses
to adjacent routers.
Note: The modify parameters correspond to the
parameters in the OPTIONS statement of NCPROUTE Gateways data set.
| Parameter | NCPROUTE GATEWAY option | Host routes | Network routes | Advertise as default router | Local routes | Unreachable routes |
|---|---|---|---|---|---|---|
| -g | default router yes | No | Yes | Yes | Yes | Yes |
| -h | Supply local hosts | Yes | Yes | No | Yes | Yes |
| -s | Supply on | No | Yes | No | Yes | Yes |
| -sd | Supply default route | No | No | Yes | No | Yes |
| -sl | supply locals | No | No | No | Yes | Yes |
| -sq or -q | supply off | No | No | No | No | No |
| None | None | No | Yes | No | Yes | Yes |