Session awareness data filter

VTAM® provides a filter to reduce the amount of session awareness (SAW) data that is passed to communication network management (CNM) application programs, such as the NetView® program. Using the SAW data filter, only data for sessions that match predefined PLU-SLU name combinations are sent over the CNM interface to the CNM application program. The PLU-SLU combination definitions can contain pattern-matching characters so that one definition can apply to a variety of sessions.

Note: If the VTAM SAW data filter definition contains SSCP-PU SAW data filter definitions, the CNM application (for example, the NetView program) does not receive any SSCP-PU SAW data from VTAM and cannot collect response time monitor (RTM) data for active physical units.

The KCLASS and MAPSESS macroinstructions define the session monitor filter. If you use the NetView program, you can copy your existing session monitor filter definitions and make some changes to create equivalent VTAM filters. You must place the KEEPMEM START macroinstruction at the beginning of the filter definitions and add KEEPMEM STOP and END macroinstructions at the end of the existing definitions. For continuation lines, use the conventions described in Rules for coding comments. VTAM ignores any NetView operands that do not apply to the VTAM SAW data filter.

VTAM includes a default filter, ISTMGC10 in VTAMLIB, that allows data for all sessions to be passed across the CNM interface. ISTMGC10 needs to be assembled. See Restrictions on use of assembler features for information on assembling modules.

You can modify ISTMGC10 or replace it with one of your own using the MODIFY TABLE command. See z/OS Communications Server: SNA Operation for more information about the MODIFY TABLE command.

You can display the name of the SAW data filter table by specifying ISTNOP, the name of the application program that represents the network operator, on the DISPLAY ID command. See z/OS Communications Server: SNA Operation.

Table 1. Session awareness data filter macroinstructions and operands
Name

Macro
instruction

Operands Page Req Default

Restrictions,
dependencies

name KEEPMEM START-STOP START-STOP R    
 
name KCLASS SAW SAW R YES  
 
name MAPSESS KCLASS KCLASS R    
    PRINET PRINET      
    PRI PRI      
    SEC SEC      
    SECNET SECNET      
 
name END          
 
Legend:
R
Required operand.