Start options

Start options are listed in this section alphabetically; however, you can code them in any order.

Precede the option list with three commas and enclose the group of options in parentheses.

Start options that are entered on the START command must be separated by commas. Do not leave any blanks between options.

For more information on the START command, see z/OS Communications Server: SNA Operation.

Read syntax diagramSkip visual syntax diagram
Options
Read syntax diagramSkip visual syntax diagram NETID = network_id SSCPID = sscp_id SSCPNAME = name AFFDELAY=600AFFDELAY=number_of_secondsAIMON=NONEAIMON=NONEIQDIOISMQDIOROCE
Read syntax diagramSkip visual syntax diagramALSREQ=NOALSREQ=YESNOAPI64R=YESAPI64R=NOAPPNCOS=NONE1APPNCOS=class-of-service_name
Read syntax diagramSkip visual syntax diagramASIRFMSG=OLUSSCPASIRFMSG=ALLSSCPOLUSSCPNONEASYDE=TERMASYDE=KEEPTERMAUTHLEN=YESAUTHLEN=NOYESAUTORTRY=AUTOCAPAUTORTRY=AUTOCAPCDRMALLNONEAUTOTI=0AUTOTI=time_period
Read syntax diagramSkip visual syntax diagramBN=NO2BN=NOYESBNDYN=LIMITED3BNDYN=LIMITEDNONEFULLBNORD=PRIORITY4BNORD=PRIORITYDEFINED
Read syntax diagramSkip visual syntax diagramBSCMDRS=(STATS,INOPS)BSCMDRS=STATSNOSTATS(,INOPS)(,NOINOPS)(STATS,INOPS,NOINOPSNOSTATS,INOPS,NOINOPS)BSCTMOUT=286BSCTMOUT=units_of_timepoolname=()Buffer Pool Values
Read syntax diagramSkip visual syntax diagramCACHETI=8CACHETI=number_of_minutesCDRDYN=YESCDRDYN=NOYES
Read syntax diagramSkip visual syntax diagramCDRSCTI=8MCDRSCTI=timeout_value
Read syntax diagramSkip visual syntax diagramCDSERVR=NO5CDSERVR=YESNO
Read syntax diagramSkip visual syntax diagramCDSREFER=16CDSREFER=number_of_CDSs
Read syntax diagramSkip visual syntax diagramCINDXSIZ=8176CINDXSIZ=table_sizeCMPMIPS=1007CMPMIPS=compression_ratioCMPVTAM=0CMPVTAM=compression_level
Read syntax diagramSkip visual syntax diagramCNMTAB=ISTMGC00CNMTAB=cnm_table_nameCNNRTMSG=SUPPRESSCNNRTMSG=SUPPRESSNOSUPP
Read syntax diagramSkip visual syntax diagramCOLDWARMCONFIG=00CONFIG=file_idfile_name
Read syntax diagramSkip visual syntax diagramCONNTYPE=APPN8CONNTYPE=APPNLENCPCDRSC=NOCPCDRSC=YESNO
Read syntax diagramSkip visual syntax diagramCPCP=LEASED9CPCP=YESNOLEASEDSWITCHEDCSALIMIT=0CSALIMIT=value(value,F)CSA24=0CSA24=valueCSDUMPCSDUMP Message TriggerCSDUMP Sense Code Trigger10
Read syntax diagramSkip visual syntax diagramDATEFORM=MDYDATEFORM=MDYDMYYMDDIALRTRY=YESDIALRTRY=YESNODIRSIZE=011DIRSIZE=number_of_resources
Read syntax diagramSkip visual syntax diagramDIRTIME=8D12DIRTIME=time_periodDISCNTIM=(15,0)DISCNTIM=(time_period1,time_period2)DLRORDER=(STATNID,FIRST)DLRORDER=STATNIDCPNAME(,FIRST)(,ONLY)(CPNAME,FIRST),ONLY(STATNID,FIRST),ONLY
Read syntax diagramSkip visual syntax diagramDLRTCB=32DLRTCB=number_of_task_control_blocksDLURSAW=YES13DLURSAW=YESNODSACTION=(SYSLOG,NONE,ALL)DSACTION=(SYSLOGCONSOLESYSLOG,NONESENSETERMNONEALLmsg_countALL)DSCOUNT=1DSCOUNT=number_of_buffersDSIRFMSG=NONEDSIRFMSG=ALLSSCPOLUSSCPNONE14DSMONITR=NODSMONITR=APPLNOYESDSPLYDEF=10015DSPLYDEF=number_of_messagesDSPLYMAX=65535DSPLYMAX=number_of_messagesDSPLYWLD=FULLWILDDSPLYWLD=FULLWILDNOWILDOPERONLYPOAONLY
Read syntax diagramSkip visual syntax diagramDSTRUST=NONEDSTRUST=NONEALL(,CDRSCDLURLOCALAPPLOCALLUTELNET)DUPDEFS=ALLDUPDEFS=ALLNONEAPPLDEPLU
Read syntax diagramSkip visual syntax diagramDVLSTCNT=2048DVLSTCNT=2048409681921638416DYNADJCP=YES17DYNADJCP=YESNODYNASSCP=YESDYNASSCP=YESNODYNDLGMD=NONEDYNDLGMD=logmode_nameNONEDYNHPPFX=prefix18DYNLU=NODYNLU=YESNODYNMODTB=NONEDYNMODTB=table_nameNONEDYNPUPFX=CNDYNPUPFX=prefixDYNVNPFX=CNVDYNVNPFX=prefix
Read syntax diagramSkip visual syntax diagramEEHPRANR=NOEEHPRANR=NOYES19EEPORTCK=NOEEPORTCK=NOYESEEVERIFY=ACTIVATEEEVERIFY=ACTIVATENEVERNumber_of_minutes20ENCRPREF=NONEENCRPREF=NONEvalueENCRYPTN=YESENCRYPTN=YESNOCCA21CUSP2431ENHADDR=NOENHADDR=NOYESENSEMBLE=NOENSEMBLE=NOYES22
Read syntax diagramSkip visual syntax diagramESIRFMSG=ALLSSCPESIRFMSG=ALLSSCPOLUSSCPNONEEXPFLTRM=0EXPFLTRM=expedited_flow_count
Read syntax diagramSkip visual syntax diagramFLDTAB=ISTMSFLDFLDTAB=table_nameNONEFSIRFMSG=OLUSSCPFSIRFMSG=ALLSSCPOLUSSCPNONE
Read syntax diagramSkip visual syntax diagramGVBKDLY=NOGVBKDLY=NOYES
Read syntax diagramSkip visual syntax diagramHNTSIZE=4080HNTSIZE=table_sizeGWSSCP=YESGWSSCP=YESNOHNTSIZE=4080HNTSIZE=table_sizeHOSTNAME=fully_qualified_hostname23HOSTPU=ISTPUSHOSTPU=host_subarea_pu_nameHOSTSA=1HOSTSA=subarea_number24HOTIOTRM=0HOTIOTRM=percentage_of_buffer_pool
Read syntax diagramSkip visual syntax diagramHPR=RTP25HPR=ANRRTPNONE(RTP,ANR)(RTP,NONE)(ANR,NONE)HPRCLKRT=STANDARD26HPRCLKRT=STANDARDADAPTIVEHPRITMSG=BASE27HPRITMSG=BASEENHANCEDHPRNCPBF=NOHPRNCPBF=YESNOHPRPSDLY=027HPRPSDLY=ps_delayHPRPSMSG=ALL27HPRPSMSG=ALLps_msg_countHPRPST=(8M,4M,2M,1M)HPRPST=(low_limit,med_limit,high_limit,network_limit)
Read syntax diagramSkip visual syntax diagramHPRSESLM=NOLIMIT27HPRSESLM=NOLIMITsess_limDISABLED28HPRSTALL=027HPRSTALL=0timeout_limitHSRTSIZE=9973HSRTSIZE=number_of_queue_pointers
Read syntax diagramSkip visual syntax diagramINITDB=ALL29INITDB=ALLDIRTOPONONE30313233INOPCODE=(ALL,ALL,DUMPDEFAULT)INOPCODE=(ALLALLmodulename,ALLALLinopcode,DUMPENABLEDUMPDISABLEDUMPDEFAULT
Read syntax diagramSkip visual syntax diagramINOPDUMP=OFFINOPDUMP=OFF34(OFF,,BASEIQDIOISMQDIOROCETCPXCFZCX)ON(ON,,BASEIQDIOISMQDIOROCETCPXCFZCX)
Read syntax diagramSkip visual syntax diagramIOINT=180IOINT=number_of_secondsIOMSGLIM=2147483647IOMSGLIM=number_of_message_pairsIOPURGE=0IOPURGE=timeout_value
Read syntax diagramSkip visual syntax diagramIPADDR=ip_address35
Notes:
  • 1 APPNCOS is meaningful only if the NODETYPE start option is also used.
  • 2 BN is meaningful only if the NODETYPE=NN start option is also used.
  • 3 BNDYN is meaningful only if the BN=YES start option is also used.
  • 4 BNORD is meaningful only if the BN=YES start option is also used.
  • 5 CDSERVR is meaningful only if the NODETYPE=NN start option is also used.
  • 6 CDSREFER is meaningful only if the NODETYPE=NN and CDSERVR=NO start options are also used.
  • 7 The CMPMIPS start option is meaningful only if the value for CMPVTAM is greater than 1.
  • 8 CONNTYPE is meaningful only if the NODETYPE start option is also used.
  • 9 CPCP is meaningful only if the NODETYPE start option is also used.
  • 10 Specify the CSDUMP start option twice to set both message and sense code triggers.
  • 11 DIRSIZE is meaningful only if the NODETYPE=NN start option is also used.
  • 12 DIRTIME is meaningful only if the NODETYPE=NN start option is also used.
  • 13 DLURSAW is meaningful only if the NODETYPE=NN start option is also used.
  • 14 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).
  • 15 If the DSPLYMAX start option value is less than 100, that value is the default for DSPLYDEF.
  • 16 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.
  • 17 DYNADJCP is meaningful only if the NODETYPE start option is also used.
  • 18 Two character prefix.
  • 19 EEHPRANR is meaningful only when the NODETYPE=NN start option is also used.
  • 20 The EEVERIFY start option is meaningful only if VTAM® provides RTP-level HPR support. The NODETYPE start option must be coded and the RTP value must be specified on the HPR start option.
  • 21 ENCRYPTN=CCA needs to be coded when Triple Des Encryption is required.
  • 22 The ENSEMBLE setting is used to either permit or deny connectivity to the intraensemble data network and the intranode management network. It does this by either allowing or denying activation of OSX and OSM interfaces.
  • 23 HOSTNAME is meaningful only if the NODETYPE start option is also used. If neither HOSTNAME nor IPADDR is specified on any of the GROUP definition statements within the Enterprise Extender XCA major node, then either the HOSTNAME, TCPNAME, or IPADDR start options must be specified in order to activate an Enterprise Extender link. The HOSTNAME start option specifies the default hostname to be used for name-to-address resolution as part of activating an Enterprise Extender connection, and must resolve at this node to a static VIPA address associated with a TCP/IP stack at this node. If IPADDR is specified along with HOSTNAME on the START command, the IPADDR value is ignored.
  • 24 HOSTSA specifies the subarea number of this VTAM. If HOSTSA is not coded, then a default subarea number of 1 is used.
  • 25 HPR is meaningful only if NODETYPE is also used.
  • 26 HPRCLKRT=ADAPTIVE is meaningful only in Enterprise Extender configurations that have a defined capacity of 1 Gb (gigabit) or higher access speeds.
  • 27 This option is meaningful only if VTAM provides RTP-level HPR support.
  • 28 HPRSESLM=DISABLED is meaningful only on interchange nodes.
  • 29 INITDB is meaningful only if the NODETYPE=NN start option is also used.
  • 30 When specifying an InOpCode for the second parameter, always specify three digits by including any leading zeros.
  • 31 If an InOpCode is specified for the second parameter, the first parameter cannot be ALL.
  • 32 INOPCODE has no effect unless INOPDUMP is active for the resource when an inoperative condition is detected. See the MODIFY INOPCODE command in z/OS Communications Server: SNA Operation for more details.
  • 33 Multiple INOPCODE parameters can be specified by the START command, and will be processed left to right as they are entered. This is different from specifying the INOPCODE parameter on either the MODIFY INOPCODE command or the MODIFY VTAMOPTS command, where only one INOPCODE parameter is allowed for each entry of these commands.
  • 34 INOPDUMP status is propagated to resources that are defined within a TRLE when the entry is activated.
  • 35 IPADDR is meaningful only if the NODETYPE start option is also used. If neither IPADDR nor HOSTNAME is specified on any of the GROUP definition statements within the Enterprise Extender XCA major node, then either the HOSTNAME, TCPNAME, or IPADDR start option must be specified in order to activate an Enterprise Extender link. The IPADDR start option specifies the default IPv4 or IPv6 static VIPA address to be used when activating an Enterprise Extender connection. If HOSTNAME is specified along with IPADDR on the START command, the IPADDR value is ignored.
