414 | HP UX Internet and Networking Software guide

Administration Commands

query_ls

Node type is unknown or LS is inactive.

END_NODE

An End Node, a Branch Network Node acting as an End Node from the local node’s perspective, or a LEN node that includes the Network Name CV in its XID3.

NETWORK_NODE

A Network Node, or a Branch Network Node acting as a Network Node from the local node’s perspective.

BACK_LEVEL_LEN_NODE

Back-level LEN node (one that does not include the Network Name CV in its XID3).

HOST_XID3

Host node; SNAplus2 responds to a polling XID from the node with a format 3 XID.

HOST_XID0

Host node; SNAplus2 responds to a polling XID from the node with a format 0 XID.

DSPU_XID

Downstream PU; SNAplus2 includes XID exchange in link activation. The dspu_name and dspu_services parameters are also returned.

DSPU_NOXID

Downstream PU; SNAplus2 does not include XID exchange in link activation. The dspu_name and dspu_services parameters are also returned.

VRN

Virtual routing node.

2.140.3 Returned Parameters: Detailed Information

Parameter name	Type	Length
ls_name	character	8
dlc_type	constant
state	constant
sub_state	constant
act_sess_count	decimal
det_adj_cp_name	character	17
det_adj_cp_type	constant
dlc_name	character	8
dynamic	constant
migration	constant
tg_num	decimal
in_xid_bytes	decimal
in_msg_bytes	decimal
in_xid_frames	decimal
in_msg_frames	decimal
out_xid_bytes	decimal
out_msg_bytes	decimal
out_xid_frames	decimal
out_msg_frames	decimal
in_invalid_sna_frames	decimal
in_session_control_frames	decimal
out_session_control_frames	decimal
good_xids	decimal
bad_xids	decimal
start_time	decimal
stop_time	decimal

414

Image 414

