HP UX 11i v1 I/O Cards manual FLAGS.event, FLAGS.valid, FLAGS.status, FLAGS.local

Page 55

ZCOM Tables and Data Structures

Node Entries Table

FLAGS - Node status and internal flags

This bit-field structure contains bits to maintain state and other internal information about this node. The contents of this field are as follows:

 

FLAGS.event -

Set to 1 if there is at least one application that wants to be

 

 

notified of a status change for the node.

 

 

FLAGS.valid -

Set to 1 if this node entry in the table is valid; that is,

 

 

currently defined and in use.

 

 

FLAGS.status -

Set to 1 if this node is currently UP. The status bit indicates

 

 

whether a remote node is usable. If this bit is not set, the

 

 

LDM will reject all requests to that node with a

 

 

 

ZENDOWN (-61) error. For a local node, the status bit

 

 

indicates that the ZNODE daemon is running properly.

 

FLAGS.local -

Set to 1 if this node entry in the table represents the local

 

 

node.

 

 

 

 

STATS - Statistics for this node

 

 

 

 

This field is a data structure that contains some statistics on the data

 

traffic for this node. The layout of this structure is shown in Table 3-5.

Table 3-5

STATS Data Structure

 

 

 

 

 

 

 

 

 

Field Name

Field Description

 

Field Type

 

Size

 

 

 

 

 

(Bytes)

 

 

 

 

 

icount

Number of incoming messages

uns.int

 

4

 

 

 

 

 

ibytes

Number of incoming bytes

uns.int

 

4

 

 

 

 

 

ocount

Number of outgoing messages

uns.int

 

4

 

 

 

 

 

obytes

Number of outgoing bytes

uns.int

 

4

 

 

 

 

 

 

NDSHZRVRS - Pointer to a list of receivers for node status events.

This field contains a pointer to a linked list of applications to be notified whenever this node changes state. Whenever this node changes state from up-to-down or down-to-up, a node status system event message will be sent to each program in this linked list. That is, those applications that have issued a zevent_rcvr() call to receive node status events. This field will be set to zero if there are no applications to be notified.

Chapter 3

55

