Useripaddress, Cbnumber | HP UX Internet and Networking Software

Administration Commands

query_lu_0_to_3

Type of application using this LU. This parameter is set to TN_SERVER.

user_ip_address

The dotted-decimal IP address of the computer where the TN3270 program is running.

port_number

The TCP/IP port number that the TN3270 program uses to access TN server.

cb_number

TN server control block number.

cfg_default

Speciﬁes whether the TN3270 program is using an explicitly deﬁned TN server user record or is using the conﬁgured default record. For more information about conﬁguring a default TN server user record, see Section 2.54, deﬁne_tn3270_access. Possible values are:

YES

The program is using the default record. The cfg_address and cfg_format parameters are reserved.

NO

The program is using an explicitly deﬁned record.

cfg_address

The TCP/IP address of the computer on which the TN3270 program runs, as deﬁned in the conﬁguration record that this user is using.

The address may be speciﬁed as a dotted-decimal IP address (such as 193.1.11.100), as a name (such as newbox.this.co.uk), or as an alias (such as newbox); the format is indicated by the cfg_format parameter.

cfg_format

Speciﬁes the format of the cfg_address parameter. Possible values are:

IP_ADDRESS

IP address

FULLY_QUALIFIED_NAME

Alias or fully qualiﬁed name

tn3270_level

Level of TN3270 support. Possible values are:

LEVEL_TN3270

TN3270E protocols are disabled.

LEVEL_TN3270E

TN3270E protocols are enabled.

lu_select

Method of LU selection. Possible values are:

GENERIC_LU

This LU can be used by any TN3270 program that requests a generic display or printer LU.

SPECIFIC_LU

This LU can be used only by a TN3270 program that names this LU speciﬁcally.

ASSOCIATED_LU

442

Image 442

HP UX Internet and Networking Software Useripaddress, Cbnumber, Cfgdefault, Cfgaddress, Cfgformat, Tn3270level, Luselect

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 Maxtime AvgtimePartnerverdata 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 Userdefparm1 through userdefparm3 PropdelayPortname 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 16 deﬁnedirectoryentry LimitedtimeoutSpeciﬁcsecuritycodes Luresource EncpresourceNncpresource Wildcardluresource Parenttype 17 deﬁnedlurdefaults Invaliddlusname 19 deﬁnedownstreamlu 18 deﬁnedomainconﬁgﬁleComment Dsluname AllowtimeoutDelayedlogon Nauaddress Supplied NAU address was not in the valid range 20 deﬁnedownstreamlurange Minnau DslubasenameMaxnau 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 Sessiontype SessionnameModeloverride 5250DISPLAY Locallualias5250PRINTER 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 Initiallyactive PuidDddluofﬂinesupported Puname parameter contained a character that was not valid 31 deﬁneipdlc Ipprecedencenetwork UdpportlowIpprecedencellc Ipprecedencehigh 32 deﬁneipls Learnnode Adjcpname LsnameAdjcptype Tgnumber LsapaddressAutoactsupp Limitedresource Defaultnnserver DisableremoteactLinkdeacttimer Lsattributes Localnodeid UsedefaulttgcharsAdjnodeid Cpcpsesssupport Bytecost Targetpacingcount ReacttimerReacttimerretry Maxsendbtusize Branchlinktype IpacktimeoutMaxifrmrcvd Adjbrnncpsupport Shortholdmode LivenesstimeoutRemoteiphost 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 Priority PoolnameLumodel Sendunbind UsenodedefaultTermmethod Sendtermself 37 deﬁnelu0to3range Basename Priority Usehexinname NameattributesUsebasenumber 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 Locallutimeout 40 deﬁnelu62timeoutGlobaltimeout Partnerlutimeout 41 deﬁnemode Maxrusizeupp DefaultrusizeReceivepacingwin 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 Puconcentration DspuservicesDlur 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 Ucfusername 47 deﬁnercfaccessSpcfpermissions Allowdefineremote 48 deﬁnerjewkstnAllowactionremote 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 Portnonswitched PortswitchedPorttype Actxidexchangelimit Implicit links to an End Node are uplinks Nprcvtimer IdletimerIdletimerretry Nprcvtimerretry Prifdplx LinkconntimerLinkconntimerretry Secfdplx Maxxidsize Maxretrycount Opt2 Rcvpoolsize Contacttimer through polloniframePollwait 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 Detailed Information Returned Parameters Summary 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 Defpuname QuerydefaultpuDefpusess Querydefaults Querydirectoryentry Speciﬁcsecuritysensecodes 337 338 Realowningcptype Realowningcpname Administration Commands querydirectoryentry Entrytype Suppliercptype LocationSuppliercpname Querydirectorylu 343 Luownername ServernameWildcard Querydirectorystats Apparentluownername Curhomeentries MaxcachesCurcaches Curregentries Querydlc State Dlctype 350 Querydlctrace Listtype Alldlctraces 353 354 355 Querydlurdefaults Querydlurlu Internal ﬁlterDownstream Pluname LulocationRscvlen Querydlurpu 361 Deﬁneddlusname Anssupport PulocationActivedlusname Pustatus Pcid Querydlus Isdefault Numactivepus IsbackupdefaultPipestate Reqactpusent Dactlureceived ActlureceivedActlurspsent Dactlurspsent Querydomainconﬁgﬁle Majorversion through updatereleaseRevisionlevel 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 Querykernelmemorylimit ResetmaxusedLimit Actual QuerylocalluMaxused Listbyalias 400 Syncptsupport through backlevel Applconnactive Activesscpid Querylocaltopology Desttype DestVRN 405 Status DlcdataRsn Cpcpsessionactive Branchtg Logﬁletype BackupﬁlenameQuerylogﬁle ﬁlename Querylogtype Override 410 Queryls 412 Detadjcpname ActsesscountDetadjcptype 414 415 416 Substate Dynamic Inmsgbytes MigrationInxidbytes Inxidframes Starttime DeterminedhprlinklvlerrorBadxids Stoptime Detbranchlinktype LstypeAdjcpisbrnn Activesscpsesscount ActiveisrcountActivelusesscount 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 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 Rar DaysleftFunctionsupport Branchaware Querynntopologystats Nodetimerupdates NodestateupdatesNodeerrors Maxnodes Tgtimerupdates TgstateupdatesTgerrors Nodepurges Querynntopologytg Owner Ownertype 476 477 478 Tgtype SubareanumberIntersubnettg 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 Backlevelclient TnserversupportSslsupport Querypartnerlu 497 Partnercpname Partnerlulocated Convsecurity Duplexsupport SecuritydetailsPreference Querypartnerludeﬁnition 502 503 Queryport Portstate 506 507 Portsimrim Numimplicitlinks Abmlssupp Lsap QuerypuVersion 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 Traceﬁlesize Dualﬁlesﬁlename2 Querytracetype Truncationlength Queryuseridpassword Removedlctrace 572 573 Resetsessionlimit Modenameselect ONE Draintarget Force 577 578 Setbckcstrace Initﬂags Setﬂags Setbufferavailability Setcentrallogging Setcstrace Csdatagram CsadminmsgCsdata Csreceive CssendCsboth Setgloballogtype Leaveunchanged 586 Setkernelmemorylimit Setlogﬁle Action Nofileaction BackupfileDeletefile 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