HP UX Internet and Networking Software manual 414

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 Copyright Notices WarrantyGovernment License Trademark Notices Publishing History New and Changed Information in This Edition Organization of This Book Prerequisite KnowledgeAbout This Book Typographic Conventions HP-UX SNAplus2 General Information SNAplus2 PublicationsPublications for Users HP-UX SNAplus2 3270 User’s Guide Publications for Administrators Publications for Programmers HP-UX SNAplus2 CSV Programmer’s Guide Related PublicationsHP-UX SNAplus2 LUA 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 Firstinlist NumentriesListoptions 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 Odai SidhSidl Messagetype Aping Pwd TpnameSecurity Userid Echo DlenConsec Iterations Avgtime MaxtimePartnerverdata Sensedata Changesessionlimit Setnegotiable Minconwinnerstarget PlumodesessionlimitMinconwinnerssource Autoact Modename parameter did not match any deﬁned mode name Deactivateconvgroup Type DeactcleanupConvgroupid Deactnormal Deactivatelu0to3 Deactivatesession Plualias Deﬁne3270diag Rtmoverﬂow Rtmthresh1 through rtmthresh4 RtmtimeroptionRtmunbind Description 10 deﬁneadjacentlennode Parameter1 through parameter3 Cpname Wildcardlus 11 deﬁnecn Connectcost FqcnnameEffectcap Bytecost Propdelay Userdefparm1 through userdefparm3Portname 12 deﬁnecos Function Not Supported Cosname Transmissionpriority Minconnectcost MinpropdelayMineffectcap Minbytecost Maxeffectcap MaxpropdelayMinuserdefparm1 through minuserdefparm3 Maxconnectcost Minrar WeightMaxuserdefparm1 through maxuserdefparm3 Minstatus Weight associated with this node row Partnerluname 13 deﬁnecpicsideinfoSymdestname Tpnametype Program SecuritypasswordConversationsecuritytype Programstrong 14 deﬁnedefaultpu Puname 15 deﬁnedefaults Implicitpluforbidden Limitedtimeout 16 deﬁnedirectoryentrySpeciﬁcsecuritycodes Luresource EncpresourceNncpresource Wildcardluresource Parenttype 17 deﬁnedlurdefaults Invaliddlusname 18 deﬁnedomainconﬁgﬁle 19 deﬁnedownstreamluComment Dsluname AllowtimeoutDelayedlogon Nauaddress Supplied NAU address was not in the valid range 20 deﬁnedownstreamlurange Dslubasename MinnauMaxnau Returned Parameters 21 deﬁnedsputemplate Maxinstance TemplatenameModifytemplate Hostlu Name speciﬁed for the templatename parameter was not valid 22 deﬁneemulatoruser Normal Maxactsessions UsernameStyleﬁle Viewrtm Changestyle AlertpermissionChangelu Userisgroup Sessionname SessiontypeModeloverride Locallualias 5250DISPLAY5250PRINTER 25 deﬁneethernetport 23 deﬁneethernetdlc24 deﬁneethernetls 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 Ipprecedencenetwork UdpportlowIpprecedencellc Ipprecedencehigh 32 deﬁneipls Learnnode Lsname AdjcpnameAdjcptype Tgnumber LsapaddressAutoactsupp Limitedresource Defaultnnserver DisableremoteactLinkdeacttimer Lsattributes Localnodeid UsedefaulttgcharsAdjnodeid Cpcpsesssupport Bytecost Targetpacingcount ReacttimerReacttimerretry Maxsendbtusize Branchlinktype IpacktimeoutMaxifrmrcvd Adjbrnncpsupport Livenesstimeout ShortholdmodeRemoteiphost Limitedresource parameter was not set to a valid value 33 deﬁneipport Inblinkactlim MaxrcvbtusizeTotlinkactlim Outlinkactlim Remotehostname ActxidexchangelimitNonactxidexchangelimit Implicitcpcpsesssupport Implicituplinktoen ImplicitdeacttimerIpacktimeout through shortholdmode Effectcap through userdefparm3 Localipinterface 34 deﬁnelocallu Incoming Calls Syncptsupport DefaultpoolListname Lusessionlimit Luattributes DisableTimeout Sscpid Disable parameter was not set to a valid value 35 deﬁnelsrouting Fqpartnerlu Wildcardfqplu 36 deﬁnelu0to3 Poolname PriorityLumodel Sendunbind UsenodedefaultTermmethod Sendtermself 37 deﬁnelu0to3range Basename Priority Usehexinname NameattributesUsebasenumber 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 Locallutimeout 40 deﬁnelu62timeoutGlobaltimeout Partnerlutimeout 41 deﬁnemode Defaultrusize MaxrusizeuppReceivepacingwin Minconlosersrc MaxnegsesslimMinconwinsrc Maxrusizelow Maxreceivepacingwin 42 deﬁnenode Fqcpname NodenameNodetype Cpalias Nodeid LocatetimeoutMdssupported Maxlocates Treecachesize MdssendalertqsizeCoscachesize Treecacheuselimit Storedlurrscvs StoreendptrscvsStoreisrrscvs Costableversion Cpluattributes DisablebranchawarenessCplusyncptsupport Dlursupport Maxlsexceptionevents PuconcsupportNnrar Maxcompressionlevel Suppressreqdiscont ImmediatediscontactImmediaterecontact Allowbbrqe Nodename parameter contained a character that was not valid 43 deﬁnepartnerlu Convsecurityver PluunnameMaxmcllsendsize Parallelsesssupp 44 deﬁneqllcdlc Cardtype 45 deﬁneqllcls Useportdefaults Administration Commands deﬁneqllcls Address Solicitsscpsessions Dspuservices PuconcentrationDlur Hprsupported Adjnodeid Connectcost Userdefparm1 through userdefparm3 Lssec LsroleLspri Lsneg PVC VctypeSVC Locpacket Remwsize ReqrevchargeLocwsize Fac Pvcid RetrytimeoutIdletimeout 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 Cudmatch ImplicithprsupportCudmode Addmode Vctype through idletimeout Addlen Lsrole parameter was not set to a valid value 47 deﬁnercfaccess UcfusernameSpcfpermissions 48 deﬁnerjewkstn AllowdefineremoteAllowactionremote Groupname WorkstationnamePrimaryuser Systemname 49 deﬁnertptuning Pathswitchtimemedium PathswitchattemptsPathswitchtimelow Pathswitchtimehigh 50 deﬁnesdlcdlc Neglssupp Statssupport AdapternumberMucredit Numports 51 deﬁnesdlcls Administration Commands deﬁnesdlcls Description Address Limitedresource Dspuservices Hprsupported Adjnodeid Bytecost Targetpacingcount Contacttimer2 ContacttimerContacttimerretry Contacttimerretry2 Nvepolltimer2 NvepolltimerNvepolltimerretry Nvepolltimerretry2 Linesp PolloniframeOpt1 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 Nprcvtimer IdletimerIdletimerretry Nprcvtimerretry Prifdplx LinkconntimerLinkconntimerretry 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 Allowspeciﬁclu AddressformatTn3270support Printerluname 214 Using the Telnet Daemon’s TCP/IP Port 55 deﬁnetn3270association 56 deﬁnetn3270defaults Displayluname NOP ForceresponsesKeepalivemethod Keepaliveinterval 57 deﬁnetp Securityrqd EnabledConvtype Synclevel Tpinstancelimit 58 deﬁnetploadinfo Path Stdin ArgumentsGroup 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 T1timeout TesttimeoutXidtimeout 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 Adduser 62 deﬁneuseridpasswordDeﬁnetype Addprofiles Deleteadjacentlennode 249 Deletebackup Deletecn Deletecos Deletecpicsideinfo Deletedirectoryentry 255 Deletedlc Deletedownstreamlu Deletedownstreamlurange Deletedsputemplate 259 260 Deleteemulatoruser 5250SESSION Deleteoptions3270SESSION Allsessions Active BackupDeletefocalpoint Implicit Deleteinternalpu Deletelocallu Deletels Deletelsrouting 268 Deletelu0to3 Deletelu0to3range 271 Deletelulupassword Deletelupool Deletelu62timeout 275 Deletemode Deletepartnerlu Deleteport Deletercfaccess Deleterjewkstn Deletesecurityaccesslist Deletetn3270access 283 Deletetn3270association Deletetp Deletetploadinfo Removeuser DeleteuseridpasswordDeletetype 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 Seqnumdt FqreqloccpnameReqagentapplname Fqorigincpname 304 Queryadjacentnn Adjnncpname Lastfrsnsent CpcpsessstatusOutofseqtdus Lastfrsnrcvd Queryavailabletp 308 Querybckcstrace Traceﬂags Resetmaxvalues Querybufferavailability Buftotalbytes BufavailBuftotalcount Bufrsrvcount Querycentrallogger Querycentrallogging Querycn Numactports 316 Querycnport Tgnum Queryconversation 319 Administration Commands queryconversation Convid Tpid LocaltpnamePartnertpname Sessid Querycos Numofnoderows Numoftgrows Calcs QuerycosnoderowTrees 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 Curhomeentries MaxcachesCurcaches Curregentries Querydlc State Dlctype 350 Querydlctrace Listtype Alldlctraces 353 354 355 Querydlurdefaults Querydlurlu ﬁlter InternalDownstream Lulocation PlunameRscvlen Querydlurpu 361 Deﬁneddlusname Anssupport PulocationActivedlusname Pustatus Pcid Querydlus Isdefault Numactivepus IsbackupdefaultPipestate Reqactpusent Dactlureceived ActlureceivedActlurspsent Dactlurspsent Majorversion through updaterelease QuerydomainconﬁgﬁleRevisionlevel Querydownstreamlu 371 Lusscpsessactive Plusessactive 373 Maxsendpacwin RcvrusizeSendrusize Cursendpacwin Rcvdatabytes RcvdataframesRcvfmddataframes Pacingtype 376 Querydownstreampu Pusscpsessactive 379 380 Querydsputemplate Activeinstance Numofdslutemplates Queryemulatoruserdef Emulatortype ALL Numsessions 386 Queryfocalpoint 388 Implicitapplname BkupapplnameBkupfpfqcpname Implicitfpfqcpname Querygloballogtype Exception SuccincterrorsAudit Succinctaudits Queryisrsession Dlursessions Isrsessions 394 Rcvrpc RscvSendrpc Sendfmddatabytes Rcvfmddatabytes Resetmaxused QuerykernelmemorylimitLimit Querylocallu ActualMaxused Listbyalias 400 Syncptsupport through backlevel Applconnactive Activesscpid Querylocaltopology Dest DesttypeVRN 405 Status DlcdataRsn Cpcpsessionactive Branchtg Logﬁletype BackupﬁlenameQuerylogﬁle ﬁlename Querylogtype Override 410 Queryls 412 Actsesscount DetadjcpnameDetadjcptype 414 415 416 Substate Dynamic Inmsgbytes MigrationInxidbytes Inxidframes Starttime DeterminedhprlinklvlerrorBadxids Stoptime Lstype DetbranchlinktypeAdjcpisbrnn Activesscpsesscount ActiveisrcountActivelusesscount 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 Cbnumber CfgdefaultUseripaddress Cfgaddress Querylulupassword Requestluname 444 Protocoldeﬁned Protocolinuse Querylupool Numactivelus Numavaillus 448 Querylu62timeout 450 451 Querymdsapplication Application Querymdsstatistics Maxrcvsize Alertssent AlerterrorsrcvdUncorrelatedalerterrors Mdsmusrcvdlocal Querymode ParseerrorsUnveriﬁederrors Faileddeliveries 456 Activesessions Sesslimit Drainsource Actclcount DrainpartnerActcwcount 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 Nodetimerupdates NodestateupdatesNodeerrors Maxnodes Tgtimerupdates TgstateupdatesTgerrors Nodepurges Querynntopologytg Owner Ownertype 476 477 478 Subareanumber TgtypeIntersubnettg 480 Querynode 481 482 483 484 Hprsupport Setsearchstatus ERPBIS Limittpsecurity Forcestandardarb Nnfunctionssupported Nnfrsn EnfunctionssupportedNnstatus Nnrsn Fqnnservername DynlsbadxidsDlurreleaselevel Currentisrsessions Querynodeall Conﬁgrole Querynodelimits Maxlu62tps Maxlinkstations MaxluatpsMaxfmapitps Maxtn3270connections Branchnetworknode Peaktn3270connectionsPeakdatasessions 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 Wkstngid WkstnpidWkstnuid Wkstngname Queryrjewkstndef Description through luname Queryrtpconnection Destnodename Rtpnameﬁrsthoplsname Numsessactive 523 Maxbtusize LivenesstimerArbmode Localtcid Packetssent ShortreqtimerBytesdiscarded Packetsreceived Delaychangesum ShortreqtimeoutsLivenesstimeouts Dcsresetcountnonheal Queryrtptuning Route Querysecurityaccesslist Querysecurityaccesslist 529 Querysession Numusers 531 532 Transpri Contention 535 Sessiontimeout Sessionstarttime Querysnanet Querystatistics Domainname Statstype ResetstatsName Tabletype Returned Parameters Sdlc LS Statistics Blusout IndexBlusin Octetsin Uiframesout IoctetsoutUiframesin Xidsin Returned Parameters Sdlc LS Operational Information Maxin MaxdataReplyto Maxout Returned Parameters Sdlc Port Statistics Activitytos Returned Parameters Sdlc Port Operational InformationProtocolerrs Rnrlimits Activto SlowpolltimerTopology Pause Lsstbytessent LsstmussentLsstmusreceived Lsstbytesreceived Bursterror LineerrorInternalerror Arifcierror Returned Parameters Enterprise Extender Querytn3270accessdef 552 553 554 Querytn3270association 556 Querytn3270defaults Querytnservertrace Querytp 559 560 Instancecount QuerytpdeﬁnitionInstancelimit 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 CFG SettnservertraceFmapi NOF Settraceﬁle 595 Settracetype Dlpi AppcLUA Sdlc Dgrm Startdlc Startinternalpu 601 Enable Startls Autoact Remoteact Startport Unsuccessful 605 Statusall Returned Information 607 Statusconnectivity Statusdependentlu Lutype LU6 DisplayRJE 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 Orderlystop StopdlcStoptype Immediatestop Stopinternalpu 619 Stopls 621 Stopport Termnode Shutdown DeactcleanAbort 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 Lang Environment Variables That Affect All FunctionsEnvironment Variables That Affect 3270 Emulation 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