MODIFY VTAMOPTS command

Read syntax diagramSkip visual syntax diagram
>>-MODIFY-- --procname--,--VTAMOPTS----------------------------->

>--+-----------------------------------+------------------------>
   '-,--AFFDELAY--=--number_of_seconds-'   

>--+-----------------------+--+---------------------------+----->
   '-,--ALSREQ--=--+-NO--+-'  |                       (1) |   
                   '-YES-'    '-,--API64R--=--+-NO--+-----'   
                                              '-YES-'         

                                            (2)   
>--+--------------------------------------+--------------------->
   '-,--APPNCOS--=--class-of-service_name-'       

>--+-----------------------------+------------------------------>
   '-,--ASIRFMSG--=--+-ALLSSCP-+-'   
                     +-OLUSSCP-+     
                     '-NONE----'     

>--+------------------------+----------------------------------->
   '-,--AUTHLEN--=--+-NO--+-'   
                    '-YES-'     

>--+-----------------------------+------------------------------>
   '-,--AUTORTRY--=--+-AUTOCAP-+-'   
                     +-CDRM----+     
                     +-ALL-----+     
                     '-NONE----'     

>--+---------------------------+-------------------------------->
   '-,--AUTOTI--=--time_period-'   

                                (3)   
>--+--------------------------+--------------------------------->
   '-,--BNDYN--=--+-NONE----+-'       
                  +-LIMITED-+         
                  '-FULL----'         

                                 (4)   
>--+---------------------------+-------------------------------->
   '-,--BNORD--=--+-DEFINED--+-'       
                  '-PRIORITY-'         

>--+------------------------------------------------------+----->
   '-,--BSCMDRS--=--+-STATS-----------------------------+-'   
                    +-NOSTATS---------------------------+     
                    +-(--,--INOPS--)--------------------+     
                    +-(--,--NOINOPS--)------------------+     
                    '-(--+-STATS--+-,--INOPS---+---+--)-'     
                         |        '-,--NOINOPS-'   |          
                         '-NOSTATS--+-,--INOPS---+-'          
                                    '-,--NOINOPS-'            

>--+-----------------------+------------------------------------>
   '-,--CDRDYN--=--+-YES-+-'   
                   '-NO--'     

>--+------------------------------------+----------------------->
   |                                (5) |   
   '-,--CDSREFER--=--number_of_CDSs-----'   

                                        (6)   
>--+----------------------------------+------------------------->
   '-,--CMPMIPS--=--compression_ratio-'       

>--+------------------------------+----------------------------->
   '-,--CNNRTMSG--=--+-SUPPRESS-+-'   
                     '-NOSUPP---'     

>--+----------------------------------+------------------------->
   '-,--CMPVTAM--=--compression_level-'   

                                (7)   
>--+--------------------------+--------------------------------->
   '-,--CONNTYPE--=--+-APPN-+-'       
                     '-LEN--'         

                                (8)   
>--+--------------------------+--------------------------------->
   '-,--CPCP--=--+-YES------+-'       
                 +-NO-------+         
                 +-LEASED---+         
                 '-SWITCHED-'         

>--+-------------------------------------------+---------------->
   '-,--CSALIMIT--=--+-value-----------------+-'   
                     '-(--value--+------+--)-'     
                                 '-,--F-'          

>--+----------------------------------------+------------------->
   '-,--CSA24--=--+-value-----------------+-'   
                  '-(--value--+------+--)-'     
                              '-,--F-'          

>--+-------------------------+---------------------------------->
   '-,--DIALRTRY--=--+-YES-+-'   
                     '-NO--'     

                                          (9)   
>--+------------------------------------+----------------------->
   '-,--DIRSIZE--=--number_of_resources-'       

                                  (10)   
>--+----------------------------+------------------------------->
   '-,--DIRTIME--=--time_period-'        

>--+---------------------------------------------+-------------->
   '-,--DISCNTIM--=--(time_period1,time_period2)-'   

>--+----------------------------------------------------+------->
   '-,--DLRORDER--=--+-STATNID------------------------+-'   
                     +-CPNAME-------------------------+     
                     +-(--,--FIRST--)-----------------+     
                     +-(--,--ONLY--)------------------+     
                     +---(--CPNAME--+-,--FIRST--)-+---+     
                     |              '-,--ONLY-----'   |     
                     '-(--STATNID--+-,--FIRST--)-+----'     
                                   '-,--ONLY-----'          

