Manuals / HP / Computer Equipment / Software

HP UX Internet and Networking Software Related Publications, HP-UX SNAplus2 MS Programmer’s Guide

Models: UX Internet and Networking Software

1 651

Download 651 pages 11.83 Kb

Page 29

Before You Begin

Related Publications

Contains the information you need to write application programs using High-Level Language Application Program Interface (HLLAPI).

HP-UX SNAplus2 LUA Programmer’s Guide

Contains the information you need to write applications using the Conventional LU Application Programming Interface (LUA).

HP-UX SNAplus2 CSV Programmer’s Guide

Contains the information you need to write application programs using the Common Service Verbs (CSV) API.

HP-UX SNAplus2 MS Programmer’s Guide

Contains the information you need to write applications using the Management Services (MS) API.

HP-UX SNAplus2 NOF Programmer’s Guide

Contains the information you need to write applications using the Node Operator Facility (NOF) API.

Related Publications

For information about SNA, APPN or LU 6.2 architecture, refer to the following IBM documents:

•IBM Systems Network Architecture: LU6.2 Reference: Peer Protocols SC31-6808

•IBM Systems Network Architecture: APPN Architecture Reference SC30-3422.

•IBM Systems Network Architecture: Management Services SC30-3346

•IBM Systems Network Architecture: Formats GA27-3136

•IBM APPN Architecture and Product Implementations Tutorial GG24-3669

•IBM AS/400 Advanced Peer-to-Peer Networking GG24-3287

•IBM Communications Manager/2 System Management Programming Reference SC31-6173

•IBM Communications Manager/2 APPC Programming Guide and Reference SC31-6160

•IBM System/370 Principles of Operation GA22-7000

•IBM Systems Network Architecture: Technical Overview GC30-3073

29

Image 29

