Data.setcard.itype | HP Advanced Communications Controllers (ACC)

ZCOM C I/F Library Routines

ZCONFIG (3X)

Configuration Data header.config

ZCOM_ZCONFIG_CARD (interface configuration)

header.action
ZcDSC_CHNG_FW_FILE	(1)	- Modify interface firmware file name
ZcDSC_CREATE_IFT	(2)	- Create a new interface table
ZcDSC_START_CARD	(3)	- Startup (e.g. restart) an interface card
ZcDSC_HALT_CARD	(4)	- Disable an interface
ZcDSC_STOP_CARD	(5)	- Shutdown (e.g. disable and flush) an
		interface card
DSC_REASSIGN_IFT	(6)	- Link an interface to different hardware

header.tag1,

header.tag2 Any values

data.setcard.iftno

Interface card number (0, 1,...)

data.setcard.bc1_addr

data.setcard.bc_addr

data.setcard.card_addr

These are the bus converter address and card address (as specified in a TTGEN configuration file) of the new hardware. These fields are needed for action 2 and 6 only.

data.setcard.itype

Interface card type. This indicates the hardware type of the new interface card. Currently, the types ZCOM_ITYPE_MUX, ZCOM_ITYPE_Z7200A, ZCOM_ITYPE_Z7300A, ZCOM_ITYPE_Z7340A, ZCOM_ITYPE_Z7350A, and ZCOM_ITTYPE_Z7400AR are supported. This field is needed for action 2 only.

data.setcard.fname

New firmware file name. This field is used for action 1 only.

200

Chapter 4

Image 200

HP Advanced Communications Controllers (ACC) manual Link an interface to different hardware, Data.setcard.itype

Contents

