MODIFY VTAMOPTS command

Read syntax diagramSkip visual syntax diagram
Read syntax diagramSkip visual syntax diagram MODIFY   procname , VTAMOPTS
Read syntax diagramSkip visual syntax diagram,AFFDELAY=number_of_seconds
Read syntax diagramSkip visual syntax diagramAIMON=NONEIQDIOISMQDIOROCE
Read syntax diagramSkip visual syntax diagram,ALSREQ=NOYES
Read syntax diagramSkip visual syntax diagram,API64R=NOYES1
Read syntax diagramSkip visual syntax diagram,APPNCOS=class-of-service_name2
Read syntax diagramSkip visual syntax diagram,ASIRFMSG=ALLSSCPOLUSSCPNONE
Read syntax diagramSkip visual syntax diagram,AUTHLEN=NOYES
Read syntax diagramSkip visual syntax diagram,AUTORTRY=AUTOCAPCDRMALLNONE
Read syntax diagramSkip visual syntax diagram,AUTOTI=time_period
Read syntax diagramSkip visual syntax diagram,BNDYN=NONELIMITEDFULL3
Read syntax diagramSkip visual syntax diagram,BNORD=DEFINEDPRIORITY4
Read syntax diagramSkip visual syntax diagram,BSCMDRS=STATSNOSTATS(,INOPS)(,NOINOPS)(STATS,INOPS,NOINOPSNOSTATS,INOPS,NOINOPS)
Read syntax diagramSkip visual syntax diagram,CDRDYN=YESNO
Read syntax diagramSkip visual syntax diagram,CDSREFER=number_of_CDSs5
Read syntax diagramSkip visual syntax diagram,CMPMIPS=compression_ratio6
Read syntax diagramSkip visual syntax diagram,CNNRTMSG=SUPPRESSNOSUPP
Read syntax diagramSkip visual syntax diagram,CMPVTAM=compression_level
Read syntax diagramSkip visual syntax diagram,CONNTYPE=APPNLEN7
Read syntax diagramSkip visual syntax diagram,CPCP=YESNOLEASEDSWITCHED8
Read syntax diagramSkip visual syntax diagram,CSALIMIT=value(value,F)
Read syntax diagramSkip visual syntax diagram,CSA24=value(value,F)
Read syntax diagramSkip visual syntax diagram,DIALRTRY=YESNO
Read syntax diagramSkip visual syntax diagram,DIRSIZE=number_of_resources9
Read syntax diagramSkip visual syntax diagram,DIRTIME=time_period10
Read syntax diagramSkip visual syntax diagram,DISCNTIM=(time_period1,time_period2)
Read syntax diagramSkip visual syntax diagram,DLRORDER=STATNIDCPNAME(,FIRST)(,ONLY)(CPNAME,FIRST),ONLY(STATNID,FIRST),ONLY
Read syntax diagramSkip visual syntax diagram,DSACTION=SYSLOGCONSOLE(SYSLOGCONSOLE,SENSE,TERM,NONE,,ALL,msg_count)
Read syntax diagramSkip visual syntax diagram,DSCOUNT=number_of_buffers
Read syntax diagramSkip visual syntax diagram,DSIRFMSG=ALLSSCPOLUSSCPNONE11
Read syntax diagramSkip visual syntax diagram,DSMONITR=APPLNOYES
Read syntax diagramSkip visual syntax diagram,DSPLYDEF=number_of_messages
Read syntax diagramSkip visual syntax diagram,DSPLYWLD=FULLWILDNOWILDOPERONLYPOAONLY
Read syntax diagramSkip visual syntax diagram,DSTRUST=ALLCDRSCDLURLOCALAPPLOCALLUTELNETNONE(,CDRSCDLURLOCALAPPLOCALLUTELNET)
Read syntax diagramSkip visual syntax diagram,DUPDEFS=ALLNONEAPPLDEPLU
Read syntax diagramSkip visual syntax diagram,DVLSTCNT=2048409681921638412
Read syntax diagramSkip visual syntax diagram,DYNDLGMD=logmode_nameNONE
Read syntax diagramSkip visual syntax diagram,DYNMODTB=table_nameNONE
Read syntax diagramSkip visual syntax diagram,EEPORTCK=NOYES
Read syntax diagramSkip visual syntax diagram,EEHPRANR=NOYES13
Read syntax diagramSkip visual syntax diagram,EEVERIFY=ACTIVATENEVERNumber_of_minutes14
Read syntax diagramSkip visual syntax diagram,ENCRPREF=NONEvalue
Read syntax diagramSkip visual syntax diagram,ENCRYPTN=YESNOCCACUSP243115
Read syntax diagramSkip visual syntax diagram,ENSEMBLE=NOYES16
Read syntax diagramSkip visual syntax diagram,ESIRFMSG=ALLSSCPOLUSSCPNONE
Read syntax diagramSkip visual syntax diagram,EXPFLTRM=expedited_flow_count
Read syntax diagramSkip visual syntax diagram,FSIRFMSG=ALLSSCPOLUSSCPNONE
Read syntax diagramSkip visual syntax diagram,GVBKDLY=NOYes
Read syntax diagramSkip visual syntax diagram,HOSTNAME=fully_qualified_hostnameNONE17
Read syntax diagramSkip visual syntax diagram,HOTIOTRM=percentage_of_buffer_pool
Read syntax diagramSkip visual syntax diagram,HPRITMSG=BASEENHANCED18
Read syntax diagramSkip visual syntax diagram,HPRNCPBF=YESNO
Read syntax diagramSkip visual syntax diagram,HPRPSDLY= ps_delay18
Read syntax diagramSkip visual syntax diagram,HPRPSMSG=ALLps_msg_count18
Read syntax diagramSkip visual syntax diagram,HPRPST=(low_limit,med_limit,high_limit,network_limit)
Read syntax diagramSkip visual syntax diagram,HPRSESLM=NOLIMITsess_lim1819
Read syntax diagramSkip visual syntax diagram,HPRSTALL=0timeout_limit18
Read syntax diagramSkip visual syntax diagram,INOPCODE=(ALLALLmodulename,ALLALLinopcode,DUMPENABLEDUMPDISABLEDUMPDEFAULT)202122
Read syntax diagramSkip visual syntax diagram,INOPDUMP=OFF23(OFF,,BASEIQDIOISMQDIOROCETCPXCFZCX)ON(ON,,BASEIQDIOISMQDIOROCETCPXCFZCX)
Read syntax diagramSkip visual syntax diagram,IOINT=number_of_seconds
Read syntax diagramSkip visual syntax diagram,IOMSGLIM=number_of_message_pairs
Read syntax diagramSkip visual syntax diagram,IOPURGE=timeout_value
Read syntax diagramSkip visual syntax diagram,IPADDR=ip_address24
Read syntax diagramSkip visual syntax diagram,IPINFO=SENDALLSNDLOCALDISPONLYNONE
Read syntax diagramSkip visual syntax diagram,IQDCHPID=ANYIQDCHPID=ANYNONECHPID25
Read syntax diagramSkip visual syntax diagram,IQDIOSTG=MAXAVGMINNNN
Read syntax diagramSkip visual syntax diagram,ISTCOSDF=ALLAPPLDEPLUINDLUNONE(,APPLDEPLUINDLU)
Read syntax diagramSkip visual syntax diagram,LIMINTCP=number_of_seconds
Read syntax diagramSkip visual syntax diagram,LSIRFMSG=ALLNNSOLUNNSNONE26
Read syntax diagramSkip visual syntax diagram,MAXEETST=max_ee_connectivity_tests
Read syntax diagramSkip visual syntax diagram,MAXLOCAT=max_locate_congestion_threshhold27
Read syntax diagramSkip visual syntax diagram,MAXLURU=ru_length
Read syntax diagramSkip visual syntax diagram,MAXSSCPS=number_of_sscps
Read syntax diagramSkip visual syntax diagram,MIHTMOUT=units_of_time
Read syntax diagramSkip visual syntax diagram,MPCACT=NOWAITWAIT28
Read syntax diagramSkip visual syntax diagram,MSGLEVEL=BASEV4R1V4R2V4R3V4R4CS390
Read syntax diagramSkip visual syntax diagram,MSGMOD=YESNO
Read syntax diagramSkip visual syntax diagram,MULTPATH=29TCPVALUENO
Read syntax diagramSkip visual syntax diagram,NACPROBE=NODUMPDUMPNumber_of_minutes
Read syntax diagramSkip visual syntax diagram,NNSPREF=NONE30network_node_server
Read syntax diagramSkip visual syntax diagram,NQNMODE=NAMENQNAME
Read syntax diagramSkip visual syntax diagram,NUMTREES=number_of_routing_trees31
Read syntax diagramSkip visual syntax diagram,OSIEVENT=ALLNONEPATTERNS32
Read syntax diagramSkip visual syntax diagram,OSIMGMT=YESNO
Read syntax diagramSkip visual syntax diagram,OSITOPO=ALLCDRSC33ILUCDRSC
Read syntax diagramSkip visual syntax diagram,PDTRCBUF=number_of_buffers
Read syntax diagramSkip visual syntax diagram,PIUMAXDS=calculation_factor
Read syntax diagramSkip visual syntax diagram,PLUALMSG=SUPPRESSNOSUPP
Read syntax diagramSkip visual syntax diagramPMTUD=TCPVALUENO34
Read syntax diagramSkip visual syntax diagram,PPOLOG=YESNO
Read syntax diagramSkip visual syntax diagram,PSRETRY=(low_tp_int,med_tp_int,high_tp_int,network_tp_int,IMMEDSCHED)
Read syntax diagramSkip visual syntax diagram,PSSTRACE=NORBIRBSRBBOTH
Read syntax diagramSkip visual syntax diagram,PSWEIGHT=EQUALLESSTHANSAMEROUT
Read syntax diagramSkip visual syntax diagram,QDIOSTG=MAXAVGMINNNN
Read syntax diagramSkip visual syntax diagram,RESUSAGE=usage_limit35
Read syntax diagramSkip visual syntax diagram,ROUTERES=resistance_value36
Read syntax diagramSkip visual syntax diagram,RSIRFMSG=ALLSSCPOLUSSCPNONE
Read syntax diagramSkip visual syntax diagram,SAVERSCV=(,FREE)(,KEEP)NO(NO,FREE)(NO,KEEP)YES(YES,FREE)(YES,KEEP)SAWDATA(SAWDATA,FREE)(SAWDATA,KEEP)
Read syntax diagramSkip visual syntax diagram,SAWMXQPK=calculation_factor
Read syntax diagramSkip visual syntax diagram,SDLCMDRS=YESNOSTATSNOSTATS(,INOPS)(,NOINOPS)(STATS,INOPS,NOINOPSNOSTATS,INOPS,NOINOPS)
Read syntax diagramSkip visual syntax diagram,SIRFMSG=ALLSSCPOLUSSCPNONE
Read syntax diagramSkip visual syntax diagram,SLOWVAL=warn_time(warn_time,end_time)
Read syntax diagramSkip visual syntax diagram,SLUALMSG=SUPPRESSNOSUPP
Read syntax diagramSkip visual syntax diagram,SNAMGMT=YESNO
Read syntax diagramSkip visual syntax diagram,SNVC=subnet_visit_count37
Read syntax diagramSkip visual syntax diagram,SORDER=ADJSSCPAPPNAPPNFRSTSUBAREA38
Read syntax diagramSkip visual syntax diagram,SRCHRED=OFFON
Read syntax diagramSkip visual syntax diagram,SRCOUNT=number_of_search_requests39
Read syntax diagramSkip visual syntax diagram,SRTIMER=number_of_seconds40
Read syntax diagramSkip visual syntax diagram,SSCPORD=DEFINEDPRIORITY
Read syntax diagramSkip visual syntax diagram,SSDTMOUT=number_of_seconds
Read syntax diagramSkip visual syntax diagram,SSEARCH=YESNOCACHEAPPNFRST41
Read syntax diagramSkip visual syntax diagram,SUPP=NOSUPINFOWARNNORMSER
Read syntax diagramSkip visual syntax diagram,SWNORDER=CPNAMESTATNID(,FIRST)(,ONLY)(CPNAME,FIRST),ONLY(STATNID,FIRST),ONLY
Read syntax diagramSkip visual syntax diagram,TCPNAME=tcp_job-name42
Read syntax diagramSkip visual syntax diagramTDUDIAG=100043TDUDIAG=resource_thresholdALWAYSNEVER
Read syntax diagramSkip visual syntax diagram,UNRCHTIM=unreachable_time(,partner_limit)(unreachable_time,partner_limit)44
Read syntax diagramSkip visual syntax diagram,UPDDELAY=maximum_time
Read syntax diagramSkip visual syntax diagram,VARYWLD=FULLWILDNOWILDOPERONLYPOAONLY
Read syntax diagramSkip visual syntax diagram,VFYRED=YESNO
Read syntax diagramSkip visual syntax diagram,VFYREDTI=OFF0reduction_timer45
Read syntax diagramSkip visual syntax diagram,VITCTRL=BASEFULL
Read syntax diagramSkip visual syntax diagram,VOSDEACT=YESNO
Read syntax diagramSkip visual syntax diagram,VRTG=YESNO46
Read syntax diagramSkip visual syntax diagram,VRTGCPCP=YESNO47
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 Use the CFSIZER tool to determine the appropriate number of lists for your EZBDVIPA structure, as well as, the suggested INITSIZE and SIZE values for the structure. Before you modify the DVLSTCNT option to increase the number of lists requested for the EZBDVIPA structure, update your CFRM policy with the recommended INITSIZE and SIZE values. Increasing the number of lists requires more storage for the EZBDVIPA structure. Make sure the same DVLSTCNT value is configured in all VTAMs in the sysplex. To enable the modified DVLSTCNT value, issue the following SETXCF MVS™ command to rebuild the EZBDVIPA structure: SETXCF START,REBUILD,STRNAME=EZBDVIPA. See SETXCF command in z/OS MVS System Commands for more information.
  • 13 EEHPRANR is meaningful only when the NODETYPE=NN start option is also used.
  • 14 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.
  • 15 The ENCRYPTN start option cannot be modified if ENCRYPTN=NO was specified during VTAM START processing.
  • 16 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.
  • 17 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.
  • 18 This option is meaningful only if VTAM provides RTP-level HPR support.
  • 19 If the current value of the HPRSESLM start option is DISABLED, then the HPRSESLM value can be changed only by stopping and restarting VTAM.
  • 20 When specifying an InOpCode for the second parameter, always specify three digits by including any leading zeros.
  • 21 If an InOpCode is specified for the second parameter, the first parameter cannot be ALL.
  • 22 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.
  • 23 When altering the INOPDUMP VTAM start option, the resulting INOPDUMP status is propagated to all TRLEs in the TRL major node if the command is globally set, or it is propogated to a subset of resources that are identified by one or more INOPDUMP control groups. The INOPDUMP setting becomes the default status for any subsequently activated TRLEs.
  • 24 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.
  • 25 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.
  • 26 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).
  • 27 MAXLOCAT can be modified only if NODETYPE was specified during VTAM START processing.
  • 28 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.
  • 29 MULTPATH is meaningful only if the NODETYPE start option is also specified.
  • 30 NNSPREF can be modified only if NODETYPE=EN was specified during VTAM START processing.
  • 31 NUMTREES can be modified only if NODETYPE=NN was specified during VTAM START processing.
  • 32 OSIEVENT=PATTERNS is not valid when OSIMGMT=YES.
  • 33 OSITOPO=ALLCDRSC is not valid when OSIMGMT=YES.
  • 34 PMTUD is meaningful only if the NODETYPE start option is also specified.
  • 35 RESUSAGE can be modified only if NODETYPE=NN was specified during VTAM START processing.
  • 36 ROUTERES can be modified only if NODETYPE=NN was specified during VTAM START processing.
  • 37 SNVC can be modified only if BN=YES was specified during VTAM START processing.
  • 38 SORDER can be modified only if VTAM has been started as an interchange node or a migration data host.
  • 39 SRCOUNT is meaningful only when SRCHRED=ON.
  • 40 SRTIMER is meaningful only when SRCHRED=ON.
  • 41 SSEARCH can be modified only if NODETYPE=NN was specified during VTAM START processing.
  • 42 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.
  • 43 TDUDIAG is meaningful only if the NODETYPE=NN start option is also available.
  • 44 UNRCHTIM is meaningful only if the NODETYPE start option is also used.
  • 45 VFYREDTI can be modified only if NODETYPE=NN was specified during VTAM START processing.
  • 46 VRTG can be modified only if NODETYPE and HOSTSA are specified.
  • 47 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.