Read syntax diagramSkip visual syntax diagramIPINFO=SENDALLIPINFO=SENDALLSNDLOCALDISPONLYNONEIQDCHPID=ANYIQDCHPID=ANYNONECHPID1IQDIOSTG=MAX2IQDIOSTG=MAXAVGMIN
Read syntax diagramSkip visual syntax diagramIRNSTRGE=0IRNSTRGE=sizeISTCOSDF=INDLUISTCOSDF=ALLAPPLDEPLUINDLUNONE(APPLDEPLUINDLU)
Read syntax diagramSkip visual syntax diagramLIMINTCP=number_of_secondsLIST=003LIST=start_option_list_idLSIRFMSG=NONELSIRFMSG=ALLNNSOLUNNSNONE4LISTBKUP=start_option_list_idDEFAULTSPROMPT5
Read syntax diagramSkip visual syntax diagramMAINTLVL=maintenance_levelMAXEETST=500MAXEETST=max_ee_connectivity_testsMAXHNRES=100MAXHNRES=max_hostname_resolutionsMAXLOCAT=50006MAXLOCAT=max_locate_congestion_threshholdMAXLURU=6144MAXLURU=ru_lengthMAXSSCPS=10MAXSSCPS=number_of_SSCPsMAXSUBA=15MAXSUBA=maximum_subarea_number
Read syntax diagramSkip visual syntax diagramMIHTMOUT=1800MIHTMOUT=units_of_timeMPCACT=WAITMPCACT=NOWAITWAITMSGLEVEL=BASEMSGLEVEL=BASEV4R1V4R2V4R3V4R4CS390MSGMOD=NOMSGMOD=NOYES
Read syntax diagramSkip visual syntax diagramMULTPATH=NO7MULTPATH=NOTCPVALUEMXSAWBUF=10000MXSAWBUF=number_of_buffersMXSSCPRU=4096MXSSCPRU=ru_lengthMXSUBNUM=511MXSUBNUM=2555111023204740958191163833276765535
Read syntax diagramSkip visual syntax diagramNACPROBE=NODUMPNACPROBE=NODUMPDUMPNumber_of_minutesNMVTLOG=NPDANMVTLOG=ALWAYSNEVERNPDANNSPREF=NONE8NNSPREF=network_node_server
Read syntax diagramSkip visual syntax diagramNODELST=nameNODETYPE=ENNN9NQNMODE=NAMENQNMODE=NAMENQNAMENSRTSIZE=(netid,size)NUMTREES=100NUMTREES=number_of_routing_trees10
Read syntax diagramSkip visual syntax diagramOSIEVENT=PATTERNSOSIEVENT=ALLNONEPATTERNSOSIMGMT=NOOSIMGMT=YESNOOSITOPO=(ILUCDRSC)OSITOPO=ALLCDRSCILUCDRSCOSRTSIZE=43OSRTSIZE=number_of_queue_pointers
Read syntax diagramSkip visual syntax diagramPDTRCBUF=2PDTRCBUF=number_of_buffersPIUMAXDS=200PIUMAXDS=calculation_factorPLUALMSG=NOSUPPPLUALMSG=SUPPRESSNOSUPPPMTUD=TCPVALUE11PMTUD=TCPVALUENOPPOLOG=NOPPOLOG=NOYES
Read syntax diagramSkip visual syntax diagramPROMPT12NOPROMPTPSRETRY=(0,0,0,0,SCHED)PSRETRY=(0low_tp_int,0med_tp_int,0high_tp_int,0network_tp_int,SCHEDIMMEDSCHED)PSSTRACE=NORBPSSTRACE=NORBIRBSRBBOTH
Read syntax diagramSkip visual syntax diagramQDIOSTG=MAX13QDIOSTG=MAXAVGMINNNN
Read syntax diagramSkip visual syntax diagramRESUSAGE=10014RESUSAGE=usage_limitROUTERES=12815ROUTERES=resistance_valueRSIRFMSG=ALLSSCPRSIRFMSG=ALLSSCPOLUSSCPNONE
Read syntax diagramSkip visual syntax diagramSACONNS=YESSACONNS=NOYESSAVERSCV=(NO,KEEP)SAVERSCV=(,FREE)(,KEEP)NO(NO,FREE)(NO,KEEP)YES(YES,FREE)(YES,KEEP)SAWDATA(SAWDATA,FREE)(SAWDATA,KEEP)SAWMAXDS=100SAWMAXDS=calculation_factorSAWMXQPK=0SAWMXQPK=calculation_factor
Read syntax diagramSkip visual syntax diagramSDLCMDRS=YESSDLCMDRS=(STATS,INOPS)SDLCMDRS=YESNOSTATSNOSTATS(,INOPS)(,NOINOPS)(STATS,INOPS,NOINOPSNOSTATS,INOPS,NOINOPS)SECLVLCP=ADAPT16SECLVLCP=LEVEL1LEVEL2ADAPTSIRFMSG=ALLSSCPSIRFMSG=ALLSSCPOLUSSCPNONE
Read syntax diagramSkip visual syntax diagramSLOWVAL=(0,0)SLOWVAL=warn_time(warn_time,end_time)SLUALMSG=NOSUPPSLUALMSG=SUPPRESSNOSUPPSMEAUTH=DISCARDSMEAUTH=DISCARDEXITKEEP
Read syntax diagramSkip visual syntax diagramSNAMGMT=NOSNAMGMT=YESNOSNAPREQ=1000SNAPREQ=number_of_requestsSNVC=317SNVC=subnet_visit_count
Read syntax diagramSkip visual syntax diagramSONLIM=(60,30)SONLIM=(percent_1,percent_2)(percent_1)(,percent_2)SORDER=APPN18SORDER=ADJSSCPAPPNAPPNFRSTSUBAREASRCHRED=OFFSRCHRED=OFFONSRCOUNT=1019SRCOUNT=number_of_search_requestsSRTIMER=3020SRTIMER=number_of_seconds
Read syntax diagramSkip visual syntax diagramSSCPDYN=YES21SSCPDYN=NOYESSSCPORD=PRIORITYSSCPORD=DEFINEDPRIORITYSSDTMOUT=30SSDTMOUT=number_of_secondsSSEARCH=YES22SSEARCH=YESNOCACHEAPPNFRST
Read syntax diagramSkip visual syntax diagramSTRGR=ISTGENERICSTRGR=ISTGENERICNONEstructure_nameSTRMNPS=ISTMNPSSTRMNPS=ISTMNPSNONEstructure_nameSUPP=NOSUPSUPP=NOSUPINFOWARNNORMSERSWNORDER=(CPNAME,FIRST)SWNORDER=CPNAMESTATNID(,FIRST)(,ONLY)(CPNAME,FIRST),ONLY(STATNID,FIRST),ONLY
Read syntax diagramSkip visual syntax diagramTCPNAME=tcp_job-name23TDUDIAG=100024TDUDIAG=resource_thresholdALWAYSNEVER
Read syntax diagramSkip visual syntax diagramTOPOTIME=topology_gc_time25NOTNSTATTNSTAT,NOCNSL,CNSL,TIME=60,TIME=minutes
Read syntax diagramSkip visual syntax diagramNOTRACE,TYPE=BUF26TRACE,TYPE=BUFBUF Trace Operands27NOTRACE,TYPE=IO26TRACE,TYPE=IOIO Trace Operands27
Read syntax diagramSkip visual syntax diagramNOTRACE,TYPE=LINE26TRACE,TYPE=LINELINE Trace Operands27
Read syntax diagramSkip visual syntax diagramNOTRACE,TYPE=MODULE26TRACE,TYPE=MODULE,MODULE Trace Operands27
Read syntax diagramSkip visual syntax diagramNOTRACE,TYPE=QDIOSYNC 26,ID=*,ID=*trle_nameTRACE,TYPE=QDIOSYNCQDIOSYNC trace operands 27
Read syntax diagramSkip visual syntax diagramNOTRACE,TYPE=SIT26TRACE,TYPE=SITSIT Trace Operands27
Read syntax diagramSkip visual syntax diagramNOTRACE,TYPE=SMS26TRACE,TYPE=SMS,ID=VTAMBUF27
Read syntax diagramSkip visual syntax diagramNOTRACE,TYPE=STATE26TRACE,TYPE=STATESTATE Trace Operands27
Notes:
  • 1 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 in z/OS Communications Server: SNA Operation.
  • 2 This option affects only iQDIO devices that use a MFS of 64k. The smaller frame sizes will always use 126 SBALs. You can override this option on a per-device basis using the READSTORAGE parameter on the LINK or INTERFACE statement in the TCP/IP profile. See z/OS Communications Server: IP Configuration Reference for more details.
  • 3 LIST can be entered by a VTAM operator only. If LIST is coded in an ATCSTRxx file, it is considered to be an error and is ignored.
  • 4 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).
  • 5 LISTBKUP can be coded only in a start option file. If you enter it on the START command or at an operator prompt, VTAM will ignore it.
  • 6 MAXLOCAT is meaningful only if NODETYPE is specified.
  • 7 MULTPATH is meaningful only if the NODETYPE start option is also specified.
  • 8 NNSPREF can be specified only if NODETYPE=EN is specified during VTAM START processing.
  • 9 NODETYPE enables APPN function. The combination of HOSTSA, NODETYPE, and SACONNS determines the configuration (subarea node, interchange node, migration data host, network node, or end node).
  • 10 NUMTREES is meaningful only if the NODETYPE=NN start option is also used.
  • 11 PMTUD is meaningful only if the NODETYPE start option is also specified.
  • 12 A VTAM operator cannot enter the PROMPT or NOPROMPT start option; it can be coded only in ATCSTR00. The value coded in ATCSTR00 is ignored if start options are entered on the START command or if VTAM finds an error in a start list. Upon finding an error in a start list, VTAM prompts the operator so that the operator can specify the option correctly.
  • 13 QDIOSTG defaults to MAX. To understand the meaning of the various keywords on QDIOSTG, see QDIOSTG start option in z/OS Communications Server: SNA Resource Definition Reference. To see the amount of read storage being used for a specific QDIO datapath device, use the DISPLAY TRLE command. You can override the QDIOSTG value on a per-device basis using the READSTORAGE parameter on the LINK or INTERFACE statement in the TCP/IP profile. See z/OS Communications Server: IP Configuration Reference for more details.
  • 14 RESUSAGE is meaningful only if the NODETYPE=NN start option is also used.
  • 15 ROUTERES is meaningful only if the NODETYPE=NN start option is also used.
  • 16 The SECLVLCP start option is meaningful only if the NODETYPE and VERIFYCP start options are also used.
  • 17 SNVC is meaningful only if the BN=YES start option is also used.
  • 18 SORDER is meaningful only in an interchange node or a migration data host.
  • 19 SRCOUNT is meaningful only if the SRCHRED=ON start option is also used.
  • 20 SRTIMER is meaningful only if the SRCHRED=ON start option is also used.
  • 21 The SSCPDYN start option applies only for interconnected networks (that is, GWSSCP=YES is used).
  • 22 SSEARCH is meaningful only if the NODETYPE=NN start option is also used.
  • 23 TCPNAME is meaningful only if the NODETYPE start option is also used. If neither IPADDR nor HOSTNAME is specified on any of the GROUP definition statements within the Enterprise Extender XCA major node, then either the HOSTNAME, TCPNAME, or IPADDR start options must be specified in order to activate an Enterprise Extender link.
  • 24 TDUDIAG is meaningful only if the NODETYPE=NN start option is also available.
  • 25 TOPOTIME is meaningful only if the NODETYPE start option is also used.
  • 26 Do not use NOTRACE when starting VTAM, except to override a TRACE start option coded in a predefined list.
  • 27 You can code TRACE and its qualifiers through position 71, even if you are in the middle of the start option. Continue the remainder of the item in the next record. Code the TYPE qualifier immediately after you code the TRACE start option.
