Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

CALL_FRAME

CLUSTER

CONNECTIONS

CRASH

DEVICE

HEADER

LOCK

PAGE_TABLE

PFN_DATA

POOL

PORTS

PROCESS

RESOURCES

RSPID

RMS

STACK

SUMMARY

SYMBOL

/NEXT_FP

/CSID

/SCS

/ADDRESS

/ADDRESS

/ALL

/ALL

/GLOBAL

/SYSTEM

/ALL

/BAD

/FREE

/MODIFIED

/SYSTEM

/IRP

/NONPAGED

/PAGED

/ALL

/FREE

/HEADER

/LRP

/SRP

/SUMMARY

/TYPE

/ADDRESS

/ALL

/CHANNEL

/INDEX

/LOCK

/PAGE_TABLES

/PCB

/PHD

/PROCESS_SECTION_TABLE

/REGISTERS

/RMS

/SYSTEM

/WORKING_SET_LIST

/ALL

/LOCKID

/CONNECTION

/ALL

/EXECUTIVE

/INTERRUPT

/KERNEL

/SUPERVISOR

/USER

/IMAGE

/ALL

System Dump Analyzer SHOW — MicroVMS 4.6

    Prints formatted data structures, other contents of memory, or RMS
    display options.  The following commands are available:

        SHOW CALL_FRAME
        SHOW CLUSTER
        SHOW CONNECTIONS
        SHOW CRASH
        SHOW DEVICE
        SHOW HEADER
        SHOW LOCK
        SHOW PAGE_TABLE
        SHOW PFN_DATA
        SHOW POOL
        SHOW PORTS
        SHOW PROCESS
        SHOW RESOURCES
        SHOW RMS
        SHOW RSPID
        SHOW STACK
        SHOW SUMMARY
        SHOW SYMBOL


Additional information available:

CALL_FRAMECLUSTERCONNECTIONSCRASHDEVICE
HEADERLOCKPAGE_TABLEPFN_DATAPOOLPORTS
PROCESSRESOURCESRSPIDRMSSTACKSUMMARY
SYMBOL

CALL_FRAME

        SHOW CALL_FRAME [starting address] [/NEXT_FP]

    Displays the locations and contents of the longwords
    representing a CALLG or CALLS procedure call frame.
    The starting address of the call frame is determined from the
    specified starting address, the NEXT_FP option, or by default.
    The default starting address is the longword contained in the
    SDA current process FP register.


Additional information available:

/NEXT_FP

/NEXT_FP

    Used to follow a chain of successive procedure call frames.
    Displays the next call frame by using the contents of the
    saved FP from the previous displayed call frame as the starting
    address of the next call frame.


CLUSTER

        SHOW CLUSTER [/CSID=n] [/SCS]

    Displays a view of the Vaxcluster, or the SCS cluster (with the
    SCS qualifier).  The VAXcluster is composed of VAXprocessor nodes
    actively participating in the management of shared resources.
    The SCS cluster (System Communication Services) is composed of
    all nodes participating in the Systems Communication Architec-
    ture (SCA) Protocol.  Generally, this is all nodes connected
    to a SCA bus, for example the CI.


Additional information available:

/CSID/SCS

/CSID=n

    Displays cluster information on a particular VAXcluster member node
    which is specified by its cluster system id.

/SCS

    Displays a view of the cluster as seen by the system communications
    services (SCS).

CONNECTIONS

        SHOW CONNECTIONS [/ADDRESS=n]

    Displays all active connection descriptor tables (CDTs). A CDT
    describes the connection between two SCS processes.

Additional information available:

/ADDRESS

/ADDRESS=n

    Displays a connection descriptor table (CDT) specified by its address.

CRASH

    Displays information concerning the operating system and the currently
    executing process, including the general and special registers that
    describe the process context at the time of the system failure. Also
    displayed is the processor type and certain hardware specific
    maintenance registers that might prove useful in the analysis of
    certain system failures.

DEVICE

        SHOW DEVICE name

    Displays the I/O data structures associated with a device.
    The device name can be a generic name (DB for example), which shows all
    I/O structures associated with that device type; it can be a specific
    name (DBA1 for example), which shows all I/O structures associated with
    that particular device; or it can be omitted, which shows all the I/O
    structures for all devices in the system.

