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.

Accessing the user controls menu

The Abend-AID Viewer site customization options are available as a selection on the User Controls menu. Display the User Controls menu, shown in the following figure, using one of the following methods:

  • If you do not currently have a dump selected, type USER in the COMMAND field of the Fault Summary or Abend-AID Directory display, and then press Enter.
  • If you currently have a dump selected, use one of two methods:
    • Tab to User Control Facility on any Abend-AID Viewer Primary Options menu, and then press Enter, or
    • Type USER  or =U in the COMMAND (or OPTION) field on any screen and press Enter.

User Controls Menu

Customization -----------------------User Controls --------------------------------
OPTION  ===>                                                                                                                    
                                                                                                                               
                           1  PROFILE  User Profile

                           2  LIST     Print Output Options

                           3  ATTRBUTE Screen Attributes

                           4  KEYS     PF Key Customization

Accessing the Customization Options Menu

Note

You can restrict access to the customization screens by specifying the CUSTOM subparameter of the EXTERNAL_SECURITY_FUNCTION_CHECK viewing server configuration parameter, as described in EXTERNAL_SECURITY_FUNCTION_CHECK=. You must also write the appropriate rules for your external security package, as described in the Security-planning of the Abend-AID Installation and Configuration Guide.

Display the Customization Options menu, shown in the following figure, using one of two methods:

  • Tab to Site Customization Options on the User Controls menu, and then press Enter.
  • Type CUSTOM or USER.5 in the COMMAND (or OPTION) field on any screen and press Enter. You can also type =U.5 if you currently have a dump selected.

Customization Options Menu

Customization ----------------- Customization Options -----------------------------

COMMAND ===>                                                                          

                                                                                      

             1  DEFAULTS Site Default Options                                          

                                                                                      

             2  CAPTURE  Modify Dump Capture and Processing Options                   

                                                                                       

             3  ACTIONS  Notify Users and Execute Scripts                             

                                                                                      

             4  SITENEWS Create/Maintain Site News                                     

                                                                                      

             5  USERDIAG Create/Maintain User Defined Diagnostics                     

                                                                                       

             6  WBHOST   Maintain Workbench Host/Port Table     


Note

You cannot execute non-customization fast-path commands from the customization screens. For example, you cannot execute the DIAG fast-path command from the customization screens. Further, you cannot execute customization fast-path commands from the Abend-AID dump analysis screens.

From this menu, you can access the customization screens from the following menus:

  • Site Default Options Menu
    Use this menu to access the customization screens for setting your site defaults for screen print output, user profile, and screen attributes, as described in Accessing the Customization Options Menu.
  • Dump Capture and Processing Menu
  • Use this menu to access the customization screens for setting your site defaults for Summary screen configuration, region dump capture profiles, and dump notification information, as described in Accessing the Dump Capture Options.
  • Notify Users and Execute Scripts

Use this menu to create contact information definitions for batch dumps, as described in Action Definitions.

  • Create/Maintain Site News
    Use this screen to enter site-defined news, as described in Creating/Maintaining Site News below.
  • Create/Maintain User-Defined Diagnostics
    Use this screen to enter user-defined diagnostics for common or frequently occurring site abends/faults, as described in Creating/Maintaining User-Defined Diagnostics.
  • Maintain Workbench Host/Port Table
  • Use this screen to maintain the BMC AMI DevX Workbench for Eclipse host/port table, as described in Maintaining the BMC AMI DevX Workbench for Eclipse Host/Port Table.

Creating/Maintaining Site News

Use the Site News Menu, shown in the following figure, to access screens that enable you to add site-specific information to the panels that display the Abend-AID and Abend-AID for CICS  for CICS product news in the Abend-AID  Viewer via the NEWS fast-path command.

Site News Menu

Customization ------------------------- Site News Menu --------------------------
OPTION  ===>                                                                                               
                                                                                                          
              1  NEWSAA   Create/Maintain Site News for Abend-AID                      
                                                                                                        
              2  NEWSCF   Create/Maintain Site News for Abend-AID for CICS             
                                                                                                          
              3  DELETEAA Delete Site News for Abend-AID                               
                                                                                                          
              4  DELETECF Delete Site News for Abend-AID for CICS                      


Select either option 1 or 2 from the Site News Menu, to display the Add/Maintain Site News input screen for Abend-AID or Abend-AID for CICS, respectively, as shown in the following figure. The text is displayed as entered without any formatting. The site-specific news resides on the customization file so all viewing servers using the same customization file have access to the same text.

Add/Maintain Site News Screen

Customization -------------- Add/Maintain Site News ------------ Row 000001 of 000160
COMMAND ===>                                                          SCROLL ===> CSR  
                                                                                                                                
Site News
          
Add a batch or CICS news record.
Text is displayed as entered.




To delete previously created site news, select option 3 or 4 from the Site News Menu to display the Confirm Delete for News window for Abend-AID or Abend-AID for CICS, respectively. Press Enter to complete the deletion. Press the END key (PF3) to cancel the delete request.

Creating/Maintaining User-Defined Diagnostics

