Space announcement This documentation space provides the same content as before, but the organization of the content has changed. The content is now organized based on logical branches instead of legacy book titles. We hope that the new structure will help you quickly find the content that you need.

Abend-AID Viewer Commands


The commands listed in this section perform specific functions. Many of these commands, especially the fast path commands, function only after you have selected an entry from the Abend-AID Directory and, in some cases, only if you are executing them from specific screens. For information about the Abend-AID Directory, see Abend-AID directory.

To determine which commands are available on a particular screen while you are using the Abend-AID  Viewer, type CMDLIST or HELP COMMANDS in the COMMAND (or OPTION) field and press Enter. A scrollable display appears that lists the available commands in alphabetical order.

To determine a particular command’s syntax while you are using the Abend-AID Viewer, type HELP  cmdname in the COMMAND (or OPTION) field and press Enter, or click on the command name in the list and press Enter. For example, HELP FIND displays a pop-up window describing the FIND command.

Syntax diagrams define command syntax. Minimum strings for commands are shown in UPPERCASE characters. Commands consist of the command itself and may include either required or optional parameters.

parameter is either a keyword or a variable.

  • Minimum strings for keywords are shown in UPPERCASE characters and must be spelled exactly as shown. Any remaining characters of the keyword may be included at your discretion. However, you cannot substitute another value.
  • All variables are user-specified values and are printed in lowercase italics. For example, data set-name indicates you are to substitute a value.

The syntax for commands is described in diagrams that help you visualize parameter use. The following example shows a command and a required parameter:

image2022-10-11_0-35-32.png

 Read the diagrams from left to right and from top to bottom. These symbols help you follow the path of the syntax

image2022-10-11_0-35-57.png 


indicates the beginning of a statement.

 image2022-10-11_0-36-18.png

indicates the statement is continued on the next line.

 image2022-10-11_0-36-32.png

indicates the statement is continued from the previous line.

 image2022-10-11_0-36-46.png

indicates the end of a statement.

Required parameters appear on the horizontal line (the main path):

image2022-10-11_0-37-33.png

Optional parameters appear below the main path. Default parameters that appear above the main path are optional; including or excluding them in the command has the same effect on the execution.

image2022-10-11_0-38-1.png

 Vertically stacked parameters are mutually exclusive. If you must choose a parameter, one item of the stack appears on the main path. If the parameters are optional, the entire stack appears below the main path. If one of the parameters in a stack is the default, it appears above the main path:

image2022-10-11_0-38-33.png

ABREC

Command Type: Fastpath

Restrictions: Valid only for batch dumps.

The ABREC command displays the menu options for Abend Re-creation. 

image-2024-6-5_15-13-0-1.png

ACTBATCH

Command Type: Fast Path

Restrictions: Valid only in installation customization.

Screen Displayed: Batch Dump Contact Information. This screen creates and maintains batch dump contact information definitions.

 image2022-10-11_0-39-3.png

ACTIONS

Command Type: Fast Path

Screen Displayed: Action Definition Menu.

image2022-10-11_0-39-19.png

ADSTCK

Command Type: Primary

The ADSTCK command displays the store clock time that is stored at the specified address. It is adjusted for GMT and Leap second.

image2022-10-11_0-39-39.png

address

A valid hexadecimal address.

Example:

ADSTCK 59ADC00

AMODE

Command Type: Primary

Restrictions: Valid only for batch dumps.

The AMODE command changes or displays the AMODE setting for the current user session. The AMODE setting is used when the storage for Assembler programs is being formatted. The register contents are used to obtain storage from the dump to be formatted for source support, and the AMODE setting influences the portion of the register that is used to locate storage.

 image2022-10-11_0-40-7.png

24

Indicates that AMODE 24 is to be used when using the register contents to access storage in the dump.

31

Indicates that AMODE 31 is to be used when using the register contents to access storage in the dump.

64

Indicates that AMODE 64 is to be used when using the register contents to access storage in the dump.

Query

Indicates that the current AMODE setting will be displayed.

RESET

Indicates that the AMODE setting will not be used. Instead, the AMODE setting, if any, known for the selected program will be used.

AMODE24

Command Type: Primary

Restrictions: Valid only for batch dumps.

The AMODE24 command sets the AMODE setting to AMODE 24 for the current user session.

image2022-10-11_0-40-33.png

AMODE31

Command Type: Primary

Restrictions: Valid only for batch dumps.

The AMODE31 command sets the AMODE setting to AMODE 31 for the current user session.

image2022-10-11_0-40-57.png

AMODE64

Command Type: Primary

Restrictions: Valid only for batch dumps.

The AMODE64 command sets the AMODE setting to AMODE 64 for the current user session.

image2022-10-11_0-41-29.png

ARCH

Command Type: Fast Path

Screen Displayed: Optional z/Architecture Features. This screen displays the unavailable z/Architecture hardware facility when the abend is due to execution of an opcode on hardware that does not support the instruction.

 image2022-10-11_0-41-52.png

ARRANGE

Command Type: Primary

Restrictions: Valid only on Abend-AID  Viewer screens with columns such as the Abend-AID Directory.

The ARRANGE command lets you rearrange the position of the columns on the screen where you enter this command. In the pop-up window that is displayed, you can enter the following line commands next to the desired column in the list of screen column headings:

  • M (Move column)
  • A (After column)
  • B (Before column)
  • L (Lock/Unlock column toggle)
  • H (Hide/Show column toggle)

After you’ve made your changes, type END (or press the PF3 key) to save your changes, CANCEL to exit the pop-up window without saving, or RESET to restore the screen column defaults.

Note

The ARRANGE command can be used on any screen that contains columns. You can save any changes for future use on the Fault Summary, Abend-AID Directory, File Summary, Database PCB Summary, and I/O PCB Summary screens.

 image2022-10-11_0-42-21.png

ASCB

Command Type: Fast Path

Restrictions: Valid only for SVC dumps.

Screen Displayed: Address Space Control Block. This screen displays the address space control block for the currently selected address space.

 image2022-10-11_0-42-39.png

ASIDLIST

Command Type: Fast Path

Restrictions: Valid only for SVC dumps.

Screen Displayed: Address Space Summary. This screen displays the list of address spaces active in the image at the time the dump was taken.

 image2022-10-11_0-42-57.png

ASMAP

Command Type: Fast Path

Restrictions: Valid only for SVC dumps.

Screen Displayed: MVS VSM Allocated Storage Map. This screen lists virtual storage address ranges and their corresponding virtual storage areas, subpools, keys, etc.

 image2022-10-11_0-43-16.png

ASSIST

Command Type: Primary

The ASSIST command displays the commands that are available for the current screen, scrollable table, or field. Pressing the ASSIST PF key (default is PF24) also executes this command. For example, to list the commands available for the current screen, tab to the COMMAND field and press the ASSIST PF key, or type ASSIST on the COMMAND line, and press Enter. To list the commands available for a specific field, tab to the field and press the ASSIST PF key, or type ASSIST on the COMMAND line, tab to the field, and press Enter. If the current screen, scrollable table, or field has no commands associated with it, a message appears stating that the ASSIST function is not available for this screen or field.

 image2022-10-11_0-43-35.png

ASXB

Command Type: Fast Path

Restrictions: Valid only for SVC dumps.

Screen Displayed: Address Space Extension Block. This screen displays the address space extension block for the currently selected address space.

 image2022-10-11_0-43-54.png

ATTRBUTE

Command Type: Fast Path

Screen Displayed: Screen Attributes. This screen lets you modify screen attribute options — for example screen colors, intensity, and highlighting. After you complete your changes, enter TESTSCR to see the effect of your changes.

 image2022-10-7_16-10-43.png

You can change the following screen areas:

  • Borders
  • Tab-selectable Data
  • Input Data
  • Available Fast-path Commands on Menus
  • Unavailable Fast-path Commands on Menus
  • Field Descriptions, Normal
  • Field Descriptions, Emphasized
  • Field Data, Normal
  • Field Data, Emphasized
  • Field Data, Errors
  • Column Headings
  • Group Headings, Normal
  • Group Headings, Emphasized

AUTO

Command Type: Fast Path

Restrictions: Valid only for batch dumps with PL/I information and without source support.

Screen Displayed: Memory Display screen of the PL/I automatic storage in hexadecimal format that was allocated to the program at the time of the dump.

 image2022-10-7_16-11-47.png

programname

The name of a PL/I program in the dump. If you do not include the program name as an operand for the AUTO command, the automatic storage for the abending program is displayed.

Example:

AUTO PAYTEST1

BACKWARD

Command Type: Primary

