Draintarget, Force | HP UX Internet and Networking Software instruction

Administration Commands

reset_session_limit

YES

Reset the maximum negotiable session limit for this LU-LU-mode combination to 0 (so that sessions cannot be activated until the limit is changed by initialize_session_limit).

NO

Leave the maximum negotiable session limit unchanged.

responsible

Indicates whether the source (local) or target (partner) LU is responsible for deactivating sessions after the session limit is reset. Possible values are:

SOURCE

The local LU is responsible for deactivating sessions.

TARGET

The partner LU is responsible for deactivating sessions.

drain_source

Speciﬁes whether the source LU satisﬁes waiting session requests before deactivating a session. Possible values are:

YES

Waiting session requests are satisﬁed.

NO

Waiting session requests are not satisﬁed.

drain_target

Speciﬁes whether the target LU satisﬁes waiting session requests before deactivating a session. Possible values are:

YES

Waiting session requests are satisﬁed.

NO

Waiting session requests are not satisﬁed.

force

Speciﬁes whether to set session limits to 0 even if CNOS negotiation fails. Possible values are:

YES

Set session limits to 0.

NO

Do not set session limits to 0 even if CNOS negotiation fails.

2.182.2 Returned Parameters

If the command executes successfully, SNAplus2 returns the following parameters:

primary_rc

OK

secondary_rc

576

Image 576

HP UX Internet and Networking Software manual Draintarget, Force

Contents