The User-Defined Diagnostics screen, shown in the following figure, enables authorized users to create or maintain user-defined diagnostic entries. Users are granted security authorization to this screen with access to the Customizations Options menu (See Customization Options Menu) through the CUSTOM subparameter of the EXTERNAL_SECURITY_FUNCTION_CHECK= viewing server configuration parameter. The user-defined diagnostics text resides on the customization file so all viewing servers using the same customization file have access to the same text.

User-Defined Diagnostics Screen

Customization ------------- User Defined Diagnostics ---------- Row 000001 of 000003
COMMAND ===>                                                         SCROLL ===> CSR  
                                                                                                                                
Enter your selection in the line command area.                                                                                   
                                                                                                                                
I Insert    R Replicate   D Delete   U Update    S Display                                                                       
                                                                                                                                
  Product  Abend Type  Abend Code  User ID   Date Saved                                                                          
 *******  **********  **********  ********  **********                                                                          
  Batch    User        ABND        AAUSER1   03DEC2007                                                                           
  Batch    System      TSRS        AAUSER2   11JAN2008                                                                           
  CICS     User        1111        AAUSER3   18JAN2008   
                                                                       
 ************************** BOTTOM OF DATA *****************************************


Authorized users can use the following line commands to display the User-Defined Diagnostics input screen, as shown in the following figure:

  • I (Insert): Use this line command to display the User Defined Diagnostics screen with all input fields blank.
  • R (Replicate): Use this line command to display the selected entry on the User Defined Diagnostics screen with all input fields blank except the User defined Diagnostic Text field.
  • D (Delete): Use this line command to delete the selected entry.
  • U (Update): Use this line command to display the selected entry on the User Defined Diagnostics screen with all input fields prefilled. Overtype the fields you want to change.
  • S (Display): Use this line command to display the selected entry on the User Defined Diagnostics screen with all input fields prefilled. This line command is for display purposes only and does not let you save any changes.

User Defined Diagnostics Screen

Customization --------------- User Defined Diagnostics -----------------------------  
COMMAND ===>                                                                                                                      
                                                                                                                                  
Enter the product and abend code if new.  Key over data to update.                                                                
                                                                                                                                  
Product.... BATCH  Abend Type....... USER    Abend Code.... ABND                                                                  
                                                                                                                                  
User defined Diagnostic Text                                                                                                      
                                                                                                                                  
See the Diagnostic Summary of the abend report for this abend.                                                                    

Press the END (PF3) key to exit the screen and save your changes. Enter the CANCEL primary command to exit the screen without saving.

Maintaining the Workbench for Eclipse Host/Port Table

The Workbench Host/Port Table screen, shown in the following figure, enables authorized users to maintain host name/port number information for establishing a connection to the Topaz Workbench (formerly, BMC AMI DevX Workbench for Eclipse). Users are granted security authorization to this screen with access to the Customizations Options menu (See Customization Options Menu) through the CUSTOM subparameter of the EXTERNAL_SECURITY_FUNCTION_CHECK= viewing server configuration parameter.

Workbench Host/Port Table Screen

Customization ----------- Workbench Host/Port Table ------------ Row 000001 of 000001
COMMAND ===>      SCROLL ===> CSR  
                                                                                                                                
S Update entry   A Add entry   D Delete entry                                                                                  
                                                                                                                                
       Port                                                                                                                    
SYSID  Number  Host Name
*****  ******  **********************************************************************                                                
CWWB   13456   CWHF1                                                                                                           
****************************** BOTTOM OF DATA *************************************** 


This table is used when viewing an Abend-AID report in the BMC AMI DevX Workbench for Eclipse and a request needs to be made to the Workbench, for example, for File-AID support. The SMF SYSID for the report being viewed is used to look up in this table the appropriate host name and port number to establish a connection to the Workbench.

Authorized users can use the following line commands that are valid for this screen:

  • A (Add entry): Use this line command to display the Add Host/Port Information screen (shown in the following figure), which lets you add a table entry. After you input the information, use the END (PF3) key to save your inputs and return to the Workbench Host/Port Table screen (See Workbench Host/Port Table Screen), or enter the CANCEL primary command to exit the screen without saving your inputs.
  • S (Update entry): Use this line command to display the selected entry on the Update Host/Port Information screen, which lets you update any of the prefilled input fields. After you make your changes, use the END (PF3) key to save your changes and return to the Workbench Host/Port Table screen (See Workbench Host/Port Table Screen), or enter the CANCEL primary command to exit the screen without saving your changes.
  • D (Delete entry): Use this line command to delete the selected table entry.

Add Host/Port Information Screen

Customization ---------------- Add Host/Port Information --------------------------
COMMAND ===>                                                                                                                    
                                                                                                                                
   Enter the following information.                                                                                              
                                                                                                                                
       SYSID:                                                                                                                   
  Port Number:
   Host Name:                                                                                                                   


Update Host/Port Information Screen

Customization ------------ Update Host/Port Information -----------------------------
COMMAND ===>                                                                                               
                                                                                                          
 Update the following information.                                                                        
                                                                                                          
      SYSID: CWWB                                                                                         
 Port Number: 13456                                                                                        
  Host Name: CWHF1                                                                                        


 

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