DISPLAY NCPSTOR command


>>-DISPLAY-- --NET--,--NCPSTOR--,--ADDR--=--address------------->

                       .-,--LENGTH--=--32--------------.   
>--,--ID--=--ncp_name--+-------------------------------+-------->
                       '-,--LENGTH--=--number_of_bytes-'   

   .-,--STORAGE--=--MAIN---------.   
>--+-----------------------------+-----------------------------><
   '-,--STORAGE--=--+-DUMPMAIN-+-'   
                    +-DUMPVEC--+     
                    '-MAIN-----'

Abbreviations

Operand	Abbreviation
DISPLAY	D

Purpose

The DISPLAY NCPSTOR (NCP storage) command displays either the storage contents of a communication controller running an NCP, or an NCP dump stored in an IBM® 3720 or 3745 Communication Controller. This command displays up to 256 (decimal) bytes from any address within the communication controller or the dump stored in the IBM 3720 or 3745 Communication Controller.

Operands

ADDR=address

Specifies the address (in hexadecimal) of the first byte of data to be displayed.

ID=ncp_name

Specifies the name of the NCP whose storage is to be displayed.

LENGTH=number_of_bytes

Specifies the number of bytes of NCP storage to be displayed. Any decimal integer 1–256 can be specified. If LENGTH is omitted, VTAM® displays 32 bytes (the default).

STORAGE

Specifies the type of storage to be displayed.

STORAGE=MAIN: Displays the storage contents of an IBM 3720 or 3745 Communication Controller running an NCP.
STORAGE=DUMPVEC: Displays the state vector (also called the dump header) of the NCP stored in the IBM 3720 or 3745 Communication Controller. The state vector contains items such as the NCP registers, storage keys, program state, and instruction addresses. The state vector is storage that is linearly addressable in the range 0–511, depending on the communication controller unit model. If the sum of the number_of_bytes specified for LENGTH and the address specified for ADDR is greater than 511, then LENGTH is modified to display the state vector from the address specified for ADDR to 511.
STORAGE=DUMPMAIN: Displays the main part of an NCP dump stored on the IBM 3270 or 3745 Communication Controller. This dump portion is mapped byte for byte to the main storage of the communication controller. The displayable address range starts at main storage address 0 and ends at the address 1 byte lower than the maximum storage installed on the communication controller external storage.

Resulting display

The resulting display shows:

The type of storage
The name of the NCP
The contents of storage, in hexadecimal, with addresses

Examples

Displaying the NCP storage executing in the controller:

d net,ncpstor,id=a0362zc,addr=0,storage=main
IST097I DISPLAY ACCEPTED
IST244I NCP MAIN STORAGE        FOR ID = A0362ZC
IST245I 000000   714C01AA 719C09A8 B900000D B806B568
IST245I 000010   00000000 00000000 00000000 00000000
IST314I END
IST241I D NCPSTOR COMMAND COMPLETE FOR A0362ZC

Displaying the state vector of a dump stored on the controller:

d net,ncpstor,id=a0362zc,storage=dumpvec,addr=0
IST097I DISPLAY ACCEPTED
IST244I NCP DUMP VECTOR STORAGE FOR ID = A0362ZC
IST245I 000000   00800C02 011257AE 0001E088 00155994
IST245I 000010   00156648 001257A8 00155D40 0004D5E0
IST314I END
IST241I D NCPSTOR COMMAND COMPLETE FOR A0362ZC

Displaying the main portion of a dump stored on the controller:

d net,ncpstor,id=a0362zc,storage=dumpmain,addr=512,length=64
IST097I DISPLAY ACCEPTED
IST244I NCP DUMP MAIN STORAGE   FOR ID = A0362ZC
IST245I 000512       2742 68140910 17180728 27BE9001
IST245I 000520   28D02539 CD0435D0 A8022458 BF40047A
IST245I 000530   A80E2539 D440E3E1 35D025B9 BF40047A
IST245I 000540   00700070 6513E47F 21390458 5180F560
IST245I 000550   8846
IST314I END
IST241I D NCPSTOR COMMAND COMPLETE FOR A0362ZC