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.

Setting User Controls

This section describes the User Controls menu, which lists the input screens that enable you to change the defaults for the following facilities:

  • User profiles
  • Print options
  • Screen attributes
  • PF key settings
  • Report Export Options

To display the User Controls menu from any Abend-AID Viewer screen, enter USER as a fast-path command. The User Controls menu is also available as a selection on the Report Menu.

 User Controls Menu

Abend-AID --------- User Controls -------------------------------
OPTION ===>

  1 PROF User Profile
  
  2 LIST Print Output Options
  
  3 ATTRBUTE Screen Attributes
  
  4 KEYS PF Key Customization
  
  5 *CUSTOM Site Customization Options
                 
                  6 EXPORT    Report Export Options    

Important

The Custom mnemonic identifier may be preceded by an asterisk (*) and displayed in a different color than the other options on the User Controls menu. This option is not available to you unless you have the appropriate access authority for the 

Abend-AID

 customization screens. These screens are documented in the Abend-AID Advanced Configuration space.

User Profile Screen

The User Profile screen allows you to modify site-defined defaults for a variety of user profile options. Modifying these options enables you to personalize how Abend-AID formats and displays data and help text. Options modified on the User Profile screen apply to the current Abend-AID session and all subsequent sessions.

Important

If you use multiple 

Abend-AID

 viewing servers, you must modify your user profile on each viewing server.

To modify a user profile, complete the following procedure:

  1. Display the User Profile screen, shown in the following figure using one of the following methods:

    • Tab to the PROFILE option on the User Controls menu, and press Enter.
    • Enter PROF as a fast-path command.
    • Enter =U.1 as a jump command.

    User Profile Screen 

    Abend-AID ---------- User Profile ------------ Row 000001 of 000018
    COMMAND ===> SCROLL ===> PAGE

    Enter profile options below. Type END (PF3) to save your changes, DEFAULTS
    to reset the values, or CANCEL to exit without saving.

    Prompt for confirmation when exiting the product................... N
    Display instructional text on screens.............................. Y
    Display line commands on screens................................... Y
    Display screen borders............................................. N
    Automatically reselect last dump viewed............................ N
    Confirm Abend-AID Directory delete requests........................ Y
    Default SDUMP dataset disposition for delete requests.............. K
    Default region dump Diagnostic Summary format...................... F
    Print dataset prefix for VTAM, CICS and Web browser access.........
    Automatically restore Abend-AID Directory sort and mask parameters. N
    Automatically restore Source Program Directory sort and mask parms. N
    Default FIND command line limit.................................... 2500
    Default national language.......................................... ENG
    Default region dump MATCH command length (1-26 bytes).............. 4
    Default Storage Navigation Mode (31 or 64 bit)..................... 31
    Fault Summary group match.......................................... J
    Logon Directory view............................................... N
    Recall migrated source listing data sets........................... N

    The User Profile screen displays a default user profile containing values supplied at installation. These values control how Abend-AID displays certain screen elements, formats data, and navigates when you enter and exit the product. If the defaults are acceptable to you, do nothing, and Abend-AID will use this profile. To customize the profile to your individual preferences, proceed to step 2.

  2. Overtype the default value of the user profile option you want to modify with the new value. Press PF1 on any field for field help.

  3. Do one of the following:

    • To save user profile options you modified, enter END (PF3) as a primary command.
    • To discard any modifications you made and return to the previous Abend-AID screen, enter CANCEL as a primary command.
    • To restore the user profile options to their defaults, enter DEFAULTS as a primary command.

    Important

    1. If, while viewing an abend, you change the value for using source for batch abends, you must reselect the current screen in order to see the change.
    2. You can modify certain user profile options temporarily using the following primary commands:
      • INSTRUCT modifies the instructional text option
      • LINECMDS modifies the line command descriptions option
      • BORDERS modifies the borders option
      • MODE modifies the storage navigation mode.

User profile options modified in this manner revert to their User Profile screen values at the beginning of the next session. See Abend-AID-Viewer-Commands for additional information about these four commands.

Print Options

The Print Options and Initiation screen, shown in the following figure allows you to modify site-defined defaults for print options and to submit print jobs. Options modified on this screen apply to the current Abend-AID session and all subsequent sessions.

See Print Options and Initiation Screen for more information about using this screen.

Print Options and Initiation 

 Abend-AID ------------ Print Options and Initiation -------------------------
COMMAND ===>

Specify print information below, then type GO to submit the print job, or
SAVE to save your changes without printing, or CANCEL to cancel your changes.

Print option........ KN PD - Print dataset and delete
D - Delete dataset without printing
KN - Keep dataset and continue with new dataset

Print Output Options:
SYSOUT Class.............. A Page Width (Characters)... 132
Destination............... LOCAL Page Length (Lines)....... 60
Print Uppercase Only...... N