>--+----------------------------------+------------------------->
   |                             (11) |   
   '-,--DSIRFMSG--=--+-ALLSSCP-+------'   
                     +-OLUSSCP-+          
                     '-NONE----'          

>--+------------------------------------+----------------------->
   '-,--DSPLYDEF--=--number_of_messages-'   

>--+------------------------------+----------------------------->
   '-,--DSPLYWLD--=--+-FULLWILD-+-'   
                     +-NOWILD---+     
                     +-OPERONLY-+     
                     '-POAONLY--'     

>--+--------------------------+--------------------------------->
   '-,--DUPDEFS--=--+-ALL---+-'   
                    +-NONE--+     
                    +-APPL--+     
                    '-DEPLU-'     

>--+----------------------------------+------------------------->
   '-,--DYNDLGMD--=--+-logmode_name-+-'   
                     '-NONE---------'     

>--+--------------------------------+--------------------------->
   '-,--DYNMODTB--=--+-table_name-+-'   
                     '-NONE-------'     

>--+-------------------------+---------------------------------->
   '-,--EEPORTCK--=--+-NO--+-'   
                     '-YES-'     

                               (12)   
>--+-------------------------+---------------------------------->
   '-,--EEHPRANR--=--+-NO--+-'        
                     '-YES-'          

>--+--------------------------------------------+--------------->
   |                                       (13) |   
   '-,--EEVERIFY--=--+-ACTIVATE----------+------'   
                     +-NEVER-------------+          
                     '-Number_of_minutes-'          

>--+---------------------------+-------------------------------->
   '-,--ENCRPREF--=--+-NONE--+-'   
                     '-value-'     

                                (14)   
>--+--------------------------+--------------------------------->
   '-,--ENCRYPTN--=--+-YES--+-'        
                     +-NO---+          
                     +-CCA--+          
                     +-CUSP-+          
                     +-24---+          
                     '-31---'          

                               (15)   
>--+-------------------------+---------------------------------->
   '-,--ENSEMBLE--=--+-NO--+-'        
                     '-YES-'          

>--+-----------------------------+------------------------------>
   '-,--ESIRFMSG--=--+-ALLSSCP-+-'   
                     +-OLUSSCP-+     
                     '-NONE----'     

>--+--------------------------------------+--------------------->
   '-,--EXPFLTRM--=--expedited_flow_count-'   

>--+-----------------------------+------------------------------>
   '-,--FSIRFMSG--=--+-ALLSSCP-+-'   
                     +-OLUSSCP-+     
                     '-NONE----'     

>--+------------------------+----------------------------------->
   '-,--GVBKDLY--=--+-NO--+-'   
                    '-Yes-'     

>--+---------------------------------------------------+-------->
   |                                              (16) |   
   '-,--HOSTNAME--=--+-fully_qualified_hostname-+------'   
                     '-NONE---------------------'          

>--+-------------------------------------------+---------------->
   '-,--HOTIOTRM--=--percentage_of_buffer_pool-'   

                                    (17)   
>--+------------------------------+----------------------------->
   '-,--HPRITMSG--=--+-BASE-----+-'        
                     '-ENHANCED-'          

                                                       (17)   
>--+-------------------------+--+--------------------+---------->
   '-,--HPRNCPBF--=--+-YES-+-'  '-,HPRPSDLY=ps_delay-'        
                     '-NO--'                                  

                                        (17)   
>--+----------------------------------+------------------------->
   '-,--HPRPSMSG--=--+-ALL----------+-'        
                     '-ps_msg_count-'          

>--+------------------------------------------------------------------------------+-->
   '-,--HPRPST--=--(--low_limit--,--med_limit--,--high_limit--,--network_limit--)-'   

                                    (17) (18)   
>--+------------------------------+----------------------------->
   '-,--HPRSESLM--=--+-NOLIMIT--+-'             
                     '-sess_lim-'               

                                         (17)   
>--+-----------------------------------+------------------------>
   '-,--HPRSTALL--=--+-0-------------+-'        
                     '-timeout_limit-'          

                                                                                 (19) (20) (21)   
