Code Processing of Message ID CAPMSGS
On the Message Processing panel, if you enter the action code Cod (K) in the Cmd column against the pseudo message CAPMSGS, a different panel is displayed.
This panel allows you to manage the parameters for message capturing routine AOFCPMSG via code matching.
COMMANDS HELP
--------------------------------------------------------------------------------------
Code Processing: CAMPMSGS Line 00000001 Col 001 075
Command ===> Scroll ===> CSR
Use line command E or S to display complete input fields of a single data line.
Cmd Message ID Jobname User （CODE3） Severity Alrt Inform List
ABC* JOB1 IMPORTANT YES EIF SDF
XYZ* * CRITICAL NO SDF
***************************** Bottom of data****************************************
The following fields are used by the CDEMATCH routine.
- Message ID
- Specify a pattern for the message ID of the triggering message.
- Jobname
- Specify a pattern for the job name of the resource that issued or is assigned to the triggering message.
- User (CODE3)
- Specify a pattern for the value used as CODE3 by CDEMATCH processing.
- Severity
- Specify the severity of the captured message: NORMAL, IMPORTANT, UNUSUAL, or CRITICAL. Specify
IGNORE if the message should not be captured. Note: If nothing is specified, the default is UNUSUAL.
- Alert
- Specify YES if an alert should be generated for the captured message, otherwise specify NO.
Note: If nothing is specified, the default is YES if severity is CRITICAL, otherwise the default is NO.
- Inform List
- Specify the target destination where the message should be sent. Valid values are: SDF, EIF,
E2E, IOM, ITM, SMF, TTT and USR. Note: If nothing is specified, the Inform List definition of the associated resource is used.
- Comment Type
- Specify MSG if the Comment Text below is defined as a message from the NetView message catalog.
Specify TXT if the Comment Text below is defined as plain text.
Note: If nothing is specified here and data is available in Comment Text, the default is TXT. - Comment Text
- Specify a comment text to be associated with the captured message, if comment type is TXT. If
Comment Type is MSG, specify a message ID and optionally up to 4 tokens that are used as message
parameters p5 to p8. The resulting text will be associated with the captured message.
This field is optional.
The text is provided to AOFCPMSG either via the COMMENT parameter if Comment Type is TXT, or via the CMTMSG parameter if Comment Type is MSG. In both cases, the text is displayed in SDF and INGMSGS command.
- DOM List
- Specify YES to delete all captured message instances that match the evaluated message ID,
otherwise specify NO.
You can also specify one or more IDs of messages to be deleted. It allows you to capture a message and thereby delete other messages that become obsolete in one step. The Message ID can contain wildcards.
This field is optional.
Note: The default is NO, unless the message is detected as a DOM, in which case the default is YES. YES and NO must not be used together with message IDs.
Code matching is done on behalf of the specifications in Message ID, Jobname and User (CODE3):
If one of the defined sets of patterns in those 3 fields matches, the contents of the corresponding 'Severity', 'Alert', 'Inform List', 'Comment Text' and 'DOM List' fields are returned to be used for further processing of AOFCPMSG. No further comparison is done.
If no match is found, strings are returned.
When the pattern is a single token, a string comparison is performed. Such a pattern can contain wild characters in any position and combination. An asterisk (*) matches a string of arbitrary length and a percent sign (%) matches a single character. Preceding the asterisk or percent sign with a backslash (\) prevents these characters from being considered as wild characters.
A pattern can also be composed of two tokens. The first token is a comparison operator and the second token is the value to compare to. No wild characters are supported in the value. There are string and numeric comparison operators.
- $EQ
- equal to
- $NE
- not equal to
- $GT
- greater than
- $GE
- greater than or equal to
- $LT
- less than
- $LE
- less than or equal to
String comparison is done character wise and in binary format after all values have been translated to uppercase. For strings with different lengths, the shorter string is padded with blank characters at the end of the string to the same length as the longer string. Strings consisting of whole numbers with and without leading zeros are not considered as equal.
- @EQ
- equal to
- @NE
- not equal to
- @GT
- greater than
- @GE
- greater than or equal to
- @LT
- less than
- @LE
- less than or equal to
For decimal comparison, whole numbers up to an absolute value of (2**31)-1 are accepted.
A hexadecimal comparison is performed, if the value following the operator starts with an X. In this case, hexadecimal digits are accepted up to XFFFFFFFF.
In case of numeric comparison, values with and without leading zeros are considered as equal.
For more information, see description of AOFCPMSG in IBM Z® System Automation Programmer's Reference.
The following LINE COMMANDS are available:
- I or Inn
- Insert one or 'nn' new lines after the selected line.
- R or Rnn
- Repeat a single line or first of 'nn' lines.
- D or Dnn
- Delete a single line or first of 'nn' lines.
- M or Mnn
- Move a single line or first of 'nn' lines.
- A
- Move lines after the selected line.
- B
- Move lines before the selected line.
- E or S
- Edit or Select the input fields in full length.
The COMMANDS choice on the action bar shows the valid commands and their abbreviations, if available:
- FIND (F)
- Find any character or string.
- RFIND
- Repeat previous find.
- RESET
- Reset find highlighting.
- CLASSNAME (CN)
- Display name of class where data is inherited from.
- CANCEL (C)
- Exit the panel without saving any changes.
- END
- Save the changes made and exits the panel.