Jobcard Information:
1... //JOBNAME JOB (’ACCOUNTING.INFO’),’PROGRAMMER.NAME’,
2... //    class="A",MSGCLASS=A
3... //*
4... //*
5... //*
6... //*

Screen Attributes

The Screen Attributes screen allows you to modify site-defined defaults for the color, intensity, and highlighting of various screen elements. Modifying these options enables you to personalize how Abend-AID screen attributes are displayed on your monitor. Options modified on the Screen Attributes screen apply to the current Abend-AID session and all subsequent sessions.

Important

  1. If you use multiple Abend-AID viewing servers, you must modify your screen attributes profile on each viewing server.
  2. If you changed your default ISPF colors, these specifications override the specifications you make here when Abend-AID is accessed from ISPF.

To modify screen attributes, complete the following procedure:

  1. Display the Screen Attributes screen, shown in the following figure, using one of the following methods:

    • Tab to the ATTRBUTE option on the User Controls menu, and press Enter.
    • Enter ATTRBUTE as a fast-path command.
    • Enter =U.3 as a jump command.

    Screen Attributes Screen 

     AA for CICS ----------------- Screen Attributes ----------------------------
    COMMAND ===>

    Enter color code for each screen area, intensity and extended highlighting,
    then END (PF3) to save, DEFAULTS to reset the values, or CANCEL to cancel.
    After saving, enter TESTSCR to see the effect of the changes.

    W - White  T - Turquoise   R - Red  G - Green   Y - Yellow B - Blue

    Screen Area   Color   Intensity  Highlighting
    Borders   T   N  R
    Tab-selectable Data   G   N  N
    Input Data   R   H  U
    Available Fast-path Commands on Menus   G   N  R
    Unavailable Fast-path Commands on Menus   T   N  R
    Field Descriptions, Normal   T   N  N
    Field Descriptions, Emphasized   Y   H  N
    Field Data, Normal   W   H  N
    Field Data, Emphasized   Y   H  N
    Field Data, Errors   Y   H  N
    Column Headings   W   H  R
    Group Headings, Normal   W   H  R
    Group Headings, Emphasized   Y   H  N

    The Screen Attributes screen displays default screen attribute values supplied at installation. These values control how the Abend-AID Viewer should display certain screen attributes. If the defaults are acceptable to you, do nothing, and the Abend-AID will use this profile. To customize the values to your individual preferences, proceed to step 2.

  2. Overtype the default value of the screen attribute you want to modify with the new color, intensity, or highlighting value. Press PF1 on any field for field help.
  3. Do one of the following:
    • To save screen attribute options you modified, enter END (PF3) as a primary command.
    • To discard any modifications you made and return to the previous Abend-AID screen, enter CANCEL as a primary command.
    • To restore the screen attribute options to their defaults, enter DEFAULTS as a primary command.

  4. To view screen attribute options you modified and saved, enter TESTSCR as a primary command. The Attribute Test Screen, displaying screen attributes of the color, intensity, and highlighting you selected is displayed, as shown in the following figure.

    Important

    You must save changed screen attribute options by entering the END (PF3) primary command on the Screen Attributes screen in order to view the effects of those changes on the Attribute Test Screen.

    Attribute Test Screen 

     AA for CICS ---------------- Attribute Test Screen -------
    Row 000001 of 000002
    COMMAND ===> SCROLL ===> PAGE

    Normal Group Heading
    Field Description Normal....... NORMAL INPUT DATA
    Field Description Normal....... NORMAL SELECTABLE DATA
    Field Description Normal....... NORMAL DATA

     Emphasized Group Heading
    Field Description Emphasized... EMPHASIZED INPUT DATA
    Field Description Emphasized... EMPHASIZED SELECTABLE DATA
    Field Description Emphasized... EMPHASIZED DATA

    1 DUMMYCMD Available Fast-Path Command

    2 DUMMYCMD Unavailable Fast-Path Command

    Column 1  Column 2
    Heading  Heading
    NORMAL DATA  080105F8
    NORMAL DATA  080105F8

    Press PF1 on any field for field help. You can repeat this entire procedure until you are satisfied with the appearance of each screen attribute.

PF Keys

This section lists the initial PF key defaults that Abend-AID defines, and it details the steps for changing those defaults.

Important

If you use multiple Abend-AID viewing servers, you must modify your PF key defaults on each viewing server.

Default PF Key Definitions

Abend-AID maintains consistency with ISPF PF key definitions for keys PF1 through PF12 (commands such as UP, DOWN, END, and RETURN). In addition, PF13 through PF16 repeat the definitions assigned PF1 through PF4. The remaining keys, PF17 through PF24, are assigned specific Abend-AID functions.

The following table describes the defaults assigned to all 24 PF keys. For information on changing these defaults, see Modifying PF Key Functions.