>--+---------------------------------------------------------------------------+----------------->
   |                    .-ALL--------.     .-ALL------.                        |                  
   '-,--INOPCODE--=--(--+------------+--,--+----------+--,--+-DUMPENABLE--+--)-'                  
                        +-ALL--------+     +-ALL------+     +-DUMPDISABLE-+                       
                        '-modulename-'     '-inopcode-'     '-DUMPDEFAULT-'                       

>--+------------------------------+----------------------------->
   '-,--INOPDUMP--=--+-ON-------+-'   
                     |     (22) |     
                     '-OFF------'     

>--+--------------------------------+--------------------------->
   '-,--IOINT--=--number_of_seconds-'   

>--+-----------------------------------------+------------------>
   '-,--IOMSGLIM--=--number_of_message_pairs-'   

>--+------------------------------+----------------------------->
   '-,--IOPURGE--=--timeout_value-'   

>--+-------------------------------+---------------------------->
   |                          (23) |   
   '-,--IPADDR--=--ip_address------'   

>--+----------------------------+------------------------------->
   '-,--IPINFO--=--+-SENDALL--+-'   
                   +-SNDLOCAL-+     
                   +-DISPONLY-+     
                   '-NONE-----'     

   .-,--IQDCHPID--=--ANY---------.   
>--+-----------------------------+------------------------------>
   |                        (24) |   
   '-IQDCHPID--=--+-ANY---+------'   
                  +-NONE--+          
                  '-CHPID-'          

>--+-------------------------+---------------------------------->
   '-,--IQDIOSTG--=--+-MAX-+-'   
                     +-AVG-+     
                     +-MIN-+     
                     '-NNN-'     

>--+-----------------------------------------+------------------>
   '-,--ISTCOSDF--=--+-ALL-----------------+-'   
                     +-APPL----------------+     
                     +-DEPLU---------------+     
                     +-INDLU---------------+     
                     +-NONE----------------+     
                     |    .-,---------.    |     
                     |    V           |    |     
                     '-(----+-APPL--+-+--)-'     
                            +-DEPLU-+            
                            '-INDLU-'            

>--+-----------------------------------+------------------------>
   '-,--LIMINTCP--=--number_of_seconds-'   

>--+---------------------------------+-------------------------->
   |                            (25) |   
   '-,--LSIRFMSG--=--+-ALLNNS-+------'   
                     +-OLUNNS-+          
                     '-NONE---'          

>--+-------------------------------------------+---------------->
   '-,--MAXEETST--=--max_ee_connectivity_tests-'   

                                                        (26)   
>--+--------------------------------------------------+--------->
   '-,--MAXLOCAT--=--max_locate_congestion_threshhold-'        

>--+--------------------------+--------------------------------->
   '-,--MAXLURU--=--ru_length-'   

>--+---------------------------------+-------------------------->
   '-,--MAXSSCPS--=--number_of_sscps-'   

>--+-------------------------------+---------------------------->
   '-,--MIHTMOUT--=--units_of_time-'   

>--+-------------------------------+---------------------------->
   |                          (27) |   
   '-,--MPCACT--=--+-NOWAIT-+------'   
                   '-WAIT---'          

>--+---------------------------+--+-----------------------+----->
   '-,--MSGLEVEL--=--+-BASE--+-'  '-,--MSGMOD--=--+-YES-+-'   
                     +-V4R1--+                    '-NO--'     
                     +-V4R2--+                                
                     +-V4R3--+                                
                     +-V4R4--+                                
                     '-CS390-'                                

>--+-----------------------------------+------------------------>
   |                (28)               |   
   '-,--MULTPATH--=-------+-TCPVALUE-+-'   
                          '-NO-------'     

>--+---------------------------------------+-------------------->
   '-,--NACPROBE--=--+-NODUMP------------+-'   
                     +-DUMP--------------+     
                     '-Number_of_minutes-'     

>--+----------------------------------------+------------------->
   |                       (29)             |   
   '-,--NNSPREF--=--+-NONE----------------+-'   
                    '-network_node_server-'     

>--+---------------------------+-------------------------------->
   '-,--NQNMODE--=--+-NAME---+-'   
                    '-NQNAME-'     

                                               (30)   
