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.

Screen layout

All Abend-AID for CICS screens have the same basic format. As shown in the following figure, a title line, a command line, and a message line comprise the first three lines.

Note

Menu screens list an OPTION field on the command line; data screens list a COMMAND field.


Abend-AID ------------------ No Source Selected ---------------------------------------  
  COMMAND ===>                                                                                                                      
  MSDSD5500I No suitable BMC source listing was found for this program  
  There is no BMC Source Listing available to provide source support for this program  
  name. For source support select one of the options below.
                                                                                                                                   
  Program Information                                                                                                               
     Program Name................ PLTTEST
     Compile Date................ 10FEB2006                                                                                         
     Compile Time................
     Program Language............ HL ASSEM
     Language Release............                                                                                              
     Load Library................ BMC.TEST.LOAD
                                                                                                                                   
  Select one of the following options to create a BMC Source listing:                                                               
     To have Abend-AID convert an existing compiler listing, select CONVERT                                                         
     To use site customized utilities (ISPF only), select UTILITIES                                                                 
                                                                                                                                   
  To add another DDIO file to Abend-AID, select ADD DDIO                                                                            
  To continue without source-level support, select NO SOURCE                                                                        
  To look for a DDIO listing of this program, select LISTALL                                                                        

Following the message line is the presentation area, which consists of menu selections or data fields whose arrangement and content differ from screen to screen. In addition, Abend-AID for CICS dynamically adjusts the information that appears in the presentation area, based on your terminal size.

The last line displays the currently selected entry’s identification number, job name, abend code, and viewing server name. It also identifies the PF key for listing the commands available from the screen. Initially, this default is PF24 for the commands list.

The remainder of this section describes the following screen components:

  • Screen borders
  • Scroll information fields
  • COMMAND and OPTION fields
  • Line commands
  • Screen attribute defaults

Screen borders

Display Abend-AID for CICS screens with no borders, a partial border, or a full border. The top border is always displayed, but you can choose to display the side and/or bottom borders. The default for the border display is set in the User Profile screen’s Display screen borders field. To override this default for the current session only, type the BORDERS command with the appropriate parameters in the COMMAND (or OPTION) field on any Abend-AID for CICS screen and press Enter. For the BORDERS command’s syntax, see BORDERS. For information on setting the color of the border, see Screen Attributes or setting other defaults on the User Profile screen.

Scroll information fields

The presentation area on Abend-AID for CICS screens can contain a fixed data area, a scrollable data area, or both. As shown in the following figure, the fixed data area, if present, appears above the scrollable data area. Further, some screens contain an additional fixed data area that appears at the bottom of the screen.

image2021-1-19_16-31-34.png

You cannot change the relative position of the fields listed in a fixed data area.  In addition, the IBM terminal emulation you are using has no effect on their arrangement.

Note

You can display Abend-AID for CICS on any terminal or PC emulating either an IBM 3270 (MOD2 through MOD5), or an IBM 3290.

Scrollable data areas, in comparison, automatically expand or contract to fill the available screen space. For example, a screen emulating an IBM 3270 MOD2 terminal displays up to 24 rows of information in an 80-character format (the preceding figure), but a screen emulating a MOD5 terminal displays up to 27 rows of information in a 132-character format.

Masking and sorting

The scrollable data area includes a mask line that you can use to tailor the contents of the scrollable data area. The mask acts as a filter, and only the list entries that match each column mask value appears in the scrollable data area. To mask the data in any column, type the characters of the data you wish to display, and press Enter. The asterisk (*) character is the wildcard character.

For example, to display Kernel Task Summary information only for kernel tasks with a transaction ID beginning with the characters CS, enter CS** in the mask line in the TRAN column. To reset the column mask to all wildcard characters for an individual column, clear the column mask using the space bar or the Erase EOF key.

You can also sort the scrollable column data by each of the column headings by using the SORT primary commands. These commands rearrange the column data alphabetically or chronologically in ascending or descending order, depending on which command you use or which column you choose to sort by. New with Release 11.2, the SORTD primary command rearranges the column data alphabetically or chronologically in descending order. See SORTA or SORTD for more information.

