| macroinstruction: | FLDENT |
| dependencies: | see description |
Specifies from one to five messages that are linked with the first message in a group to determine whether the message group should be suppressed. The messages you specify on LIST must be present as FLDENT entries in the message-flooding prevention table.
With the LIST operand, you can prevent messages that are
not duplicates from being suppressed. For instance, if you specify
message IST663I on the MESSAGE operand, and do not code the LIST operand,
then all message groups beginning with IST663I are suppressed, even
if the groups are not duplicates. An example of this problem follows:
IST663I CDINIT REQUEST FROM IBMGW FAILED , SENSE=087D0001
IST664I REAL OLU=USIBMEL.ELNA9171 REAL DLU=IBMIN.IBMN2CC9
(intervening messages removed)
IST663I CDINIT REQUEST FROM IBMGW FAILED , SENSE=087D0001
IST664I REAL OLU=USIBMP0.TF2LAADV REAL DLU=IBMIN.IBMJ1EP8
(intervening messages removed)
IST663I CDINIT REQUEST FROM IBMGW FAILED , SENSE=087D0001
IST664I REAL OLU=APPN.IKPASS0A REAL DLU=APPN.IKPASSHQ
(intervening messages removed)In the above example, the three IST663I messages are treated as duplicates. The first IST663I multi-line message is kept and the others suppressed. However, the messages are not duplicates because they have different LU partner names in the IST664I messages.
If the second and third IST663I messages were suppressed, it would take you longer for problem determination, because of having to search trace tapes to find the failures that would have been displayed through the message.
But, if you were to specify IST664I on the LIST operand
(LIST=0664) of the FLDENT entry for IST663I, VTAM® would evaluate the IST664I messages for
duplication, and not suppress them because they are not duplicates.
Note:
- The values of the LIST operand are the message IDs of the other FLDENT entries (for instance, LIST=0664). All LIST references must be to other messages with corresponding FLDENT entries in the message-flooding prevention table.
- A LIST entry which is the same as its FLDENT entry is not permitted.
- If the FLDENT entry indicates a LIST, but the message is being issued as a single-line message, the FLDENT entry is ignored for the one message.
- If the FLDENT entry indicates a LIST with multiple messages and all of the messages are not present in the message group being issued by VTAM, the FLDENT entry is ignored for the current group.
- If the FLDENT entry indicates a LIST with multiple messages, the messages do not have to be present within the multiple line write-to-operator group in the order indicated in the FLDENT entry.
- You cannot specify a particular message in more than one LIST operand.
- The HARDCOPY and TIME operands are ignored if either operand is coded for a message that is not a single-line message or the first message within a group. For the "later messages", the HARDCOPY and TIME values for the first message apply to the entire group.