Additional information available:

/ADDRESS

/ADDRESS=n

    Displays the I/O data structures associated with the device which
    is specified by its unit control block (UCB) address.

HEADER

    Displays the header of the dump file.

LOCK

        SHOW LOCK [lockid] [/ALL]

    Displays lock data structures.  Specify the lockid to display
    the lock identified by particular lockid.

Additional information available:

/ALL

/ALL

    Displays all the lock data structures in the system.

PAGE_TABLE

        SHOW PAGE_TABLE [range]

    Displays the contents of the system page table and the global page
    table.  You can display a range of page table entries or the entire
    system page table.

    The range is a range of virtual addresses for which SDA is to display
    page table entries.  You can specify a range as two addresses separ-
    ated by a colon (:), or as an address and a length, in bytes, separ-
    ated by a semicolon (;).

Additional information available:

/ALL/GLOBAL/SYSTEM

/ALL

    Lists both the global and system page tables.  This is the default
    qualifier.

/GLOBAL

    Lists the global page table.

/SYSTEM

    Lists the system page table.

PFN_DATA

        SHOW PFN_DATA [pfn]

    Displays a listing of the free, modified, and bad page
    lists as well as the entire PFN database.

    If the pfn is specified, SDA displays the information
    associated with that page frame number.

Additional information available:

/ALL/BAD/FREE/MODIFIED/SYSTEM

/ALL

    Displays the free page list, modified page list, and bad page list as
    as well as the entire PFN database.  This qualifier is the default.

/BAD

    Displays the bad page list.

/FREE

    Displays the free page list.

/MODIFIED

    Displays the modified page list.

/SYSTEM

    Displays the PFN database.  The information is ordered by page frame
    number, starting at PFN zero.

POOL

        SHOW POOL [range]

    Displays the contents of the lookaside (SRP, IRP, and LRP)
    pools, the nonpaged dynamic storage pool, and the paged dynamic storage
    pool.  You can display part or all of each pool.

    The range is a range of virtual addresses within a pool that you want to
    display. You can specify a range as two addresses separated by a colon
    (:), or as an address and a length, in bytes, separated by a semicolon
    (;).

Additional information available:

/IRP/NONPAGED/PAGED/ALL/FREE/HEADER
/LRP/SRP/SUMMARY/TYPE

/IRP

    Displays the contents of the IRP lookaside list

/NONPAGED

    Displays all the contents of nonpaged pool except the IRP list

/PAGED

    Displays the contents of paged pool

/ALL

    Displays the contents of all of memory; this is the default

/FREE

    Displays the lookaside,paged, and nonpaged pools and shows the blocks
    that are currently available to the system

/HEADER

    Displays only the first 16 longwords of each block within pool

/LRP

    Displays the pool of long I/O request packets. Formats all blocks
    currently allocated (in use) within this pool.

/SRP

    Displays the pool of short I/O request packets.  Formats all blocks
    currently allocated (in use) within this pool.

/SUMMARY

    Displays a summary of the pools or portions of pool specified by the
    above qualifiers.  This qualifier shows the different types of blocks
    present, lists the total number of each, and shows, in decimal, the
    number of bytes in each block.

/TYPE=block-type

    Displays the blocks within pool that are of the specified type.

PORTS

        SHOW PORTS [/ADDRESS=n]

    Displays the port independent portion of the port descriptor table
    (PDT), particularly the list of system communication services
    (SCS) entry addresses.

Additional information available:

/ADDRESS

/ADDRESS=n

    Displays the port descriptor table (PDT) specified by the address.

PROCESS

        SHOW PROCESS [procname] [/qualifier...]

    Displays the software and hardware context of any process in the
    balance set, and performs an implicit SET PROCESS command.

    If no options are given, the PCB of the current process is printed by
    default.

    If 'procname' is specified as "ALL", then information is shown for
    all processes that exist in the system.

    'Procname' must be a quoted string if characters other than capital
    letters and numbers are present in the process name.

Additional information available:

