HP UX 11i v1 I/O Cards manual Parameters, Following fields

Page 222

ZCOM C I/F Library Routines

ZINIT (3X)

PARAMETERS

sip (Return Param) ZCOM system information data structure containing

 

the following fields:

 

sizrev

ZCOM software revision code (4 digits).

 

sinode

ZCOM system local node number.

 

sinzlu

Total number of ZLU tables in the ZCOM system.

 

sinltt

Total number of Logical Terminal Tables in the ZCOM system.

 

sinptt

Total number of Physical Terminal Tables in the ZCOM system.

 

sinift

Total number of Interface Tables in the ZCOM system.

 

sintzlu

Total number of terminal ZLUs in the ZCOM system.

 

siszlu1

First program ZLU in the ZLU table.

 

sipqlim

Default program ZLU queue limit.

 

siltsze

Size (in bytes) of the Logical Terminal Table (LTT).

 

sispare

Reserved for future use.

NOTES

1. If the calling program has already opened a primary ZLU, the

 

primary ZLU will be reset after calling zinit: the ZLU remains open

 

and its contents is not disturbed, but it stops being the ‘primary’ ZLU

 

of the calling program. The calling program will no longer have a

 

primary ZLU and need to call zopen to open a primary ZLU again

 

(usually with the same name, hence the same ZLU will be opened).

 

The other opened ZLUs are not affected by calling zinit. See

 

zopen(3X) for more information about the primary ZLU.

 

2. The zinit routine will reset the node timeouts to the default values.

 

Hence, any user specified node timeout must be set again after calling

 

zinit. See zrntimer(3X) for more information.

 

3. In a multi-threaded application, this routine is to be called only once

 

by any one of the threads. Once zinit returns successfully, the

 

necessary initialization tasks are completed for all threads, and all

 

subsequent calls to ZCOM APIs will be allowed. There is no need for

 

the other running threads or the newly created threads to call this

 

routine again. Usually, zinit is to be called during the main program’s

 

initialization phase, before any threads are generated.

222

Chapter 4

