VSE Changes to VTAM V4R2 Network Implementation Guide (Information APAR II11297)
Changes to the VTAM Network Implementation Guide Version 4 Release 2 for MVS, VM, and VSE (SC31-6494-01) that are applicable to VSE.
In section 18.104.22.168.3, Configuration Restart VSAM Files, this sample file, showing sample VSAM utility control statements used to allocate space for a configuration restart dataset, is shown:
DEFINE - CLUSTER(NAME(ARNCKPT) - VOLUMES(111111) - KEYS(4 0) - RECORDSIZE(24 136)) - DATA(NAME(ARNCKPT.DATA) - TRACKS(1)) - INDEX(NAME(ARNCKPT.INDEX) - TRACKS(1))
This section specifies step 4 as follows:
"4. Code RECORDSIZE (24 136). The average record size must be 24 bytes, and the maximum record size must be 136 bytes."
The maximum record size has changed from 136 to 158 bytes. Specifying too small a record length may result in VTAM issuing the following message:
IST184I I/O ERROR ON CKPT DS datasetname MAJOR NODE nodename RTNCD = 08 6C
DY43813 START OPTION SWNORDER NO LONGER FUNCTIONS AS EXPECTED
In Section 22.214.171.124 Defining Peripheral Nodes and Logical Units, 126.96.36.199.1 Defining Type 2.1 Peripheral Nodes, 188.8.131.52.1.2 CPNAME Operand, the fifth sentence is changed as follows:
(To have VTAM first use IDBLK and IDNUM, use the SWNORDER=STATNID start option or GROUP/LINE operand.)
DY43827 SESSION SETUP FAILS WITH 08970007
In section 4.1.4 "Defining CDRSCs", change:
"...becomes the owning CDRM of the resource to other VTAMs in the subarea network, unless the resource was predefined as a CDRSC with NETID and an owning CDRM name coded."
"...becomes the owning CDRM of the resource to other VTAMs in the subarea network, unless the resource was predefined as a CDRSC with an owning CDRM name coded."
DY45033 ADD DLRORDER START OPTION
In Section 4.1 Implementing a Combined Subarea and APPN Network, 4.1.3 Dependent LUs, 184.108.40.206 Dependent LU Server, under 'To implement the dependent LU server function, consider the following:', replace the existing text with the new text, as follows:
- For DLUR-initiated PU activation, no system definition is required. The dynamic switched definition facility can be used to dynamically define the PU. For information on the dynamic switched definition facility, see Defining Switched Resources Dynamically and Dynamically Defining Switched Resources
- For DLUR-initiated PU activation, no system definition is required. The dynamic switched definition facility can be used to dynamically define the PU (and LUs). For information on the dynamic switched definition facility, see:
- For DLUR-initiated PU activation, you can use the DLRORDER start option to control whether VTAM attempts first to find the PU using CPNAME or station identifier (IDBLK and IDNUM). When the DLUR PU is adjacent to the DLUS (the control point of the DLUR PU has an APPN connection with the DLUS) you must use some means other than CPNAME to find the PU. Some examples of means other than CPNAME for finding the PU are:
- DLRORDER=STATNID with IDBLK and IDNUM defined on the PU.
- Some DLURs have the capability of sending the PU name to the DLUS on REQACTPU (in the X'0E' type X'F1' control vector). In this case the DLUS VTAM tries to find the PU by name before looking for it by CPNAME or station id. See the publications for your DLUR implementation to see if this function is supported.
DY45045 USE DISJOINT PARAMETER ON A SAME NET CDRM
In section 220.127.116.11 Using the DISJOINT Operand to Define Disjoint SNI Networks, replace "SNI" with "SUBAREA" in the heading "Using the DISJOINT Operand to Define Disjoint SNI Networks"
In that same section, delete the second sentence of the fourth paragraph. The fourth paragraph should read:
"When the APPN search request is received by HOSTD, HOSTD uses this information to determine the SSCPs to which the request should be routed. HOSTD routes the request to other SSCPs that are not in NETA (the network identifier provided by HOSTC, the interchange node serving as the APPN entry point)."
Add the following NOTE before the next section:
NOTE: The above discussion of the DISJOINT operand also applies when the netids of all four hosts in figures 130 and 131 are the same (NETA).
DY45360 IST321I IST323I FOR PUTYPE=4 WHEN MEDIUM=FDDI
The VTAM Network Implementation Guide will be changed to add, under Section 18.104.22.168 VTAM-to-VTAM XCA Connections, a new topic, Sample Configuration with Multiple Protocols:
Sample Configuration with Multiple Protocols
Figure xx shows a multiple domain XCA configuration using multiple protocols with routers acting as protocol converters.
+------+ +------+ | | | | | VTAM | | VTAM | | | | | +------+ +------+ | | +----+ +----+ |OSA | |NCP | |card| |NTRI| +----+ +----+ | | | Ethernet ------ | +------+ | | +------+ / \ ----FDDI----|router|---|--|--|--|---|router|-----| Token- | +------+ | | +------+ \ Ring / ------
To be in session across the XCA connection, application programs in each VTAM must be compatible application programs (that is, they must both be SNA application programs).
- To define the configuration in Figure xx, define the following in the VTAM connected through the OSA card: One external communication adapter major node for each FDDI connection to the OSA card.
- Major nodes for any devices connected to the FDDI.
The following is an example of coding used for the configuration in Figure xx:
1. Define an external communication adapter major node for the FDDI connection:
XCACON2 VBUILD TYPE=XCA XCA MAJOR NODE PORT2 PORT MEDIUM=FDDI, FDDI SAPADDR=4, SERVICE ACCESS POINT ADD ADAPNO=1, ADAPTER NUMBER CUADDR=BC0 CHANNEL UNIT ADDRESS * GROUP2A GROUP DIAL=YES, SWITCHED PERIPHERAL NODE ANSWER=ON, DIAL WILL ACCEPT CALLS CALL=INOUT, DIAL IN AND OUT ISTATUS=ACTIVE ACTIVATED AT GEN LINE2A LINE ANSWER=ON PU CAN DIAL IN PU2A PU * GROUP2B GROUP DIAL=NO, NCP SUBAREA ISTATUS=ACTIVE ACTIVATED AT GEN LINE2B LINE PU2A PU MACADDR=400077009938, MAC ADDRESS PUTYPE=4, NCP PU SAPADDR=8, SERVICE ACCESS POINT SUBAREA=50, NCP'S SUBAREA NUMBER TGN=1 TRANSMISSION GROUP NUMBER
2. Define a switched major node for the peripheral node attached to the FDDI:
SWNODE1 VBUILD TYPE=SWNET
PU2 PU DISCNT=YES, DISCONNECT FACILITY
DYNLU=YES, DYNAMIC DEFINITION OF ILU
IDBLK=002, BLOCK IDENTIFICATION
IDNUM=000002, IDENTIFICATION NUMBER
PUTYPE=2 PHYSICAL UNIT TYPE
LANPATH2 PATH DIALNO=0104000069020D60, TIC, SAP, MACADDR
GRPNM=GROUP2A LOGICAL GROUP DEFINITION
LU2 LU LOCADDR=2, DEPENDENT LU
ISTATUS=INACTIVE INITIAL STATUS INACTIVE
- You need to code one LINE and PU definition statement in the dial GROUP definition statement for every simultaneous peripheral node connection.
- Switched devices connected to a FDDI can be defined to VTAM using the model major node. See section 2.2.7 "Dynamically Defining Switched Resources".
- Multiple VTAM hosts can be in session with different stations on the FDDI through one OSA card. To implement this support, code a different SAPADDR and MACADDR value combination to distinguish between the two hosts.
The user is responsible for determining the 'smallest' frame size that the connection can support and insuring that the maximum data field length that flows across the connection does not exceed the 'smallest' frame supported.
The VTAM product has no knowledge of any technology other than what is directly attached to and adjacent to VTAM. Example: If an Ethernet bridge is remote from VTAM and is in the path to the NCP, then the maximum token ring frame size must be X'001' (1500) or less. If not, the bridge will terminate the connection if a data frame greater than 1500 is sent.
DY46311 COMMUNICATION CONTROLLER FOR LINUX ON ZSERIES V1R1 SUPPORT
Please refer to section 22.7 IBM Communication Controller for Linux on System z considerations in the z/OS V1.12 Communications Server: SNA Network Implementation Guide.