Network Operations can be controlled through a number of VT AM operator commands which affect both VT AM and NCP operations. Network Operations are now further improved through the use of the 3745 MOSS disk, which can be used to improve network availability and flexibility.
NCP V5RI provides the capability to store one NCP load module (optionally including the PEP feature of NCP) and one dump fue per CCU on the MOSS disk.
NCP V5R2 and subsequent releases increase this to two load modules that may be stored per CCU.
The following operator commands support loading and dumping storage using the 3745 disk.
• VARY ACT (for a NCP major node)
• DISPLAY NCPSTOR
• MODIFY DUMP
7.2.1 NCP Load Operation
One or two NCP load modules per CCU can be transferred from the host to the 10Ql1 or remote 3745, and stored on the 3745 disk. The capability of loading two NCP load modules per CCU is supported by ACF /NCP V5R2 and later releases.
Also, the multiple load module support requires ACF /VT AM V3R2.
The loading of NCP from disk can be initiated either by VT AM operator command from the host, or locally from the control panel or MOSS console. A MOSS initiated load requires an IPL of a particular CCU with the DUMPLOAD
=
YES option. This will automatically load the NCP from disk at the end of the IPL.NCP V5R2 and subsequent releases will allow the transfer of NCP load modules from the host without disruption to 3745 operations.
7.2.1.1 VARY ACT command
The VARY ACT command for the. NCP major node supports the 3745 disk feature.
V NET,ACT,ID=ncpname,LOAD=YESINOlu,LOADFROM=HOSTIEXTERNAL,SAVEMOD=YESINO, DUMPLOAD=YESINO,LOADMOD=load-module-name
The LOADFROM keyword provides the source of an NCP load module to be loaded into a communication controller.
• HOST
Specifies that an NCP module is to be loaded into a 3745 from a host data set.
HOST is the default value.
• EXTERNAL
Specifies that an NCP module is to be loaded into a 3745 from the hard disk attached to that controller. (This only applies when LOAD
=
YES is also specified for this command.) EXTERNAL may be abbreviated as EXT.The SAVEMOD keyword applies to saving an NCP module on the 3745 disk after the controller has been loaded from a NCP load module library at the host. The
save module option is valid only when LOAD is specified with the operand value of YES. NO is the default value.
The DUMPLOAD keyword applies to setting the automatic dump/load switch in the 3745. The switch controls automatic dumping and reloading of an NCP on unrecoverable conditions in the NCP. The DUMPLOAD keyword is valid only when LOAD is specified with an operand value of YES. NO is the default value.
YES turns the automatic dump/load switch 'ON' and NO turns it 'OFF'. The default setting of the switch is 'OFF'.
LOADMOD specifies the name of the load module to be activated. Default load module name is ncpname. This must be specified if NCP PU name (PUNAME on BUILD) is different from load module name (NEWNAME on BUILD).
7.2.1.2 Automatic Load/Dump
The function of automatic load/dump of NCP from/to the 3745 disk is assigned to a 3745 by the network operator during the activation of an NCP load module saved on the 3745.
In order to perform the automatic load/dump function, the network operator needs to set the automatic load/dump switch by specifying 'DUMPLOAD
=
YES' in the VARY ACT command.VARY NET,ACT,ID=name,LOAD=YES, ... ,DUMPLOAD=YES
When unrecoverable errors occur in the NCP, the switch is tested. If it is 'ON', a dump of the NCP is stored on the hard disk. After a dump has been successfully stored on the controller's hard disk, the 3745 is reloaded with the NCP load module held on the 3745 disk. If it is 'OFF', the controller is not automatically dumped and loaded from the 3745 hard disk when an NCP abends. The default setting of the switch is 'OFF'.
In case of CCU and storage related failure or microcode error, a dump of the NCP storage is automatically saved on the disk and then the CCU storage is automatically loaded from the disk with the NCP load module which was preselected for activation in this CCU. After a power outage or a CCU power failure, the NCP automatic re-Ioad sequence begins.
In Twin-in-Standby mode, bus switching will automatically take place and the standby CCU will be IPLed in the case of a CCU or storage related failure. If the DUMPLOAD
=
YES option has been specified, then NCP will be loaded from disk automatically after the CCU has IPLed.7.2.1.3 Multiple Load Modules Support
In conjunction with ACF /VT AM V3R2 and ACF /SSP V3R4, ACF /NCP V5R2 provides support of multiple load modules on 3745/3720 disk. This support allows:
• Non-disruptive addition, replacement or deletion of load module on the disk
• Selection, at lead time, of which load module on disk will be loaded
• Ability to cancel and in-progress addition or replacement
• Display of disk contents.
In order to perform these functions, the following commands will be available:
• MODIFY LOAD adds, replaces, deletes a load module on the disk non-disruptively, and cancels an in-progress add or replace.
F NET,LOAD,ID~ncpname,LOADMOD=load-module-name,ACTION=ADDIREPLACElpURGEICANCEL ACTION
=
ADD adds a load module on the disk, unless already two load modules are there on the disk or unless the load module with the same name is there. Auto dump/load switch is set to "OFF".ACTION
=
REPLACE replaces a load module on the disk with new copy, or adds a load module to the disk if the load module is not there. If two other load modules are already on the disk, the older is replaced. . Auto dump/load switch is set to "OFF".ACTION = PURGE purges a load module on the disk.
ACTION = CANCEL cancels an in-progress add or replace.
• DISPLAY DISK gets information about load modules and dumps on the disk.
D NET,DISK,ID=ncpname
The information about load module contains load module name, date/time load occurred, auto load/dump switch status, load module status (LOADED, LOADING, SUSPENDED), and active load module name.
The information about dump contains dump name and date/time dump taken.
7.2.2 Dump Operations
The network operator can request the on-line transfer of a full dump or a partial dump. The ~CP dump stored on the 3745 disk must be retrieved and/or erased by the network operator before a new NCP dump can be saved on the 3745 disk for the same CCU. The on-line transfer can be done without deactivating the current NCP loaded in the 3745, but it could impact response time of other network applications.
Also, the operat9r can display information on the status of NCP load modules and NCP dumps residing on the 3745 disk at one of the 3745 MOSS consoles.
7.2.~.1 M"ODIFY DUMP command
The MODIFY DUMP command supports the online transfer of a full NCP dump or MOSS ftles saved in the 3745 disk.
F NET,DUMP, ID=ncpname,TYPE=MOSsl NcplcSP,ACTION=TRANSFERI PURGEICOMP
TYPE keyword specifies whether to take a normal NCP dump, or transfer two internal controller dumps to the host.
The ACTION keyword applies to the disposition of a dump stored on the 3745 disk and specifies that the dump indicated by the TYPE keyword is one of the following:
• TRANSFER
Transferred to a host data set from the 3745 disk. The dump IS not automatically purged from the disk.
• PURGE
Purged from the 3745 disk. No dump is transferred to a host data set.
• COMP
Specifies that the action is compatible with the previous release of VT AM. This is the default value.
Fonnatting is done with the ACF /SSP Print Dump utility. See Appendix C for details of the JCL used for printing the NCP, MOSS, or CSP dump data.
7 .2.2.2 DISPLAY NCPSTOR command
The DISPLAY NCPSTOR command supports the 3745 disk feature. A partial dump can be perfonned as an alternative to the full dump transfer using this command.
D NET,NCPSTOR,ID=ncpname,ADDR=address,LENGTH=nnn, STORAGE=MAINIDUMPVECIDUMPMAIN
The STORAGE keyword applies to the type of NCP storage to be displayed.
• MAIN
Specifies that a portion of the communication controller mam storage containing an NCP ·is to be displayed. This is the default value.
• DUlVIPVEC
Specifies that the communication controller state vector stored on the 3745 disk flie is to be displayed. The state vector contains the registers, storage keys, program state, instruction state, instruction addresses, and is also referred to as the dump header.
• DUlVIPMAIN
Specifies that a portion of an NCP dump stored on the 3745 disk as a result of an automatic dump is to be displayed. The resultant display refers to the main storage of the controller, starting at address zero and continuing to the maximum storage installed minus one.
LENGTH
=
256 is required for STORAGE = DUMPVEC or STORAGE = DUMPMAIN.7.2.2.3 DISPLAY DISK command
The DISPLAY DISK command provides infonnation about 3745 Communication Controller's disk contents.
D NET,DISK,ID=ncpname
The infonnation about the load module includes:
• The load module name
• The date and time the load module was stored in the disk
• The status of the load module (store,storing or suspended)
• The status of the AUTO DUMP/LOAD The infonnation about dumps modules includes:
• The dump name
• The date and time the dump was stored to disk Note: This command is supported by VTAM V3R2 only.