Image 222
Contents ACC Programmer’s Reference Guide Page Legal Notices Page Printing History Ninth Edition April Release B.03.10 HP-UXRelated Documentation Hardware ManualsContents Zcom Tables and Data Structures Zcom C I/F Library Routines Contents Zcom Subsystem Introduction Zcom Software Overview Overview of Zcom Software Structure ZcomZcom 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 QueueingPhysical Terminal Table Priorities Multiplexing Outbound Multiplexing Outbound MultiplexingInbound Multiplexing Inbound Multoplexing PTZRVR=PZLU PzluTerminal 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 Hpptbl HpzluHpttbl HpiftpZcom Header Structure Zcom Header Structure Zcom Header Structure Zcom Header Structure Zcom Header Structure Ttgen Zcom Header Structure Qlbqnb QlbgrpQlbnam QlbrsvSlbsze SlbgrpSlbnam SlboffZcom Header Structure Node Entries Table FLAGS.status FLAGS.eventFLAGS.valid FLAGS.localNode Entries Table ZLU Tables Individual ZLU EntriesZLU Type Values Type DescriptionZLU Tables Logical Terminal Tables Lthdqn LtzshrcvrsLthldq LtaddrLogical Terminal Tables System Status flags LTCWCT, LTTXCT, LTRXCT, Lterct Message and error counters Logical Status Structure LtstatLTINST, LTBRCH, LTWORK, Ltarea Terminal logical ID Physical Terminal Tables Physical Terminal Tables User Maintainable Area Ptuser Field Name Field Description Field Type Size BytesPhysical 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-6Symbol Value hex Meaning Interface Card Status IfstatScheduler 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 SyncTxSubch WhereTimeslot Array Element Structure TxFillSubchannel Specification Array Element Structure 31-30 29-24 23-8IFIRQBUF, IRESPBUF, Istdtbuf DMA response buffers Datadelay Response Records Zcomrptyperemote Response Type Field Symbol Value MeaningZcomrptypebuffer ZcomrptypeirrResponse Records Queue Header Queue Header AreaQlimit QfdataQfunc Queue Header Queue Flags Chapter 101 Data Buffer Pool Organization of Buffer PoolBuffer Pool Layout when first initialized Free Buffer Header Structure zfbhtype Buffer flags Bfflag Field Block Size Used flag106 Message Header MIDMRQ Mzdest MstypeMsresp MzsrceMessage Type Mstype Response code for message type 2 Response code for all other message typesMrqstat MrqcodeMrqterm MrqtagMrqcode Terminal request codes Request Value DescriptionSenode SetypeSeflag SetimeNstat Node Status Change Event Fields ZcomsetypenodeNodenum SpareDynamic Reconfiguration Event Zcomsetypereconfig CfgclassCFGINFO1 116 Chapter 117 Zcom Kernel Data NcardChapter 119 HPA value of I/F card Hpano Chapter 121 SYS structure Zcom system global information, zsystype Current Zcom system status Name Value hex State Current Zcom system status Higher Order BitsName Value hex State Debug Level Field Format Debug Level Field Values Bit Name Value hex MeaningChapter 125 Zcrlock ZcglockZcmlock ZcslockLockp RefcountZcom Kernel Data 128 Zcom C I/F Library Routines 130 ZLU configuration calls Zltstore Logical data storage allocationZLU data transfer calls Chapter 133 ZLU Definition Man Pages Getdevice Getdevice Read Zcom device definitionsConsiderations Dpp Return paramExample Ascii file, /opt/acc/cfg/zcomdevice.txt File, /opt/acc/cfg/zcomdeviceMultiprotocol ACC Utilities Reference Zdgen1, malloc3CLtfind DescriptionLogical terminal table. Note that if the logical Terminal is not found, ibuf will not contain valid dataLen Length in bytes of ibuf 142 Chapter 143 Ltqdget Ltqdget Posix 1003.1c kernel threads API package. This routine has146 Ltqdput 148 Chapter 149 Makezluname TTY Name Returned Name CommentMYZLU01 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 zpttReturn 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 statusRstat MhpACC Programmers’ Reference Guide Ibuf, len ReturnParamFor rcode not all of them are applicable to zcntl Rtyp164 Chapter 165 166 Zcomerror Not a cancellation point168 Async-cancel safe ZcomlnameZcomlog3x Zcomlog 172 Int Zcom error code Int Unix error code, usually errnoUnix error string will be logged Zcom error string will be logged174 Chapter 175 Zcomstatus ACC Programmers Reference Guide under ‘ZCOM Status MessageChapter 177 Zconfig Zap Return Param Response data Chapter 181 Zcomzconfigcard ZcomzconfigcntlZcomzconfigsys ZcomzconfigportChapter 183 DSC Control Configuration DataHeader.config Header.actionData.setctl.cfginfo1 No specific response data or errorData.setctl.cfgclass Zcom subsystemData.setsys.sysname Data.sysret.errorHeader.tag1 Header.tag2 Data.setsys.qlimitChapter 187 Data.setcard.itype DscreassigniftData.setcard.iftno Data.setcard.fnameData.cardret.error Data.cardret.iftnoData.setport.portno Data.setport.rcodeData.setport.spare FM1 transition = FM0 transition = Data.setport.cnfgValue Encoding modes Value Parity select No Parity Odd parity Even parityValue Clock multiplier Value Rate 0000 Use Baud2 1000 19,200Value Rate Pmode Pmode2 FsyncValue Other port for clock synchronization Port Value T1 Transmit Attenuation Z7330B only 15 dB 22.5 dBUser 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 modeData.setport.qlimit Data.portret.iftno Data.portret.portnoData.portret.status Chapter 197 Configuration Data header.config Data.setportsc.subchno Data.setportsc.iftnoData.setportsc.portno Data.setportsc.rcodeData.setportsc.ptcfg-ptinfo.subchb.tmsl RTISet to Set to ModeData.setportsc.ptcfg-ptinfo.subchb.spec Data.setportsc.lenData.portscret.status Chapter 203 Data.setterm.daddr Header.action ZcDSCCREATELTTPTT Create a new terminal LTTZcDSCCREATELTTONPTT Create a new LTT on an existing Data.setterm.iftnoData.setterm.dtype Data.setterm.portnoData.setterm.subchno Data.setterm.ltypeResponse Data data.termret.zaddr Chapter 207 208 Name Zeventrcvr210 Chapter 211 ‘C’ structure for a Zcom Event Message is shown below ZcomsetypenodeFiles Zgetshrcvrlist Zgetshrcvrlist Get list of current shared receiversTable entry from which you want the shared receivers list Type of shared receiver list is set to ZcMAXSHAREDRCVRSShould have ZcMAXSHAREDRCVRS+1 entries 216 Name ZinfoReturn , Tables and Data Structures sectionParam Returnvalue Files Zinit Zinit Zcom routine initializationParameters Following fieldsChapter 223 Zltmg Zltmg Move a logical terminal between groupsZltmg 226 Zltmx Zltmx Control logical terminal multiplexingParameters Chapter 229 Zltqueue Zltqueue Logical data queue allocationApplication number of terminal group ApplnAppln Queue Returned Program Nmbr Label Queue No Chapter 233 Zltstore Zltstore Logical data storage allocationTerminal table, for the storage in the extension area 236 Zltup 238 Chapter 239 Zluopen Zcom error codes and their meanings This return parameter is undefined242 Zmapr 244 Zname 246 Chapter 247 Zopen Ld1 Zap Zcom address node, ZLU number, and checksumNode contains the local node as defined in the Ttgen 250 Chapter 251 Zpeek Error codes and their meanings Zread3X, zluopen3XZport Zcomzmuxportbaud ZcomzmuxportallZcomzmuxportconf ZcomzmuxportportIllegal port mode No errorSome terminals in this port not disabled Break routine not installedClk Value Operating modeValue Parity select Value Clock source258 Value Port Mode ValueT1 ESF 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 oneChapter 271 272 Chapter 273 274 Zrntimer 276 Chapter 277 Zsend Mhp-mid.ztagw2Zsend 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