>--+-----------------------------------------+------------------>
   '-,--NUMTREES--=--number_of_routing_trees-'        

>--+-----------------------------------+------------------------>
   '-,--OSIEVENT--=--+-ALL-----------+-'   
                     +-NONE----------+     
                     |          (31) |     
                     '-PATTERNS------'     

>--+------------------------+----------------------------------->
   '-,--OSIMGMT--=--+-YES-+-'   
                    '-NO--'     

>--+----------------------------------+------------------------->
   |                           (32)   |   
   '-,--OSITOPO--=--+-ALLCDRSC------+-'   
                    '-ILUCDRSC    --'     

>--+-----------------------------------+------------------------>
   '-,--PDTRCBUF--=--number_of_buffers-'   

>--+------------------------------------+----------------------->
   '-,--PIUMAXDS--=--calculation_factor-'   

>--+------------------------------+----------------------------->
   '-,--PLUALMSG--=--+-SUPPRESS-+-'   
                     '-NOSUPP---'     

>--+-----------------------------+--+-----------------------+--->
   |                        (33) |  '-,--PPOLOG--=--+-YES-+-'   
   '-PMTUD--=--+-TCPVALUE-+------'                  '-NO--'     
               '-NO-------'                                     

>--+-------------------------------------------------------------------------------------------------+-->
   '-,--PSRETRY--=--(--low_tp_int--,--med_tp_int--,--high_tp_int--,--network_tp_int--,--+-IMMED-+--)-'   
                                                                                        '-SCHED-'        

>--+--------------------------+--------------------------------->
   '-,--PSSTRACE--=--+-NORB-+-'   
                     +-IRB--+     
                     +-SRB--+     
                     '-BOTH-'     

>--+------------------------------+----------------------------->
   '-,--PSWEIGHT--=--+-EQUAL----+-'   
                     +-LESSTHAN-+     
                     '-SAMEROUT-'     

>--+------------------------+----------------------------------->
   '-,--QDIOSTG--=--+-MAX-+-'   
                    +-AVG-+     
                    +-MIN-+     
                    '-NNN-'     

                                   (34)   
>--+-----------------------------+------------------------------>
   '-,--RESUSAGE--=--usage_limit-'        

                                        (35)   
>--+----------------------------------+------------------------->
   '-,--ROUTERES--=--resistance_value-'        

>--+-----------------------------+------------------------------>
   '-,--RSIRFMSG--=--+-ALLSSCP-+-'   
                     +-OLUSSCP-+     
                     '-NONE----'     

>--+------------------------------------+----------------------->
   '-,--SAVERSCV--=--+-(,FREE)--------+-'   
                     +-(,KEEP)--------+     
                     +-NO-------------+     
                     +-(NO,FREE)------+     
                     +-(NO,KEEP)------+     
                     +-YES------------+     
                     +-(YES,FREE)-----+     
                     +-(YES,KEEP)-----+     
                     +-SAWDATA--------+     
                     +-(SAWDATA,FREE)-+     
                     '-(SAWDATA,KEEP)-'     

>--+------------------------------------+----------------------->
   '-,--SAWMXQPK--=--calculation_factor-'   

>--+-------------------------------------------------------+---->
   '-,--SDLCMDRS--=--+-YES-------------------------------+-'   
                     +-NO--------------------------------+     
                     +-STATS-----------------------------+     
                     +-NOSTATS---------------------------+     
                     +-(--,--INOPS--)--------------------+     
                     +-(--,--NOINOPS--)------------------+     
                     '-(--+-STATS--+-,--INOPS---+---+--)-'     
                          |        '-,--NOINOPS-'   |          
                          '-NOSTATS--+-,--INOPS---+-'          
                                     '-,--NOINOPS-'            

>--+----------------------------+------------------------------->
   '-,--SIRFMSG--=--+-ALLSSCP-+-'   
                    +-OLUSSCP-+     
                    '-NONE----'     

>--+-----------------------------------------+------------------>
   '-,--SLOWVAL--=--+-warn_time------------+-'   
                    '-(warn_time,end_time)-'     

>--+------------------------------+----------------------------->
   '-,--SLUALMSG--=--+-SUPPRESS-+-'   
                     '-NOSUPP---'     