HP-UX SNAplus2 R7 Administration Command Reference Contents Supplied Parameters Supplied Parameters Returned Parameters Error Return Codes 120 133 199 251 258 273 288 312 330 358 393 434 468 516 550 571 593 Appendix a Common Return Codes from snapadmin Commands Appendix C Warranty Government LicenseCopyright Notices Trademark Notices Publishing History New and Changed Information in This Edition Prerequisite Knowledge About This BookOrganization of This Book Typographic Conventions SNAplus2 Publications Publications for UsersHP-UX SNAplus2 General Information HP-UX SNAplus2 3270 User’s Guide Publications for Administrators Publications for Programmers Related Publications HP-UX SNAplus2 LUA Programmer’s GuideHP-UX SNAplus2 CSV Programmer’s Guide HP-UX SNAplus2 MS Programmer’s Guide Introduction to SNAplus2 Administration Commands Using snapadmin Command Line Options Changing Speciﬁc Parameters Parameter Syntax Used for Administration Commands Using Command Line Help Default Parameter Values Subrecords in Administration Commands Numentries ListoptionsFirstinlist Listinclusive Examples of Administration Commands Defineethernetdlc, dlcname = DLCNAME, initiallyactive = YES Activatesession Supplied Parameters Error Return Codes Returned Parameters Addbackup State Check Backupname Adddlctrace Resourcetype Resourcename Sidh SidlOdai Messagetype Aping Tpname SecurityPwd Userid Dlen ConsecEcho Iterations Avgtime MaxtimePartnerverdata Sensedata Changesessionlimit Setnegotiable Plumodesessionlimit MinconwinnerssourceMinconwinnerstarget Autoact Modename parameter did not match any deﬁned mode name Deactivateconvgroup Deactcleanup ConvgroupidType Deactnormal Deactivatelu0to3 Deactivatesession Plualias Deﬁne3270diag Rtmoverﬂow Rtmtimeroption RtmunbindRtmthresh1 through rtmthresh4 Description 10 deﬁneadjacentlennode Parameter1 through parameter3 Cpname Wildcardlus 11 deﬁnecn Fqcnname EffectcapConnectcost Bytecost Propdelay Userdefparm1 through userdefparm3Portname 12 deﬁnecos Function Not Supported Cosname Transmissionpriority Minpropdelay MineffectcapMinconnectcost Minbytecost Maxpropdelay Minuserdefparm1 through minuserdefparm3Maxeffectcap Maxconnectcost Weight Maxuserdefparm1 through maxuserdefparm3Minrar Minstatus Weight associated with this node row 13 deﬁnecpicsideinfo SymdestnamePartnerluname Tpnametype Securitypassword ConversationsecuritytypeProgram Programstrong 14 deﬁnedefaultpu Puname 15 deﬁnedefaults Implicitpluforbidden Limitedtimeout 16 deﬁnedirectoryentrySpeciﬁcsecuritycodes Encpresource NncpresourceLuresource Wildcardluresource Parenttype 17 deﬁnedlurdefaults Invaliddlusname 18 deﬁnedomainconﬁgﬁle 19 deﬁnedownstreamluComment Allowtimeout DelayedlogonDsluname Nauaddress Supplied NAU address was not in the valid range 20 deﬁnedownstreamlurange Dslubasename MinnauMaxnau Returned Parameters 21 deﬁnedsputemplate Templatename ModifytemplateMaxinstance Hostlu Name speciﬁed for the templatename parameter was not valid 22 deﬁneemulatoruser Normal Username StyleﬁleMaxactsessions Viewrtm Alertpermission ChangeluChangestyle Userisgroup Sessionname SessiontypeModeloverride Locallualias 5250DISPLAY5250PRINTER 23 deﬁneethernetdlc 24 deﬁneethernetls25 deﬁneethernetport 26 deﬁnefddidlc 28 deﬁnefddiport 29 deﬁnefocalpoint Application is the main focal point 30 deﬁneinternalpu Puid InitiallyactiveDddluofﬂinesupported Puname parameter contained a character that was not valid 31 deﬁneipdlc Udpportlow IpprecedencellcIpprecedencenetwork Ipprecedencehigh 32 deﬁneipls Learnnode Lsname AdjcpnameAdjcptype Lsapaddress AutoactsuppTgnumber Limitedresource Disableremoteact LinkdeacttimerDefaultnnserver Lsattributes Usedefaulttgchars AdjnodeidLocalnodeid Cpcpsesssupport Bytecost Reacttimer ReacttimerretryTargetpacingcount Maxsendbtusize Ipacktimeout MaxifrmrcvdBranchlinktype Adjbrnncpsupport Livenesstimeout ShortholdmodeRemoteiphost Limitedresource parameter was not set to a valid value 33 deﬁneipport Maxrcvbtusize TotlinkactlimInblinkactlim Outlinkactlim Actxidexchangelimit NonactxidexchangelimitRemotehostname Implicitcpcpsesssupport Implicitdeacttimer Ipacktimeout through shortholdmodeImplicituplinktoen Effectcap through userdefparm3 Localipinterface 34 deﬁnelocallu Incoming Calls Defaultpool ListnameSyncptsupport Lusessionlimit Disable TimeoutLuattributes Sscpid Disable parameter was not set to a valid value 35 deﬁnelsrouting Fqpartnerlu Wildcardfqplu 36 deﬁnelu0to3 Poolname PriorityLumodel Usenodedefault TermmethodSendunbind Sendtermself 37 deﬁnelu0to3range Basename Priority Nameattributes UsebasenumberUsehexinname Basenumber Basename parameter contained a character that was not valid 38 deﬁnelulupassword PasswordVeriﬁcationprotocol 39 deﬁnelupool Luname parameters can be speciﬁed Supplied parameters are 40 deﬁnelu62timeout GlobaltimeoutLocallutimeout Partnerlutimeout 41 deﬁnemode Defaultrusize MaxrusizeuppReceivepacingwin Maxnegsesslim MinconwinsrcMinconlosersrc Maxrusizelow Maxreceivepacingwin 42 deﬁnenode Nodename NodetypeFqcpname Cpalias Locatetimeout MdssupportedNodeid Maxlocates Mdssendalertqsize CoscachesizeTreecachesize Treecacheuselimit Storeendptrscvs StoreisrrscvsStoredlurrscvs Costableversion Disablebranchawareness CplusyncptsupportCpluattributes Dlursupport Puconcsupport NnrarMaxlsexceptionevents Maxcompressionlevel Immediatediscontact ImmediaterecontactSuppressreqdiscont Allowbbrqe Nodename parameter contained a character that was not valid 43 deﬁnepartnerlu Pluunname MaxmcllsendsizeConvsecurityver Parallelsesssupp 44 deﬁneqllcdlc Cardtype 45 deﬁneqllcls Useportdefaults Administration Commands deﬁneqllcls Address Solicitsscpsessions Dspuservices PuconcentrationDlur Hprsupported Adjnodeid Connectcost Userdefparm1 through userdefparm3 Lsrole LspriLssec Lsneg Vctype SVCPVC Locpacket Reqrevcharge LocwsizeRemwsize Fac Retrytimeout IdletimeoutPvcid Snid Invaliddspuname Solicitsscpsess parameter was not set to a valid value PU speciﬁed in the puname parameter has already been deﬁned 46 deﬁneqllcport Lsneg Portnumber Implicitdsputemplate Implicitdspuservices Lsxmitrcvcap Lstws Lstwa Implicithprsupport CudmodeCudmatch Addmode Vctype through idletimeout Addlen Lsrole parameter was not set to a valid value 47 deﬁnercfaccess UcfusernameSpcfpermissions 48 deﬁnerjewkstn AllowdefineremoteAllowactionremote Workstationname PrimaryuserGroupname Systemname 49 deﬁnertptuning Pathswitchattempts PathswitchtimelowPathswitchtimemedium Pathswitchtimehigh 50 deﬁnesdlcdlc Neglssupp Adapternumber MucreditStatssupport Numports 51 deﬁnesdlcls Administration Commands deﬁnesdlcls Description Address Limitedresource Dspuservices Hprsupported Adjnodeid Bytecost Targetpacingcount Contacttimer ContacttimerretryContacttimer2 Contacttimerretry2 Nvepolltimer NvepolltimerretryNvepolltimer2 Nvepolltimerretry2 Polloniframe Opt1Linesp Hmoddata Maxifrmrcvd Returned Parameters 196 State Check Modem Control Characters Escape Sequences for Modem Control Characters 52 deﬁnesdlcport Administration Commands deﬁnesdlcport Portswitched PortnonswitchedPorttype Actxidexchangelimit Implicit links to an End Node are uplinks Idletimer IdletimerretryNprcvtimer Nprcvtimerretry Linkconntimer LinkconntimerretryPrifdplx Secfdplx Maxxidsize Maxretrycount Opt2 Contacttimer through polloniframe RcvpoolsizePollwait Porttype parameter was not set to a valid value 53 deﬁnesecurityaccesslist 54 deﬁnetn3270access Defaultrecord Clientaddress Addressformat Tn3270supportAllowspeciﬁclu Printerluname 214 Using the Telnet Daemon’s TCP/IP Port 55 deﬁnetn3270association 56 deﬁnetn3270defaults Displayluname Forceresponses KeepalivemethodNOP Keepaliveinterval 57 deﬁnetp Enabled ConvtypeSecurityrqd Synclevel Tpinstancelimit 58 deﬁnetploadinfo Path Arguments GroupStdin Stdout 59 deﬁnetrdlc, deﬁneethernetdlc, deﬁnefddidlc Lantype DIX 60 deﬁnetrls, deﬁneethernetls, deﬁnefddils 226 227 Macaddress 229 230 Hprlinklvlerror 232 233 234 235 Testtimeout XidtimeoutT1timeout Testretrylimit 237 238 Bit Ordering in MAC Addresses 61 deﬁnetrport, deﬁneethernetport, deﬁnefddiport Reversing the Bit Order in a MAC Address 241 242 243 Implicitlinklvlerror Testtimeout through t1retrylimit 246 62 deﬁneuseridpassword DeﬁnetypeAdduser Addprofiles Deleteadjacentlennode 249 Deletebackup Deletecn Deletecos Deletecpicsideinfo Deletedirectoryentry 255 Deletedlc Deletedownstreamlu Deletedownstreamlurange Deletedsputemplate 259 260 Deleteemulatoruser Deleteoptions 3270SESSION5250SESSION Allsessions Backup DeletefocalpointActive Implicit Deleteinternalpu Deletelocallu Deletels Deletelsrouting 268 Deletelu0to3 Deletelu0to3range 271 Deletelulupassword Deletelupool Deletelu62timeout 275 Deletemode Deletepartnerlu Deleteport Deletercfaccess Deleterjewkstn Deletesecurityaccesslist Deletetn3270access 283 Deletetn3270association Deletetp Deletetploadinfo Deleteuseridpassword DeletetypeRemoveuser Removeprofiles Initnode Initializesessionlimit 289 290 291 292 Pathswitch Rtpconnectionname Path Switch Failure Query3270diag Alertnumber Rtmoverﬂow through numalerts Query3270user Scope Returned Parameters Summary Information Returned Parameters Detailed InformationUserpid Query3270usersessions 300 301 Queryactivetransaction Fqreqloccpname ReqagentapplnameSeqnumdt Fqorigincpname 304 Queryadjacentnn Adjnncpname Cpcpsessstatus OutofseqtdusLastfrsnsent Lastfrsnrcvd Queryavailabletp 308 Querybckcstrace Traceﬂags Resetmaxvalues Querybufferavailability Bufavail BuftotalcountBuftotalbytes Bufrsrvcount Querycentrallogger Querycentrallogging Querycn Numactports 316 Querycnport Tgnum Queryconversation 319 Administration Commands queryconversation Convid Localtpname PartnertpnameTpid Sessid Querycos Numofnoderows Numoftgrows Querycosnoderow TreesCalcs Rejs Minrar through weight Noderowindex Querycostgrow Tgrowindex 328 329 Querycpicsideinfo Partnerluname through lualias Querycstrace Destsys Tracedirection Querydefaultpu DefpunameDefpusess Querydefaults Querydirectoryentry Speciﬁcsecuritysensecodes 337 338 Realowningcptype Realowningcpname Administration Commands querydirectoryentry Entrytype Location SuppliercptypeSuppliercpname Querydirectorylu 343 Servername LuownernameWildcard Querydirectorystats Apparentluownername Maxcaches CurcachesCurhomeentries Curregentries Querydlc State Dlctype 350 Querydlctrace Listtype Alldlctraces 353 354 355 Querydlurdefaults Querydlurlu ﬁlter InternalDownstream Lulocation PlunameRscvlen Querydlurpu 361 Deﬁneddlusname Pulocation ActivedlusnameAnssupport Pustatus Pcid Querydlus Isdefault Isbackupdefault PipestateNumactivepus Reqactpusent Actlureceived ActlurspsentDactlureceived Dactlurspsent Majorversion through updaterelease QuerydomainconﬁgﬁleRevisionlevel Querydownstreamlu 371 Lusscpsessactive Plusessactive 373 Rcvrusize SendrusizeMaxsendpacwin Cursendpacwin Rcvdataframes RcvfmddataframesRcvdatabytes Pacingtype 376 Querydownstreampu Pusscpsessactive 379 380 Querydsputemplate Activeinstance Numofdslutemplates Queryemulatoruserdef Emulatortype ALL Numsessions 386 Queryfocalpoint 388 Bkupapplname BkupfpfqcpnameImplicitapplname Implicitfpfqcpname Querygloballogtype Succincterrors AuditException Succinctaudits Queryisrsession Dlursessions Isrsessions 394 Rscv SendrpcRcvrpc Sendfmddatabytes Rcvfmddatabytes Resetmaxused QuerykernelmemorylimitLimit Querylocallu ActualMaxused Listbyalias 400 Syncptsupport through backlevel Applconnactive Activesscpid Querylocaltopology Dest DesttypeVRN 405 Dlcdata RsnStatus Cpcpsessionactive Branchtg Backupﬁlename QuerylogﬁleLogﬁletype ﬁlename Querylogtype Override 410 Queryls 412 Actsesscount DetadjcpnameDetadjcptype 414 415 416 Substate Dynamic Migration InxidbytesInmsgbytes Inxidframes Determinedhprlinklvlerror BadxidsStarttime Stoptime Lstype DetbranchlinktypeAdjcpisbrnn Activeisrcount ActivelusesscountActivesscpsesscount Reverseanrlabel 423 424 425 426 427 428 Determinedipaddress Querylsrouting 431 Querylu0to3 Hostattachment DirectattachedDlurattached 434 Returned Parameters for All Application Types 436 437 Bindlutype Additional Returned Parameters for an LU Used by Apptype Usertype Returned Parameters for an LU Used by an RJE Workstation Puconcdownstreamlu Cfgdefault UseripaddressCbnumber Cfgaddress Querylulupassword Requestluname 444 Protocoldeﬁned Protocolinuse Querylupool Numactivelus Numavaillus 448 Querylu62timeout 450 451 Querymdsapplication Application Querymdsstatistics Maxrcvsize Alerterrorsrcvd UncorrelatedalerterrorsAlertssent Mdsmusrcvdlocal Parseerrors UnveriﬁederrorsQuerymode Faileddeliveries 456 Activesessions Sesslimit Drainsource Drainpartner ActcwcountActclcount Maxnegsesslimit Implicit Querymodedeﬁnition Maxrusizeupp through maxreceivepacingwin Querymodetocosmapping Querynmvtapplication Msvectorkeytype Querynntopologynode Conversionrequired 467 To Obtain Consistent Information Using the frsn Parameter Frsn Daysleft RarFunctionsupport Branchaware Querynntopologystats Nodestateupdates NodeerrorsNodetimerupdates Maxnodes Tgstateupdates TgerrorsTgtimerupdates Nodepurges Querynntopologytg Owner Ownertype 476 477 478 Subareanumber TgtypeIntersubnettg 480 Querynode 481 482 483 484 Hprsupport ERP BISSetsearchstatus Limittpsecurity Forcestandardarb Nnfunctionssupported Enfunctionssupported NnstatusNnfrsn Nnrsn Dynlsbadxids DlurreleaselevelFqnnservername Currentisrsessions Querynodeall Conﬁgrole Querynodelimits Maxlu62tps Maxluatps MaxfmapitpsMaxlinkstations Maxtn3270connections Peaktn3270connections PeakdatasessionsBranchnetworknode Networknode Tnserversupport BacklevelclientSslsupport Querypartnerlu 497 Partnercpname Partnerlulocated Convsecurity Securitydetails DuplexsupportPreference Querypartnerludeﬁnition 502 503 Queryport Portstate 506 507 Portsimrim Numimplicitlinks Abmlssupp Querypu LsapVersion 511 512 513 Dddlusupported Tcpcvsupported Queryrcfaccess Queryrjewkstn 517 Wkstnpid WkstnuidWkstngid Wkstngname Queryrjewkstndef Description through luname Queryrtpconnection Rtpname ﬁrsthoplsnameDestnodename Numsessactive 523 Livenesstimer ArbmodeMaxbtusize Localtcid Shortreqtimer BytesdiscardedPacketssent Packetsreceived Shortreqtimeouts LivenesstimeoutsDelaychangesum Dcsresetcountnonheal Queryrtptuning Route Querysecurityaccesslist Querysecurityaccesslist 529 Querysession Numusers 531 532 Transpri Contention 535 Sessiontimeout Sessionstarttime Querysnanet Querystatistics Domainname Resetstats NameStatstype Tabletype Returned Parameters Sdlc LS Statistics Index BlusinBlusout Octetsin Ioctetsout UiframesinUiframesout Xidsin Returned Parameters Sdlc LS Operational Information Maxdata ReplytoMaxin Maxout Returned Parameters Sdlc Port Statistics Returned Parameters Sdlc Port Operational Information ProtocolerrsActivitytos Rnrlimits Slowpolltimer TopologyActivto Pause Lsstmussent LsstmusreceivedLsstbytessent Lsstbytesreceived Lineerror InternalerrorBursterror Arifcierror Returned Parameters Enterprise Extender Querytn3270accessdef 552 553 554 Querytn3270association 556 Querytn3270defaults Querytnservertrace Querytp 559 560 Querytpdeﬁnition InstancelimitInstancecount Locallystartedcount 562 Listname through tpinstancelimit Querytploadinfo 565 Querytraceﬁle Traceﬁletype Dualﬁles Traceﬁlesizeﬁlename2 Querytracetype Truncationlength Queryuseridpassword Removedlctrace 572 573 Resetsessionlimit Modenameselect ONE Draintarget Force 577 578 Setbckcstrace Initﬂags Setﬂags Setbufferavailability Setcentrallogging Setcstrace Csadminmsg CsdatagramCsdata Cssend CsreceiveCsboth Setgloballogtype Leaveunchanged 586 Setkernelmemorylimit Setlogﬁle Action Backupfile NofileactionDeletefile Setlogtype 591 592 Settnservertrace FmapiCFG NOF Settraceﬁle 595 Settracetype Appc LUADlpi Sdlc Dgrm Startdlc Startinternalpu 601 Enable Startls Autoact Remoteact Startport Unsuccessful 605 Statusall Returned Information 607 Statusconnectivity Statusdependentlu Lutype Display RJELU6 Other Snapadmin statusdependentlu,puname=ETH0 LU62 Example 2-6 Returned Information for the statusdlur Command Statusdlur Example 2-7 Returned Information for the statuslu62 Command Statuslu62 Example 2-8 Returned Information for the statusnode Command Statusnode Statusremotenode Parameters Stopdlc StoptypeOrderlystop Immediatestop Stopinternalpu 619 Stopls 621 Stopport Termnode Deactclean AbortShutdown Quiesce Communications Subsystem Not Active Function Not Supported Parameter Check State Check System Error Initial Conﬁguration Files Conﬁguration File Format Record Ordering in a Conﬁguration File Record Format Subrecord Format File Input to the snapadmin Program Sample snapadmin Input Files Config1.cfg Sample Files Delivered with SNAplus2 Environment Variables That Affect All Functions Environment Variables That Affect 3270 EmulationLang Path SNAP3270LOWERRIGHT SNAP3270SI and SNAP3270SO Environment Variables That Affect RJE Workstations SNAP3270COLOR Environment Variables That Affect the CSV API Appcllu Environment Variables That Affect Tracing Columns Snatrunc Index 639 640 641 642 643 644 645 646 647 648 649 650 651