/ALL/CHANNEL/INDEX/LOCK/PAGE_TABLES/PCB
/PHD/PROCESS_SECTION_TABLE/REGISTERS/RMS
/SYSTEM/WORKING_SET_LIST

/ALL

    This qualifier selects all other qualifiers available with this
    command. Thus, the maximum amount of information for the specified
    process or processes is displayed.

/CHANNEL

    Displays the I/O channels assigned to the process, the address of the
    window control block associated with that channel, and the specifica-
    tion of the file or device associated with the channel.

/INDEX=n

    Displays the software and hardware context of the process which is
    specified by the index of the software PCB into the system's PCB
    vector.  Alternately,  this value could be the process identifica-
    tion ( PID or EPID ), from which SDA extracts the correct index.

/LOCK

    Displays the locks owned by the current process.

/PAGE_TABLES [range]

    Displays the page tables of the program and control regions.  The
    range is a range of virtual addresses within a pool that you want to
    display. You can specify a range as two addresses separated by a colon
    (:), or as an address and a length, in bytes, separated by a semicolon
    (;).

    An accepted abbreviation is /PPT.

/PCB

    Produces a list of the data contained in the software process control
    block(PCB).  This qualifier is the default.

/PHD

    Lists information included in the process header.

/PROCESS_SECTION_TABLE

    Lists the information contained in the process section table.

    An accepted abbreviation is /PST.

/REGISTERS

    Lists the saved hardware context of the process.  If the process is
    the current process at the time of the system failure, the active
    registers are also displayed.

/RMS[=optionspec]

    Displays the RMS control blocks specified by the optionspec or by the
    last SET RMS command.  If the optionspec is specified, it is valid for
    only that command and has no effect on the options selected by the
    last SET RMS command.  See the SET RMS command for the format of the
    optionspec. The default optionspec is to display all RMS structures.

/SYSTEM

    Displays the system process control block (PCB).

/WORKING_SET_LIST

    Displays the working set list for the process.

    An accepted abbreviation is /WSL.

RESOURCES

        SHOW RESOURCES [qualifier]

    Displays resource data structures.

Additional information available:

/ALL/LOCKID

/ALL

    Displays all resources in the system.

    This qualifier is the default.

/LOCKID=n

    Displays the resource data associated with the lock whose lockid
    is n.

RSPID

        SHOW RSPID [/CONNECTION=n]

    Displays all entries in the response-id descriptor table which are
    in use.  The VMS System Communication Services (SCS) provide response-
    ids (RSPIDs) as a mechanism for matching request completion mes-
    sages to the original requests.  Generally, the original request
    is represented by a class driver request packet (CDRP).

Additional information available:

/CONNECTION

/CONNECTION=n

    Displays all entries in the response-id descriptor table which
    are associated with this connection descriptor table (CDT).

RMS

    Displays the RMS display options currently selected by the SET RMS
    command (only applies to the show process/rms command).

STACK

        SHOW STACK [range]

    Displays the location and contents of the four process stacks and the
    system-wide interrupt stack.

    You can express the range of memory locations you want to display as two
    locations separated by a colon (:), or as a location and a length, in
    bytes, separated by a semicolon (;).

    If no options are specified, the current operating stack is displayed.

Additional information available:

/ALL/EXECUTIVE/INTERRUPT/KERNEL/SUPERVISOR
/USER

/ALL

    Displays the location and contents of the four process stacks and
    the system-wide interrupt stack.

/EXECUTIVE

    Displays the executive mode stack for the current process.

/INTERRUPT

    Displays the interrupt mode stack for the system.

/KERNEL

    Displays the kernel mode stack for the current process.

/SUPERVISOR

    Displays the supervisor mode stack for the current process.

/USER

    Displays the user mode stack for the current process.

SUMMARY

    Displays a list of all processes in the system at the time of
    the system crash.

Additional information available:

/IMAGE

/IMAGE

    Displays the name of the image being run by each process, if
    available.

SYMBOL

        SHOW SYMBOL name

    Displays the value of the specified system symbol
    and the contents of that memory location (if possible).

Additional information available:

/ALL

/ALL

    Displays information on all the symbols that start with the
    string you specified in the command parameter and are defined
    in the SDA symbol table.

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026