SIRFMSG


   .-SIRFMSG--=--STARTOPT-----.   
>>-+--------------------------+--------------------------------><
   '-SIRFMSG--=--+----------+-'   
                 +-ALLSSCP--+     
                 +-OLUSSCP--+     
                 +-STARTOPT-+     
                 '-NONE-----'

statements:

GROUP, CDRSC

dependencies:

none

Controls the display of error messages IST663I, IST664I, IST889I, and their message groups. These messages are issued when a session initiation request originated by this CDRSC fails because trial and error routing, using an adjacent SSCP table, exhausted the table and was unable to locate the destination LU. The messages might also be issued when a session initiation request (or searches that may not result in a session being established) to this CDRSC fails for similar reasons. The messages might also be issued when an APPN locate search request fails to locate a target resource.

The SIRFMSG operand setting on the CDRSC controls the ASIRFMSG, DSIRFMSG, ESIRFMSG, FSIRFMSG, LSIRFMSG, RSIRFMSG, and SIRFMSG start option processing. See Descriptions of start options for more details.

When a value other than SIRFMSG=STARTOPT is specified for a CDRSC, the resource level setting of SIRFMSG overrides whatever SIRFMSG start option setting is in effect at the node. If both resources (origin and destination logical units) for a given session initiation request have SIRFMSG values other than SIRFMSG=STARTOPT specified, then the less restrictive setting (where ALLSSCP is less restrictive than OLUSSCP which in turn is less restrictive than NONE) will be used to determine if the error messages are issued. When CPNAME= is coded on a CDRSC, the SIRFMSG setting will also be used to override the LSIRFMSG start option setting for APPN locate searches.

Tip: When SIRFMSG is used to override the LSIRFMSG start option, then ALLSSCP is equivalent in function to ALLNNS and OLUSSCP is equivalent in function to OLUNNS.

SIRFMSG=ALLSSCP: Specifies that messages are issued for all session initiation request failures involving this CDRSC. For APPN locate searches SIRFMSG=ALLSSCP will result in failure messages being issued for searches when this node is acting as a network node.
SIRFMSG=OLUSSCP: Specifies that messages are issued only when the VTAM® owning this CDRSC is the origin logical unit (OLU) SSCP for the failing session initiation request. For APPN locate searches, SIRFMSG=OLUSSCP will result in failure messages being issued for searches where this node is acting as a network node server for the OLU or when acting as the origin directory server of the search.
SIRFMSG=STARTOPT: Specifies that the value of the SIRFMSG start option is to be used for this resource. This is the default setting.
SIRFMSG=NONE: Specifies that no messages are issued for any searches involving this CDRSC.