>--+------------------------+----------------------------------->
   '-,--SNAMGMT--=--+-YES-+-'   
                    '-NO--'     

                                      (36)   
>--+--------------------------------+--------------------------->
   '-,--SNVC--=--subnet_visit_count-'        

                                  (37)   
>--+----------------------------+------------------------------->
   '-,--SORDER--=--+-ADJSSCP--+-'        
                   +-APPN-----+          
                   +-APPNFRST-+          
                   '-SUBAREA--'          

>--+------------------------+----------------------------------->
   '-,--SRCHRED--=--+-OFF-+-'   
                    '-ON--'     

                                                (38)   
>--+------------------------------------------+----------------->
   '-,--SRCOUNT--=--number_of_search_requests-'        

                                        (39)   
>--+----------------------------------+------------------------->
   '-,--SRTIMER--=--number_of_seconds-'        

>--+-----------------------------+------------------------------>
   '-,--SSCPORD--=--+-DEFINED--+-'   
                    '-PRIORITY-'     

>--+-----------------------------------+------------------------>
   '-,--SSDTMOUT--=--number_of_seconds-'   

                                   (40)   
>--+-----------------------------+------------------------------>
   '-,--SSEARCH--=--+-YES------+-'        
                    +-NO-------+          
                    +-CACHE----+          
                    '-APPNFRST-'          

>--+-----------------------+------------------------------------>
   '-,--SUPP--=--+-NOSUP-+-'   
                 +-INFO--+     
                 +-WARN--+     
                 +-NORM--+     
                 '-SER---'     

>--+----------------------------------------------------+------->
   '-,--SWNORDER--=--+-CPNAME-------------------------+-'   
                     +-STATNID------------------------+     
                     +-(--,--FIRST--)-----------------+     
                     +-(--,--ONLY--)------------------+     
                     +---(--CPNAME--+-,--FIRST--)-+---+     
                     |              '-,--ONLY-----'   |     
                     '-(--STATNID--+-,--FIRST--)-+----'     
                                   '-,--ONLY-----'          

>--+----------------------------------+------------------------->
   |                             (41) |   
   '-,--TCPNAME--=--tcp_job-name------'   

                      (42)                  
   .-TDUDIAG--=--1000-------------------.   
>--+------------------------------------+----------------------->
   '-TDUDIAG--=--+-resource_threshold-+-'   
                 +-ALWAYS-------------+     
                 '-NEVER--------------'     

                                                            (43)   
>--+------------------------------------------------------+------->
   '-,--UNRCHTIM--=--+-unreachable_time-----------------+-'        
                     +-(,partner_limit)-----------------+          
                     '-(unreachable_time,partner_limit)-'          

>--+------------------------------+----------------------------->
   '-,--UPDDELAY--=--maximum_time-'   

>--+-----------------------------+--+-----------------------+--->
   '-,--VARYWLD--=--+-FULLWILD-+-'  '-,--VFYRED--=--+-YES-+-'   
                    +-NOWILD---+                    '-NO--'     
                    +-OPERONLY-+                                
                    '-POAONLY--'                                

                                           (44)   
>--+-------------------------------------+---------------------->
   '-,--VFYREDTI--=--+-OFF-------------+-'        
                     +-0---------------+          
                     '-reduction_timer-'          

                                                        (45)   
>--+-------------------------+--+---------------------+--------->
   '-,--VOSDEACT--=--+-YES-+-'  '-,--VRTG--=--+-YES-+-'        
                     '-NO--'                  '-NO--'          

                               (46)   
>--+-------------------------+---------------------------------><
   '-,--VRTGCPCP--=--+-YES-+-'        
                     '-NO--'          