Important

All references to PF keys in this manual assume the initial default values.

 Default PF Key Definitions

Key

Command

Description

PF1/PF13

HELP

Provides cursor-sensitive information. To display screen-level help, press the HELP PF key with the cursor positioned off any specific data field. To display field-level help, press the HELP PF key with the cursor located on the field. To display system message help, press the HELP PF key with the cursor located on the message.

PF2/PF14

SPLIT

Divides the display screen into two logical, functionally independent screens. Valid for ISPF access only.

PF3/PF15

END

Ends the current function and redisplays the previous level screen or menu.

PF4/PF16

RETURN

If you have selected a report, redisplays the Report Menu. If you have not selected a report, redisplays the Fault Summary. Executing this command from the Fault Summary screen exits the product..

PF5

RFIND

Repeats the last FIND command executed. For specifics about the FIND command, see FIND.

PF6

MAINMENU

Displays the Abend-AID Report Menu for the selected report/SVC dump.

PF7

UP

Scrolls backward through a screen’s scrollable area. To scroll a specific number of lines, type the UP command with a numeric value in the COMMAND field. For example, type UP 12 and press Enter to scroll backward 12 lines.

PF8

DOWN

Scrolls forward through a screen’s scrollable area. To scroll a specific number of lines, type the DOWN command with a numeric value in the COMMAND field. For example, type DOWN 8 and press Enter to scroll forward eight lines. Valid for ISPF access only.

PF9

SWAP

Moves the cursor to the other logical screen when the display is in split screen mode. Valid for ISPF access only.

PF10

LEFT

Scrolls toward the first column of data. Left scrollable screens display a left arrow symbol (<) at the end of the message line. To scroll a specific number of columns, type the LEFT command with a numeric value in the COMMAND field. For example, type LEFT 2 and press Enter to scroll left two columns.

PF11

RIGHT

Scrolls toward the last column of data. Right scrollable screens display a right arrow symbol (>) at the end of the message line. To scroll a specific number of columns, type the RIGHT command with a numeric value in the COMMAND field. For example, type RIGHT 2 and press Enter to scroll right two columns.

PF12

RETRIEVE

Redisplays the last command entered in the COMMAND or OPTION field.

PF17

DISASM

Disassembles all assembler instructions in storage. Abend-AID displays this information on the Storage Disassembly screen, starting with the address specified. On Memory Display data fields only (for example, Word1), the DISASM command disassembles the data displayed in the field. For more information about this command, see DISASM.

PF18

HEXD

Displays storage in hexadecimal format when the cursor is positioned on an address, a table entry, or a control block symbol. For more information about displaying storage, see Displaying Storage.

PF19

DSECT

Displays storage in DSECT format when the cursor is positioned on an address, a table entry, or a control block symbol. For more information about displaying storage, see Displaying Storage.

PF20

INFO

Displays the Entry Information screen for the current dump.

PF21

WHO

For region dumps only. Lists TCBs (for any dump), TCAs (for CICS dumps only), and KETASKs (for CICS dumps only) that have addressability to the address specified with the WHO command or for the current cursor field. For more information about this command, see ZOSSDMP.

PF22

MATCH

For region dumps only. Lists TCBs (for any dump), TCAs (for CICS dumps only), and KETASKs (for CICS dumps only) that have data matching the data at the address specified with the MATCH command or for the current cursor field. For more information about this command, see MLOG.

PF23

LPRINT

Prints a logical image of a screen to a sequential data set. For more information about this command, see LPRINT.

PF24

ASSIST

Displays the commands available for the current screen, scrollable table, or field. The position of the cursor determines which commands are listed. For example, to list the commands available for a specific field, position the cursor on that field and press the PF ASSIST key. If the field is located in a scrollable table, the commands available for that table are listed also. To list a screen’s commands that are not specific to a particular field or scrollable table, position the cursor off any field in the screen’s nonscrollable area. For more information about this command, see ASSIST.

Modifying PF Key Functions

Abend-AID provides an easy method for changing PF key functions.

Important

  1. Because the Abend-AID maintains its PF key definitions separately from a user’s ISPF/PDF profile, the changes you make to the PF keys are valid only when using the Abend-AID. Your ISPF/PDF default PF key definitions are unaffected.
  2. You can assign multiple commands to a PF key by using the semicolon (;) as a delimiter between commands.

