HP UX Internet and Networking Software instruction

HP-UX SNAplus2 R7 Administration Command Reference

HP-UX 11i v1,11i v2 and 11i v3

Edition: 4

Manufacturing Part Number: 5991–2742

April 2007

© 2007 Hewlett-Packard Development Company, L.P. All rights reserved.

Image 1

HP UX Internet and Networking Software manual HP-UX SNAplus2 R7 Administration Command Reference

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 Government License WarrantyCopyright Notices Trademark Notices New and Changed Information in This Edition Publishing History About This Book Prerequisite KnowledgeOrganization of This Book Typographic Conventions Publications for Users SNAplus2 PublicationsHP-UX SNAplus2 General Information HP-UX SNAplus2 3270 User’s Guide Publications for Programmers Publications for Administrators HP-UX SNAplus2 LUA Programmer’s Guide Related PublicationsHP-UX SNAplus2 CSV Programmer’s Guide HP-UX SNAplus2 MS Programmer’s Guide Introduction to SNAplus2 Administration Commands Command Line Options Using snapadmin Changing Speciﬁc Parameters Using Command Line Help Parameter Syntax Used for Administration Commands Default Parameter Values Subrecords in Administration Commands Listoptions NumentriesFirstinlist Listinclusive Defineethernetdlc, dlcname = DLCNAME, initiallyactive = YES Examples of Administration Commands Supplied Parameters Activatesession Returned Parameters Error Return Codes State Check Addbackup Adddlctrace Backupname Resourcename Resourcetype Sidl SidhOdai Messagetype Aping Security TpnamePwd Userid Consec DlenEcho Iterations Maxtime AvgtimePartnerverdata Sensedata Setnegotiable Changesessionlimit Minconwinnerssource PlumodesessionlimitMinconwinnerstarget Autoact Modename parameter did not match any deﬁned mode name Deactivateconvgroup Convgroupid DeactcleanupType Deactnormal Deactivatelu0to3 Deactivatesession Plualias Rtmoverﬂow Deﬁne3270diag Rtmunbind RtmtimeroptionRtmthresh1 through rtmthresh4 Description Parameter1 through parameter3 10 deﬁneadjacentlennode Wildcardlus Cpname 11 deﬁnecn Effectcap FqcnnameConnectcost Bytecost Userdefparm1 through userdefparm3 PropdelayPortname Function Not Supported 12 deﬁnecos Transmissionpriority Cosname Mineffectcap MinpropdelayMinconnectcost Minbytecost Minuserdefparm1 through minuserdefparm3 MaxpropdelayMaxeffectcap Maxconnectcost Maxuserdefparm1 through maxuserdefparm3 WeightMinrar Minstatus Weight associated with this node row Symdestname 13 deﬁnecpicsideinfoPartnerluname Tpnametype Conversationsecuritytype SecuritypasswordProgram Programstrong Puname 14 deﬁnedefaultpu Implicitpluforbidden 15 deﬁnedefaults 16 deﬁnedirectoryentry LimitedtimeoutSpeciﬁcsecuritycodes Nncpresource EncpresourceLuresource Wildcardluresource Parenttype 17 deﬁnedlurdefaults Invaliddlusname 19 deﬁnedownstreamlu 18 deﬁnedomainconﬁgﬁleComment Delayedlogon AllowtimeoutDsluname Nauaddress Supplied NAU address was not in the valid range 20 deﬁnedownstreamlurange Minnau DslubasenameMaxnau Returned Parameters 21 deﬁnedsputemplate Modifytemplate TemplatenameMaxinstance Hostlu Name speciﬁed for the templatename parameter was not valid Normal 22 deﬁneemulatoruser Styleﬁle UsernameMaxactsessions Viewrtm Changelu AlertpermissionChangestyle Userisgroup Sessiontype SessionnameModeloverride 5250DISPLAY Locallualias5250PRINTER 24 deﬁneethernetls 23 deﬁneethernetdlc25 deﬁneethernetport 26 deﬁnefddidlc 29 deﬁnefocalpoint 28 deﬁnefddiport Application is the main focal point 30 deﬁneinternalpu Initiallyactive PuidDddluofﬂinesupported Puname parameter contained a character that was not valid 31 deﬁneipdlc Ipprecedencellc UdpportlowIpprecedencenetwork Ipprecedencehigh Learnnode 32 deﬁneipls Adjcpname LsnameAdjcptype Autoactsupp LsapaddressTgnumber Limitedresource Linkdeacttimer DisableremoteactDefaultnnserver Lsattributes Adjnodeid UsedefaulttgcharsLocalnodeid Cpcpsesssupport Bytecost Reacttimerretry ReacttimerTargetpacingcount Maxsendbtusize Maxifrmrcvd IpacktimeoutBranchlinktype Adjbrnncpsupport Shortholdmode LivenesstimeoutRemoteiphost Limitedresource parameter was not set to a valid value 33 deﬁneipport Totlinkactlim MaxrcvbtusizeInblinkactlim Outlinkactlim Nonactxidexchangelimit ActxidexchangelimitRemotehostname Implicitcpcpsesssupport Ipacktimeout through shortholdmode ImplicitdeacttimerImplicituplinktoen Effectcap through userdefparm3 Localipinterface Incoming Calls 34 deﬁnelocallu Listname DefaultpoolSyncptsupport Lusessionlimit Timeout DisableLuattributes Sscpid Disable parameter was not set to a valid value Fqpartnerlu 35 deﬁnelsrouting Wildcardfqplu 36 deﬁnelu0to3 Priority PoolnameLumodel Termmethod UsenodedefaultSendunbind Sendtermself 37 deﬁnelu0to3range Basename Priority Usebasenumber NameattributesUsehexinname Basenumber Basename parameter contained a character that was not valid Password 38 deﬁnelulupasswordVeriﬁcationprotocol 39 deﬁnelupool Luname parameters can be speciﬁed Supplied parameters are Globaltimeout 40 deﬁnelu62timeoutLocallutimeout Partnerlutimeout 41 deﬁnemode Maxrusizeupp DefaultrusizeReceivepacingwin Minconwinsrc MaxnegsesslimMinconlosersrc Maxrusizelow Maxreceivepacingwin 42 deﬁnenode Nodetype NodenameFqcpname Cpalias Mdssupported LocatetimeoutNodeid Maxlocates Coscachesize MdssendalertqsizeTreecachesize Treecacheuselimit Storeisrrscvs StoreendptrscvsStoredlurrscvs Costableversion Cplusyncptsupport DisablebranchawarenessCpluattributes Dlursupport Nnrar PuconcsupportMaxlsexceptionevents Maxcompressionlevel Immediaterecontact ImmediatediscontactSuppressreqdiscont Allowbbrqe Nodename parameter contained a character that was not valid 43 deﬁnepartnerlu Maxmcllsendsize PluunnameConvsecurityver Parallelsesssupp Cardtype 44 deﬁneqllcdlc 45 deﬁneqllcls Useportdefaults Administration Commands deﬁneqllcls Address Solicitsscpsessions Puconcentration DspuservicesDlur Hprsupported Adjnodeid Connectcost Userdefparm1 through userdefparm3 Lspri LsroleLssec Lsneg SVC VctypePVC Locpacket Locwsize ReqrevchargeRemwsize Fac Idletimeout RetrytimeoutPvcid Snid Invaliddspuname Solicitsscpsess parameter was not set to a valid value PU speciﬁed in the puname parameter has already been deﬁned Lsneg 46 deﬁneqllcport Implicitdsputemplate Portnumber Lsxmitrcvcap Implicitdspuservices Lstwa Lstws Cudmode ImplicithprsupportCudmatch Addmode Addlen Vctype through idletimeout Lsrole parameter was not set to a valid value Ucfusername 47 deﬁnercfaccessSpcfpermissions Allowdefineremote 48 deﬁnerjewkstnAllowactionremote Primaryuser WorkstationnameGroupname Systemname 49 deﬁnertptuning Pathswitchtimelow PathswitchattemptsPathswitchtimemedium Pathswitchtimehigh Neglssupp 50 deﬁnesdlcdlc Mucredit AdapternumberStatssupport Numports 51 deﬁnesdlcls Administration Commands deﬁnesdlcls Description Address Limitedresource Dspuservices Hprsupported Adjnodeid Bytecost Targetpacingcount Contacttimerretry ContacttimerContacttimer2 Contacttimerretry2 Nvepolltimerretry NvepolltimerNvepolltimer2 Nvepolltimerretry2 Opt1 PolloniframeLinesp Hmoddata Maxifrmrcvd Returned Parameters 196 State Check Escape Sequences for Modem Control Characters Modem Control Characters 52 deﬁnesdlcport Administration Commands deﬁnesdlcport Portnonswitched PortswitchedPorttype Actxidexchangelimit Implicit links to an End Node are uplinks Idletimerretry IdletimerNprcvtimer Nprcvtimerretry Linkconntimerretry LinkconntimerPrifdplx Secfdplx Maxretrycount Maxxidsize Opt2 Rcvpoolsize Contacttimer through polloniframePollwait Porttype parameter was not set to a valid value 53 deﬁnesecurityaccesslist 54 deﬁnetn3270access Clientaddress Defaultrecord Tn3270support AddressformatAllowspeciﬁclu Printerluname 214 55 deﬁnetn3270association Using the Telnet Daemon’s TCP/IP Port Displayluname 56 deﬁnetn3270defaults Keepalivemethod ForceresponsesNOP Keepaliveinterval 57 deﬁnetp Convtype EnabledSecurityrqd Synclevel Tpinstancelimit Path 58 deﬁnetploadinfo Group ArgumentsStdin Stdout 59 deﬁnetrdlc, deﬁneethernetdlc, deﬁnefddidlc DIX Lantype 60 deﬁnetrls, deﬁneethernetls, deﬁnefddils 226 227 Macaddress 229 230 Hprlinklvlerror 232 233 234 235 Xidtimeout TesttimeoutT1timeout Testretrylimit 237 238 Bit Ordering in MAC Addresses Reversing the Bit Order in a MAC Address 61 deﬁnetrport, deﬁneethernetport, deﬁnefddiport 241 242 243 Implicitlinklvlerror Testtimeout through t1retrylimit 246 Deﬁnetype 62 deﬁneuseridpasswordAdduser Addprofiles Deleteadjacentlennode 249 Deletebackup Deletecn Deletecos Deletecpicsideinfo Deletedirectoryentry 255 Deletedlc Deletedownstreamlu Deletedownstreamlurange 259 Deletedsputemplate 260 Deleteemulatoruser 3270SESSION Deleteoptions5250SESSION Allsessions Deletefocalpoint BackupActive Implicit Deleteinternalpu Deletelocallu Deletels Deletelsrouting 268 Deletelu0to3 Deletelu0to3range 271 Deletelulupassword Deletelupool Deletelu62timeout 275 Deletemode Deletepartnerlu Deleteport Deletercfaccess Deleterjewkstn Deletesecurityaccesslist Deletetn3270access 283 Deletetn3270association Deletetp Deletetploadinfo Deletetype DeleteuseridpasswordRemoveuser Removeprofiles Initnode 289 Initializesessionlimit 290 291 292 Rtpconnectionname Pathswitch Query3270diag Path Switch Failure Rtmoverﬂow through numalerts Alertnumber Query3270user Scope Returned Parameters Detailed Information Returned Parameters Summary InformationUserpid Query3270usersessions 300 301 Queryactivetransaction Reqagentapplname FqreqloccpnameSeqnumdt Fqorigincpname 304 Adjnncpname Queryadjacentnn Outofseqtdus CpcpsessstatusLastfrsnsent Lastfrsnrcvd Queryavailabletp 308 Traceﬂags Querybckcstrace Querybufferavailability Resetmaxvalues Buftotalcount BufavailBuftotalbytes Bufrsrvcount Querycentrallogger Querycentrallogging Querycn Numactports 316 Querycnport Tgnum 319 Queryconversation Convid Administration Commands queryconversation Partnertpname LocaltpnameTpid Sessid Querycos Numoftgrows Numofnoderows Trees QuerycosnoderowCalcs Rejs Noderowindex Minrar through weight Querycostgrow Tgrowindex 328 329 Querycpicsideinfo Partnerluname through lualias Destsys Querycstrace Tracedirection Defpuname QuerydefaultpuDefpusess Querydefaults Speciﬁcsecuritysensecodes Querydirectoryentry 337 338 Realowningcpname Realowningcptype Entrytype Administration Commands querydirectoryentry Suppliercptype LocationSuppliercpname Querydirectorylu 343 Luownername ServernameWildcard Apparentluownername Querydirectorystats Curcaches MaxcachesCurhomeentries Curregentries Querydlc State Dlctype 350 Querydlctrace Alldlctraces Listtype 353 354 355 Querydlurdefaults Querydlurlu Internal ﬁlterDownstream Pluname LulocationRscvlen Querydlurpu 361 Deﬁneddlusname Activedlusname PulocationAnssupport Pustatus Pcid Querydlus Isdefault Pipestate IsbackupdefaultNumactivepus Reqactpusent Actlurspsent ActlureceivedDactlureceived Dactlurspsent Querydomainconﬁgﬁle Majorversion through updatereleaseRevisionlevel Querydownstreamlu 371 Plusessactive Lusscpsessactive 373 Sendrusize RcvrusizeMaxsendpacwin Cursendpacwin Rcvfmddataframes RcvdataframesRcvdatabytes Pacingtype 376 Querydownstreampu Pusscpsessactive 379 380 Querydsputemplate Numofdslutemplates Activeinstance Queryemulatoruserdef ALL Emulatortype Numsessions 386 Queryfocalpoint 388 Bkupfpfqcpname BkupapplnameImplicitapplname Implicitfpfqcpname Querygloballogtype Audit SuccincterrorsException Succinctaudits Queryisrsession Isrsessions Dlursessions 394 Sendrpc RscvRcvrpc Sendfmddatabytes Rcvfmddatabytes Querykernelmemorylimit ResetmaxusedLimit Actual QuerylocalluMaxused Listbyalias 400 Applconnactive Syncptsupport through backlevel Activesscpid Querylocaltopology Desttype DestVRN 405 Rsn DlcdataStatus Cpcpsessionactive Branchtg Querylogﬁle BackupﬁlenameLogﬁletype ﬁlename Override Querylogtype 410 Queryls 412 Detadjcpname ActsesscountDetadjcptype 414 415 416 Substate Dynamic Inxidbytes MigrationInmsgbytes Inxidframes Badxids DeterminedhprlinklvlerrorStarttime Stoptime Detbranchlinktype LstypeAdjcpisbrnn Activelusesscount ActiveisrcountActivesscpsesscount Reverseanrlabel 423 424 425 426 427 428 Determinedipaddress Querylsrouting 431 Querylu0to3 Directattached HostattachmentDlurattached 434 Returned Parameters for All Application Types 436 437 Bindlutype Additional Returned Parameters for an LU Used by Usertype Apptype Puconcdownstreamlu Returned Parameters for an LU Used by an RJE Workstation Useripaddress CfgdefaultCbnumber Cfgaddress Requestluname Querylulupassword 444 Protocolinuse Protocoldeﬁned Querylupool Numavaillus Numactivelus 448 Querylu62timeout 450 451 Application Querymdsapplication Maxrcvsize Querymdsstatistics Uncorrelatedalerterrors AlerterrorsrcvdAlertssent Mdsmusrcvdlocal Unveriﬁederrors ParseerrorsQuerymode Faileddeliveries 456 Sesslimit Activesessions Drainsource Actcwcount DrainpartnerActclcount Maxnegsesslimit Implicit Querymodedeﬁnition Maxrusizeupp through maxreceivepacingwin Querymodetocosmapping Querynmvtapplication Msvectorkeytype Conversionrequired Querynntopologynode 467 Frsn To Obtain Consistent Information Using the frsn Parameter Rar DaysleftFunctionsupport Branchaware Querynntopologystats Nodeerrors NodestateupdatesNodetimerupdates Maxnodes Tgerrors TgstateupdatesTgtimerupdates Nodepurges Querynntopologytg Ownertype Owner 476 477 478 Tgtype SubareanumberIntersubnettg 480 481 Querynode 482 483 484 Hprsupport BIS ERPSetsearchstatus Limittpsecurity Nnfunctionssupported Forcestandardarb Nnstatus EnfunctionssupportedNnfrsn Nnrsn Dlurreleaselevel DynlsbadxidsFqnnservername Currentisrsessions Querynodeall Conﬁgrole Maxlu62tps Querynodelimits Maxfmapitps MaxluatpsMaxlinkstations Maxtn3270connections Peakdatasessions Peaktn3270connectionsBranchnetworknode Networknode Backlevelclient TnserversupportSslsupport Querypartnerlu 497 Partnerlulocated Partnercpname Convsecurity Duplexsupport SecuritydetailsPreference Querypartnerludeﬁnition 502 503 Queryport Portstate 506 507 Portsimrim Abmlssupp Numimplicitlinks Lsap QuerypuVersion 511 512 513 Tcpcvsupported Dddlusupported Queryrcfaccess Queryrjewkstn 517 Wkstnuid WkstnpidWkstngid Wkstngname Queryrjewkstndef Description through luname Queryrtpconnection ﬁrsthoplsname RtpnameDestnodename Numsessactive 523 Arbmode LivenesstimerMaxbtusize Localtcid Bytesdiscarded ShortreqtimerPacketssent Packetsreceived Livenesstimeouts ShortreqtimeoutsDelaychangesum Dcsresetcountnonheal Route Queryrtptuning Querysecurityaccesslist Querysecurityaccesslist 529 Numusers Querysession 531 532 Transpri Contention 535 Sessionstarttime Sessiontimeout Querysnanet Domainname Querystatistics Name ResetstatsStatstype Tabletype Returned Parameters Sdlc LS Statistics Blusin IndexBlusout Octetsin Uiframesin IoctetsoutUiframesout Xidsin Returned Parameters Sdlc LS Operational Information Replyto MaxdataMaxin Maxout Returned Parameters Sdlc Port Statistics Protocolerrs Returned Parameters Sdlc Port Operational InformationActivitytos Rnrlimits Topology SlowpolltimerActivto Pause Lsstmusreceived LsstmussentLsstbytessent Lsstbytesreceived Internalerror LineerrorBursterror Arifcierror Returned Parameters Enterprise Extender Querytn3270accessdef 552 553 554 Querytn3270association 556 Querytn3270defaults Querytnservertrace 559 Querytp 560 Instancelimit QuerytpdeﬁnitionInstancecount Locallystartedcount 562 Listname through tpinstancelimit Querytploadinfo 565 Traceﬁletype Querytraceﬁle Traceﬁlesize Dualﬁlesﬁlename2 Querytracetype Truncationlength Queryuseridpassword Removedlctrace 572 573 Resetsessionlimit ONE Modenameselect Force Draintarget 577 578 Initﬂags Setbckcstrace Setﬂags Setcentrallogging Setbufferavailability Setcstrace Csdatagram CsadminmsgCsdata Csreceive CssendCsboth Leaveunchanged Setgloballogtype 586 Setkernelmemorylimit Action Setlogﬁle Nofileaction BackupfileDeletefile Setlogtype 591 592 Fmapi SettnservertraceCFG NOF Settraceﬁle 595 Settracetype LUA AppcDlpi Sdlc Dgrm Startdlc Startinternalpu 601 Startls Enable Remoteact Autoact Unsuccessful Startport 605 Returned Information Statusall 607 Statusconnectivity Lutype Statusdependentlu RJE DisplayLU6 Other Snapadmin statusdependentlu,puname=ETH0 LU62 Statusdlur Example 2-6 Returned Information for the statusdlur Command Statuslu62 Example 2-7 Returned Information for the statuslu62 Command Statusnode Example 2-8 Returned Information for the statusnode Command Parameters Statusremotenode Stoptype StopdlcOrderlystop Immediatestop Stopinternalpu 619 Stopls 621 Stopport Termnode Abort DeactcleanShutdown Quiesce Function Not Supported Communications Subsystem Not Active State Check Parameter Check System Error Conﬁguration File Format Initial Conﬁguration Files Record Format Record Ordering in a Conﬁguration File Subrecord Format Sample snapadmin Input Files File Input to the snapadmin Program Sample Files Delivered with SNAplus2 Config1.cfg Environment Variables That Affect 3270 Emulation Environment Variables That Affect All FunctionsLang Path SNAP3270SI and SNAP3270SO SNAP3270LOWERRIGHT SNAP3270COLOR Environment Variables That Affect RJE Workstations Appcllu Environment Variables That Affect the CSV API Columns Environment Variables That Affect Tracing Snatrunc 639 Index 640 641 642 643 644 645 646 647 648 649 650 651