HP UX 11i v1 I/O Cards manual Zsetrcvr

Page 293

 

 

ZCOM C I/F Library Routines

 

 

ZSET_RCVR (3X)

PARAMETERS

 

 

action

Type of action to perform.

 

 

ZcADD_PRIMARY

- Sets the program ZLU as the primary receiver.

 

ZcDEL_PRIMARY

- Deletes the primary receiver.

 

ZcADD_SHARED

- Adds the program ZLU to the list of shared receiv

 

ZcDEL_SHARED

- Removes the program ZLU from the list of shared

zap

ZCOM address of terminal.

 

mode

Receiver mode:

 

 

ZcNORMAL

(0) - Set receiver for normal messages

 

ZcINB_MLTPLX

(1) - Set inbound multiplexer receiver

 

ZcOUTB_MLTPLX

(2) - Set outbound multiplexer receiver

 

ZcCONTROL

(3) - Set receiver for control messages

 

Note: Only one constant value can be specified per call for this field. You cannot

 

OR these values in one call

 

rzap

ZCOM address of the receiver program.

NOTES

Usually, an application uses only mode ZcNORMAL to set up itself as the

 

receiver for normal data and status messages. An application uses mode

 

ZcCONTROL only if it needs to receive “control” messages. Control

 

messages are generated by ZCOM protocol modules. You should refer to

 

the specific ZCOM Protocol Manual to determine the “control” messages

 

generated by that protocol, if any.

 

Modes ZcINB_MLTPLX and ZcOUTB_MLTPLX require the terminal to

 

be an inbound and outbound multiplexed terminal, respectively.

 

Otherwise, error ZERTYPE (-54) is returned. A multiplexed terminal is

 

usually set up by defining the proper device type in the TTGEN

 

configuration file (using TERM or LTERM statements). It may also be

 

modified by using zltmx.

When inbound multiplexing is enabled for a terminal, an inbound receiver must be set up (using mode ZcINB_MLTPLX) by the multiplexing program, which will be responsible for receiving messages from the terminal and passing them to the “normal receivers” kept in the logical terminal tables.

Chapter 4

293

