HP Advanced Communications Controllers (ACC) manual

Page 251

ZCOM C I/F Library Routines

ZLTQUEUE (3X)

EXAMPLE

#include

<zcom/zcomsys.h>

 

 

#include

<zcom/zcomcall.h>

 

 

int32

ierr;

 

 

uint32

appln;

 

 

char

label[6];

 

 

uint32

queue

 

 

if (ierr = zltqueue (appln, label, &queue)) {

 

/* error return code */

 

 

}

 

 

 

else {

 

 

 

/* good return code */

 

 

}

 

 

FILES

 

 

 

 

/opt/acc/include/zcom/zcomsys.h

ZCOM subsystem general include

 

 

 

file, containing data types, data

 

 

 

structures, constants, error codes,

 

 

 

masks, etc. Note that this must be the

 

 

 

first include file before any other

 

 

 

ZCOM include files.

 

/opt/acc/include/zcom/zcomcall.h

ZCOM routine function prototypes

 

 

 

(requires ANSI C compilation).

SEE ALSO

ltqdget(3X), ltqdput(3X), zltstore(3X), zltup(3X)

Chapter 4

251

Image 251
Contents ACC Programmer’s Reference Guide Page Legal Notices Page First Edition February 2004 Release Printing HistorySoftware Manuals Related DocumentationContents 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 Program Message Queueing Message QueuingPhysical Terminal Table Priorities Multiplexing Outbound Multiplexing Inbound Multiplexing PTZRVR=PZLU Inbound MultiplexingTerminal State Terminal StateError Handling Error Handling Chapter Zcom Tables and Data Zcom Tables and Data Structures Memory Organization Memory OrganizationDifferences 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 Hnltsl HncardHnresp HnltqlHnhigh HndpidHndsig HnidleZcom Header Structure Zcom Header Structure Zcom Header Structure Zcom Header Structure Zcom Header Structure Ttgen Zcom Header Structure Qlbqnb Queue Label TableQlbgrp QlbnamStorage Label Table Zcom Header Structure Node Entries Table Node Entries TableFLAGS.status Stats Data StructureFLAGS.event FLAGS.validHost Link Information Structure Node Entries Table Individual ZLU Data Structure zlutype ZLU TablesType Description ZLU Type ValuesZLU Tables Field Name Field Description Size Type Bytes Logical Terminal TablesLogical Terminal Table Reserved Area Logical Terminal Table User Maintainable Area SPARE2 10 Logical Terminal Table User Maintainable AreaSystem 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 System Area Physical Terminal TablesPhysical 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 TableImaxterms Iportn 63-32 31-2 27-18 17-1 13-12 10-6 Interface HPA Value Format InhpaInterface Card Status Ifstat Symbol Value hex MeaningScheduler Event Flags Ischdl Interface Table Interface Table CARD.MMP Structure CARD.BSP Structure Interface Table Tmtail Itxlstx Express Transmit List HeadersInterface 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 Timeslot Array Element Structure Port Subchannel Configuration StructureINV 23 Subchannel Specification Array Element Structure31-30 29-24 23-8 ItbsInterface Table Optional E1/T1 Tunable Parameters Bquota Response Record Format Response RecordsZcomrptyperemote Symbol Value MeaningResponse Type Field Zcomrptypebuffer100 Free Queue Header Structure zfqhtype Queue HeaderQfunc Queue Header Structure zqhdtypeQlimit QfdataChapter 103 Queue Flag Format Symbol Value Meaning HexChapter 105 Organization of Buffer Pool Data Buffer PoolChapter 107 Buffer Pool Layout when first initialized Pointer to next buffer on queue Linkage to the next buffer. zbhdtype. See -30 and TableSystem flags length & status Uns.int Reserved, not used IntFlag 32 Buffer flags Bfflag Field FormatChapter 111 MRQ Message HeaderMessage Header zmhdtype MIDMessage ID Header zmidtype Message Type Mstype LPR Response code for message type 2 and 10 Format37 Response code for all other message types LPR XPS PGW BFR DEF ERRMessage Request Header zmrqtype Request Value Description Mrqcode Terminal request codes118 System Event Message zeventtype Structure Spare Node Status Change Event Fields ZcomsetypenodeNodenum NstatCFGINFO1 Dynamic Reconfiguration EventCfgclass Change in Card Status Event Zcomsetypecard Chapter 123 Reserved for future use Int Zcom Kernel DataHPA Table Entries HPA value of this interface LongChapter 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 Zcrlock Linfo Structure FieldsZcglock ZcmlockRefcount Super IFT spinlock Zcslock Data StructureLockp Zcom C I/F Library Routines 136 Initialization call Zinit Zcom library access initializationInterface configuration calls Zsend Send data buffer to ZLU ZLU information callsZLU Definition Man Pages Fork unsafe Cancellation pointGetdevice Chapter 143 Zdevtype elements Allocated memory when it is no longer neededPointer to a data structure containing the full Device table. The device table is an arrayMultiprotocol ACC Utilities Reference Device file, /opt/acc/cfg/zcomdeviceZdgen1, malloc3C Opt/acc/cfg/zcomdevice.txtLtfind Ibuf Return Param ZapLaddr LlenChapter 149 150 Ltqdget 152 Ltqdget 154 Ltqdput 156 Ltqdput Zcom error codes and their meanings158 MYZLU01 MakezlunameReturned Comment Name Be returned Parameter and from the same TTY, the same ZLU name will beChapter 161 Ptfind Chapter 163 Async-signal unsafe Async-cancel unsafeLen Length in bytes of zptt buffer Pointer to a buffer into which the ZcomPhysical terminal table data will be placed Ierr != 0, then no data is moved into zptt166 Chapter 167 Zclos Zclos Zcntl Zmoderpterrswbuf ZmodenowaitZmoderpterrs ZmodedefstatusMulti-protocol ACC Programmers’ Reference Guide MhpRtyp RstatReturn Param174 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 Zcomlname Async-cancel safeZcomlog3x Zcomlog 184 Zcomatsint ZcomatzerrorZcomatchar Zcomatuchar186 Chapter 187 ACC Programmers Reference Guide under ‘ZCOM Status Message ZcomstatusChapter 189 Zconfig Node Destination node Return Param Response data CdataRdata Chapter 193 Zcomzconfigport ZcomzconfigcntlZcomzconfigsys ZcomzconfigcardDSC Control ZcomsetypereconfigHeader.tag1 Header.tag2 Any values Configuration Data header.configData.setctl.cfgclass No specific response data or errorHeader.config Data.setsys.qlimit Data.sysret.errorHeader.tag1 Header.tag2 Data.setsys.sysnameChapter 199 Data.setcard.fname Link an interface to different hardwareHeader.tag1 Header.tag2 Any values Data.setcard.iftno Data.setcard.itypeData.cardret.iftno Data.cardret.errorData.setport.spare Data.setport.portnoData.setport.rcode Value Encoding modes Value Sync mode selectValue Operating mode Data.setport.cnfgEven parity Parity selectNo Parity Odd parity0000 150 Value Port mode0001 300 Value RateFmod Frame mode parameterValue T1 Transmit Attenuation Z7330B only 15 dB 22.5 dB Value Port mode 0000 ReservedValue Other port for clock synchronization Port Frame synchronization is detected by the Falc Otherwise by default there is a delay to avoidFast link-down option Makes the line go down whenever loss of T1/E1Reduced corner frequency Z7330B only Long-haul mode Z7330B onlyJT G.706 mode Z7330B only T1/ESF performance report messages suppressedData.portret.status Data.portret.iftno Data.portret.portnoChapter 211 212 Data.setportsc.portno Configuration DataHeader.action Data.setportsc.iftnoReceive subch number Receive fill mask Transmit subch number Transmit fill mask Set toChapter 215 Data.setportsc.qlimit Set to ModeData.setportsc.ptcfg-ptinfo.subchb.spec Data.setportsc.lenData.portscret.status 218 Chapter 219 220 Data.setterm.portno Data.setterm.zaddrData.setterm.daddr Data.setterm.iftnoData.setterm.ptt Response Data data.termret.zaddr 224 Chapter 225 Zeventrcvr Chapter 227 228 Chapter 229 Zcomsetypenode ‘C’ structure for a Zcom Event Message is shown belowChapter 231 232 Zgetshrcvrlist Get list of current shared receivers ZgetshrcvrlistReceiver list is set to ZcMAXSHAREDRCVRS currently Type of data specified by the mode parameter. The listIs terminated by an entry with a zlu value of 0. Maximum number of receivers in each type of sharedChapter 235 Zinfo Zinfo 238 Chapter 239 Zinit Following fields Default program ZLU queue limitCalling zinit. See zrntimer3X for more information Initialization phase, before any threads are generated242 Zltmg Error codes and their meanings Zltmx 246 Chapter 247 Zltqueue Ccccc Appln Queue Progra Returned Nmb LabelUsage Globa250 Chapter 251 Zltstore Zltstore Extension area Logical terminal table, for the storageChapter 255 256 Zltup 258 Chapter 259 Zluopen Unsafe Fork unsafe Async-cancelAsync-signal Unsafe262 Chapter 263 Zmapr Zmapr Zname Zname Zcom address Chapter 269 Zopen Chapter 271 Limit PflagName 273 Zpeek Chapter 275 Zport Chapter 277 Stat For Z7200A, Z7340A and Z7400A ACC Interface cardsFM1 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 Value Rate 0000 Use Baud2 1000 19,200 PmodeValue Port modeT1 ESF Chapter 283 284 Chapter 285 286 Zptup 288 Zqmve 290 Chapter 291 Zqsze Zqhdp Return param 294 Chapter 295 Zread Chapter 297 Zmhdtype in zcomsys.h for more detail Not require the returned message header. It is describedSubsection on ‘Message Header’ in the Multiprotocol ACC Programmers’ Reference Guide. See the data structureRstat Return status No errorVe Zcom error code 300 Chapter 301 302 Chapter 303 Not a cancellation point ZrntimerTimeout processing is activated on 1-second intervals Means setting the timeout values for ALL remote nodesTtgen configuration file. If an unknown node number is Specified, it is rejected with error -6 Zenode306 Mhp-mid.ztagw2 Zsend308 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
Related manuals
Manual 54 pages 2.24 Kb