Notes:
  1. API64R can be modified only when running in z/Architecture® mode.
  2. APPNCOS can be modified only if NODETYPE was specified during VTAM START processing.
  3. BNDYN can be modified only if BN=YES was specified during VTAM START processing.
  4. BNORD can be modified only if BN=YES was specified during VTAM START processing.
  5. CDSREFER can be modified only if NODETYPE=NN and CDSERVR=NO were specified during VTAM START processing.
  6. CMPMIPS is meaningful only if the value for CMPVTAM is greater than 1.
  7. CONNTYPE can be modified only if NODETYPE was specified during VTAM START processing.
  8. CPCP can be modified only if NODETYPE was specified during VTAM START processing.
  9. DIRSIZE can be modified only if NODETYPE=NN was specified during VTAM START processing.
  10. DIRTIME can be modified only if NODETYPE=NN was specified during VTAM START processing.
  11. Because of the volume of messages that can be generated, it is not recommended that this option be enabled during normal operation. Instead, it is recommended that this option be enabled (using the MODIFY VTAMOPTS command) on all necessary hosts only when trying to diagnose specific problems. After the problem has been diagnosed or documentation has been collected, this option should be disabled once again (using the MODIFY VTAMOPTS command).
  12. EEHPRANR is meaningful only when the NODETYPE=NN start option is also used.
  13. The EEVERIFY start option is meaningful only if VTAM provides RTP-level HPR support. The EEVERIFY start option can be modified only if the NODETYPE start option is specified and the RTP value is specified on the HPR start option.
  14. The ENCRYPTN start option cannot be modified if ENCRYPTN=NO was specified during VTAM START processing.
  15. The ENSEMBLE setting is used to either permit or deny connectivity to the intraensemble data network and the intranode management network. The ensemble setting permits or denies connectivity by either allowing or denying activation of OSX and OSM interfaces. Modifying the ENSEMBLE start option does not cause z/OS Communications Server to take action on active OSX or OSM interfaces.
  16. HOSTNAME can be modified only if NODETYPE was specified during VTAM START processing. Displays of VTAM start options will show the new value immediately; however, the new value will not be used until all Enterprise Extender lines, whose GROUP definition statements do not have HOSTNAME explicitly coded, are inactive. Any subsequent line activation from the Enterprise Extender XCA major node, whose GROUP definition statements do not have HOSTNAME explicitly coded, will make use of the new HOSTNAME start option value. The IPADDR start option, if it is in effect at the time when the MODIFY VTAMOPTS,HOSTNAME=hostname is specified, will be reset (that is, set to a value of 0.0.0.0) as part of the MODIFY processing. The value NONE can be used to clear the setting of the HOSTNAME start option. HOSTNAME and IPADDR cannot be modified using one MODIFY VTAMOPTS command. If both start options are specified on the same MODIFY command, they will both be ignored and message IST1917I will be generated.
  17. This option is meaningful only if VTAM® provides RTP-level HPR support.
  18. If the current value of the HPRSESLM start option is DISABLED, then the HPRSESLM value can be changed only by stopping and restarting VTAM.
  19. When specifying an InOpCode for the second parameter, always specify three digits by including any leading zeros.
  20. If an InOpCode is specified for the second parameter, the first parameter cannot be ALL.
  21. INOPCODE has no effect unless INOPDUMP is active for the resource when an inoperative condition is detected. See the section called MODIFY INOPCODE command for more details.
  22. When altering the INOPDUMP VTAM start option, the resulting INOPDUMP status is propagated to all TRLEs in the TRL major node and becomes the default status for any subsequently activated TRLEs.
  23. IPADDR can be modified only if NODETYPE was specified during VTAM START processing. The new value will not be used until all lines, defined with or defaulting to the old value of the IPADDR start option, in the XCA major node used for Enterprise Extender are inactive. However, displays of VTAM start options will show the new value immediately. Any subsequent line activation from the Enterprise Extender XCA major node, whose GROUP definition statement does not specify the IPADDR operand, will make use of the new IPADDR start option value. The HOSTNAME start option, if it is in effect at the time when the MODIFY VTAMOPTS,IPADDR=ip_address is specified, will be reset (that is, set to a value of NONE) as part of the MODIFY processing. The value of 0.0.0.0, or an IPv6 address of all zeros, usually written as ::, can be used to clear the setting of the IPADDR start option. HOSTNAME and IPADDR cannot be modified using one MODIFY VTAMOPTS command. If both start options are specified on the same MODIFY command, they will both be ignored and message IST1917I will be generated.
  24. The IQDCHPID option controls which IQD CHPID (and related subchannel devices) VTAM selects to dynamically build the iQDIO (IUTIQDIO) MPC group. The IUTIQDIO MPC group is used for TCP/IP dynamic XCF communications within System z®. Although this option can be modified (and the modification will immediately be displayed) while the IUTIQDIO MPC group is currently active, any modifications have the effects shown in the section called IQD CHPID modifications.
  25. Because of the volume of messages that can be generated, it is not recommended that this option be enabled during normal operation. Instead, it is recommended that this option be enabled (using the MODIFY VTAMOPTS command) on all necessary hosts only when trying to diagnose specific problems. After the problem has been diagnosed or documentation has been collected, this option should be disabled once again (using the MODIFY VTAMOPTS command).
  26. MAXLOCAT can be modified only if NODETYPE was specified during VTAM START processing.
  27. The option does not take effect for MPC groups that are in the process of being activated when the command is issued until those MPC groups are deactivated and reactivated.
  28. MULTPATH is meaningful only if the NODETYPE start option is also specified.
  29. NNSPREF can be modified only if NODETYPE=EN was specified during VTAM START processing.
  30. NUMTREES can be modified only if NODETYPE=NN was specified during VTAM START processing.
  31. OSIEVENT=PATTERNS is not valid when OSIMGMT=YES.
  32. OSITOPO=ALLCDRSC is not valid when OSIMGMT=YES.
  33. PMTUD is meaningful only if the NODETYPE start option is also specified.
  34. RESUSAGE can be modified only if NODETYPE=NN was specified during VTAM START processing.
  35. ROUTERES can be modified only if NODETYPE=NN was specified during VTAM START processing.
  36. SNVC can be modified only if BN=YES was specified during VTAM START processing.
  37. SORDER can be modified only if VTAM has been started as an interchange node or a migration data host.
  38. SRCOUNT is meaningful only when SRCHRED=ON.
  39. SRTIMER is meaningful only when SRCHRED=ON.
  40. SSEARCH can be modified only if NODETYPE=NN was specified during VTAM START processing.
  41. TCPNAME can be modified only if NODETYPE was specified during VTAM START processing. The new value will not be used until all lines in the XCA major node used for Enterprise Extender are inactive. However, displays of VTAM start options will show the new value immediately. Any subsequent line activation from the Enterprise Extender XCA major node will make use of the new TCPNAME value.
  42. TDUDIAG is meaningful only if the NODETYPE=NN start option is also available.
  43. UNRCHTIM is meaningful only if the NODETYPE start option is also used.
  44. VFYREDTI can be modified only if NODETYPE=NN was specified during VTAM START processing.
  45. VRTG can be modified only if NODETYPE and HOSTSA are specified.
  46. VRTGCPCP can be modified only if NODETYPE and HOSTSA are specified.