The BACKWARD command is an alias for the UP command (PF7). Use this command to scroll the active display toward the top of a scrollable list of entries.

 image2022-10-7_16-12-35.png

lines

The number of lines to scroll.

Example:

BACKW 8

This example scrolls the active display eight lines toward the top of the entries list.

BIND

Command Type: Fast Path

Restrictions: Valid only for dumps with Db2 information.

Screen Displayed: Bind Information.

 image2022-10-7_16-19-50.png

BLOG

Command Type: Primary

Restrictions: For ISPF access only.

The BLOG command lets you browse the problem log for the current dump using the ISPF browse.

 image2022-10-7_16-21-5.png

BORDERS

Command Type: Primary

The BORDERS command shows or hides the side and bottom borders of all screens in the current session. (The top border cannot be hidden.) For information about setting the default values for this command for all sessions, see User Profile screen.

 image2022-10-7_16-22-42.png

ON

Displays the borders on all screens in the current session.

OFF

Removes the borders on all screens in the current session.

BOTTOM

Specifies that only the bottom border is affected by the command.

SIDE

Specifies that only the side borders are affected by the command.

Example:

BORDERS OFF SIDE

This example turns off the side borders for all screens in this session.

BOTTOM

Command Type: Primary

The BOTTOM command scrolls to the bottom of a screen’s scrollable area.

 image2022-10-7_16-23-58.png

CANCEL

Command Type: Primary

The CANCEL command cancels the current operation without saving the data and then redisplays the previous menu or screen.

 image2022-10-7_16-24-15.png

CAPTURE

Command Type: Fast Path

Restrictions: Valid only in customization.

Screen Displayed: Dump Capture and Processing menu. This menu provides access to the following screens:

•Region Configuration

•Region Dump Capture Profiles

 image2022-10-7_16-30-17.png

CB

Command Type: Fast Path

Restrictions: Valid only for SVC dumps where control blocks have been captured.

Screen Displayed: Control Blocks/Storage screen. This screen displays a selectable list of control blocks that were included in the dump. The listed control blocks can be displayed in hexadecimal and, if applicable, DSECT format. The screen also provides access to the current paperclip table and the saved paperclip list.

 image2022-10-7_16-30-39.png

CHAIN

Command Type: Primary

The CHAIN command runs a control block chain based on user-specified parameters. For each control block located, the chain facility creates a paperclip entry in the current paperclip table. The comments associated with the paperclip entries reflect the entry number of the chain, with the user-specified chain prefix as the chain name.

If you type the CHAIN command without one of its optional parameters, the Abend-AID  Viewer displays the Chain Command Parameters screen. This screen includes entry fields for specifying all of the parameters associated with the CHAIN command, including the chain prefix and the chain termination value. For more information about this screen, see Running control block chains

 image2022-10-7_16-31-2.png

address

The address at which the CHAIN command begins executing. The address must be a valid hexadecimal address.

offset

The link address offset specifying the address of the fullword pointer that points to the control block in the chain. This parameter is processed based on whether the addressing mode is 24-bit or 31-bit, as set on the CHAIN Command Parameters screen.

Example:

CHAIN 00007000 +10

This example specifies the starting address, 00007000, and the link address offset +10.

CLIP

Command Type: Primary

Restrictions: This command is valid on the Memory Display and Storage Map Display screens only.

The CLIP command displays paperclip entries.

 image2022-10-7_16-31-28.png

FIRST

Displays the first entry in the paperclip table. FIRST is the default if you execute the CLIP command without any keyword parameter.

LAST

Displays the last entry in the paperclip table.

LOCK

Locks the current paperclip entry.

NEXT

Displays the next entry in the paperclip table.

PREV

Displays the previous entry in the paperclip table.

CLR

Command Type: Primary

The CLR command clears the current paperclip table by deleting all entries.

 image2022-10-7_16-32-2.png

CMDLIST

Command Type: Primary

The CMDLIST command lists the commands that are available for execution from within Abend-AID.

A small subset of commands are always available, even when you have not selected a dump from the Abend-AID Directory. Additional commands become available after you select an SVC dump entry from the directory. Most commands, however, become available only after you select a batch entry from the directory.

 image2022-10-7_16-32-21.png

The following figure is an example of the information displayed when you invoke the CMDLIST command. You can tab to any command and press Enter to display help for that command.

 Command List Example

 image2022-10-7_17-13-59.png

COBSORT

Command Type: Fast Path

Restrictions: Valid only for batch dumps.

Screen Displayed: COBOL Sort Information screen.

 image2022-10-7_17-14-25.png

COLSREF

Command Type: Fast Path

Restrictions: Valid only for batch dumps.

Screen Displayed: Db2 Columns Referenced.

 image2022-10-7_17-14-59.png

COMM

Command Type: Primary

The COMM command adds a user-specified comment to a paperclip entry. The Comm command is valid only on the Memory Display screen.

 image2022-10-7_17-31-16.png

comment

User-specified text. The maximum comment length allowed is 35 characters (including spaces).

CONTROL

Command Type: Fast Path

Restrictions: Valid only for batch dumps with PL/I information and without source support.

Screen Displayed: Memory Display screen of the PL/I controlled storage in hexadecimal format that was allocated to the program at the time of the dump.

 image2022-10-7_17-31-59.png

programname

The name of a PL/I program in the dump. If you do not include the program name as an operand for the CONTROL command, the external storage for the abending program is displayed.

Example:

CONTROL PAYTEST1

CORE

Command Type: Primary

The CORE command displays the storage found at the exact location specified. However, if you issue the CORE command without one of its optional parameters, Abend-AID displays the Storage Map Display screen. This screen lists in hexadecimal format all allocated and unallocated segments of storage for the current dump.

 image2022-10-7_17-47-53.png

address

The address must be in hexadecimal.

symbolname

For SVC dumps only. The literal S/ must precede the symbol name.

Example 1:

CORE 002744F0

Example 1 displays the storage at hexadecimal address 002744F0.

Example 2:

CORE S/TCA0009

Example 2 displays the storage at symbol TCA0009.

CRETRIEV

Command Type: Primary

The CRETRIEV command functions differently depending on the position of the cursor when you enter the command.

If the cursor is in the COMMAND (or OPTION) field, CRETRIEV functions like the RETRIEVE command. That is, the most recently entered commands are redisplayed on the command line, one command at a time, in the reverse sequence in which they were entered (last-in, first-out). This command lets you easily recall a command for resubmission from the command line. You can edit the command before issuing it.

If the cursor is not in the COMMAND (or OPTION) field, CRETRIEV functions like the CURSOR command. That is, the cursor is moved to the first input field on the menu or screen being displayed, usually the COMMAND (or OPTION) field. When used in this way, CRETRIEV functions like a HOME key.

 image2022-10-7_17-48-28.png

CSASP

Command Type: Fast Path

Restrictions: Valid only for SVC dumps.

Screen Displayed: Summarized CSA Subpools. This screen lists the CSA subpools allocated at the time of the fault.

 image2022-10-7_17-48-51.png

CSASUM

Command Type: Fast Path

Restrictions: Valid only for SVC dumps.

Screen Displayed: Common Service Area Summary. This screen lists the CSA area allocations at the time of the fault.

 image2022-10-7_17-49-44.png

CSSTEXT

Command Type: Primary