By default, Abend-AID for CICS does not restore the mask and sort parameters from your last session on the Abend-AID Directory and the Source Program Directory.

Rearrange column headings

In addition, you can use the ARRANGE primary command to rearrange the columns on any screen that contains columns for the current session. Your new settings are saved for future use on the Fault Summary, Abend-AID Directory, File Request Summary, and Task/Wait Analysis screens. If you save the rearranged columns, the screen displays Customized View in the bottom-right.

Valid only on Abend-AID Viewer screens with left-right scrollable 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. See ARRANGE for more information.

Row field

Screens that have an up/down scrollable area include a Row field in their title line. This field lists two numbers: the row number of the first row currently displayed and the total number of rows in the scrollable area. For example, in the following figure, Row 000001 of 000024 indicates that the first row currently displayed is also the first row of 24 total rows.

image2021-1-19_16-37-53.png

Up/down scroll field

Screens that have a scrollable area also have a SCROLL field listed immediately below the Row field. To scroll through the data, press the UP and DOWN PF keys. (PF7 and PF8 are the defaults.) The number of rows scrolled depends on the SCROLL field’s listed value, such as CSR, PAGE, or MAX. To change the scroll amount, overtype the listed value with a different amount. (Abend-AID for CICS supports the same scroll amount values used in ISPF.) You also can use the UP, DOWN, TOP, and BOTTOM commands to scroll through the data. For information about the UP and DOWN commands, see Default PF Key Definitions, and for information about the TOP and BOTTOM commands, see Commands.

Left/right scroll field

Some screens have a left/right scrollable area. If so, left (<==) and right (==>) arrow symbols appear immediately below the SCROLL field. If the screen scrolls in only a left or right direction, then only the arrow indicating that direction is shown.

To scroll left or right, press the LEFT or RIGHT PF key. (PF10 and PF11 are the defaults.) The number of columns scrolled depends on the SCROLL field’s listed value. You also can use the LEFT and RIGHT commands to scroll through the data. For information about these commands, see Default PF Key Definitions.

COMMAND and OPTION fields

All data screens have a Command field on their command line, as shown in the following figure. In comparison, all menu screens have an OPTION field on their command line. Though these two fields have different names, they perform the same function of providing a location from which you can execute Abend-AID for CICS commands.

image2021-1-19_16-40-38.png

Not all commands are available from every screen, however. To display the entire command list for Abend-AID for CICS, type CMDLIST or HELP COMMANDS in the COMMAND or OPTION field, and then press Enter. For a description of primary commands, see Commands. You can also display the description for any command by typing HELP command-name and pressing Enter. For example, typing HELP MAPD displays information describing the function and syntax of the MAPD command.

Line commands

As shown in the preceding figure, some data screens also display single character line commands that you can execute against the entries listed. To execute a line command, tab the cursor to the desired line command entry field, type the character assigned to the command, and press Enter.

For general information about line commands, perform either of the following two procedures:

  • Type HELP in the Command field, position the cursor on any line command entry field, and press Enter.
  • Position the cursor on any line command entry field and press the HELP PF key. (PF1 is the default.)

For specific information about a single line command, perform one of the following procedures:

  • Type HELP in the Command field, position the cursor on the line command or its name, and press Enter.
  • Position the cursor on the line command or its name and press the HELP PF key.
  • On the general help screen for line commands, position the cursor on the desired line command and press the HELP PF key.

Screen attribute defaults

All fields and screen areas have assigned highlighting, color, and interactive defaults. Abend-AID for CICS uses these defaults to differentiate the types of information it can display. The Abend-AID for CICS default color for:

  • Non-emphasized field data is white.
  • Non-emphasized field names is turquoise.
  • User-input fields is red.
  • Tab-selectable fields is green. These are the fields that support the cursor point-and-shoot feature. See Cursor Point-and-Shoot Feature.

Note

If you have changed your default ISPF colors, those changes override the Abend-AID for CICS defaults when Abend-AID for CICS is accessed from ISPF.

You have the option to change field and screen area defaults to suit your own tastes. For specifics, see Screen-attributes.


 

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