Abbreviations

Operand Abbreviation
MODIFY F
MSGLEVEL MSGLVL
PLUALMSG=NOSUPP PLUALMSG=NOSUP
PLUALMSG=SUPPRESS PLUALMSG=SUPP
SLUALMSG=NOSUPP SLUALMSG=NOSUP
SLUALMSG=SUPPRESS SLUALMSG=SUPP

When using an abbreviation in place of an operand, code the abbreviation exactly as shown in the table. For example, when coding the abbreviation for PLUALMSG=SUPPRESS, code only PLUALMSG=SUPP.

Purpose

The MODIFY VTAMOPTS (VTAM start options) command enables you to change certain values that might have been specified on VTAM start options. See the z/OS Communications Server: SNA Resource Definition Reference for descriptions of each of the start options that you can change with this command.

There are no default values on the MODIFY VTAMOPTS command. In general, only the values that you specify are affected, and operands that are not specified on the command are unaffected. The exceptions are the IPADDR and HOSTNAME operands, which do affect each other when specified on the MODIFY VTAMOPTS command.

Note: If a start option affects individual resources, and you change the value of the start option with this command, the change does not go into effect until the major nodes for those resources are deactivated and reactivated. The command takes effect for major nodes that are activated after you issue this command and for dynamic cross-network resources that are dynamically defined after the command is issued.

Operands

procname
The procedure name for the command. If procname in the START command was specified as startname.ident, where startname is the VTAM start procedure and ident is the optional identifier, either startname.ident or ident can be specified for procname.

If procname in the START command was startname, startname must be specified for procname.