Read syntax diagramSkip visual syntax diagramTRACE,TYPE=VTAM,VIT Operands2NOTRACE,TYPE=VTAM1
Read syntax diagramSkip visual syntax diagramTRANSLAT=(0,1,2,3,4,5,6,7)TRANSLAT=value()(OLUALIAS0DLUREAL1DLUSSCP2COSNAME3LOGMODES4LUANAME5USERVAR6DLUALIAS7)
Read syntax diagramSkip visual syntax diagramUNRCHTIM=(0,10)3UNRCHTIM=unreachable_time(,partner_limit)(unreachable_time,partner_limit)
Read syntax diagramSkip visual syntax diagramUPDDELAY=604UPDDELAY=max_time
Read syntax diagramSkip visual syntax diagramUSSTAB=table_nameVARYWLD=FULLWILDVARYWLD=FULLWILDNOWILDOPERONLYPOAONLYVERIFYCP=NONE5VERIFYCP=NONEOPTIONALREQUIRED
Read syntax diagramSkip visual syntax diagramVFYRED=YESVFYRED=YESNOVFYREDTI=OFF6VFYREDTI=OFF0reduction_timerVITCTRL=BASE7VITCTRL=FULLVOSDEACT=NOVOSDEACT=YESNOVRTG=NO8VRTG=YESNOVRTGCPCP=YES9VRTGCPCP=YESNOVTAMEAS=32001VTAMEAS=number_of_concurrent_sessions
Read syntax diagramSkip visual syntax diagramXCFGRPID=group_idXCFINIT=YES10XCFINIT=NOYESDEFINE
Read syntax diagramSkip visual syntax diagramXNETALS=NOXNETALS=NOYES
Buffer Pool Values
Read syntax diagramSkip visual syntax diagram ( baseno , bufsize , slowpt , F , xpanno , xpanpt , xpanlim )
Read syntax diagramSkip visual syntax diagram
BUF Trace Operands
Read syntax diagramSkip visual syntax diagram , ID = node_name ,EVERY,AMOUNT=PARTIAL,AMOUNT=FULLPARTIAL,IDTYPE=RESOURCE,IDTYPE=CPSSCPRESOURCE,SAVE=NO,SAVE=NOYES
Read syntax diagramSkip visual syntax diagram
CSDUMP message trigger
Read syntax diagramSkip visual syntax diagram , MESSAGE = message_id_numberIST1504I,REMOTE=NO,REMOTE=NOYES(IST1504I,message_value_field),REMOTE=NO,REMOTE=NOYES(message_id_number,message_value_field) ,TCPNM=TCPIP_Jobname,RNICTRLE=MSGVALUE12RNIC_TRLEName,MATCHLIM=1,MATCHLIM=matchlim_value
CSDUMP sense code trigger
Read syntax diagramSkip visual syntax diagram , SENSE = sense_code1314 ,RU=ru_code ,TCPNM=TCPIP_Jobname,MATCHLIM=1,MATCHLIM=matchlim_value
IO Trace Operands
Read syntax diagramSkip visual syntax diagram , ID = node_name ,EVERY,IDTYPE=RESOURCE,IDTYPE=CPSSCPRESOURCE,SAVE=NO,SAVE=NOYES
LINE Trace Operands
Read syntax diagramSkip visual syntax diagram , ID = line_name ,COUNT=ALL,COUNT=ALLnumber_of_bytes
MODULE Trace Operands
Read syntax diagramSkip visual syntax diagram , OPTION = ALLoption(option)(COMMANDCONNECTIONSDEFINITIONINTERFACESMANAGEMENTNOEXITSESSION)
QDIOSYNC trace operands
Read syntax diagramSkip visual syntax diagram,ID=*,ID=*trle_name,OPTION=ALLINOUT,OPTION=ALLINALLINOUTALLOUTININOUTOUT,SYNCID=trle_name,SYNCID=identifier,SAVE=YES,SAVE=NOYES
SIT Trace Operands
Read syntax diagramSkip visual syntax diagram , ID = line_name ,COUNT=ALL,COUNT=ALLnumber_of_bytes15,TRACEPT=trace_point_id
STATE Trace Operands
Read syntax diagramSkip visual syntax diagram,ID=node_nameOperands used with IDOPTION Operand
Operands used with ID
Read syntax diagramSkip visual syntax diagram,IDTYPE=RESOURCE,IDTYPE=CPSSCPRESOURCE
OPTION Operand
Read syntax diagramSkip visual syntax diagram , OPTION = ALLoption(option)(ADJCPAPPLCDRMCDRSCGROUPLINELNKSTLUNCPPU)
Notes:
  • 1 NOTRACE,TYPE=VTAM is accepted but ignored. Tracing is started with the default trace table size and the default options. The NOTRACE,TYPE=VTAM start option processing is affected by the level of VIT control being used (as specified by the VITCTRL start option). See z/OS Communications Server: SNA Diagnosis Vol 2, FFST Dumps and the VIT for details.
  • 2 You can code TRACE and its qualifiers through position 71, even if you are in the middle of the start option. Continue the remainder of the item in the next record. Code the TYPE qualifier immediately after you code the TRACE start option.
  • 3 UNRCHTIM is meaningful only if the NODETYPE start option is also used.
  • 4 UPDDELAY is meaningful only if the OSIMGMT=YES start option is also used.
  • 5 The VERIFYCP start option is meaningful only if the NODETYPE start option is also used.
  • 6 VFYREDTI is meaningful only if the NODETYPE=NN start option is also used.
  • 7 VITCTRL start option will only affect the TRACE or NOTRACE start option if it is specified prior to the TRACE or NOTRACE TYPE=VTAM (MODE=INT) start option.
  • 8 VRTG is meaningful only if the NODETYPE and HOSTSA start options are also used.
  • 9 VRTGCPCP is meaningful only if the NODETYPE and HOSTSA start options are also used.
  • 10 XCFINIT=YES is the default if VTAM is started as an APPN node (that is, the NODETYPE start option has been specified). XCFINIT=YES is not valid for pure subarea nodes. XCFINIT=DEFINE is the default if VTAM is started as a pure subarea node (the NODETYPE start option has not been specified).
  • 11 When the same parameter is entered multiple times on a CSDUMP message trigger, only the last occurrence is accepted.
  • 12 MSGVALUE is valid only when the MESSAGE operand is used and specifies either message IST2391I, IST2406I or IST2419I.
  • 13 When an error message is received on any parameter of the CSDUMP start option, the remaining parameters for this CSDUMP start option are ignored. Enter the complete CSDUMP start option again when you are prompted.
  • 14 When the same parameter is entered multiple times on a CSDUMP sense trigger, only the last occurrence is accepted.
  • 15 COUNT applies only to the IBM® 3720 and 3745 Communication Controllers.
