Defining VTAM terminals

If your IMS system uses VTAM®, use the COMM, NAME, SUBPOOL, TERMINAL, TYPE, and VTAMPOOL macros to describe the VTAM data communication facilities.

If your IMS system uses VTAM, prepare a set of VTAM macro statements to describe the VTAM data communication facilities. The number of sets you must prepare depends on the hardware configuration of your IMS system.

To add VTAM support, specify an ONLINE or ALL system definition on the IMSCTRL macro statement.

You must enter the macro sets in your IMS system stage 1 input deck in the order specified in Coding IMS macros that define the system. IMS issues stage 1 output warning messages and does not complete system definition if the macro sets are not entered in this order.

All non-VTAM data communication specifications must precede the VTAM macro set in your IMS system definition stage 1 input deck; a stage 1 output warning message occurs if the VTAM macro set is not the last physical set. If an MSC macro set is part of your system definition, it must precede the VTAM macro set, or your system definition does not complete. The following table lists macros for defining VTAM terminals.

Table 1. VTAM data communication macros
Macro Number of macros coded Purpose
COMM1 One only per IMS system definition Specifies general communication options not associated with any particular terminal type.
NAME One or more for each physical terminal or component Specifies the logical terminal name for physical terminals of the type specified by the TERMINAL or SUBPOOL statement.
SUBPOOL One for each dynamically allocated session Defines logical unit type 6 (LU 6.1) subpools that can be dynamically allocated within the VTAMPOOL.
TERMINAL One for each terminal or component; must follow the TYPE macro Provides the characteristics of the physical terminal type that is specified in the TYPE statement.
TYPE One for each terminal type Specifies a group of VTAM terminals of the same type.
VTAMPOOL One or more per SUBPOOL; the only purpose for multiple VTAMPOOL statements is to facilitate the documentation of the intended use of the logical terminal group Defines subpools of logical terminals to be dynamically allocated to LU 6.1 sessions.
Note: 1 You can specify only one COMM macro in an IMS system definition. The COMM macro is required for the VTAM macro set.
The following figure is an example of coding for a group of 3270 VTAM terminals.
TYPE UNITYPE=3270,MODEL=2,PTRSIZE=132,OPTIONS=COPY
TERMINAL NAME=CT3275,UNIT=3275,COMPT=PTR1,MODEL=1
NAME VT3275
NAME VT3275P,COMPT=PTR1
TERMINAL NAME=CT3277A
NAME VT3270A
TERMINAL NAME=CT3277B
NAME VT3270B
TERMINAL NAME=CT3277C,MODEL=1
NAME VT3270C
TERMINAL NAME=CT3277D,UNIT=3284
NAME VT3270P1
TERMINAL NAME=CT3277E,UNIT=3286
NAME VT3270P2

The following figure shows the configuration for 3270 VTAM terminals using the VTAM macro set.

Figure 1. Configuration for 3270 VTAM terminals
Relationships are shown between type, terminal, and logical name. UNITYPE=3270. One terminal is associated with two logical names; five terminals are associated with five logical names.