This section describes the commands available in the dump viewer.
Some commands are only available on Dump Index display, while others are only available when a dump is loaded. For a list of valid commands for each of these environments, see the chapter Viewing Dumps on TSO/ISPF.
This section contains the following topics:
Scrolls the display to the last line.
None
BOTTOM
Displays a CICS Message Help report for any CICS message, CICS dump code or CICS transaction abend code.
CM
CMSG arg
Where:
arg specifies the CICS message, CICS dump code or CICS transaction code for which the help report is being requested.
Examples:
Displays the CICS Auxiliary Trace dialog.
CT
CTRACE
Formats the contents of virtual storage using the built-in disassembler.
DI
DISASSEM address length
Where:
Specifies the virtual storage location to be disassembled.
Note: For more information about address specification, see the description of the DUMP command in this appendix.
Identifies the length of storage to be disassembled.
Examples:
DISASSEM *
DISASSEM R14
DISASSEM PSW
DISASSEM R13?+4?+C?
Use the DOWN command to scroll the current display forward.
None
DOWN {number-of-lines|MAX|CSR|PAGE|HALF}
Where:
Specifies the number of lines to scroll the display
Scrolls the display to the bottom.
Scrolls the display to the current cursor position, or one page if the cursor is not located within the display area.
Scrolls the display by the number of lines in the display area.
Scrolls the display by one half the number of lines in the display area.
If no argument is specified, the scroll amount is determined by the default scroll value that appears in the upper right corner of the display.
Deletes a previously defined symbol.
None
DROP <symbol-name|ALL>
Where:
Specifies the name of the symbol to delete.
Specifies that all symbols must be deleted.
Examples:
Displays the contents of virtual storage from the selected dump.
D
DUMP address
Where:
Specifies the virtual storage location to be dumped, address can include a symbol and can specify an indirect address. Enter address using the following syntax. The base variable is required; the prefix, suffix and offset variables are optional:
[prefix]base[suffix][+|-offset[suffix]…]
A symbol can be used as part or all of the address operand. The symbol is automatically replaced by its assigned value during address resolution. For more information, see "Using Symbols". The built-in symbols are as follows:
The PSW at the time the dump was captured.
The address of the TCB at the time the dump was captured.
The general purpose registers at the time the dump was captured.
Valid values for prefix are:
Treats the address as a 31-bit indirect address.
Treats the address as a 24-bit indirect address.
Valid values for base are:
Current location reference. Valid only when the Command is entered from a DUMP, MAP, or DISASSEM display. The asterisk (*) is replaced by the starting address of the current display.
A one- to eight-digit hexadecimal address.
A one to 10 decimal digit followed by a decimal point.
A symbol previously defined by an EQUATE command or one of the predefined symbols.
Valid values for suffix are:
Treats the address as a 31-bit indirect address.
Treats the address as a 24-bit indirect address.
Valid values for offset are:
A one to eight digit hexadecimal address.
A one to ten decimal digit followed by a decimal point.
The length of a previously defined symbol.
The length of a previously loaded map.
The length of a previously loaded label within a loaded map.
Any number of kilobytes (KB). The value nnnnnnnn is multiplied by 1024 for kilobytes.
Any number of pages (P). The value nnnnnnnn is multiplied by 4096 for pages.
Any number of megabytes (MB). The value nnnnnnnn is multiplied by 1048576 for megabytes.
The offset of a label defined within a loaded map (that is, psa.psaaold).
The value of a symbol previously defined by an EQUATE command or the value of a predefined symbol.
An indirect address identifies the address of an address. Suffix characters used to specify indirect address references are processed as they are encountered from left to right. Prefix characters used to specify indirect address references are processed once after the remainder of the address parameter has been completely resolved.
Examples:
DUMP *-100
DUMP *
DUMP R1
DUMP R1?+0? DUMP R1??
DUMP CURRTCB DUMP PSA.PSATOLD%
Defines a symbol to represent a virtual storage address or any other numeric value. For more information, see "Using Symbols".
EQ
EQUATE symbol address {length|USE mapname}
Where:
Specifies a one to eight character symbol name beginning with a letter (a to z) and containing any alphanumeric characters including the national symbols @, #, and $.
Specifies the virtual storage location to be equated with a symbol.
Note: See the description of the DUMP command in this appendix for more information about address specification.
Specifies the length of the area to be equated with a symbol.
Specifies the name of a loaded map that is used to Auto-Map the specified address.
Examples:
EQUATE X *
EQUATE LTCB L'TCBFIX
EQUATE EP R13?+4?+10? 4K
Locates:
F
From a DUMP display:
FIND data start-address {length}
From any other display:
FIND string {PREV}
Where:
Specifies the EBCDIC or hexadecimal data to be located. Specify hexadecimal data as an even number of digits enclosed by x’ ‘.
Specifies the storage address where the search must begin.
Note: For more information about address specification, see the description of the DUMP command in this appendix.
Specifies the length, as a hexadecimal value, of storage to be searched. If not specified, a default length of 10000 bytes is searched.
Specifies any group of letters or numbers up to 31 characters long. If string contains a blank, you must enclose string in apostrophes. If string contains an apostrophe (‘), you must enclose string in quotation marks (“).
Locates the previous occurrence of string.
Examples:
Requests help for the current display, the current message, or the specified topic or message.
H
HELP {topic|COMMANDS|TOPICS|MESSAGE}
Where:
Specifies any command, message number, or topic for which help is being requested.
Displays a selection list of all dump viewer commands.
Displays a selection list of help topics.
Displays a selection list of all product messages.
Examples:
Gives the current display home state status.
None
HOME
Adds a data record from the display to the Keep Window; enables, or disables the window display. The KEEP command can also be used as a synonym for REMOVE.
None
KEEP {ON|OFF}
Where:
Enables the window display.
Disables the window display.
If the Keep Window display is enabled and no argument is specified on the KEEP command, the line of data identified by the cursor position is added or removed from the window.
Scrolls the current display to the left.
None
LEFT {number-of-columns|MAX|CSR|PAGE|HALF}
Where:
Specifies the number of columns to scroll the display
Scrolls the display to the first column.
Scrolls the display to the current cursor position, or the width of one page if the cursor is not located within the display area.
Scrolls the display by the number of columns in the display area.
Scrolls the display by one half the number of columns in the display area.
If no argument is specified, the scroll amount is determined by the default scroll value that appears in the upper right corner of the display.
Displays the names of the currently loaded maps.
None
LISTMAPS
Loads maps from a member in a map library.
None
LOADMAPS mapname [maplib]
Where:
Specifies the name of a map library member to be loaded.
Specifies the name of the map library.
Example:
LOADMAPS CADVMMVS CAI.MAPLIB
Formats the contents of virtual storage using one of the loaded maps. For more information about the use of maps, see "Advanced Techniques."
None
MAP address mapname
Specifies the virtual storage location to be mapped.
Note: For more information about address specification, see the description of the DUMP command.
Specifies the name of the map to use. When mapping a known control block, you do not need to specify the name of the map to use for formatting. The location and map name for most OS control blocks and many CICS control blocks are already known to the dump viewer.
Note: For more information about listing available maps, see the description of the LISTMAPS command.
Examples:
MAP * TCB
MAP R13 DFHCSADS
Edits the Electronic Notepad.
None
NOTES {dsname}
Where:
The dsname of the reports dataset for an existing dump. If you specify a fully-qualified dsname, it must be enclosed in apostrophes. If no apostrophes are used, your ZPREFIX value will be appended as the high-level qualifier. This argument is only permitted when using the NOTES command on the command line from the Dump Index display. Once a dump is selected for viewing, only the notepad for that dump may be edited.
Displays the options in effect.
OPT
OPTIONS
Use the PRINT command from any display to print all or part of the display to any print destination. You are always prompted for a printer destination.
PR
No parameters are required. However, you are prompted for the following information:
A 1-32 character title that appears at the top of every printed page.
The destination to which the printed output will be routed. This can be specified as a printer name, node.userid, or left blank to spool the printed output to your TSO user ID.
The starting and ending lines to print. By default, the starting line is set to one and the ending line is set to the number of lines in the report.
Number of copies to print.
The sysout class that will be used to allocate the print data set.
Number of logical lines per page, including the title and header lines.
Logical record length to use for the print data set. This is the maximum width of the data being printed. You can increase or decrease this value to fit your printer. However, decreasing the record size can result in truncation of data.
Name of the library member that PSF uses to define the page layout for printing on a 3800 Printing Subsystem Model 3.
Form Def
Name of the library member that PSF uses to define the form layout for printing on a 3800 Printing Subsystem Model 3.
Name of the character arrangement tables for printing on a 3800 Printing Subsystem Model 3.
Refreshes the contents of the Dump Index display.
REF
REFRESH
Repeats the previous FIND command.
RF
RFIND
Scrolls the current display to the right.
None
RIGHT {number-of-columns|MAX|CSR|PAGE|HALF}
Where:
The number of columns to scroll the display
Scrolls the display to the last column.
Scrolls the display to the current cursor position, or the width of one page if the cursor is not located within the display area.
Scrolls the display by the number of columns in the display area.
Scrolls the display by one half the number of columns in the display area.
If no argument is specified, the scroll amount is determined by the default scroll value that appears in the upper right corner of the display.
Selects a dump data set for viewing. This command is only valid from the Dump Index display.
S
SELECT
No parameters are required; however, you are prompted for the following information:
The data set name of a reports data set for the captured dump.
The data set name of a storage data set for the captured dump.
Selects a dump data set for viewing and adds the related data set names to the current dump index. This command is only valid from the Dump Index display.
SX
SELECTX
No parameters are required; however, you are prompted for the following information:
The data set name of a reports data set for the captured dump.
The data set name of a storage data set for the captured dump.
Selects a new dump index file for the Dump Index display.
SET
SETINDEX dsname
Where:
The data set name of dump index. If the dsname parameter is omitted, you are prompted for it.
Displays the current status of the dump capture facility, the availability of SYSVIEW/E Services, the product genlevel, and the system ID. STATUS also displays the core address for each resident module associated with the dump capture facility.
ST
STATUS
Sorts the current output display on any column by name. Column names appear in the highlighted header line at the top of the display. By default, the display is sorted in ascending alphabetical order.
Once sorted, specify an asterisk in place of the column name to return the display to its initial order.
None
SORT <column-name|*> {D|H}
Where:
The name of the column as it appears on the highlighted header line in the display.
Specifies that the display must be returned to its original sort order.
Sorts in descending order.
Indicates that the column being sorted contains hexadecimal data in EBCDIC display format and must be sorted with the characters A-F considered greater than 0-9.
Examples:
Displays the currently defined symbols. Symbols are created by the EQUATE command. For more information, see "Using Symbols".
None
SYMBOLS
Each time a dump is loaded, CA SymDump System provides the following built-in symbols:
The PSW at the time the dump was captured.
The address of the TCB which requested the dump.
The general purpose registers at the time the dump was captured.
Scrolls the display to the top line.
None
TOP
Scrolls the current display backward.
None
UP {number-of-lines|MAX|CSR|PAGE|HALF}
Where:
Specifies the number of lines to scroll the display.
Scrolls the display to the top.
Scrolls the display to the current cursor position, or one page if the cursor is not located within the display area.
Scrolls the display by the number of lines in the display area.
Scrolls the display by one half the number of lines in the display area.
If no argument is specified, the scroll amount is determined by the default scroll value in the upper right corner of the display.
|
Copyright © 2014 CA Technologies.
All rights reserved.
|
|