VIT Operands
Read syntax diagramSkip visual syntax diagram,MODE=INT,SIZE=4M,MODE=EXT,BFRNUM=2,BFRNUM=numberINT,SIZE=size,OPTION=(API,CIO,MSG,NRM,PIU,PSS,SSCP)12,SUBTRACE=ARBP,OPTION=HPR3ALLhprgrpopt(..,HPR,..)4(..,hprgrpopt,..),SUBTRACE=DIO,OPTION=CIA5ALLciagrpopt(..,CIA,..)6(..,ciagrpopt,..),SUBTRACE=TGVCTREE,OPTION=SSCP7ALLgroupopt(..,SSCP,..)8(..,groupopt,..),OPTION=ALLNONEoption(option)(APIAPIOPTSAPPCAPPCOPTSCFSCIACIOCMIPCPCPOPTSCSMCSMOPTSDLUROPTSEEOPTSESCHPDTOPTSHPRHPROPTSLCSLCSOPTSLOCKMSGNRMPIUPSSQDIOOPTSSMSSSCPSTDOPTSTCPTCPOPTSVCNSXBUFXCFXCFOPTS)
Notes:
  • 1 The default options apply only to MODE=INT.
  • 2 PSS is a default VIT option, but PSS can be turned off.
  • 3 When you specify SUBTRACE=ARBP and you code a single OPTION value, the OPTION value must be HPR, ALL, or one of the group options (hprgrpopt) that include HPR as an individual option equivalent. The applicable group options are DLUROPTS, EEOPTS, HPDTOPTS, HPROPTS, QDIOOPTS, and XCFOPTS.
  • 4 When SUBTRACE=ARBP is coded and you code multiple trace options in parentheses, you must code either HPR or one of the group options (hprgrpopt) that include HPR as an individual option equivalent inside the parentheses.
  • 5 When you specify SUBTRACE=DIO and you code a single OPTION value, the OPTION value must be CIA, ALL, or one of the group options (ciagrpopt) that include CIA as an individual option equivalent. The applicable group options are EEOPTS, HPDTOPTS, HPROPTS, QDIOOPTS, TCPOPTS and XCFOPTS.
  • 6 When SUBTRACE=DIO is coded and you code multiple trace options in parentheses, you must code either CIA or one of the group options (ciagrpopt) that include CIA as an individual option equivalent inside the parentheses.
  • 7 When you code SUBTRACE=TGVC or SUBTRACE=TREE and you code a single OPTION value, the OPTION value must be either SSCP, ALL, or one of the group options (groupopt), all of which include SSCP as an individual option equivalent. The group options are APIOPTS, APPCOPTS, CPCPOPTS, CSMOPTS, DLUROPTS, EEOPTS, HPDTOPTS, HPROPTS, LCSOPTS, QDIOOPTS, STDOPTS, TCPOPTS, and XCFOPTS.
  • 8 When you code SUBTRACE=TGVC or SUBTRACE=TREE and you code multiple trace options in parentheses, you must code either SSCP or one of the group options (groupopt) inside the parentheses.