ZLU Definition | HP UX 11i v1 I/O Cards guide

ZCOM C I/F Library Routines

Introduction

ZLU Definition

The zlu field of a <zaddr_type> parameter specifies the ZLU address. The checksum field of a <zaddr_type> parameter is a checksum used to verify the address of the message. All routine calls that specify ‘(with checksum)’ in the ZLU definition must have both fields defined correctly for successful processing.

The checksum minimizes the possibility of messages being accidentally misdirected. The checksum is calculated based on the type and name of the ZLU, hence the checksum does not change even when the system is restarted. If the program that opened the ZLU is killed, it may reopen the same ZLU by referencing it by ZLU name and the same checksum will be generated. This allows any other message sources to deliver data to a restarted ZLU without any impact.

The node field of a <zaddr_type> parameter must contain a valid node number or zero if it is an input parameter. However, if it is a return parameter, such as in the zopen call, then the node number returned is the local node as defined in the “configuration file”. Note that specifying a node number of zero is the same as specifying the local node number. If a remote node is specified, it must be defined in the Node-Definitionsection of the TTGEN configuration file. Refer to the ACC Utilities Guide for more information about the TTGEN configuration or the ttgen(1) man page file.

134

Chapter 4

Image 134

HP UX 11i v1 I/O Cards manual ZLU Definition

Contents