Image 55
Contents ACC Programmer’s Reference Guide Page Legal Notices Page Ninth Edition April Release B.03.10 HP-UX Printing HistoryHardware Manuals Related DocumentationContents Zcom Tables and Data Structures Zcom C I/F Library Routines Contents Zcom Subsystem Introduction Zcom Software Overview Zcom Overview of Zcom Software StructureZcom Subsystem Components Zcom Software Overview Zcom Concepts Definition and Features of ZLUs Program ZLUs Zcom Concepts User Interface References Zcom Message Handling Overview ZLU Definition Mapped ZLUs Program Message Queueing Message QueuingPhysical Terminal Table Priorities Multiplexing Outbound Multiplexing Outbound MultiplexingInbound Multiplexing PTZRVR=PZLU Pzlu Inbound MultoplexingTerminal State Terminal StateError Handling Error Handling Zcom Tables and Data Zcom Tables and Data Structures Memory Organization Memory OrganizationDifferences in 32-bit and 64-bit Data Structures Differences in 32-bit and 64-bit Data Structures Zcom Header Structure Hpiftp HpzluHpttbl HpptblZcom Header Structure Zcom Header Structure Zcom Header Structure Zcom Header Structure Zcom Header Structure Ttgen Zcom Header Structure Qlbrsv QlbgrpQlbnam QlbqnbSlboff SlbgrpSlbnam SlbszeZcom Header Structure Node Entries Table FLAGS.local FLAGS.eventFLAGS.valid FLAGS.statusNode Entries Table Individual ZLU Entries ZLU TablesType Description ZLU Type ValuesZLU Tables Logical Terminal Tables Ltaddr LtzshrcvrsLthldq LthdqnLogical Terminal Tables System Status flags Logical Status Structure Ltstat LTCWCT, LTTXCT, LTRXCT, Lterct Message and error countersLTINST, LTBRCH, LTWORK, Ltarea Terminal logical ID Physical Terminal Tables Field Name Field Description Field Type Size Bytes Physical Terminal Tables User Maintainable Area PtuserPhysical Terminal Tables Physical Terminal Tables Physical Terminal Tables Terminal Status Field Ptdrst Firmware terminal status Ptfwst Physical Terminal Tables Physical Terminal Tables Interface Table Ifwinfo 63-32 31-28 27-18 17-14 13-12 10-6 Interface HPA Value InhpaInterface Card Status Ifstat Symbol Value hex MeaningScheduler Event Flags Ischdl Interface Table Interface Table Ipendgbufs Isubchbuf Ifirqbp Nextl Interface Table Zcomipstatund Zcomipstattxb Sync Port Configuration Buffer IportnChannel E1/T1 ACC Card Format EcodeTxFill WhereTimeslot Array Element Structure TxSubch31-30 29-24 23-8 Subchannel Specification Array Element StructureIFIRQBUF, IRESPBUF, Istdtbuf DMA response buffers Datadelay Response Records Zcomrptypeirr Response Type Field Symbol Value MeaningZcomrptypebuffer ZcomrptyperemoteResponse Records Queue Header Area Queue HeaderQfdata QlimitQfunc Queue Header Queue Flags Chapter 101 Organization of Buffer Pool Data Buffer PoolBuffer Pool Layout when first initialized Free Buffer Header Structure zfbhtype Block Size Used flag Buffer flags Bfflag Field106 MID Message HeaderMRQ Mzsrce MstypeMsresp MzdestMessage Type Mstype Response code for all other message types Response code for message type 2Mrqtag MrqcodeMrqterm MrqstatRequest Value Description Mrqcode Terminal request codesSetime SetypeSeflag SenodeSpare Node Status Change Event Fields ZcomsetypenodeNodenum NstatCfgclass Dynamic Reconfiguration Event ZcomsetypereconfigCFGINFO1 116 Chapter 117 Ncard Zcom Kernel DataChapter 119 HPA value of I/F card Hpano Chapter 121 SYS structure Zcom system global information, zsystype Current Zcom system status Higher Order Bits Current Zcom system status Name Value hex StateName Value hex State Debug Level Field Values Bit Name Value hex Meaning Debug Level Field FormatChapter 125 Zcslock ZcglockZcmlock ZcrlockRefcount LockpZcom Kernel Data 128 Zcom C I/F Library Routines 130 Zltstore Logical data storage allocation ZLU configuration callsZLU data transfer calls Chapter 133 ZLU Definition Man Pages Getdevice Read Zcom device definitions GetdeviceDpp Return param ConsiderationsExample Zdgen1, malloc3C File, /opt/acc/cfg/zcomdeviceMultiprotocol ACC Utilities Reference Ascii file, /opt/acc/cfg/zcomdevice.txtDescription LtfindTerminal is not found, ibuf will not contain valid data Logical terminal table. Note that if the logicalLen Length in bytes of ibuf 142 Chapter 143 Ltqdget Posix 1003.1c kernel threads API package. This routine has Ltqdget146 Ltqdput 148 Chapter 149 TTY Name Returned Name Comment MakezlunameMYZLU01 Makezluname Parameter and from the same TTY, the same ZLU name will be Ptfind 154 Data is moved into zptt Pointer to a buffer into which the Zcom physicalTerminal table data will be placed. Note that if Physical terminal is not found i.e., ierr != 0, then noReturn Value Zclos Cancellation point Chapter 159 Zcntl Send no wait, definite status Send no wait, report errorsSend no wait, report errors with buffer Send no waitReturnParam MhpACC Programmers’ Reference Guide Ibuf, len RstatRtyp For rcode not all of them are applicable to zcntl164 Chapter 165 166 Not a cancellation point Zcomerror168 Zcomlname Async-cancel safeZcomlog3x Zcomlog 172 Zcom error string will be logged Int Unix error code, usually errnoUnix error string will be logged Int Zcom error code174 Chapter 175 ACC Programmers Reference Guide under ‘ZCOM Status Message ZcomstatusChapter 177 Zconfig Zap Return Param Response data Chapter 181 Zcomzconfigport ZcomzconfigcntlZcomzconfigsys ZcomzconfigcardChapter 183 Header.action Configuration DataHeader.config DSC ControlZcom subsystem No specific response data or errorData.setctl.cfgclass Data.setctl.cfginfo1Data.setsys.qlimit Data.sysret.errorHeader.tag1 Header.tag2 Data.setsys.sysnameChapter 187 Data.setcard.fname DscreassigniftData.setcard.iftno Data.setcard.itypeData.cardret.iftno Data.cardret.errorData.setport.rcode Data.setport.portnoData.setport.spare Value Parity select No Parity Odd parity Even parity Data.setport.cnfgValue Encoding modes FM1 transition = FM0 transition =Value Rate 0000 Use Baud2 1000 19,200 Value Clock multiplierValue Rate Fsync Pmode Pmode2Value T1 Transmit Attenuation Z7330B only 15 dB 22.5 dB Value Other port for clock synchronization PortPerformance report messages in T1/ESF mode Otherwise by default there is a delay to avoidT1/ESF mode contain an address which User device. By default the ACC is a userData.portret.iftno Data.portret.portno Data.setport.qlimitData.portret.status Chapter 197 Configuration Data header.config Data.setportsc.rcode Data.setportsc.iftnoData.setportsc.portno Data.setportsc.subchnoRTI Data.setportsc.ptcfg-ptinfo.subchb.tmslData.setportsc.len Set to ModeData.setportsc.ptcfg-ptinfo.subchb.spec Set toData.portscret.status Chapter 203 Data.setterm.iftno Header.action ZcDSCCREATELTTPTT Create a new terminal LTTZcDSCCREATELTTONPTT Create a new LTT on an existing Data.setterm.daddrData.setterm.ltype Data.setterm.portnoData.setterm.subchno Data.setterm.dtypeResponse Data data.termret.zaddr Chapter 207 208 Zeventrcvr Name210 Chapter 211 Zcomsetypenode ‘C’ structure for a Zcom Event Message is shown belowFiles Zgetshrcvrlist Get list of current shared receivers ZgetshrcvrlistType of shared receiver list is set to ZcMAXSHAREDRCVRS Table entry from which you want the shared receivers listShould have ZcMAXSHAREDRCVRS+1 entries 216 Zinfo Name, Tables and Data Structures section ReturnParam Returnvalue Files Zinit Zcom routine initialization ZinitFollowing fields ParametersChapter 223 Zltmg Move a logical terminal between groups ZltmgZltmg 226 Zltmx Control logical terminal multiplexing ZltmxParameters Chapter 229 Zltqueue Logical data queue allocation ZltqueueAppln Application number of terminal groupAppln Queue Returned Program Nmbr Label Queue No Chapter 233 Zltstore Logical data storage allocation ZltstoreTerminal table, for the storage in the extension area 236 Zltup 238 Chapter 239 Zluopen This return parameter is undefined Zcom error codes and their meanings242 Zmapr 244 Zname 246 Chapter 247 Zopen Zap Zcom address node, ZLU number, and checksum Ld1Node contains the local node as defined in the Ttgen 250 Chapter 251 Zpeek Zread3X, zluopen3X Error codes and their meaningsZport Zcomzmuxportport ZcomzmuxportallZcomzmuxportconf ZcomzmuxportbaudBreak routine not installed No errorSome terminals in this port not disabled Illegal port modeValue Clock source Value Operating modeValue Parity select Clk258 Value Value Port ModeT1 ESF 260 Chapter 261 Zptup Chapter 263 Zqmve Chapter 265 Zqsze Zqhdp Return param 268 Zread Same ZLU. When a message arrives, only one Mode ZcREADWWAIT 0 Read with waitAfter the timeout period has elapsed There is no message on the queue, error ZenodataChapter 271 272 Chapter 273 274 Zrntimer 276 Chapter 277 Mhp-mid.ztagw2 ZsendZsend 280 Chapter 281 282 Chapter 283 284 Chapter 285 286 Chapter 287 Zsetql Chapter 289 290 Zsetrcvr 292 Zsetrcvr 294 Ztimr 296 Chapter 297 298
Related manuals
Manual 20 pages 4.89 Kb