This command invokes a pop-up screen containing the error message text for BMC AMI Common Shared Services (CSS) return codes. The first line contains the return code number. The next line contains the text message for CSS SDINTF RC (########). The return code is a hex value. All eight digits must be enclosed in parentheses.

image2022-10-7_17-50-19.pngCSSUTIL

CSSUTIL

Command Type: Primary

Restrictions: Valid only when using the ISPF viewing access method.

Screen Displayed: CSS Utilities panel. This command can be issued from anywhere within the Abend-AID  Viewer when accessing Abend-AID through ISPF. It allows you to access the CSS Utilities panel on-the-fly. For detailed information on how to use the CSS utilities, refer to the  BMC AMI Common Shared Services User/Reference space . This space is available on the BMC Support .


 image2022-10-7_17-51-2.png

CURSOR

Command Type: Primary

The CURSOR command moves the cursor to the first input field on the menu or screen being displayed, usually the COMMAND (or OPTION) field. This command functions like a HOME key and is usually assigned to a specific PF key. For more information about modifying PF Key assignments, see Modifying PF Key Functions.

 image2022-10-7_17-52-8.png

CUSTOM

Command Type: Fast Path

  • Screen Displayed: Customization Options menu. This menu provides access to the following Abend-AID customization menus which in turn let you access additional screens to tailor your environment:
    • Site Default Options Menu (from which you can access the following screens):
    • Site Print Options
    • Site User Profile
    • Site Screen Attributes
    • Site PF Key - Primary
  • Dump Capture and Processing Menu (from which you can access the following screens):
    • Region Configuration
    • Region Dump Capture Profiles
  • Action Definition Menu
    Batch Dump Contact Information

 image2022-10-7_17-52-36.png

CUSTUSER

Command Type: Fast Path

Restrictions: Delete function is available only to a user with UPDATE authority to the Customization file.

Screen Displayed: Server List. This screen displays a list of servers using this Customization file. Active servers and subsystems are highlighted. You may delete obsolete server records if that server is not active and you have UPDATE access to the Customization file.

 image2022-10-7_17-53-4.png

CVT

Command Type: Fast Path

Restrictions: Valid only for SVC dumps.

Screen Displayed: Communications Vector Table.

image2022-10-7_17-53-39.png

DB2

Command Type: Fast Path

Restrictions: Valid only for dumps that contain Db2 information and only if you’re licensed for the Db2 option.

Screen Displayed: DB2 Information menu. This menu provides access to the following screens containing detailed Db2 information:

  • Host Variables
  • Bind Information
  • Precompile Information
  • Columns Referenced
  • RCT Detail
  • Dependencies

 image2022-10-7_17-54-7.png

DECODE

Command Type: Primary

The DECODE command disassembles a single assembler instruction at the address specified, and it places this information on the message line of the current screen.

Important

On Memory Display data fields only (for example, Word1), the DECODE command disassembles the data displayed in the field.

Methods of executing this command include the following:

  • From any Abend-AID screen — Enter DECODE, a space, and the hexadecimal address of the instruction as a primary command.
  • From any tab-selectable field listing a hexadecimal address — Type DECODE in the COMMAND field, position the cursor on the hexadecimal address, and press Enter.
  • From the Memory Display screen — Type DECODE in the COMMAND field, position the cursor on the first byte of the instruction to decode, and press Enter.

Note

To decode all assembler instructions in storage for the current dump, use the DISASM command. See DISASM command for specifics.

image2022-10-7_17-54-53.pngaddress

The hexadecimal address of the instruction you want to decode.

DEFAULTS

Command Type: Primary

This command is valid on the User Profile, Screen Attributes, and the PF Key Definitions screens only. The DEFAULTS command restores the site-defined defaults for these screens if you changed them.

image2022-10-7_17-55-46.png 

DELETEAA

Command Type: Fast Path

Restrictions: Valid only within the Site Customization facility.

Screen Displayed: Confirmation window to Delete Site News for batch Abend-AID.

Access this window from the Site News Menu on the Customization Options menu or as a fast-path command from the Report Menu. With DELETEAA, you can delete site news information relating to Abend-AID. To add or maintain site news, you must use the NEWSAA command as described in NEWSAA

 image2022-10-7_17-56-13.png

DEPN

Command Type: Fast Path

Screen Displayed: Package Dependencies (if the program that issued the last Db2 call was bound in a package) or Plan Dependencies (if the program that issued the last Db2 call was bound in a plan).

 image2022-10-7_17-56-33.png

DIAG

Command Type: Fast Path

Screen Displayed: Diagnostic Summary. This screen provides important analysis information about the abend. A description of the abend is provided, and the error analysis, error location, next sequential instruction are also identified.

image2022-10-7_17-56-54.png 

DIRECTRY

Command Type: Fast Path

Screen Displayed: Abend-AID Directory. This screen provides information on the entries within the report databases and the SVC dump data sets.

Entering this command without any operands results in the directory being displayed using the criteria from the last selection made on the Abend-AID Fault Summary screen during the current session. To display all of the entries on the Abend-AID Directory, enter the command with the ALL operand.

 image2022-10-7_18-3-12.png

all

Optional literal to display all directory entries for this viewing server.

DIRSCAN

Command Type: Primary

The DIRSCAN command initiates an immediate scan for new report entries to be displayed on the Abend-AID Directory. The command first updates the server database list and then queries the shared directory for new report entries. Any new report entries are added to the directory display.

 image2022-10-7_18-3-40.png

DISASM

Command Type: Primary

The DISASM command disassembles all assembler instructions in storage. It displays this information on the Storage Disassembly screen, starting with the address specified. See Storage Disassembly screen for an explanation of this screen. 

Note

On Memory Display data fields only (for example, Word1), the DISASM command disassembles the data displayed in the field.


You can execute this command in several ways:

From any Abend-AID  screen — Enter DISASM, a space, and the hexadecimal address of the instruction as a primary command.

From any tab-selectable field listing a hexadecimal address — Perform one of the following:

–Type DISASM in the COMMAND (or OPTION) field, position the cursor on the hexadecimal address, and press Enter.

–Position the cursor on the hexadecimal address and press the DISASM PF key. (PF17 is the default.)

From the Memory Display screen — Perform one of the following:

–Type DISASM in the COMMAND field, position the cursor on the first byte of the first instruction you want to display, and press Enter.

–Position the cursor on the first byte of the first instruction you want to display and press the DISASM PF key.

Use the UP and DOWN PF keys to scroll through the Storage Disassembly screen. (PF7 and PF8 are the defaults.)

To decode a single instruction, use the DECODE command. See DECODE for specifics.

image2022-10-7_18-6-36.pngdisasm.png

 address

The hexadecimal address at which you want the DISASM command to start. When the Storage Disassembly screen appears, the decoded instruction at that address is listed first.

Example:

DISASM 59ADC00

DOWN

Command Type: Primary

The DOWN command scrolls the active screen display toward the bottom of a scrollable list of entries. Pressing the DOWN key also executes this command. (PF8 is the default.)

 image2022-10-7_18-7-15.png

scrollamount

The number of rows to scroll toward the bottom of a scrollable list of entries.

Example:

DOWN 12

This example scrolls the active screen display 12 rows toward the bottom of a scrollable list of entries.

DSA

Command Type: Fast Path

Restrictions: Valid only for batch dumps for COBOL programs.

Screen Displayed: Dynamic Storage Area Summary. This screen displays a dynamic storage area summary for the specified COBOL program at the time the dump was taken. The DSA can only occur for COBOL for MVS and VM, COBOL for OS/390 and VM, and for higher versions of COBOL.

 image2022-10-7_18-14-15.png

programname

The name of a COBOL program in the dump. If you do not include the program name as an operand for the DSA command, the Dynamic Storage Area for the abending program is displayed.

Example:

DSA PAYTEST1

DSECT

Command Type: Primary

The DSECT command displays storage in DSECT format. To use the command, type DSECT in the COMMAND field; position the cursor on an address, a table entry, or a control block symbol; and then press Enter. Pressing the DSECT PF key also executes this command. (PF19 is the default.) 

The DSECT command functions only in fields for which a control block has been defined. To determine if the command is available, use the ASSIST command. See ASSIST for specifics.

For a list of available MVS DSECTs that the Abend-AID  Viewer supports, see Available MVS DSECTs

image2022-10-7_18-15-10.pngDSNLIST

DSNLIST

Command Type: Primary

The DSNLIST command dynamically updates the list of report databases on the Available Data Sets screen after a report database is added while the viewing server is active. Access the Available Data Sets screen by pressing Enter on the DBLIST field on the Fault Summary or the Abend-AID Directory. The DSNLIST command gives you access to the added database without your having to logoff and log back on to the viewing server.

image2022-10-7_18-16-28.png

END

Command Type: Primary

The END command terminates the current operation and redisplays the previous menu or screen. The END command is usually assigned to a PF key. (The default is PF3.)

image2022-10-10_11-38-49.pngESRCH

Command Type: Fast Path

Restrictions: Valid only for batch dumps.

Screen Displayed: Extended Search Listing. For COBOL programs only, this screen displays all fields available for extended search.

 image2022-10-10_11-37-19.png

EXIT

Command Type: Primary

The EXIT command terminates the current session.

 image2022-10-10_11-39-13.png

FADB2

Command Type: Fast Path

Restrictions: Valid only in ISPF for batch reports with Db2 information.

Screen Displayed: File-AID for DB2 Interface screen. This screen provides access to File-AID for DB2 information in ISPF.

 image2022-10-10_11-44-23.png

FILES

Command Type: Fast Path

Restrictions: Valid only for batch dumps.

Screen Displayed: Files Summary. This screen provides information about the files associated with the abending job.

 image2022-10-10_11-44-46.png

FIND

Command Type: Primary

The FIND command locates hexadecimal or character data strings. Its function and syntax depend on the screen from which you are executing the command. By default, the FIND command searches 2500 lines at a time. To change this value, modify the user profile FIND command line limit default value. See User Profile screenfor additional information.

The FIND command searches to the end of the page on which the last line of the search is located. For example, if you change the FIND command line limit to 5000, executing the command actually searches more than 5000 lines, unless the 5000th line happens to be the last line on the page.


Executing FIND from the Memory Display

On the Memory Display screen, the FIND command locates hexadecimal or character data based on selection parameters you specify. If you execute FIND without parameters, the Find for Storage Display screen appears. This screen allows you to update FIND command defaults for use on the Memory Display. For more information about the Find for Storage Display screen, see Setting FIND Command Parameters

image2022-10-10_11-46-48.png

C'string 1'

Finds the character data identified as string 1.

X'string 2'

Finds the hexadecimal data identified as string 2.

T'string 3'

Finds the mixed-case character data identified as string 3.

NEXT

Finds the next occurrence of the string. Executing FIND without a directional keyword (NEXT, PREV, FIRST, LAST) accomplishes the same result.

PREV

Finds the previous occurrence of the string.

FIRST

Finds the first occurrence of the string.

LAST

Finds the last occurrence of the string.

Example 1:

F C'DFH'

Example 1 finds the character string DFH.

Example 2:

F X'D010' PREV

Example 2 finds the previous occurrence of the hexadecimal string D010. PREV overrides the default direction and updates the Find for Storage Display screen.

Executing FIND from Screens Other Than the Memory Display

On screens other than the Memory Display, the FIND command locates specified data strings. (Not all screens support the FIND command.) If you execute FIND without specifying a data string, an error message appears.

Because hexadecimal values are considered data strings on screens other than the Memory Display, enclosing the hexadecimal value with x' ' is not necessary.


 image2022-10-10_11-54-54.png

string

Finds the specified data string.

NEXT

Finds the next occurrence of the data string. Executing the command without a directional keyword (NEXT, PREV, FIRST, LAST) accomplishes the same result.

PREV

Finds the previous occurrence of the data string.

FIRST

Finds the first occurrence of the data string.

LAST

Finds the last occurrence of the data string.

Example:

F DELETED LAST

This example finds the last occurrence of data string DELETED.

FLOAT

Command Type: Fast Path

Restrictions: Valid only for CICS transaction dumps.

Screen Displayed: Floating-Point Registers screen. This screen provides the values of the floating-point registers for the transaction at the time of the abend.

 image2022-10-10_11-59-11.png

FORWARD

Command Type: Primary

The FORWARD command is an alias for the DOWN command. (PF8 is the default.). Use this command to scroll the active display toward the bottom of a scrollable list of entries.

 image2022-10-10_11-59-57.png

lines

The number of lines to scroll.

Example:

FORW 8

This example scrolls the active display eight lines toward the bottom of the entries list.

GO

Command Type: Primary

Valid on the Print Options and Initiation screen only. The GO command processes the print data set using the print options specified on the Print Options and Initiation screen.

 image2022-10-10_16-32-35.png

HELP

Command Type: Primary

The HELP command displays help text that describes a user-selected screen, field, primary command, fast-path command, or system message. Pressing the HELP PF key also executes this command. (PF1 and PF13 are the defaults.)

To access help for the current screen, enter HELP as a primary command. For field help, type HELP, in the COMMAND field, move the cursor to the desired field, and press Enter. For command help, enter HELP  cmdname. For message help, type HELP, in the COMMAND (or OPTION) field, move the cursor to the message text, and press Enter.

Note

Use the MSGHELP command to display help text for a particular Abend-AID message number. For specifics, see MSGHELP.


For more information about accessing online help, see Online-help.

 image2022-10-10_16-33-59.png

COMMANDS

Displays the list of Abend-AID primary and fast-path commands.

cmdname

The name of the primary or fast-path command for which Abend-AID displays help text.

Example:

HELP FIND

This example displays help text for the FIND command.

HEXD

Command Type: Primary

The HEXD command displays storage in hexadecimal format. To use the command, type HEXD in the COMMAND field, position the cursor on an address, a table entry, or a control block symbol; and then press Enter. Pressing the HEXD PF key also executes this command. (PF18 is the default.)

For more information about displaying storage, see Displaying Storage

 image2022-10-10_16-34-28.png

HISTORY

Command Type: Fast Path

Screen Displayed: Duplicate History Log. This screen describes the 100 most recently suppressed duplicate dumps.

 image2022-10-10_16-40-6.png

HOSTVAR

Command Type: Fast Path

Restrictions: Valid only for batch dumps that contain Db2 information.

Screen Displayed: Host Variables. This screen lists the host variables that were referred to by the SQL statement.

 image2022-10-10_16-40-44.png

IDMS

Command Type: Fast Path

Restrictions: Valid only for batch dumps that contain IDMS information.

Screen Displayed: IDMS Information for the current dump.

image2022-10-10_16-41-30.png

IMPORT

Command Type: Fast Path

Screen Displayed: Data set Import. This screen can be used to import new SVC dumps into Abend-AID.

 image2022-10-10_16-42-7.png

IMS

Command Type: Fast Path

Restrictions: Valid only for batch dumps that contain IMS information.

Screen Displayed: IMS Information menu for the current dump.

 image2022-10-10_16-42-32.png

INFO

Command Type: Fast Path

Screen Displayed: Entry Information screen for the current dump. General information about the dump is displayed including the date and time the dump was taken and the job name and system ID.

 image2022-10-10_16-45-50.png

INSTRUCT

Command Type: Primary

The INSTRUCT command shows or hides the instructional text on all screens in the current session. For information about setting the INSTRUCT default value for all sessions, see User-Profile-screen.

 image2022-10-10_16-46-8.png

INTFLOAT

Command Type: Fast Path

Screen Displayed: Interpreted Floating Point Registers screen. This screen displays the content of the 16 floating point registers, along with the value they represent.

 image2022-10-10_16-48-13.png

IPCS

Command Type: Fast Path

Screen Displayed: IPCS Command Facility. This screen lets you enter IPCS commands.

This facility is available only for SVC dumps, when the optional IPCS support has been enabled. In addition, when executing on an MVS/ESA system, the facility is only available for MVS/ESA system dumps and when running on an MVS/XA system the facility is only available for non-blocked MVS/XA system dumps.

 image2022-10-10_16-48-33.png

ITRACE

Command Type: Primary

This command is used to format the internal trace entries used by the product to capture internal information.

 image2022-10-10_16-48-54.png

JES

Command Type: Fast Path

Restrictions: Valid only for batch dumps running with JES2 1.9 and z/OS 1.9 or more current.

Screen Displayed: JES2 Submitted JCL. This screen displays the job JCL images as they were submitted. The maximum number of lines displayed is controlled by an Abend-AID global option set at installation customization. The default is 800 lines. The syntax for the JES command is:

 image2022-10-10_16-49-24.png

JPASUMM

Command Type: Fast Path

Restrictions: Valid only for SVC dumps.

Screen Displayed: Job Pack Area Summary. This screen displays the Job Pack Area Summary for the current address space. All of the load modules loaded into private area storage are displayed on this screen, with further detailed information available from this screen. The syntax for the JPASUMM command is:

 image2022-10-10_16-49-44.png

KEYS

Command Type: Fast Path

Screen Displayed: PF Key Definitions - Primary. This screen is used to modify PF key definitions and labels.

 image2022-10-10_16-50-15.png

LECB

Command Type: Fast Path

Restrictions: Valid only for batch dumps that contain LE information.

Screen Displayed: LE Control Blocks Selection List menu. You can access information for the following anchor blocks from this menu:

•Common anchor area

•Enclave data block

•Process control block

•Region control block

•Condition information block

•Machine state block

 image2022-10-10_16-50-36.png

LEFT

Command Type: Primary

The LEFT command scrolls the active screen display toward the first column of a scrollable list of entries. Pressing the LEFT PF key also executes this command. (PF10 is the default.)

 image2022-10-10_16-51-3.png

scrollamount

The number of columns the active screen display should be scrolled toward the first column of a scrollable list of entries.

Example:

LEFT 12

This example scrolls the active screen display 12 columns toward the first column of a scrollable list of entries.

LEHEAP

Command Type: Fast Path

Restrictions: Valid only for batch dumps that contain LE information.

Screen Displayed: LE Heap Summary.

image2022-10-10_16-51-32.png

LEINFO

Command Type: Fast Path

Restrictions: Valid only for batch dumps that contain LE information.

Screen Displayed: LE Information menu. You can access the following screens from this menu:

•LE Run Time Options

•LE Heap Summary

•LE Control Blocks

•LE Summary

 image2022-10-10_16-51-57.png

LEOCB

Command Type: Fast Path

Restrictions: Valid only for batch dumps that contain LE information.

Screen Displayed: LE Options Control Block.

 image2022-10-10_16-52-18.png

LIBRARY

Command Type: Fast Path

Restrictions: Valid only for batch dumps.

Screen Displayed: JOBLIB or STEBLIB Concatenation.

 image2022-10-10_16-52-50.png

LINECMDS

Command Type: Primary

The LINECMDS command shows or hides the line commands for all screens in the current session. For information about setting the LINECMDS default value for all sessions, see User Profile screen.

 image2022-10-10_16-53-13.png

LIST

Command Type: Fast Path

Screen Displayed: Print Options and Initiation. This command is used to update the print output options and to process the print data set.

 image2022-10-10_16-53-41.png

LMODINFO

Command Type: Primary

The LMODINFO command displays the load module name, release level, and service level information for the specified load module. Look for message RC1977 in the FDBDLOG.

 image2022-10-10_17-3-43.png

LOG

Command Type: Fast Path

Screen Displayed: Problem Log Entries for the current dump. This command is available only with the Abend-AID ISPF viewing access method.

 image2022-10-10_17-4-7.png

LOGSPOOL

Command Type: Primary

The LOGSPOOL command closes and re-opens the FDBDLOG SYSOUT data set. This allows the data set to be saved or printed, reducing the amount of system spool space used by the server.

 image2022-10-10_17-4-27.png

LPAMAP

Command Type: Fast Path

Restrictions: Valid only for SVC dumps.

Screen Displayed: Link Pack Areas Map. This screen lists the modules in the system PLPA, MLPA, and FLPA.

 image2022-10-10_17-4-51.png

LPRINT

Command Type: Primary

The LPRINT command prints a logical image of a screen to a sequential data set. Pressing the LPRINT PF key also executes this command. (PF23 is the default). A logical image includes all data associated with a screen, regardless of how much is currently displayed (contrasted to a physical image, which includes only the data currently displayed). A physical print is accomplished using the PRINT command.

When used without an optional parameter, LPRINT prints a logical image of the screen currently displayed. When used with an optional parameter, LPRINT prints a logical image of the screen specified by the parameter. Certain exceptions apply. A physical image of a screen is always printed, even if a logical print is requested, when the screen to be printed is one of the following:

•A non-scrollable screen

•A memory display screen

•A storage disassembly screen.

These exceptions apply both to currently displayed screens and to those specified by a parameter.

Screens printed using the LPRINT command are written to a data set governed by the Print Options and Initiation screen. You may access this screen using the LIST fast-path command. The Print Options and Initiation screen controls various print options including the disposition of the data set. Printing is initiated using the GO command or by logging off. You must use this screen to print any data sets created using the LPRINT command. For more information about displaying print output options or the Print Options and Initiation screen, see Print Options and Initiation screen.

For more information about using the LPRINT command, see Printing Abend-AID Viewer Information.

 image2022-10-10_17-5-25.png

fastpathcommand

The fast-path command of the screen to be printed.

#ALL

Valid for batch entries only. Prints a complete batch report. See Complete Batch Abend Report for a description of what is contained in this report.

#D2ALL

Valid for batch entries only. Prints a complete batch report, including Db2 information if available. See Complete Db2 Batch Abend Report  for a description of what is contained in this report.

#SUMMARY

Prints a summary report. See Batch Abend Summary Report  and SVC Dump Summary Report  for a description of what is contained in a summary report, by entry type.

#D2SUMM

Valid for batch entries only. Prints a summary report, including the Db2 information if available. See Db2 Batch Abend Summary Report.

$controlblockname

Prints the DSECT format of the named control block. Only DSECTS of single element control blocks (CSA or CSAOPFL, for example) can be printed this way. For other types of control blocks (FCT, for example), you must first display the control block’s DSECT screen and then use the LPRINT command. See Control Blocks and Storage for additional information about control blocks.

@symbolname ’storage comment’

Prints the hexadecimal storage associated with the named symbol. The symbol name is required but the storage comment (limited to 66 characters) is optional and, if specified, must be surrounded by single quotation marks. See Symbols list for a list of valid symbols.

@address.length ’storage comment’

Prints the hexadecimal storage at the given address for the given length. The address is required and must be in hexadecimal notation. The default length is 4096 and the maximum length allowed is 1,048,576 (1 megabyte). The storage comment (limited to 66 characters) is optional and, if specified, must be surrounded by single quotation marks.

LSQASP

Command Type: Fast Path

Restrictions: Valid only for SVC dumps.

Screen Displayed: Summarized LSQA Subpools. This screen lists a summary of storage allocated to the LSQA subpools at the time of the fault.

 image2022-10-10_17-5-45.png

LSQASUM

Command Type: Fast Path

Restrictions: Valid only for SVC dumps.

Screen Displayed: LSQA Summary. This screen lists the LSQA AQAT Index addresses and DFE chains at the time of the fault.

 image2022-10-10_17-6-44.png

MAINMENU

Command Type: Fast Path

Screen Displayed: Causes an immediate return to the Report Menu.

 image2022-10-10_17-7-26.png

MAINTAA

Command Type: Fast Path

Restrictions: Valid only within the Site Customization facility.

Screen Displayed: Add/Maintain Site News screen. This screen lets you add site-specific text to the Product News facility for Abend-AID.

 image2022-10-10_17-7-1.png

MAPD

Command Type: Primary

The MAPD command maps storage into DSECT format. Typing the command without any parameters, positioning the cursor on a hexadecimal address, and pressing Enter displays the System DSECT Table, which lists the DSECTs available for the selected dump.

 image2022-10-10_17-7-51.png

firstdsect

The first DSECT in a DSECT member. The literal O= (“origin equals”) must precede the name of the first DSECT. MAPD automatically includes the first DSECT by default if you include neither the first DSECT, nor a DSECT label parameter in the command.

label

First 30 bytes of the DSECT statement’s Name field. The literal O= must precede the name of the DSECT. Use the label parameter to view DSECTs other than the first DSECT in a DSECT member.

address

Maps storage at the hexadecimal address specified. You cannot include this parameter in a MAPD command that uses the tabletype and tableentry parameters.

symbolname

Maps storage at the symbol name specified. The literal S/ must precede the symbol name. You cannot include this parameter in a MAPD command that uses the tabletype and tableentry parameters.

dsecttype

DSECT type. If you do not specify a DSECT type, Abend-AID automatically displays the System DSECT Table, which lists the DSECT types available for the current dump.

To select one from those listed, position the cursor on the desired DSECT type and press Enter. Use the UP and DOWN PF keys to scroll the list. (PF7 and PF8 are the defaults.) After you select the DSECT type, the applicable DSECT screen automatically appears.

USER

This literal specifies that the storage is mapped against a user-defined DSECT type. For information about defining your own DSECTs, refer to the Abend-AID Advanced Configuration space .

Example 1:

MAPD

Example 1 displays the System DSECT Table, which lists the DSECTs available for the currently selected dump.

Example 2:

MAPD 0045FD34 FCTE

Example 2 maps the storage associated with hexadecimal address 0045FD34 into the FCT entry DSECT format.

Example 3:

MAPD S/TCA0009 UTCA

Example 3 maps the storage associated with symbol TCA0009 into the user TCA DSECT format.

Example 4:

MAPD 007D0010 MYDSECT USER

Example 4 maps the storage associated with hexadecimal address 007D0010 into the user-defined DSECT specified by the first DSECT in member MYDSECT.

Example 5:

MAPD O=YOURDSECT 007D00B0 MYDSECT USER

Example 5 maps the storage associated with hexadecimal address 007D00B0 into the user-defined DSECT specified by starting label YOURDSECT in member MYDSECT.

MLOG

Command Type: Fast Path

Restrictions: Valid only for SVC dumps.

Screen Displayed: Dump Analysis Message Log for the currently selected dump. This screen lists the messages generated during dump import and analysis.

 image2022-10-10_17-8-23.png

MLVL

Command Type: Fast Path

Restrictions: Valid only for batch dumps.

Screen Displayed: Abend-AID  Module List, which shows the release and maintenance level of all Abend-AID modules loaded at dump capture.

 image2022-10-10_17-8-45.png

MM

Command Type: Fast Path

Screen Displayed: Returns immediately return to the Report Menu. This command acts as an alias for the MAINMENU command.

 image2022-10-10_17-9-8.png

MODE

Command Type: Primary

The MODE command sets the Memory Display navigation mode to either 31-bit or 64-bit for the current session.

 image2022-10-10_17-9-28.png

MODS

Command Type: Fast Path

Restrictions: Valid only for batch dumps.

Screen Displayed: Load/PDSE Object Modules screen. This screen displays the attributes of the load and PDSE object modules listed in the Call Trace section.

 image2022-10-10_17-10-1.png

MQINFO

Command Type: Fast Path

Restrictions: Valid only for batch dumps that contain WebSphere MQ information. You must be licensed for the Abend-AID for WebSphere MQ option to use this command.

Screen Displayed: Websphere MQ Information. This screen provides information about WebSphere MQ relating to the abending program.

 image2022-10-10_17-10-30.png

MSGHELP

Command Type: Primary

The MSGHELP command displays the help text associated with a specific Abend-AID system message number.

Note

Use the HELP command to display help text for screens, fields, commands, and currently displayed system messages. For specifics, see HELP.

image2022-10-10_23-27-31.png

messageID

The number associated with the system message entered minus the first 3 characters, and the last character. For example, the messageID for message number ERWSI0052E is SI0052. To display help text for the currently displayed message, you can also type HELP, move the cursor to the displayed message, and press Enter.

Example:

This example displays the help text associated with system message ERWSI0052E.

MSGHELP SI0052

MSGS

Command Type: Primary

The MSGS command toggles the message parameter value to display (ON) or suppress (OFF) messages in the server FDBDLOG. When no action is specified, the current MESSAGES parameter value is displayed in the FDBDLOG.


 image2022-10-10_23-28-10.png

MVSENV

Command Type: Fast Path

Restrictions: Valid only for SVC dumps.

Screen Displayed: MVS Environment Summary. This screen provides general information about the address space job and the MVS environment under which it was executing.

 image2022-10-10_23-28-36.png

MVSINFO

Command Type: Fast Path

Restrictions: Valid only for SVC dumps.

Screen Displayed: MVS Information menu. This menu provides access to the following screens:

•MVS Environment Summary

•MVS TCB Summary

•JES2 System Log

•MVS Storage Analysis

•Job Pack Area Summary

•TCB Load List Summary

•LE Information

 image2022-10-10_23-30-4.png

MVSSTG

Command Type: Fast Path

Restrictions: Valid only for SVC dumps.

Screen Displayed: MVS Storage Analysis menu. This menu provides access to the following screens:

•Virtual Storage Map

•Private Area Summary

•Allocated Private Subpools

•LSQA Summary

•Summarized LSQA Subpools

•Allocated Storage Map

•SQA Summary

•Summarized SQA Subpools

•Common Service Area Summary

•Summarized CSA Subpools

•Link Pack Areas Map

•Nucleus Map

•Memory Objects

•Data Spaces

 image2022-10-10_23-30-20.png

NEWS

Command Type: Primary

The NEWS command displays a pop-up window with a summary of changes for the current and recent Abend-AID release. The first time you log onto Abend-AID, the NEWS pop-up window is automatically displayed. Thereafter, enter the command on the Command line of any Abend-AID  Viewer screen to display the summary of changes at any time.

 image2022-10-10_23-30-36.png

NEWSAA

Command Type: Fast Path

Restrictions: Valid only within the Site Customization facility.

Screen Displayed: Add/Maintain Site News for Abend-AID.

Access this screen from the Site News Menu or as a fast-path command from any Customization screen. With NEWSAA, you can add or maintain site news information relating to Abend-AID. To delete site news information relating to Abend-AID, you must use the DELETEAA command as described in DELETEAA

 image2022-10-10_23-31-39.png

NOTE

Command Type: Primary

Restrictions: This command is available only with the Abend-AID ISPF viewing access method.

The NOTE command lets you enter notes into the problem log for the current dump using ISPF EDIT facilities. All commands function as in ISPF.

 image2022-10-10_23-31-56.png

NOTIFY

Command Type: Fast Path

Restrictions: Valid only in the customization facility.

Screen Displayed: Action Definition menu. This menu provides access to the following screens:

•Create Job Cards for Action Definitions (valid for CICS transaction and region dumps only)

•Transaction Dump Action Definitions (valid for CICS transaction dumps only)

•Region Dump Action Definitions (valid for CICS region dumps only)

•Batch Dump Contact Information Definitions (valid for batch dumps only)

image2022-10-10_23-32-15.png

NUCMAP

Command Type: Fast Path

Restrictions: Valid only for SVC dumps.

Screen Displayed: Nucleus Map. This screen lists the modules in the system nucleus.

 image2022-10-10_23-32-30.png

@offset

Command Type: Primary

Valid on the Memory Display screen only. The @offset command positions the display at the fullword address at the hexadecimal offset.

 image2022-10-10_23-32-53.png

offset

Hexadecimal offset number

-offset

Command Type: Primary

Valid on the Memory Display and Storage Disassembly screens only. The -offset command scrolls the display backward the specified hexadecimal offset. Use the RESET primary command to reset the display to offset zero. See RESET for additional information.

 image2022-10-10_23-33-22.png

offset

Hexadecimal offset number

#offset

Command Type: Primary

Valid on the Memory Display screen only. The #offset command scrolls the Memory Display forward to the specified offset relative to the start address.

 image2022-10-10_23-33-41.png

offset

Hexadecimal offset number

+offset

Command Type: Primary

Valid on the Memory Display and Storage Disassembly screens only. The +offset command scrolls the display forward the specified hexadecimal offset. Use the RESET primary command to reset the display to offset zero. See RESET for additional information.

 image2022-10-10_23-33-58.png

offset

Hexadecimal offset number

PARM

Command Type: Fast Path

Screen Displayed: PSW Information Screen with the parameter data displayed at the bottom if present in the dump.

 image2022-10-10_23-34-14.png

PCLP

Command Type: Fast Path

Screen Displayed: Current Paperclip Table. This screen lists the 389 most recently accessed memory locations on the Memory Display screen.

 image2022-10-10_23-34-30.png

PFKEYS

Command Type: Fast Path

Screen Displayed: Site PF Keys - Primary. This screen is used to set site defaults for PF key options.

 image2022-10-10_23-34-47.png

PRINT

Command Type: Primary

The PRINT command prints a physical image of a screen to a sequential data set. A physical image includes only the data currently displayed (contrasted to a logical image, which includes all data associated with a screen). A logical print is accomplished using the LPRINT command.

When used without an optional parameter, PRINT prints a physical image of the screen currently displayed. When used with an optional parameter, PRINT prints a logical image of the screen specified by the parameter. Certain exceptions apply. A physical image of a screen is always printed, even if a logical print is requested, when the screen to be printed is one of the following:

•A non-scrollable screen

•A memory display screen

•A storage disassembly screen.

These exceptions apply both to currently displayed screens and to those specified by a parameter.

Screens printed using the PRINT command are written to a data set governed by the Print Options and Initiation screen. You may access this screen using the LIST fast-path command. The Print Options and Initiation screen controls various print options including the disposition of the data set. Printing is initiated using the GO command or by logging off. You must use this screen to print any data sets created using the PRINT command. For more information about displaying print output options or the Print Options and Initiation screen, see  Print Options and Initiation Screen.

For more information about using the PRINT command, see Printing Abend-AID Viewer Information.

 image2022-10-10_23-35-5.png

fastpathcommand

The fast-path command of the screen to be printed.

#ALL

Valid for batch entries only. Prints a complete batch report. See Complete Batch Abend Report for a description of what is contained in this report.

#D2ALL

Valid for batch entries only. Prints a complete batch report, including Db2 information if available. See Complete Db2 Batch Abend Report  for a description of what is contained in this report.

#SUMMARY

Prints a summary report. See Batch Abend Summary Report  and  SVC Dump Summary Report  for a description of what is contained in a summary report, by entry type.

#D2SUMM

Valid for batch entries only. Prints a summary report, including the Db2 information if available. See Db2 Batch Abend Summary Report.

$controlblockname

Prints the DSECT format of the named control block. Only DSECTS of single element control blocks (CSA or CSAOPFL, for example) can be printed this way. For other types of control blocks (FCT, for example), you must first display the control block’s DSECT screen and then use the LPRINT command. See Accessing-Storage-Information for additional information about control blocks.

@symbolname ’storage comment’

Prints the hexadecimal storage associated with the named symbol. The symbol name is required but the storage comment is optional (limited to 66 characters) and, if specified, must be surrounded by single quotation marks. See Symbols list for a list of valid symbols. To display storage for other types of control blocks, you must supply the storage address and length of the control block (see next parameter).

@address.length ’storage comment’

Prints the hexadecimal storage at the given address for the given length. The address is required and must be in hexadecimal notation. The default length is 4096 and the maximum length allowed is 1,048,576 (1 megabyte). The storage comment is optional (limited to 66 characters) and, if specified, must be surrounded by single quotation marks.

PROFILE

Command Type: Fast Path

Screen Displayed: User Profile. This screen is used to modify user profile options.

 image2022-10-10_23-35-34.png

PROG

Command Type: Fast Path

Restrictions: Valid only for batch dumps.

Screen Displayed: Program Summary Information screen.

 image2022-10-10_23-35-56.png

PRTOPTS

Command Type: Fast Path

Restrictions: Valid only in the customization facility

Screen Displayed: Site Print Options. This screen is used to set site defaults for print options.

 image2022-10-10_23-36-13.png

PSA

Command Type: Fast Path

Restrictions: Valid only for SVC dumps.

Screen Displayed: Prefixed Save Area.

 image2022-10-10_23-36-37.png

PSW

Command Type: Fast Path

Restrictions: Valid only for batch dumps.

Screen Displayed: PSW Information screen. This screen displays an interpretation of the application's program status word (PSW) at the time of the abend.

 image2022-10-10_23-37-12.png

PVTSP

Command Type: Fast Path

Restrictions: Valid only for SVC dumps.

Screen Displayed: Allocated Private Subpools. This screen lists the private area subpools allocated at the time of the fault.

 image2022-10-10_23-37-30.png

PVTSUM

Command Type: Fast Path

Restrictions: Valid only for SVC dumps.

Screen Displayed: Private Area Summary. This screen lists the private area allocations of the current ASID at the time of the fault.

 image2022-10-10_23-43-28.png

REGIONS

Command Type: Fast Path

Restrictions: Valid only in customization.

Screen Displayed: Region Configuration. This screen is used to create and maintain region configuration entries.

 image2022-10-10_23-43-52.png

REGS

Command Type: Fast Path

Restrictions: Valid only for batch dumps.

Screen Displayed: Registers. This screen display the values of the registers and their storage locations at the time of the dump.

 image2022-10-11_0-18-31.png

REMOTE

Command Type: Fast Path

Restrictions: Valid only for batch dumps and CICS transaction dumps.

Screen Displayed: List of Remote Source Files. This screen displays the user-defined remote source data sets.

 image2022-10-11_0-15-55.png

RESET

Command Type: Primary

Restrictions: Valid only on the Memory Display and Storage Disassembly screens, on any screen that supports masking and sorting, and on any screen that supports the ARRANGE command.

On the Memory Display and Storage Disassembly screens, enter the RESET command without a parameter to reset the display to offset zero. On screens that support masking and sorting, you can enter this command without a parameter to reset both masking and sorting, or specify the parameter to reset only one or the other. On screens that support the ARRANGE command, enter RESET on the command line in the Arrange Column Order pop-up window to reset the screen columns to the defaults.

 image2022-10-11_0-19-1.png

MASK

Resets the column mask only.

SORT

Resets the column sort only.

RESETDAE

Command Type: Primary

Upon execution, the RESETDAE command increments by one the Dump Analysis and Elimination (DAE) sequence number when an internal server dump is taken. Updating the DAE sequence number ensures that the next dump will not be suppressed by the operating system’s DAE facility. This command is available for use with the Abend-AID viewing server.

Normally BMC Support asks you to execute this command to obtain an SVC dump to help resolve a problem when the prior SVC dump is no longer available and DAE is suppressing duplicate SVC dumps.

 image2022-10-11_0-19-39.png

RESTORE

Command Type: Primary

The RESTORE command restores a saved paperclip table from the Saved Paperclip List. Once restored, the table becomes the current paperclip table. For information about the paperclip list, see Saved Paperclip List.

 image2022-10-11_0-19-58.png

tablename

One- to eight-character name of the paperclip table.

Example:

RESTORE PFHTBL12

This example restores paperclip table PFHTBL12 from the Saved Paperclip List.

RETRIEVE

Command Type: Primary

The RETRIEVE command displays the most recently entered commands on the command line, one command at a time, in the reverse sequence in which they were entered (last-in, first-out). This command allows you to easily recall a command for resubmission from the command line. You can edit the command before entering it. Pressing the RETRIEVE PF key also executes this command. (PF12 is the default.)

 image2022-10-11_0-20-17.png

RETURN

Command Type: Primary

The RETURN command causes an immediate return to the Abend-AID Report Menu. Pressing the RETURN PF keys also executes this command. (PF4/PF16 are the defaults.)

 image2022-10-11_0-20-39.png

REXX

Command Type: Primary

The REXX command processes REXX EXECs for selected Abend-AID batch or SVC dumps.

 image2022-10-11_0-20-59.png

execname

One- to eight-character member name of the REXX EXEC from a data set allocated to the viewing server’s SYSEXEC DD statement during Abend-AID installation.

data

Optional parameter that specifies the data to be passed to the EXEC.

Example:

REXX CHECK CSA

This example processes the EXEC named CHECK, which uses the string ’CSA’ as input.

RFIND

Command Type: Primary

The RFIND command repeats the previously issued FIND command. Pressing the RFIND PF key also executes this command. (PF5 is the default.)

 image2022-10-11_0-21-36.png

RIGHT

Command Type: Primary

The RIGHT command scrolls the active screen display toward the last column of a scrollable list of entries. Pressing the RIGHT PF key also executes this command. (PF11 is the default.)

 image2022-10-11_0-21-54.png

scrollamount

The number of columns the active screen display should be scrolled toward the last column of a scrollable list of entries.

Example:

RIGHT 12

This example scrolls the active screen display 12 columns toward the last column of a scrollable list of entries.

SACLIP

Command Type: Fast Path

Screen Displayed: Saved Paperclip List. This command displays a list of paperclip tables that have been saved for the current dump. From the Saved Paperclip List, paperclip tables can be either restored or deleted.

 image2022-10-11_0-22-20.png

Use the SAVE command to save the current paperclip table in the saved paperclip list. If you do not use the SAVE command, the current paperclip table is saved automatically using your user ID as the name of the saved table.

SAVE

Command Type: Primary

The SAVE command saves the current paperclip table to the Saved Paperclip List. For information about the paperclip list, see Saved Paperclip List.

 image2022-10-11_0-22-41.png

tablename

One- to eight-character name of the paperclip table. If the current paperclip table has been previously restored, you can type the SAVE command without specifying a table name. The Abend-AID  Viewer will save the table to the same name from which it was restored. However, if the current paperclip table has not been previously restored and you type the SAVE command without a table name, the command saves the paperclip table under your user ID.

Example:

SAVE PFHTBL12

This example saves the current paperclip table as PFHTBL12 on the Saved Paperclip List.

SCRATTR

Command Type: Fast Path

Restrictions: Valid only in the customization facility

Screen Displayed: Site Screen Attributes. This screen is used to set site defaults for screen attributes.

 image2022-10-11_0-23-12.png

SD

Command Type: Fast Path

Screen Displayed: Source Directory. This command displays the list of source files that you have added and, if a batch dump is selected, displays the list of source files allocated to the viewing server at the time of the dump. This command acts as an alias for the SRCDIR command.

 image2022-10-11_0-23-29.png

SDPLIST

Command Type: Fast Path

Restrictions: Valid only for SVC dumps.

Screen Displayed: SVC Dump Parameter List for the currently selected dump.

 image2022-10-11_0-23-48.png

SERVINFO

Command Type: Fast Path

Screen Displayed: Server Information. This screen lists users currently logged on to the server. Press Enter at the RELEASE field to display the Service Information screen, which lists the active applications and their release levels.

 image2022-10-11_0-24-6.png

SHOWCOPY

Command Type: Primary

Restrictions: Valid only for reports when source support is used and the source listing has been processed using the COBOL, PL/I, or Assembler language preprocessor.

The SHOWCOPY command provides support for COBOL COPY SUPPRESS, PL/I %NOPRINT, and Assembler lines suppressed by, for example, the PRINT OFF or PRINT NOGEN options. The default setting for this command returns suppressed lines to the report in the Abend-AID Viewer. Users can view the suppressed information on the Diagnostic Summary in the Abending Statement, Next Sequential Instruction, and Last Call sections, among others. Users can continue to suppress the lines by issuing the new SHOWCOPY OFF command.

 image2022-10-11_0-24-29.png

ON

Displays the suppressed lines on all applicable screens in the current session (default).

OFF

Suppresses the lines on all applicable screens in the current session.

SHUTDOWN

Command Type: Primary

The SHUTDOWN command terminates the current server.

 image2022-10-11_0-24-53.png

nnnn

Is the number of seconds the region should allow for the current user and transaction load to be closed down (shutdown timer value). The default value is 30 seconds.

IMMED

Indicates that the server is to terminate immediately.

SITENEWS

Command Type: Fast Path

Restrictions: Valid only within the Site Customization facility.

Screen Displayed: Site News Menu. This menu lets you select the options for creating and maintaining site news for Abend-AID and Abend-AID for CICS.

 image2022-10-11_0-25-17.png

SMAP

Command Type: Fast Path

Restrictions: Valid only for SVC dumps.

Screen Displayed: Storage Map Display (storage allocation map for the current dump). The storage map displays alternatively allocated and unallocated segments of storage.

 image2022-10-11_0-25-51.png

SORTA

Command Type: Primary

The SORTA command reorganizes a screen’s scrollable data according to the column specified in the column-identifier parameter in ascending order. If you do not specify a parameter, Abend-AID displays a window from which you can select a valid column-identifier by pressing Enter. As an alternative, you can issue the SORTA command without a parameter by typing SORTA in the COMMAND field, positioning the cursor on the column that you want the data sorted by, and then pressing Enter.

Use the space bar or Erase EOF key to clear the column mask for individual columns. Use the RESET primary command to reset all columns to their original settings, as described in RESET.

 image2022-10-11_0-26-7.png

columnidentifier

Unique identifier of the column heading.

SORTD

Command Type: Primary

The SORTD command reorganizes a screen’s scrollable data according to the column specified in the column-identifier parameter in descending order. If you do not specify a parameter, Abend-AID displays a window from which you can select a valid column-identifier by pressing Enter. As an alternative, you can issue the SORTD command without a parameter by typing SORTD in the COMMAND field, positioning the cursor on the column that you want the data sorted by, and then pressing Enter.

Use the space bar or Erase EOF key to clear the column mask for individual columns. Use the RESET primary command to reset all columns to their original settings, as described in RESET.

image2022-10-11_0-26-34.png 

columnidentifier

Unique identifier of the column heading.

SOURCE

Command Type: Primary

For batch abends only. The SOURCE command lets you toggle on and off the display of source processing for Abend-AID batch abends. The command affects only the currently selected batch abend. If the program for the selected abend was not compiled using the COBOL language processor or the PL/I language processor, the SOURCE command has no effect.

 image2022-10-11_0-26-55.png

ON

Displays source processing for the batch abend.

OFF

Suppresses source processing for the batch abend.

RESET

Returns source processing for the batch abend to its original setting before the entry of the SOURCE command.

SQASP

Command Type: Fast Path

Restrictions: Valid only for SVC dumps.

Screen Displayed: Summarized SQA Subpools. This screen lists the system queue area subpools allocated at the time of the fault.

 image2022-10-11_0-27-21.png

SQASUM

Command Type: Fast Path

Restrictions: Valid only for SVC dumps.

Screen Displayed: SQA Summary, which lists the system queue area information obtained from the Global Data Area (GDA) at the time of the fault.

 image2022-10-11_0-27-50.png

SRCDIR

Command Type: Fast Path

Screen Displayed: Source Directory. This command displays the list of source files that you have added and, if a batch dump is selected, displays the list of source files allocated to the viewing server at the time of the dump.

 image2022-10-11_0-28-7.png

STORAGE

Command Type: Fast Path

Restrictions: Valid only for SVC dumps.

Screen Displayed: Control Blocks/Storage menu. This menu provides a selectable list of control blocks that can be displayed in hexadecimal, DSECT, or interpreted format. It also provides access to the current paperclip table and the saved paperclip list.

 image2022-10-11_0-28-25.png

SUBS

Command Type: Fast Path

Restrictions: Valid only for SVC dumps.

Screen Displayed: MVS Sub Systems Summary. This screen displays the list of MVS subsystems located in the currently selected dump.

 image2022-10-11_0-28-41.png

SUMMARY

Command Type: Fast Path

Screen Displayed: Abend-AID Fault Summary. This screen provides summary information for all dumps available to this server.

 image2022-10-11_0-28-59.png

SUPPORT

Command Type: Fast Path

Screen Displayed: COBOL Supporting Data. This screen provides BLx cell information for the specified for the specified COBOL program at the time the dump was taken.

 image2022-10-11_0-29-23.png

programname

The name of a COBOL program in the dump. If you do not include the program name as an operand for the SUPPORT command, COBOL supporting data for the abending program is displayed.

Example:

SUPPORT PAYTEST1

SYSLOG

Command Type: Fast Path

Restrictions: Valid only for SVC dumps.

Screen Displayed: JES2 System Log. This screen displays the messages from the last two JES2 system log buffers for the selected dump address space.

 image2022-10-11_0-29-50.png

TCBJST

Command Type: Fast Path

Restrictions: Valid only for SVC dumps.

Screen Displayed: Task Control Block. This screen displays Task Control Block information for the currently selected address space.

 image2022-10-11_0-30-10.png

TCBLLE

Command Type: Fast Path

Restrictions: Valid only for SVC dumps.

Screen Displayed: TCB Load List Summary. This screen displays summary information for all tasks (TCBs) in the current address space. All of the load modules loaded by tasks are displayed on this screen, with further detailed information available from this screen. For modules loaded by a specific task, either mask the TCB Address column or use an available line command on the TCB Summary screen.

 image2022-10-11_0-30-27.png

TCBS

Command Type: Fast Path

Restrictions: Valid only for SVC dumps.

Screen Displayed: TCB Summary. This screen lists all task control blocks (TCBs) in the abending job and all request blocks (RBs) for each TCB.

 image2022-10-11_0-30-47.png

TESTSCR

Command Type: Fast Path

Screen Displayed: Attribute Test Screen. This screen displays a sample screen containing examples of the screen attributes that Abend-AID uses. After you change your screen attributes using the ATTRBUTE command, entering TESTSCR displays your new screen attributes.

 image2022-10-11_0-31-4.png

TGT

Command Type: Fast Path

Restrictions: Valid only for batch dumps for COBOL programs.

Screen Displayed: Task Global Table (TGT) storage associated with the selected COBOL program in hexadecimal format.

 image2022-10-11_0-31-25.png

programname

The name of a COBOL program in the dump. If you do not include the program name as an operand for the TGT command, the TGT for the abending program is displayed.

Example:

TGT PAYTEST1

TOP

Command Type: Primary

The TOP command scrolls to the top of a screen’s scrollable area.

 image2022-10-11_0-31-49.png

UNSTCK

Command Type: Primary

The UNSTCK command interprets the store clock date and time at a user-specified address.

Note

On Memory Display data fields only (for example, Word1), the UNSTCK command interprets the data displayed in the field. To use this command, type UNSTCK in the Memory Display’s COMMAND field, position the cursor on the first byte of either the address or the data to convert, and press Enter.

image2022-10-11_0-32-27.png 

address

A valid hexadecimal address.

Example:

UNSTCK 59ADC00

UP

Command Type: Primary

The UP command scrolls the active screen display toward the top of a scrollable list of entries. Pressing the UP PF key also executes this command. (PF7 is the default.)

 image2022-10-11_0-32-51.png

scroll-amount

The number of rows the active screen display should be scrolled toward the top of a scrollable list of entries.

Example:

UP 12

This example scrolls the active screen display 12 rows toward the top of a scrollable list of entries.

USER

Command Type: Fast Path

Screen Displayed: User Controls menu. This menu provides access to the following screens:

•User Profile

•Print Output Options

•Screen Attributes

•PF Key Customization

•Site Customization Options

 image2022-10-11_0-33-14.png

USERDIAG

Command Type: Fast Path

Restrictions: Valid only within the Site Customization facility.

Screen Displayed: User-Defined Diagnostics screen. This screen lets you create and maintain site-specific diagnostics for user-defined abend codes.

 image2022-10-11_0-33-35.png

USERPROF

Command Type: Fast Path

Screen Displayed: Site User Profile. This screen is used to set site defaults for user profile options.

 image2022-10-11_0-33-55.png

VSMAP

Command Type: Fast Path

Restrictions: Valid only for SVC dumps.

Screen Displayed: Virtual Storage Map. This screen lists all virtual storage areas of the MVS operating system from which the address space was dumped.

 image2022-10-11_0-34-16.png

ZOSSDMP

Command Type: Fast Path

Restrictions: Valid only for SVC dumps.

Screen Displayed: z/OS SVC Dump Analysis menu. This menu provides access to the following screens:

•SVC Diagnostic Summary

•Dump Header Record

•Prefixed Save Area

•Communications Vector Table

•MVS Sub Systems Summary

•Address Space Control Block

•Address Space Extension Block

•Address Space Summary

•SVC Dump Parameter List

This command is available on the Report Menu for SVC dumps.

 image2022-10-11_0-34-34.png


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*