Skip to main content

Software  >  Networking  >  

Activation of VSE VTAM switched major node for OSA-Express in non-QDIO mode fails

 Technote (troubleshooting)
 
Problem(Abstract)
A problem occurred during implementation of a PU5 to PU5 APPN connection cross network between a VSE VTAM configured as a BN and ICN, running with the InterEnterprise VTAM function set, and a z/OS Communications Server VTAM.

On the VSE VTAM host, a VARY ACT command for the switched major node failed, as shown below:
 v net,id=switched_major_node,scope=all,act
 AR 0015 1C39I COMMAND PASSED TO ACF/VTAM
F3 0003 IST097I VARY ACCEPTED
F3 0003 IST363I CONFIG switched_major_node NODES AND SUBNODES SET UNAVAILABLE - MISSING PARAMETER
F3 0003 IST323I LABEL = pu_label -MACRO TYPE = PU - KEYWORD = ADDR
F3 0003 IST142I CONFIG switched_major_node BYPASSED-PATH MACRO ERROR, REASON CODE 2
F3 0003 IST1264I VARY ACT FOR switched_major_node FAILED DURING DEFINITION
 
Symptom
The switched major node was coded as follows:


         VBUILD TYPE=SWNET
PU4      PU PUTYPE=2,                                        
         CPNAME=control_point_name,
         NN=YES,                                                    
         NETID=network_id,                                              
         CPCP=YES,                                                  
         CONNTYPE=APPN,                                              
         DYNLU=YES,                                                  
         DWACT=YES,                                                  
         TGP=ETHERNET,                                              
         MAXOUT=7,                                                  
         DISCNT=NO,                                                  
         ISTATUS=ACTIVE                                              
PATH     DIALNO=dial_digits,GRPNM=group_name 

 
Diagnosing the problem

The switched major node activated here was originally defined on an MVS VTAM node used for Enterprise Extender (EE) connections.

1) F3 0003 IST363I CONFIG switched_major_node NODES AND SUBNODES SET UNAVAILABLE - MISSING PARAMETER

F3 0003 IST323I LABEL = pu_label - MACRO TYPE = PU - KEYWORD = ADDR

In MVS, the ADDR keyword is not valid for a switched major node PU statement when defining EE connections. But, for non-EE XCA connections, whether they be MVS or VSE, the ADDR keyword is required, which is why these two error messages were issued. ADDR must be set to a link station address, as specified in the VTAM V4R2 Resource Definition Reference (SC31-6498-01).



2) F3 0003 IST142I CONFIG switched_major_node BYPASSED - PATH MACRO ERROR, REASON CODE 2

Reason code 2 in message IST142I indicates that the "MAXPATH value on preceding PU definition is zero or is default (the default value is zero)." To process the PATH statement, there must already be a path table in existence, and that path table is allocated when the MAXPATH parameter on the preceding PU statement is processed. Therefore, MAXPATH is a required parameter on the PU definition, and must be coded with a value greater than 0, because 0 indicates that a path table is not to be created.

The MAXPATH parameter has been obsolete for MVS VTAM since MVS VTAM V4R4, which introduced switched dynamics. However, for VSE VTAM, MAXPATH on the PU statement is still valid and required. For information regarding how to code MAXPATH on the PU statement, see the VTAM V4R2 Resource Definition Reference (SC31-6498-01).
 
Resolving the problem
Code the ADDR and MAXPATH parameters on the PU statement. Activation of the switched major node should proceed without a problem.
 
 
 

Copyright and trademark information
IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.
Rate this page
Please take a moment to complete this form to help us better serve you.
This material provides me with the information I need.




This material is clear and easy to understand.




Did the information help you to achieve your goal?
What updates, improvements, or related information would you like to see in this document?
Your response will be used to improve our document content. Requests for assistance, if applicable, should be submitted through your normal support channel as we cannot respond from this site.
Input the verification number to submit feedback:
Document information
 Product categories:
 Software
 Networking
 Enterprise Connectivity
 VTAM for VSE/ESA and VM/ESA
 All
 Operating system(s):
  VSE/ESA
 Software version:
  4.2
 Reference #:
  1299539
 IBM Group:
 Software Group
 Modified date:
 2009-08-14

Translate My Page
 
 

Rate this page

Help us improve this page. Your response will be used to improve our document content. Requests for assistance, if applicable, should be submitted through your normal support channel as we cannot respond from this site.