ACC Programmer’s Reference Guide Page Legal Notices Page Printing History First Edition February 2004 Release Related Documentation Software Manuals Contents Zcom C I/F Library Routines Contents Contents Zcom Subsystem Introduction Zcom Software Overview Overview of Zcom Software Structure 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 Inbound Multiplexing Inbound Multiplexing PTZRVR=PZLU Terminal State Terminal State Error Handling Error Handling Chapter Zcom Tables and Data Zcom Tables and Data Structures Memory Organization Memory Organization Differences in 32-bit and 64-bit Data Structures ACC Zcom product to implement its functionality. These data Field Name Field Description Field Type Size Bytes Zcom Header StructureZcom Header Structure Hncard HnrespHnltql Hnltsl Hndpid HndsigHnidle Hnhigh Zcom Header Structure Zcom Header Structure Zcom Header Structure Zcom Header Structure Zcom Header Structure Ttgen Zcom Header Structure Queue Label Table QlbgrpQlbnam Qlbqnb Storage Label Table Zcom Header Structure Node Entries Table Node Entries Table Stats Data Structure FLAGS.eventFLAGS.valid FLAGS.status Host Link Information Structure Node Entries Table ZLU Tables Individual ZLU Data Structure zlutype ZLU Type Values Type Description ZLU Tables Field Name Field Description Size Type Bytes Logical Terminal TablesLogical Terminal Table Reserved Area Logical Terminal Table User Maintainable Area 10 Logical Terminal Table User Maintainable Area SPARE2 System Status flags Logical Terminal Tables LTINST, LTBRCH, LTWORK, Ltarea Terminal logical ID LTCWCT, LTTXCT, LTRXCT, Lterct Message and error countersLogical Status Format Ltstat Physical Terminal Tables Physical Terminal Tables System Area Physical Terminal Tables User Maintainable Area Ptuser Physical Terminal Tables Physical Terminal Tables Physical Terminal Tables Terminal Status Field Ptdrst Physical Terminal Tables Physical Terminal Tables Interface Table Interface Table Imaxterms Iportn Interface HPA Value Format Inhpa 63-32 31-2 27-18 17-1 13-12 10-6 Symbol Value hex Meaning Interface Card Status Ifstat Scheduler Event Flags Ischdl Interface Table Interface Table CARD.MMP Structure CARD.BSP Structure Interface Table Itxlstx Express Transmit List Headers Tmtail Interface Table Zcomipstattxbx Port Configuration Buffer Iportn Fmode 20 4-Channel E1/T1 ACC Card Format31-30 29-26 26-22 21-20 19-16 15-11 10-0 Port Subchannel Configuration Structure Timeslot Array Element Structure 23 Subchannel Specification Array Element Structure 31-30 29-24 23-8Itbs INV Interface Table Optional E1/T1 Tunable Parameters Bquota Response Records Response Record Format Symbol Value Meaning Response Type FieldZcomrptypebuffer Zcomrptyperemote 100 Queue Header Free Queue Header Structure zfqhtype Queue Header Structure zqhdtype QlimitQfdata Qfunc Chapter 103 Symbol Value Meaning Hex Queue Flag Format Chapter 105 Data Buffer Pool Organization of Buffer Pool Chapter 107 Buffer Pool Layout when first initialized Linkage to the next buffer. zbhdtype. See -30 and Table System flags length & status Uns.intReserved, not used Int Pointer to next buffer on queue 32 Buffer flags Bfflag Field Format Flag Chapter 111 Message Header Message Header zmhdtypeMID MRQ Message ID Header zmidtype Message Type Mstype Response code for message type 2 and 10 Format 37 Response code for all other message typesLPR XPS PGW BFR DEF ERR LPR Message Request Header zmrqtype Mrqcode Terminal request codes Request Value Description 118 System Event Message zeventtype Structure Node Status Change Event Fields Zcomsetypenode NodenumNstat Spare CFGINFO1 Dynamic Reconfiguration EventCfgclass Change in Card Status Event Zcomsetypecard Chapter 123 Zcom Kernel Data HPA Table EntriesHPA value of this interface Long Reserved for future use Int Chapter 125 HPA value of I/F card Hpano Chapter 127 SYS structure Zcom system global information Name Value hex State Current Zcom system statusCurrent Zcom system status Higher Order Bits Bit Name Value Meaning Hex Debug Level Field FormatDebug Level Field Values Chapter 131 132 Linfo Structure Fields ZcglockZcmlock Zcrlock Refcount Super IFT spinlock Zcslock Data StructureLockp Zcom C I/F Library Routines 136 Zinit Zcom library access initialization Initialization call Interface configuration calls ZLU information calls Zsend Send data buffer to ZLU ZLU Definition Man Pages Fork unsafe Cancellation pointGetdevice Chapter 143 Allocated memory when it is no longer needed Pointer to a data structure containing the fullDevice table. The device table is an array Zdevtype elements Device file, /opt/acc/cfg/zcomdevice Multiprotocol ACC Utilities Reference Opt/acc/cfg/zcomdevice.txt Zdgen1, malloc3C Ltfind Zap LaddrLlen Ibuf Return Param Chapter 149 150 Ltqdget 152 Ltqdget 154 Ltqdput 156 Zcom error codes and their meanings Ltqdput 158 MYZLU01 MakezlunameReturned Comment Name Parameter and from the same TTY, the same ZLU name will be Be returned Chapter 161 Ptfind Chapter 163 Async-cancel unsafe Async-signal unsafe Pointer to a buffer into which the Zcom Physical terminal table data will be placedIerr != 0, then no data is moved into zptt Len Length in bytes of zptt buffer 166 Chapter 167 Zclos Zclos Zcntl Zmodenowait ZmoderpterrsZmodedefstatus Zmoderpterrswbuf Mhp Multi-protocol ACC Programmers’ Reference Guide Rstat ReturnParam Rtyp 174 Chapter 175 176 Chapter 177 Point ZcomerrorNot a cancellation File zerrmsg.msg in /opt/acc/msg ZCOMMESSAGEPATH. If not Err Error numberFound, it uses the default message file default.msg 180 Async-cancel safe Zcomlname Zcomlog3x Zcomlog 184 Zcomatzerror ZcomatcharZcomatuchar Zcomatsint 186 Chapter 187 Zcomstatus ACC Programmers Reference Guide under ‘ZCOM Status Message Chapter 189 Zconfig Node Destination node Return Param Response data CdataRdata Chapter 193 Zcomzconfigcntl ZcomzconfigsysZcomzconfigcard Zcomzconfigport Zcomsetypereconfig DSC Control Configuration Data header.config Header.tag1 Header.tag2 Any values Data.setctl.cfgclass No specific response data or errorHeader.config Data.sysret.error Header.tag1 Header.tag2Data.setsys.sysname Data.setsys.qlimit Chapter 199 Link an interface to different hardware Header.tag1 Header.tag2 Any values Data.setcard.iftnoData.setcard.itype Data.setcard.fname Data.cardret.error Data.cardret.iftno Data.setport.spare Data.setport.portnoData.setport.rcode Value Sync mode select Value Operating modeData.setport.cnfg Value Encoding modes Parity select No ParityOdd parity Even parity Value Port mode 0001 300Value Rate 0000 150 Frame mode parameter Fmod Value T1 Transmit Attenuation Z7330B only 15 dB 22.5 dB Value Port mode 0000 ReservedValue Other port for clock synchronization Port Otherwise by default there is a delay to avoid Fast link-down optionMakes the line go down whenever loss of T1/E1 Frame synchronization is detected by the Falc Long-haul mode Z7330B only JT G.706 mode Z7330B onlyT1/ESF performance report messages suppressed Reduced corner frequency Z7330B only Data.portret.iftno Data.portret.portno Data.portret.status Chapter 211 212 Configuration Data Header.actionData.setportsc.iftno Data.setportsc.portno Transmit subch number Transmit fill mask Set to Receive subch number Receive fill mask Chapter 215 Set to Mode Data.setportsc.ptcfg-ptinfo.subchb.specData.setportsc.len Data.setportsc.qlimit Data.portscret.status 218 Chapter 219 220 Data.setterm.zaddr Data.setterm.daddrData.setterm.iftno Data.setterm.portno Data.setterm.ptt Response Data data.termret.zaddr 224 Chapter 225 Zeventrcvr Chapter 227 228 Chapter 229 ‘C’ structure for a Zcom Event Message is shown below Zcomsetypenode Chapter 231 232 Zgetshrcvrlist Zgetshrcvrlist Get list of current shared receivers Type of data specified by the mode parameter. The list Is terminated by an entry with a zlu value of 0.Maximum number of receivers in each type of shared Receiver list is set to ZcMAXSHAREDRCVRS currently Chapter 235 Zinfo Zinfo 238 Chapter 239 Zinit Default program ZLU queue limit Calling zinit. See zrntimer3X for more informationInitialization phase, before any threads are generated Following fields 242 Zltmg Error codes and their meanings Zltmx 246 Chapter 247 Zltqueue Appln Queue Progra Returned Nmb Label UsageGloba Ccccc 250 Chapter 251 Zltstore Zltstore Logical terminal table, for the storage Extension area Chapter 255 256 Zltup 258 Chapter 259 Zluopen Async-cancel Async-signalUnsafe Unsafe Fork unsafe 262 Chapter 263 Zmapr Zmapr Zname Zname Zcom address Chapter 269 Zopen Chapter 271 Limit PflagName 273 Zpeek Chapter 275 Zport Chapter 277 For Z7200A, Z7340A and Z7400A ACC Interface cards Stat FM1 transition = FM0 transition = Cnfg Configuration data 32 bitsEcode Sync Mode Parity Clk Baud Pmode Pmode2 = Not Used Value Parity select No Parity Odd parity Even parity PmodeValue Port mode Value Rate 0000 Use Baud2 1000 19,200 T1 ESF Chapter 283 284 Chapter 285 286 Zptup 288 Zqmve 290 Chapter 291 Zqsze Zqhdp Return param 294 Chapter 295 Zread Chapter 297 Not require the returned message header. It is described Subsection on ‘Message Header’ in the Multiprotocol ACCProgrammers’ Reference Guide. See the data structure Zmhdtype in zcomsys.h for more detail Rstat Return status No errorVe Zcom error code 300 Chapter 301 302 Chapter 303 Zrntimer Not a cancellation point Means setting the timeout values for ALL remote nodes Ttgen configuration file. If an unknown node number isSpecified, it is rejected with error -6 Zenode Timeout processing is activated on 1-second intervals 306 Zsend Mhp-mid.ztagw2 308 Null may be used if the return status is not required 310 Chapter 311 Mode=0 Mode=1 Mode=2 Mode=5 Mode=8 314 Chapter 315 Zsetql Chapter 317 318 Chapter 319 320 Zsetrcvr 322 Chapter 323 Rzap Chapter 325 Ztimr Chapter 327 328