ACC Programmer’s Reference Guide Page Legal Notices Page Printing History Ninth Edition April Release B.03.10 HP-UX Related Documentation Hardware Manuals Contents Zcom Tables and Data Structures Zcom C I/F Library Routines Contents Zcom Subsystem Introduction Zcom Software Overview Overview of Zcom Software Structure Zcom Zcom 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 Message Queuing Program Message Queueing Physical Terminal Table Priorities Multiplexing Outbound Multiplexing Outbound Multiplexing Inbound Multiplexing Inbound Multoplexing PTZRVR=PZLU Pzlu Terminal State Terminal State Error Handling Error Handling Zcom Tables and Data Zcom Tables and Data Structures Memory Organization Memory Organization Differences in 32-bit and 64-bit Data Structures Differences in 32-bit and 64-bit Data Structures Zcom Header Structure Hpptbl HpzluHpttbl Hpiftp Zcom Header Structure Zcom Header Structure Zcom Header Structure Zcom Header Structure Zcom Header Structure Ttgen Zcom Header Structure Qlbqnb QlbgrpQlbnam Qlbrsv Slbsze SlbgrpSlbnam Slboff Zcom Header Structure Node Entries Table FLAGS.status FLAGS.eventFLAGS.valid FLAGS.local Node Entries Table ZLU Tables Individual ZLU Entries ZLU Type Values Type Description ZLU Tables Logical Terminal Tables Lthdqn LtzshrcvrsLthldq Ltaddr Logical Terminal Tables System Status flags LTCWCT, LTTXCT, LTRXCT, Lterct Message and error counters Logical Status Structure Ltstat LTINST, LTBRCH, LTWORK, Ltarea Terminal logical ID Physical Terminal Tables Physical Terminal Tables User Maintainable Area Ptuser Field Name Field Description Field Type Size Bytes Physical 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 Interface HPA Value Inhpa 63-32 31-28 27-18 17-14 13-12 10-6 Symbol Value hex Meaning Interface Card Status Ifstat Scheduler Event Flags Ischdl Interface Table Interface Table Ipendgbufs Isubchbuf Ifirqbp Nextl Interface Table Zcomipstatund Zcomipstattxb Ecode Port Configuration Buffer IportnChannel E1/T1 ACC Card Format Sync TxSubch WhereTimeslot Array Element Structure TxFill Subchannel Specification Array Element Structure 31-30 29-24 23-8 IFIRQBUF, IRESPBUF, Istdtbuf DMA response buffers Datadelay Response Records Zcomrptyperemote Response Type Field Symbol Value MeaningZcomrptypebuffer Zcomrptypeirr Response Records Queue Header Queue Header Area Qfunc QlimitQfdata Queue Header Queue Flags Chapter 101 Data Buffer Pool Organization of Buffer Pool Buffer Pool Layout when first initialized Free Buffer Header Structure zfbhtype Buffer flags Bfflag Field Block Size Used flag 106 MRQ Message HeaderMID Mzdest MstypeMsresp Mzsrce Message Type Mstype Response code for message type 2 Response code for all other message types Mrqstat MrqcodeMrqterm Mrqtag Mrqcode Terminal request codes Request Value Description Senode SetypeSeflag Setime Nstat Node Status Change Event Fields ZcomsetypenodeNodenum Spare CFGINFO1 Dynamic Reconfiguration Event ZcomsetypereconfigCfgclass 116 Chapter 117 Zcom Kernel Data Ncard Chapter 119 HPA value of I/F card Hpano Chapter 121 SYS structure Zcom system global information, zsystype Name Value hex State Current Zcom system status Name Value hex StateCurrent Zcom system status Higher Order Bits Debug Level Field Format Debug Level Field Values Bit Name Value hex Meaning Chapter 125 Zcrlock ZcglockZcmlock Zcslock Lockp Refcount Zcom Kernel Data 128 Zcom C I/F Library Routines 130 ZLU configuration calls Zltstore Logical data storage allocation ZLU data transfer calls Chapter 133 ZLU Definition Man Pages Getdevice Getdevice Read Zcom device definitions Considerations Dpp Return param Example Ascii file, /opt/acc/cfg/zcomdevice.txt File, /opt/acc/cfg/zcomdeviceMultiprotocol ACC Utilities Reference Zdgen1, malloc3C Ltfind Description Len Length in bytes of ibuf Logical terminal table. Note that if the logicalTerminal is not found, ibuf will not contain valid data 142 Chapter 143 Ltqdget Ltqdget Posix 1003.1c kernel threads API package. This routine has 146 Ltqdput 148 Chapter 149 MYZLU01 MakezlunameTTY Name Returned Name Comment Makezluname Parameter and from the same TTY, the same ZLU name will be Ptfind 154 Physical terminal is not found i.e., ierr != 0, then no Pointer to a buffer into which the Zcom physicalTerminal table data will be placed. Note that if Data is moved into zptt Return Value Zclos Cancellation point Chapter 159 Zcntl Send no wait Send no wait, report errorsSend no wait, report errors with buffer Send no wait, definite status Rstat MhpACC Programmers’ Reference Guide Ibuf, len ReturnParam For rcode not all of them are applicable to zcntl Rtyp 164 Chapter 165 166 Zcomerror Not a cancellation point 168 Async-cancel safe Zcomlname Zcomlog3x Zcomlog 172 Int Zcom error code Int Unix error code, usually errnoUnix error string will be logged Zcom error string will be logged 174 Chapter 175 Zcomstatus ACC Programmers Reference Guide under ‘ZCOM Status Message Chapter 177 Zconfig Zap Return Param Response data Chapter 181 Zcomzconfigcard ZcomzconfigcntlZcomzconfigsys Zcomzconfigport Chapter 183 DSC Control Configuration DataHeader.config Header.action Data.setctl.cfginfo1 No specific response data or errorData.setctl.cfgclass Zcom subsystem Data.setsys.sysname Data.sysret.errorHeader.tag1 Header.tag2 Data.setsys.qlimit Chapter 187 Data.setcard.itype DscreassigniftData.setcard.iftno Data.setcard.fname Data.cardret.error Data.cardret.iftno Data.setport.spare Data.setport.portnoData.setport.rcode FM1 transition = FM0 transition = Data.setport.cnfgValue Encoding modes Value Parity select No Parity Odd parity Even parity Value Rate Value Clock multiplierValue Rate 0000 Use Baud2 1000 19,200 Pmode Pmode2 Fsync Value Other port for clock synchronization Port Value T1 Transmit Attenuation Z7330B only 15 dB 22.5 dB User device. By default the ACC is a user Otherwise by default there is a delay to avoidT1/ESF mode contain an address which Performance report messages in T1/ESF mode Data.portret.status Data.setport.qlimitData.portret.iftno Data.portret.portno Chapter 197 Configuration Data header.config Data.setportsc.subchno Data.setportsc.iftnoData.setportsc.portno Data.setportsc.rcode Data.setportsc.ptcfg-ptinfo.subchb.tmsl RTI Set to Set to ModeData.setportsc.ptcfg-ptinfo.subchb.spec Data.setportsc.len Data.portscret.status Chapter 203 Data.setterm.daddr Header.action ZcDSCCREATELTTPTT Create a new terminal LTTZcDSCCREATELTTONPTT Create a new LTT on an existing Data.setterm.iftno Data.setterm.dtype Data.setterm.portnoData.setterm.subchno Data.setterm.ltype Response Data data.termret.zaddr Chapter 207 208 Name Zeventrcvr 210 Chapter 211 ‘C’ structure for a Zcom Event Message is shown below Zcomsetypenode Files Zgetshrcvrlist Zgetshrcvrlist Get list of current shared receivers Should have ZcMAXSHAREDRCVRS+1 entries Table entry from which you want the shared receivers listType of shared receiver list is set to ZcMAXSHAREDRCVRS 216 Name Zinfo Param Return, Tables and Data Structures section Returnvalue Files Zinit Zinit Zcom routine initialization Parameters Following fields Chapter 223 Zltmg Zltmg Move a logical terminal between groups Zltmg 226 Zltmx Zltmx Control logical terminal multiplexing Parameters Chapter 229 Zltqueue Zltqueue Logical data queue allocation Application number of terminal group Appln Appln Queue Returned Program Nmbr Label Queue No Chapter 233 Zltstore Zltstore Logical data storage allocation Terminal table, for the storage in the extension area 236 Zltup 238 Chapter 239 Zluopen Zcom error codes and their meanings This return parameter is undefined 242 Zmapr 244 Zname 246 Chapter 247 Zopen Node contains the local node as defined in the Ttgen Ld1Zap Zcom address node, ZLU number, and checksum 250 Chapter 251 Zpeek Error codes and their meanings Zread3X, zluopen3X Zport Zcomzmuxportbaud ZcomzmuxportallZcomzmuxportconf Zcomzmuxportport Illegal port mode No errorSome terminals in this port not disabled Break routine not installed Clk Value Operating modeValue Parity select Value Clock source 258 T1 ESF Value Port ModeValue 260 Chapter 261 Zptup Chapter 263 Zqmve Chapter 265 Zqsze Zqhdp Return param 268 Zread There is no message on the queue, error Zenodata Mode ZcREADWWAIT 0 Read with waitAfter the timeout period has elapsed Same ZLU. When a message arrives, only one Chapter 271 272 Chapter 273 274 Zrntimer 276 Chapter 277 Zsend Mhp-mid.ztagw2 Zsend 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