355 | HP UX Internet and Networking Software manual

Administration Commands

query_dlc_trace

message_type

The type of messages to be traced for the speciﬁed resource or session. If all messages are being traced, this parameter is set to TRACE_ALL. If speciﬁc messages are being traced, one or more of the following values is combined with a + character:

TRACE_XID

XID messages

TRACE_SC

Session control RUs

TRACE_DFC

Data ﬂow control RUs

TRACE_FMD

FMD messages

TRACE_NLP

Network layer protocol messages

TRACE_NC

Network control messages

TRACE_SEGS

Non-BBIU segments that do not contain an RH

TRACE_CTL

Messages other than MUs and XIDs

2.122.3 Error Return Codes

If the command cannot be executed, SNAplus2 returns a primary return code to indicate the type of error and a secondary return code to provide speciﬁc details about the reason for unsuccessful execution.

Parameter Check

If the command does not execute because of a parameter error, SNAplus2 returns the following parameters:

primary_rc

PARAMETER_CHECK

secondary_rc

Possible values are:

INVALID_LIST_TYPE

The value speciﬁed in the list_type parameter was not valid.

INVALID_RESOURCE_TYPE

The value speciﬁed in the resource_type parameter was not valid.

ALL_RESOURCES_NOT_DEFINED

The resource_type parameter was set to ALL_RESOURCES, but a DLC_TRACE entry has not been deﬁned for tracing options on all resources.

INVALID_RTP_CONNECTION

The RTP connection named in the resource_name parameter does not have any tracing options set.

355

Image 355

HP UX Internet and Networking Software manual 355

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