MESSAGES/USER DATA Policy Item

If you select policy item MESSAGES/USER DATA from the Policy Selection panel for Applications (Policy Items for Applications), the Message Processing panel shown in Figure 1 is displayed.

Figure 1. Message Processing Panel

   COMMANDS  HELP                                                               
 ------------------------------------------------------------------------------ 
 AOFGDYNM                 Message Processing          Line 00000001 Col 001 075 
 Command ===>                                                  Scroll ===> PAGE 
                                                           
 Entry Type : Application           PolicyDB Name   : USER_PDB                  
 Entry Name : DB21MSTR              Enterprise Name : USER_ENTERPRISE           

 Line Commands: S/C (Cmd), R (Rep), K (Cod), U (Usr), A,M (AT, MRT, MPF)        
                I, D (insert or delete lines), CN (Class Name)                  
 Message ID field length. . 16   (1 - 32)                                       
                                                                                
 Cmd Message ID       Description                               C  R  K  U A M F
     CAPMSGS          Message capturing (AOFCPMSG parameters)         1    P P P
     DATABASE         Specifications for DATABASE                     3    P P P
     DSNB250E         Start tablespaces                         1
     DSNP007I         Data set extend failed                    1     5    *    
     DSNT500I         Resource unavailable                      1     5    *

On the Message Processing panel you specify how SA z/OS should react if the application issues the specified message. If the application is linked to a class, the panel shows both instance and class data sorted alphabetically, with the inherited data shown in a different color. For more details see Nested Class Details. You can find out which class a value has been inherited from by typing the command classname (or its abbreviation cn) on the command line, moving the cursor to the field of interest and pressing Enter.

Use the CANCEL command (abbreviated to C) to exit the panel without saving any changes to the data.

You can define message responses for each message ID. By default, the first 16 characters of the message ID is shown. The length of the description that is displayed depends on your screen width (for a 24x80 screen, it is 40 characters).

You can change the length of the message ID field with the Message ID field length field. Note that this value is saved across sessions. If you increase the message ID field length, you can view any information on the right of the panel that is no longer displayed by scrolling right with the PF11 key.

You can enter different line commands in the Cmd column. Depending on what you type here, SA z/OS displays a follow-on panel where you further specify SA z/OS automated reaction to the message. Note that the message ID must not end with an asterisk and cannot have any commas in it.

Generally, SA z/OS requires an entry in the NetView automation table that specifies which routine SA z/OS should use to process your specified action. SA z/OS is able automatically to build the NetView AT entries for all CMD, REP, and AT actions as well as for certain USR and COD actions.

Information about how to manage the NetView automation table is given in IBM Z® System Automation Customizing and Programming.

The following line commands are available:

CMD: To issue commands as a response to a message, see Command Processing.
REP: To issue replies, see Reply Processing.
COD: To check for certain codes within a message. For different sets of code values, you can define a corresponding value that is returned to the calling REXX script that checks for a matching code definition. See Code Processing.
USR: You can specify your own data that is needed when SA z/OS runs user-specified actions if the current message requires more specific automation than provided by the generic routines (see User Data Processing).
Using the ACFFQRY common routine from within a REXX exec, you can retrieve the keywords entered into this panel and process them as needed. Syntax rules for specifying user data are available in the online help. For information on how to use ACFFQRY in a REXX exec see ACFFQRY in IBM Z System Automation Programmer's Reference.
A or M (short for AT, MRT, MPF): Use the associated panels to customize the AT, MRT, and MPF entry that is built for the message ID. See Message Automation Definitions.

Columns C, R, K, and U display the number of commands, replies, codes, and user definitions for the particular message.

Columns A, M, and F indicate whether there are any specifications that are related to entries for the NetView automation table, message revision table or MPFLSTxx member as follows:

*: User data has been defined for the message ID. The * is always turquoise because the data cannot be associated with a class because there may be other instances with entries for the same message ID.
P: There is a predefined entry for this message ID, shown in the color for inherited data.
blank: If none of the above.

You can enter the LOCATE (abbreviated to L) command to position to a specific message ID.

You can enter FIND (abbreviated to F) at the command line on the Message Processing panel to search the displayed data for a specific string, for example, f abc. All occurrences of the string are highlighted and the cursor is positioned at the start of the first one. You can use the RESET command to remove the highlighting.

Note that only the data that is visible is searched through in the Message ID column. You should therefore consider expanding the column width so that the complete message ID is visible before performing a search.

You can use the RFIND function key (PF5) to move to the next occurrence of the string. If you enter the RFIND command at the command line it repeats the last find.

For more details, see How to Find Data in a Policy Item.