To change any PF key definition or label, perform the following steps:

  1. Display the PF Key Definitions screen, shown in the following figure, using one of the following methods:

    • Tab to the KEYS option on the User Controls menu, and press Enter.
    • Enter KEYS as a fast-path command.
    • Enter =U.4 as a jump command.

    PF Key Definitions and Labels Screen 

     Abend-AID --------------- PF Key Definitions - Primary --------------------
    COMMAND ===>

    PF13 Definition... HELP
    PF14 Definition... SPLIT
    PF15 Definition... END
    PF16 Definition... RETURN
    PF17 Definition... DISASM
    PF18 Definition... HEXD
    PF19 Definition... DSECT
    PF20 Definition... INFO
    PF21 Definition... WHO
    PF22 Definition... MATCH
    PF23 Definition... LPRINT
    PF24 Definition... ASSIST

    PF13 Label... PF14 Label... PF15 Label...
    PF16 Label... PF17 Label... PF18 Label...
    PF19 Label... PF20 Label... PF21 Label...
    PF22 Label... PF23 Label... PF24 Label...

    Press Enter to display the alternate keys. Type END command (PF3) to save,
    CANCEL to exit without saving, or DEFAULTS to reset the values.
  2. Press Enter to display the alternate keys.
  3. Type the new value or function for the associated PF key in the area directly following the key name. See the above figure for the default PF key function names.
  4. Press Enter. The PF Key Definitions and Labels screen displays the new PF key values.
  5. When modifications are complete, press the END PF key to exit the screen and save your changes. (PF3 and PF15 are the defaults.) Or, enter CANCEL to exit the screen without saving your changes.
  6. To restore the site-defined defaults if you saved your changes, enter DEFAULTS as a primary command.

Report Export Options 

The default Abend-AID Report Export settings are configured for the current user using this function.  Individual users can override the values you set here when they sign onto the Abend-AID Viewer. Please note that each user only needs to do this once. 

Display the Report Export Options, shown in the below figure using one of two methods:

  • Tab to Report Export Options on the User Controls Menu, and then press Enter.
  • User can enter provided Fast-path command EXP on the Command line and press ENTER to access the same.

Report Export Options

Customization ----------- Report Export Options ----------------------------
COMMAND ===>                                                                 
                                                                             
To change a displayed value, overtype it.                                    
 ___________________________________________________________________________  
                                                                             
Output DSN:                                                                  
Output DSN............                                                       
                                                                             
 CSS Load Library:                                                            
 SLCXLOAD..............                                                       
                                                                             
                                                                             
 Jobcard Information:                                                         
1... //JOBNAMEP JOB ('OCXBAS7.7DSP',R4244),'ACCOUNTING INFO',                   
2... //       CLASS=L,MSGCLASS=R,NOTIFY=&SYSUID,REGION=0M                    
3... //*                                                                     
 4... //*                                                                     
 5... //*                                                                     
 6... //*                                                                   
                                                                                                                                                           

Below are the     parameters:

Output DSN: 

The output DSN is the name of the dataset to which you wish to export the Abend AID report.

RXXXXXXX will be added to the output data set name. 

SLCXLOAD:

This is the name of the CSS (or SLCXLOAD) library that gets generated when Abend-AID is installed.  

Jobcard Information:

These jobcards are identical to those that the user submitted on the LIST screen. 

Important

Be advised that the Jobname will be modified based on the Report Number.

Press the END (PF3) key to save your changes, or type CANcel to ignore them. 
RESet command restores the export options to original values prior to the changes if any.

Exporting the Report from AA Viewer:

  • You’ll see a new Line command ‘Export’ on your Directory Screen.
  • This functions just like any other Line command. By entering X before the Report Number and pressing ENTER, the user can export any of the Batch/CICS reports.
  • A Batch job with 3 EXEC statements will be submitted in the same region where the AA viewer is installed if the input parameters in the ‘Report Export Options’ screen are entered correctly.
    • Meanwhile, ‘FDBSI1404’ will be displayed on the viewer with the Output Dataset.
      • As previously indicated, the Jobname and Output DSN in the submitted JCL will be changed in accordance with the Report number.
      • Jobname modification: If the report number to be exported is 0001234, and the jobname in the "Report Export Options" is JOBNAMEP, the jobname on the JCL will be J0001234.
      • Output DSN : AA.SAMPLE.EXPORT will be replaced with AA.SAMPLE.EXPORT.R00001234, if AA.SAMPLE.EXPORT is the output DSN provided in the 'Report Export Options'.
    • Why are there three EXEC steps?

      • STEP001: Using IDCAMS, this step will determine whether the Output DSN—AA.SAMPLE.EXPORT.R00001234, in the example above—is present in the system.

        In the event that the DSN is absent, IDCAMS returns 04; in the event that it is present, it returns 00.

      • STEP002: Using the Return code from STEP001, this step runs IEFBR14.
        i.e. If the dataset is already in the system, this step will remove it.
        • And if the Dataset is present, it won't run.
      • CXUTIL: This is the last JCL step where the export is executed.
  • Should there be any JCL issues—like space errors and so on—we ask the user to assess the errors and manually submit the job.
  • If an error cannot be fixed, the user can get in touch with BMC technical support.

 

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