HP UX Internet and Networking Software manual Related Publications, HP-UX SNAplus2 LUA Programmer’s Guide

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 NoticesNew and Changed Information in This Edition Publishing HistoryAbout This Book Prerequisite KnowledgeOrganization of This Book Typographic ConventionsPublications for Users SNAplus2 PublicationsHP-UX SNAplus2 General Information HP-UX SNAplus2 3270 User’s GuidePublications for Programmers Publications for AdministratorsHP-UX SNAplus2 LUA Programmer’s Guide Related PublicationsHP-UX SNAplus2 CSV Programmer’s Guide HP-UX SNAplus2 MS Programmer’s GuideIntroduction to SNAplus2 Administration Commands Command Line Options Using snapadminChanging Speciﬁc Parameters Using Command Line Help Parameter Syntax Used for Administration CommandsDefault Parameter Values Subrecords in Administration Commands Listoptions NumentriesFirstinlist ListinclusiveDefineethernetdlc, dlcname = DLCNAME, initiallyactive = YES Examples of Administration CommandsSupplied Parameters ActivatesessionReturned Parameters Error Return CodesState Check AddbackupAdddlctrace BackupnameResourcename ResourcetypeSidl SidhOdai MessagetypeAping Security TpnamePwd UseridConsec DlenEcho IterationsPartnerverdata AvgtimeMaxtime Sensedata Setnegotiable ChangesessionlimitMinconwinnerssource PlumodesessionlimitMinconwinnerstarget AutoactModename parameter did not match any deﬁned mode name Deactivateconvgroup Convgroupid DeactcleanupType DeactnormalDeactivatelu0to3 Deactivatesession Plualias Rtmoverﬂow Deﬁne3270diagRtmunbind RtmtimeroptionRtmthresh1 through rtmthresh4 DescriptionParameter1 through parameter3 10 deﬁneadjacentlennodeWildcardlus Cpname11 deﬁnecn Effectcap FqcnnameConnectcost BytecostPortname PropdelayUserdefparm1 through userdefparm3 Function Not Supported 12 deﬁnecosTransmissionpriority CosnameMineffectcap MinpropdelayMinconnectcost MinbytecostMinuserdefparm1 through minuserdefparm3 MaxpropdelayMaxeffectcap MaxconnectcostMaxuserdefparm1 through maxuserdefparm3 WeightMinrar MinstatusWeight associated with this node row Symdestname 13 deﬁnecpicsideinfoPartnerluname TpnametypeConversationsecuritytype SecuritypasswordProgram ProgramstrongPuname 14 deﬁnedefaultpuImplicitpluforbidden 15 deﬁnedefaultsSpeciﬁcsecuritycodes Limitedtimeout16 deﬁnedirectoryentry Nncpresource EncpresourceLuresource WildcardluresourceParenttype 17 deﬁnedlurdefaults Invaliddlusname Comment 18 deﬁnedomainconﬁgﬁle19 deﬁnedownstreamlu Delayedlogon AllowtimeoutDsluname NauaddressSupplied NAU address was not in the valid range 20 deﬁnedownstreamlurange Maxnau DslubasenameMinnau Returned Parameters 21 deﬁnedsputemplate Modifytemplate TemplatenameMaxinstance HostluName speciﬁed for the templatename parameter was not valid Normal 22 deﬁneemulatoruserStyleﬁle UsernameMaxactsessions ViewrtmChangelu AlertpermissionChangestyle UserisgroupModeloverride SessionnameSessiontype 5250PRINTER Locallualias5250DISPLAY 24 deﬁneethernetls 23 deﬁneethernetdlc25 deﬁneethernetport 26 deﬁnefddidlc29 deﬁnefocalpoint 28 deﬁnefddiportApplication is the main focal point 30 deﬁneinternalpu Dddluofﬂinesupported PuidInitiallyactive Puname parameter contained a character that was not valid 31 deﬁneipdlc Ipprecedencellc UdpportlowIpprecedencenetwork IpprecedencehighLearnnode 32 deﬁneiplsAdjcptype LsnameAdjcpname Autoactsupp LsapaddressTgnumber LimitedresourceLinkdeacttimer DisableremoteactDefaultnnserver LsattributesAdjnodeid UsedefaulttgcharsLocalnodeid CpcpsesssupportBytecost Reacttimerretry ReacttimerTargetpacingcount MaxsendbtusizeMaxifrmrcvd IpacktimeoutBranchlinktype AdjbrnncpsupportRemoteiphost LivenesstimeoutShortholdmode Limitedresource parameter was not set to a valid value 33 deﬁneipport Totlinkactlim MaxrcvbtusizeInblinkactlim OutlinkactlimNonactxidexchangelimit ActxidexchangelimitRemotehostname ImplicitcpcpsesssupportIpacktimeout through shortholdmode ImplicitdeacttimerImplicituplinktoen Effectcap through userdefparm3Localipinterface Incoming Calls 34 deﬁnelocalluListname DefaultpoolSyncptsupport LusessionlimitTimeout DisableLuattributes SscpidDisable parameter was not set to a valid value Fqpartnerlu 35 deﬁnelsroutingWildcardfqplu 36 deﬁnelu0to3 Lumodel PoolnamePriority Termmethod UsenodedefaultSendunbind Sendtermself37 deﬁnelu0to3range Basename Priority Usebasenumber NameattributesUsehexinname BasenumberBasename parameter contained a character that was not valid Veriﬁcationprotocol 38 deﬁnelulupasswordPassword 39 deﬁnelupool Luname parameters can be speciﬁed Supplied parameters are Globaltimeout 40 deﬁnelu62timeoutLocallutimeout Partnerlutimeout41 deﬁnemode Receivepacingwin DefaultrusizeMaxrusizeupp Minconwinsrc MaxnegsesslimMinconlosersrc MaxrusizelowMaxreceivepacingwin 42 deﬁnenode Nodetype NodenameFqcpname CpaliasMdssupported LocatetimeoutNodeid MaxlocatesCoscachesize MdssendalertqsizeTreecachesize TreecacheuselimitStoreisrrscvs StoreendptrscvsStoredlurrscvs CostableversionCplusyncptsupport DisablebranchawarenessCpluattributes DlursupportNnrar PuconcsupportMaxlsexceptionevents MaxcompressionlevelImmediaterecontact ImmediatediscontactSuppressreqdiscont AllowbbrqeNodename parameter contained a character that was not valid 43 deﬁnepartnerlu Maxmcllsendsize PluunnameConvsecurityver ParallelsesssuppCardtype 44 deﬁneqllcdlc45 deﬁneqllcls Useportdefaults Administration Commands deﬁneqllcls Address Solicitsscpsessions Dlur DspuservicesPuconcentration Hprsupported Adjnodeid Connectcost Userdefparm1 through userdefparm3 Lspri LsroleLssec LsnegSVC VctypePVC LocpacketLocwsize ReqrevchargeRemwsize FacIdletimeout RetrytimeoutPvcid SnidInvaliddspuname Solicitsscpsess parameter was not set to a valid value PU speciﬁed in the puname parameter has already been deﬁned Lsneg 46 deﬁneqllcportImplicitdsputemplate PortnumberLsxmitrcvcap ImplicitdspuservicesLstwa LstwsCudmode ImplicithprsupportCudmatch AddmodeAddlen Vctype through idletimeoutLsrole parameter was not set to a valid value Spcfpermissions 47 deﬁnercfaccessUcfusername Allowactionremote 48 deﬁnerjewkstnAllowdefineremote Primaryuser WorkstationnameGroupname Systemname49 deﬁnertptuning Pathswitchtimelow PathswitchattemptsPathswitchtimemedium PathswitchtimehighNeglssupp 50 deﬁnesdlcdlcMucredit AdapternumberStatssupport Numports51 deﬁnesdlcls Administration Commands deﬁnesdlcls Description Address Limitedresource Dspuservices Hprsupported Adjnodeid Bytecost Targetpacingcount Contacttimerretry ContacttimerContacttimer2 Contacttimerretry2Nvepolltimerretry NvepolltimerNvepolltimer2 Nvepolltimerretry2Opt1 PolloniframeLinesp HmoddataMaxifrmrcvd Returned Parameters 196 State Check Escape Sequences for Modem Control Characters Modem Control Characters52 deﬁnesdlcport Administration Commands deﬁnesdlcport Porttype PortswitchedPortnonswitched Actxidexchangelimit Implicit links to an End Node are uplinks Idletimerretry IdletimerNprcvtimer NprcvtimerretryLinkconntimerretry LinkconntimerPrifdplx SecfdplxMaxretrycount MaxxidsizeOpt2 Pollwait Contacttimer through polloniframeRcvpoolsize Porttype parameter was not set to a valid value 53 deﬁnesecurityaccesslist 54 deﬁnetn3270access Clientaddress DefaultrecordTn3270support AddressformatAllowspeciﬁclu Printerluname214 55 deﬁnetn3270association Using the Telnet Daemon’s TCP/IP PortDisplayluname 56 deﬁnetn3270defaultsKeepalivemethod ForceresponsesNOP Keepaliveinterval57 deﬁnetp Convtype EnabledSecurityrqd SynclevelTpinstancelimit Path 58 deﬁnetploadinfoGroup ArgumentsStdin Stdout59 deﬁnetrdlc, deﬁneethernetdlc, deﬁnefddidlc DIX Lantype60 deﬁnetrls, deﬁneethernetls, deﬁnefddils 226 227 Macaddress 229 230 Hprlinklvlerror 232 233 234 235 Xidtimeout TesttimeoutT1timeout Testretrylimit237 238 Bit Ordering in MAC Addresses Reversing the Bit Order in a MAC Address 61 deﬁnetrport, deﬁneethernetport, deﬁnefddiport241 242 243 Implicitlinklvlerror Testtimeout through t1retrylimit 246 Deﬁnetype 62 deﬁneuseridpasswordAdduser AddprofilesDeleteadjacentlennode 249 Deletebackup Deletecn Deletecos Deletecpicsideinfo Deletedirectoryentry 255 Deletedlc Deletedownstreamlu Deletedownstreamlurange 259 Deletedsputemplate260 Deleteemulatoruser 3270SESSION Deleteoptions5250SESSION AllsessionsDeletefocalpoint BackupActive ImplicitDeleteinternalpu Deletelocallu Deletels Deletelsrouting 268 Deletelu0to3 Deletelu0to3range 271 Deletelulupassword Deletelupool Deletelu62timeout 275 Deletemode Deletepartnerlu Deleteport Deletercfaccess Deleterjewkstn Deletesecurityaccesslist Deletetn3270access 283 Deletetn3270association Deletetp Deletetploadinfo Deletetype DeleteuseridpasswordRemoveuser RemoveprofilesInitnode 289 Initializesessionlimit290 291 292 Rtpconnectionname PathswitchQuery3270diag Path Switch FailureRtmoverﬂow through numalerts AlertnumberQuery3270user Scope Userpid Returned Parameters Summary InformationReturned Parameters Detailed Information Query3270usersessions 300 301 Queryactivetransaction Reqagentapplname FqreqloccpnameSeqnumdt Fqorigincpname304 Adjnncpname QueryadjacentnnOutofseqtdus CpcpsessstatusLastfrsnsent LastfrsnrcvdQueryavailabletp 308 Traceﬂags QuerybckcstraceQuerybufferavailability ResetmaxvaluesBuftotalcount BufavailBuftotalbytes BufrsrvcountQuerycentrallogger Querycentrallogging Querycn Numactports 316 Querycnport Tgnum 319 QueryconversationConvid Administration Commands queryconversationPartnertpname LocaltpnameTpid SessidQuerycos Numoftgrows NumofnoderowsTrees QuerycosnoderowCalcs RejsNoderowindex Minrar through weightQuerycostgrow Tgrowindex 328 329 Querycpicsideinfo Partnerluname through lualias Destsys QuerycstraceTracedirection Defpusess QuerydefaultpuDefpuname Querydefaults Speciﬁcsecuritysensecodes Querydirectoryentry337 338 Realowningcpname RealowningcptypeEntrytype Administration Commands querydirectoryentrySuppliercpname LocationSuppliercptype Querydirectorylu 343 Wildcard ServernameLuownername Apparentluownername QuerydirectorystatsCurcaches MaxcachesCurhomeentries CurregentriesQuerydlc State Dlctype 350 Querydlctrace Alldlctraces Listtype353 354 355 Querydlurdefaults Querydlurlu Downstream ﬁlterInternal Rscvlen LulocationPluname Querydlurpu 361 Deﬁneddlusname Activedlusname PulocationAnssupport PustatusPcid Querydlus Isdefault Pipestate IsbackupdefaultNumactivepus ReqactpusentActlurspsent ActlureceivedDactlureceived DactlurspsentRevisionlevel Majorversion through updatereleaseQuerydomainconﬁgﬁle Querydownstreamlu 371 Plusessactive Lusscpsessactive373 Sendrusize RcvrusizeMaxsendpacwin CursendpacwinRcvfmddataframes RcvdataframesRcvdatabytes Pacingtype376 Querydownstreampu Pusscpsessactive 379 380 Querydsputemplate Numofdslutemplates ActiveinstanceQueryemulatoruserdef ALL EmulatortypeNumsessions 386 Queryfocalpoint 388 Bkupfpfqcpname BkupapplnameImplicitapplname ImplicitfpfqcpnameQuerygloballogtype Audit SuccincterrorsException SuccinctauditsQueryisrsession Isrsessions Dlursessions394 Sendrpc RscvRcvrpc SendfmddatabytesRcvfmddatabytes Limit ResetmaxusedQuerykernelmemorylimit Maxused QuerylocalluActual Listbyalias 400 Applconnactive Syncptsupport through backlevelActivesscpid Querylocaltopology VRN DestDesttype 405 Rsn DlcdataStatus CpcpsessionactiveBranchtg Querylogﬁle BackupﬁlenameLogﬁletype ﬁlenameOverride Querylogtype410 Queryls 412 Detadjcptype ActsesscountDetadjcpname 414 415 416 Substate Dynamic Inxidbytes MigrationInmsgbytes InxidframesBadxids DeterminedhprlinklvlerrorStarttime StoptimeAdjcpisbrnn LstypeDetbranchlinktype Activelusesscount ActiveisrcountActivesscpsesscount Reverseanrlabel423 424 425 426 427 428 Determinedipaddress Querylsrouting 431 Querylu0to3 Dlurattached HostattachmentDirectattached 434 Returned Parameters for All Application Types 436 437 Bindlutype Additional Returned Parameters for an LU Used by Usertype ApptypePuconcdownstreamlu Returned Parameters for an LU Used by an RJE WorkstationUseripaddress CfgdefaultCbnumber CfgaddressRequestluname Querylulupassword444 Protocolinuse ProtocoldeﬁnedQuerylupool Numavaillus Numactivelus448 Querylu62timeout 450 451 Application QuerymdsapplicationMaxrcvsize QuerymdsstatisticsUncorrelatedalerterrors AlerterrorsrcvdAlertssent MdsmusrcvdlocalUnveriﬁederrors ParseerrorsQuerymode Faileddeliveries456 Sesslimit ActivesessionsDrainsource Actcwcount DrainpartnerActclcount MaxnegsesslimitImplicit Querymodedeﬁnition Maxrusizeupp through maxreceivepacingwin Querymodetocosmapping Querynmvtapplication Msvectorkeytype Conversionrequired Querynntopologynode467 Frsn To Obtain Consistent Information Using the frsn ParameterFunctionsupport DaysleftRar Branchaware Querynntopologystats Nodeerrors NodestateupdatesNodetimerupdates MaxnodesTgerrors TgstateupdatesTgtimerupdates NodepurgesQuerynntopologytg Ownertype Owner476 477 478 Intersubnettg SubareanumberTgtype 480 481 Querynode482 483 484 Hprsupport BIS ERPSetsearchstatus LimittpsecurityNnfunctionssupported ForcestandardarbNnstatus EnfunctionssupportedNnfrsn NnrsnDlurreleaselevel DynlsbadxidsFqnnservername CurrentisrsessionsQuerynodeall Conﬁgrole Maxlu62tps QuerynodelimitsMaxfmapitps MaxluatpsMaxlinkstations Maxtn3270connectionsPeakdatasessions Peaktn3270connectionsBranchnetworknode NetworknodeSslsupport TnserversupportBacklevelclient Querypartnerlu 497 Partnerlulocated PartnercpnameConvsecurity Preference SecuritydetailsDuplexsupport Querypartnerludeﬁnition 502 503 Queryport Portstate 506 507 Portsimrim Abmlssupp NumimplicitlinksVersion QuerypuLsap 511 512 513 Tcpcvsupported DddlusupportedQueryrcfaccess Queryrjewkstn 517 Wkstnuid WkstnpidWkstngid WkstngnameQueryrjewkstndef Description through luname Queryrtpconnection ﬁrsthoplsname RtpnameDestnodename Numsessactive523 Arbmode LivenesstimerMaxbtusize LocaltcidBytesdiscarded ShortreqtimerPacketssent PacketsreceivedLivenesstimeouts ShortreqtimeoutsDelaychangesum DcsresetcountnonhealRoute QueryrtptuningQuerysecurityaccesslist Querysecurityaccesslist529 Numusers Querysession531 532 Transpri Contention 535 Sessionstarttime SessiontimeoutQuerysnanet Domainname QuerystatisticsName ResetstatsStatstype TabletypeReturned Parameters Sdlc LS Statistics Blusin IndexBlusout OctetsinUiframesin IoctetsoutUiframesout XidsinReturned Parameters Sdlc LS Operational Information Replyto MaxdataMaxin MaxoutReturned Parameters Sdlc Port Statistics Protocolerrs Returned Parameters Sdlc Port Operational InformationActivitytos RnrlimitsTopology SlowpolltimerActivto PauseLsstmusreceived LsstmussentLsstbytessent LsstbytesreceivedInternalerror LineerrorBursterror ArifcierrorReturned Parameters Enterprise Extender Querytn3270accessdef 552 553 554 Querytn3270association 556 Querytn3270defaults Querytnservertrace 559 Querytp560 Instancelimit QuerytpdeﬁnitionInstancecount Locallystartedcount562 Listname through tpinstancelimit Querytploadinfo 565 Traceﬁletype Querytraceﬁleﬁlename2 DualﬁlesTraceﬁlesize Querytracetype Truncationlength Queryuseridpassword Removedlctrace 572 573 Resetsessionlimit ONE ModenameselectForce Draintarget577 578 Initﬂags SetbckcstraceSetﬂags Setcentrallogging SetbufferavailabilitySetcstrace Csdata CsadminmsgCsdatagram Csboth CssendCsreceive Leaveunchanged Setgloballogtype586 Setkernelmemorylimit Action SetlogﬁleDeletefile BackupfileNofileaction Setlogtype 591 592 Fmapi SettnservertraceCFG NOFSettraceﬁle 595 Settracetype LUA AppcDlpi SdlcDgrm Startdlc Startinternalpu 601 Startls EnableRemoteact AutoactUnsuccessful Startport605 Returned Information Statusall607 Statusconnectivity Lutype StatusdependentluRJE DisplayLU6 OtherSnapadmin statusdependentlu,puname=ETH0 LU62 Statusdlur Example 2-6 Returned Information for the statusdlur CommandStatuslu62 Example 2-7 Returned Information for the statuslu62 CommandStatusnode Example 2-8 Returned Information for the statusnode CommandParameters StatusremotenodeStoptype StopdlcOrderlystop ImmediatestopStopinternalpu 619 Stopls 621 Stopport Termnode Abort DeactcleanShutdown QuiesceFunction Not Supported Communications Subsystem Not ActiveState Check Parameter CheckSystem Error Conﬁguration File Format Initial Conﬁguration FilesRecord Format Record Ordering in a Conﬁguration FileSubrecord Format Sample snapadmin Input Files File Input to the snapadmin ProgramSample Files Delivered with SNAplus2 Config1.cfgEnvironment Variables That Affect 3270 Emulation Environment Variables That Affect All FunctionsLang PathSNAP3270SI and SNAP3270SO SNAP3270LOWERRIGHTSNAP3270COLOR Environment Variables That Affect RJE WorkstationsAppcllu Environment Variables That Affect the CSV APIColumns Environment Variables That Affect TracingSnatrunc 639 Index640 641 642 643 644 645 646 647 648 649 650 651