Image 293
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 Hpttbl HpzluHpptbl HpiftpZcom Header Structure Zcom Header Structure Zcom Header Structure Zcom Header Structure Zcom Header Structure Ttgen Zcom Header Structure Qlbnam QlbgrpQlbqnb QlbrsvSlbnam SlbgrpSlbsze SlboffZcom Header Structure Node Entries Table FLAGS.valid FLAGS.eventFLAGS.status FLAGS.localNode Entries Table Individual ZLU Entries ZLU TablesType Description ZLU Type ValuesZLU Tables Logical Terminal Tables Lthldq LtzshrcvrsLthdqn LtaddrLogical 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 Channel E1/T1 ACC Card Format Port Configuration Buffer IportnEcode SyncTimeslot Array Element Structure WhereTxSubch TxFill31-30 29-24 23-8 Subchannel Specification Array Element StructureIFIRQBUF, IRESPBUF, Istdtbuf DMA response buffers Datadelay Response Records Zcomrptypebuffer Response Type Field Symbol Value MeaningZcomrptyperemote ZcomrptypeirrResponse Records Queue Header Area Queue HeaderQfunc QlimitQfdata 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 MRQ Message HeaderMID Msresp MstypeMzdest MzsrceMessage Type Mstype Response code for all other message types Response code for message type 2Mrqterm MrqcodeMrqstat MrqtagRequest Value Description Mrqcode Terminal request codesSeflag SetypeSenode SetimeNodenum Node Status Change Event Fields ZcomsetypenodeNstat SpareCFGINFO1 Dynamic Reconfiguration Event ZcomsetypereconfigCfgclass 116 Chapter 117 Ncard Zcom Kernel DataChapter 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 Values Bit Name Value hex Meaning Debug Level Field FormatChapter 125 Zcmlock ZcglockZcrlock ZcslockRefcount 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 Multiprotocol ACC Utilities Reference File, /opt/acc/cfg/zcomdeviceAscii file, /opt/acc/cfg/zcomdevice.txt Zdgen1, malloc3CDescription LtfindLen 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 Posix 1003.1c kernel threads API package. This routine has Ltqdget146 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 Terminal table data will be placed. Note that if Pointer to a buffer into which the Zcom physicalPhysical terminal is not found i.e., ierr != 0, then no Data is moved into zpttReturn Value Zclos Cancellation point Chapter 159 Zcntl Send no wait, report errors with buffer Send no wait, report errorsSend no wait Send no wait, definite statusACC Programmers’ Reference Guide Ibuf, len MhpRstat ReturnParamRtyp For rcode not all of them are applicable to zcntl164 Chapter 165 166 Not a cancellation point Zcomerror168 Zcomlname Async-cancel safeZcomlog3x Zcomlog 172 Unix error string will be logged Int Unix error code, usually errnoInt Zcom error code Zcom error string will be logged174 Chapter 175 ACC Programmers Reference Guide under ‘ZCOM Status Message ZcomstatusChapter 177 Zconfig Zap Return Param Response data Chapter 181 Zcomzconfigsys ZcomzconfigcntlZcomzconfigcard ZcomzconfigportChapter 183 Header.config Configuration DataDSC Control Header.actionData.setctl.cfgclass No specific response data or errorData.setctl.cfginfo1 Zcom subsystemHeader.tag1 Header.tag2 Data.sysret.errorData.setsys.sysname Data.setsys.qlimitChapter 187 Data.setcard.iftno DscreassigniftData.setcard.itype Data.setcard.fnameData.cardret.iftno Data.cardret.errorData.setport.spare Data.setport.portnoData.setport.rcode Value Encoding modes Data.setport.cnfgFM1 transition = FM0 transition = Value Parity select No Parity Odd parity Even parityValue Rate Value Clock multiplierValue Rate 0000 Use Baud2 1000 19,200 Fsync Pmode Pmode2Value T1 Transmit Attenuation Z7330B only 15 dB 22.5 dB Value Other port for clock synchronization PortT1/ESF mode contain an address which Otherwise by default there is a delay to avoidUser device. By default the ACC is a user Performance report messages in T1/ESF modeData.portret.status Data.setport.qlimitData.portret.iftno Data.portret.portno Chapter 197 Configuration Data header.config Data.setportsc.portno Data.setportsc.iftnoData.setportsc.subchno Data.setportsc.rcodeRTI Data.setportsc.ptcfg-ptinfo.subchb.tmslData.setportsc.ptcfg-ptinfo.subchb.spec Set to ModeSet to Data.setportsc.lenData.portscret.status Chapter 203 ZcDSCCREATELTTONPTT Create a new LTT on an existing Header.action ZcDSCCREATELTTPTT Create a new terminal LTTData.setterm.daddr Data.setterm.iftnoData.setterm.subchno Data.setterm.portnoData.setterm.dtype Data.setterm.ltypeResponse 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 ZgetshrcvrlistShould have ZcMAXSHAREDRCVRS+1 entries Table entry from which you want the shared receivers listType of shared receiver list is set to ZcMAXSHAREDRCVRS 216 Zinfo NameParam Return, Tables and Data Structures section 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 Node contains the local node as defined in the Ttgen Ld1Zap Zcom address node, ZLU number, and checksum 250 Chapter 251 Zpeek Zread3X, zluopen3X Error codes and their meaningsZport Zcomzmuxportconf ZcomzmuxportallZcomzmuxportbaud ZcomzmuxportportSome terminals in this port not disabled No errorIllegal port mode Break routine not installedValue Parity select Value Operating modeClk Value Clock source258 T1 ESF Value Port ModeValue 260 Chapter 261 Zptup Chapter 263 Zqmve Chapter 265 Zqsze Zqhdp Return param 268 Zread After the timeout period has elapsed Mode ZcREADWWAIT 0 Read with waitThere is no message on the queue, error Zenodata Same ZLU. When a message arrives, only oneChapter 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