z/OS Communications Server: SNA Network Implementation Guide
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Model name table

z/OS Communications Server: SNA Network Implementation Guide
SC27-3672-01

The model name table contains model names that can be passed to VTAM® application programs in their LOGON exits. The purpose is to help VTAM application programs create dynamic definitions for their session-partner resources.

A model definition is normally used as the starting point for a dynamic resource definition. A typical application might maintain many different model definitions, one for each possible combination of resource characteristics. The model name passed by VTAM enables the application program to and accurately select the proper model definition to use.

Operands on an SLU resource definition can associate that SLU with the proper model name data. The MDLTAB operand specifies the model name table to be used, and the MDLENT operand specifies the proper entry within the table.

You create a model name table by specifying:
  • A MDLTAB macro instruction
  • One or more MDLENT macro instructions
  • Optional MDLPLU macro instructions for each MDLENT

File these macros in the VTAM definition library. The name of the table is the name of the stored member or file. No assembly or link-edit is required to install the table. The table is built dynamically upon the first activation of any resource that has a defined association to the table.

IBM® does not supply a default model name table.

An example of a model name table is shown in Table 1.

Table 1. Example of model name table
Name Operation Operands
MDLTAB1 MDLTAB  
ENTRY1 MDLENT MODEL=MDLNAME1
ENTRY2 MDLENT  
  MDLPLU PLU=APPL2, MODEL=MDLNAME2
  MDLPLU PLU=APPL5, MODEL=MDLNAME3
ENTRY3 MDLENT MODEL=MDLNAME3
  MDLPLU PLU=APPL5, MODEL=MDLNAME4
  MDLPLU PLU=APPL7
Following are some examples of how the model name table in Table 1 works:
  • Assume that the SLU has the MDLTAB=MDLTAB1 macro coded in its definition. The entry name specified by the SLU and the name of the PLU involved in the session determines which model name is sent to the PLU during session initiation.
  • Assume the SLU has the MDLENT=ENTRY1 macro coded in its definition. This macro specifies a default model name of MDLNAME1 for the entry. Because no MDLPLU macros are specified, model name MDLNAME1 is sent for any PLU.
  • Assume the SLU has the MDLENT=ENTRY2 macro coded in its definition. This macro specifies no default model name. The first MDLPLU macro specifies that model name MDLNAME2 is sent when the PLU is APPL2. The second MDLPLU macro specifies that model name MDLNAME3 is sent when the PLU is APPL5. For any other PLU, no model name is sent.
  • Assume the SLU has the MDLENT=ENTRY3 macro coded in its definition. This macro specifies a default model name of MDLNAME3 for the entry. The first MDLPLU macro specifies that model name MDLNAME4 is sent when the PLU is APPL5. The second MDLPLU macro specifies that no model name is sent when the PLU is APPL7. For any other PLU, model name MDLNAME3 is sent.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014