Intermec 4980 Manual

Model4980 NetworkController
PROGRAMMER’S
GUIDE
""""""""""""""""""""""""""""
PN:977-028-001
RevisionA
August1993

"NOTICETheinformationcontainedhereinisproprietaryandisprovidedsolelyforthe
purpose ofallowingcustomersto operateandserviceIntermecmanufactured
equipmentandisnot tobereleased,reproduced,orusedforanyotherpurpose
withoutwrittenpermissionofIntermec.
DisclaimerofWarranties.Thesamplesourcecodeincludedinthisdocumentis
presentedfor reference only.Thecodedoesnotnecessarilyrepresentcomplete,
tested programs.Thecodeisprovided“ASISWITHALL FAULTS.”ALL
WARRANTIESARE EXPRESSLY DISCLAIMED,INCLUDING THE
IMPLIEDWARRANTIESOFMERCHANTABILITY AND FITNESS FORA
PARTICULARPURPOSE.
Wewelcomeyour commentsconcerningthispublication.Althougheveryefforthas
beenmadetokeepitfree oferrors,somemayoccur.Whenreportingaspecific
problem,pleasedescribeitbrieflyandincludethebooktitleand partnumber,as
well astheparagraphorfigurenumberandthepagenumber.
Sendyour commentsto:
IntermecTechnologiesCorporation
PublicationsDepartment
550 SecondStreetSE
CedarRapids,IA52401
INTERMEC,NORAND,NOR*WARE,andPEN*KEYareregisteredtrademarks
ofIntermecTechnologiesCorporation.
Ó1992 IntermecTechnologiesCorporation.All rightsreserved.
Thispublicationprintedonrecycled paper.

Model4980 NetworkControllerProgrammer’sGuide i
CONTENTS
""""""""""""""""""""""""""""
Introduction
SECTION1
Getting Started
CommunicationSession1-1..............................
NetworkConfigurations1-4..............................
PhysicalPorts,LogicalPorts,andLogicalChannels1-7.....
DeviceChannelOption1-9...............................
SECTION2
FileStructures
Introduction2-1.........................................
PseudoHostCommunicationsProgram2-2................
CommonFileStructures2-5..............................
Controller-to-HostRecordTypes2-6...................
SpecialRequestSubtypes2-7.........................
Host-to-ControllerRecords2-8........................
Controller-to-HostRecordFormatswith
a 1-byteChannelID2-10..........................
Controller-to-HostRecordFormatswith
2-byteChannelID2-13............................
AsynchronousInterface2-14..............................
Controller-to-HostRecords2-14........................
Host-to-ControllerRecords2-14........................
SpecialCommands2-18...............................
BisynchronousInterface2-18..............................
Controller-to-HostRecords2-18........................
Host-to-ControllerRecords2-19........................
SNA/SDLCInterface2-22.................................

CONTENTS
ii Model4980 NetworkControllerProgrammer’sGuide
ActivationRecordParameters2-23.........................
Type0–BisynchronousHost(CONFIG.NCC only)2-24. .
Type1–AsynchronousHost(CONFIG.NCC only)2-25...
Type2–PrimaryADCCP
(CONFIG.NCC orHostActivationParameters)2-26. .
Type3–PrimaryTTY
(CONFIG.NCC orHostActivationParameters)2-30. .
Type4–LAN
(CONFIG.NCC orHostActivationParameters)2-33. .
Type5–SecondaryADCCPHost(CONFIG.NCC only)2-34
InitializationRecordParameters2-37......................
SystemParameters2-37...............................
HostParameters2-39.................................
BisynchronousHost2-42..............................
PortParameters2-42.................................
RecordExamples2-43.................................
AsynchronousHostExample2-43...................
BisynchronousHostExample2-43..................
SystemModeParameters2-43.............................
SystemConfigurationFile–CONFIG.NCC 2-46.............
ControllerErrorStatusCodes2-48.........................
EndofSessionStatusCodes2-48.......................
ActivateRequestStatusCodes2-48....................
HostFileDirectiveStatusCodes2-49...................
SECTION3
EquipmentInterfaces
ModemSupport3-1.....................................
FrontPanelRun-TimeDisplay3-4........................
SECTION4
OtherFeatures
Controller-BasedFileProcessing4-1......................
BootingHand-HeldComputersfromtheController4-5.....
AutodialingfromaRemoteController4-5.................

CONTENTS
Model4980 NetworkControllerProgrammer’sGuide iii
SECTION5
FrontPanelUserInterface
NavigatingtheMenus5-3................................
SelectingandChangingaValueOption5-13................
Conventions5-13.........................................
LoggingOn5-15.........................................
SettingPhoneEntries5-17................................
SettingDateandTime5-19...............................
Date5-21............................................
Time5-23............................................
DefineSystemModeParameters5-25......................
Set theControllerID5-29.................................
ConfiguringPortParameters5-31.........................
YmodemPort5-33....................................
HostPort5-35........................................
SecondaryADCCP5-37...............................
Bisync5-40..........................................
Async5-42...........................................
SNA/SDLC5-44......................................
LogicalPort1 5-47....................................
ADCCP5-49.........................................
TTY5-51.............................................
LAN5-53............................................
LogicalPort1Alt5-55................................
LoggingOff 5-56.........................................
APPENDIXA
CommunicationsSession
AsynchronousHost to
4980 NetworkCommunicationsControllerA-1..........
BisynchronousHost to4980 CommunicationsSessionA-3...
BisynchronousHost-to-ControllerA-5.....................
APPENDIXB
ExampleC-ProgramB-1.................................

CONTENTS
ivModel4980 NetworkControllerProgrammer’sGuide
APPENDIXC
Adapting ProgramsUsedwiththeNI315 ProtocolConverter
RecordTypesC-2........................................
NI315 RecordTypesC-2..............................
4980 NetworkControllerC-2..........................
LogicalChannelsC-5....................................
DataRecordLengthC-6..................................
ASCII/EBCDICHostSupportC-6.........................
EnhancementsC-6......................................
APPENDIXD
Adapting ProgramsUsedwiththeNI311 ProtocolConverter
RecordTypesD-2........................................
NI311 RecordTypesD-2..............................
4980 NetworkControllerD-2..........................
SpecialCommandsD-5...................................
LogicalChannelsD-6....................................
DataRecordLengthD-7..................................
EnhancementsD-7......................................
APPENDIX E
XenixLineDefinition E-1.................................
APPENDIXF
3275 LineDefinition F-1.................................
APPENDIXG
AsynchronousHostsG-1................................
APPENDIXH
3745 Nonswitched LineDefinition H-1.....................

CONTENTS
Model4980 NetworkControllerProgrammer’sGuide v
FIGURES
Figure1-1Local4980 Network(ADCCP/TTY)1-4..........
Figure1-2Local4980 Network(NPCPtoLAN)1-5.........
Figure1-3Remote4980 1-5..............................
Figure1-4RemoteHand-HeldComputer
(SingleTerminal)1-5.................................
Figure1-5RemoteHand-HeldComputer(ADCCP/TTY)1-5.
Figure1-6Remote602/277 1-6...........................
Figure1-7RemoteMQL1-6..............................
Figure1-8CompleteSampleNetworkConfiguration1-6....
Figure5-1NavigatingtheMenus5-2......................
Figure5-2TTYSpecificParametersOverviewPart1 5-4....
Figure5-3TTYSpecificParametersOverviewPart2 5-5....
Figure5-4ASYNCandSecondaryADCCP Parameters
OverviewPart1 5-6..................................
Figure5-5ASYNCandSecondaryADCCP Parameters
OverviewPart2 5-7..................................
Figure5-6ASYNCandSecondaryADCCP Parameters
OverviewPart3 5-8..................................
Figure5-7YModem,Bisync,3270 SNA,andSystemParameters
OverviewPart1 5-9..................................
Figure5-8YModem,Bisync,3270 SNA,andSystemParameters
OverviewPart2 5-10..................................
Figure5-9YModem,Bisync,3270 SNA,andSystemParameters
OverviewPart3 5-11..................................
Figure5-10 FrontPanelof4980 Controller5-12.............
Figure5-11 LoggingOnParameters5-14...................
Figure5-12 PhoneEntriesParameters5-16.................
Figure5-13 DateandTimeParameters5-18................
Figure5-14 AdditionalDateParameters5-20...............
Figure5-15 AdditionalTimeParameters5-22...............
Figure5-16 SystemModeParameters5-24.................
Figure5-17 SystemModeCompatibilityParameters5-26....
Figure5-18 ControllerIDParameters5-28.................
Figure5-19 PortParameters5-30..........................
Figure5-20 YmodemPortParameters5-32.................
Figure5-21 HostPortParameters5-34.....................
Figure5-22 SecondaryADCCP Parameters5-36.............
Figure5-23 BisyncParameters5-39........................
Figure5-24 AsyncParameters5-41........................
Figure5-25 SNA/SDLCParameters5-43...................

CONTENTS
viModel4980 NetworkControllerProgrammer’sGuide
Figure5-26 LogicalPort1Parameters5-46.................
Figure5-27 ADCCP Parameters5-48.......................
Figure5-28 TTYParameters5-50..........................
Figure5-29 LANParameters5-52.........................
Figure5-30 LogicalPort1AltParameters5-54..............
Figure5-31 LoggingOff 5-56..............................
TABLES
Table1-1ControllerEnvironments1-1....................
Table1-2PossibleControllerPortConfigurations1-3.......
Table2-1Controller-to-HostRecordTypes2-6..............
Table2-2SpecialRequestSubtypes2-7....................
Table2-3Host-to-ControllerRecords2-8...................
Table2-4HostDirectiveSubtypes2-9.....................
Table2-5Controller-to-HostRecords2-11...................
Table2-6 2-ByteChannelID2-13..........................
Table2-7AsyncHost-to-ControllerRecords2-15.............
Table2-8AsynchronousSpecialCommands2-18............
Table2-9BisyncHost-to-ControllerRecords2-19............
Table2-10 Type0–BisynchronousHost2-24...............
Table2-11 Type1–AsynchronousHost2-25................
Table2-12 Type2–PrimaryADCCP2-26...................
Table2-13 Type3–PrimaryTTY2-30......................
Table2-14 Type4–LAN2-33.............................
Table2-15 Type5–SecondaryADCCPHost2-34............
Table2-16 SystemParameters2-38........................
Table2-17 AsynchronousHost2-40........................
Table2-18 SystemModeParameterCodes2-44.............
Table2-19 EndofSessionStatusCodes2-48................
Table2-20 ActivateRequestStatusCodes2-48..............
Table2-21 HostFileDirectiveStatusCodes2-49............
Table3-1ConfigurationStringsforModems3-3...........
Table4-1NCDIR.NCC DirectoryEntries4-2...............
GLOSSARY
INDEX

Model4980 NetworkControllerProgrammer’sGuide 1
Introduction
""""""""""""""""""""""""""""
The4980 NetworkCommunicationsControllerprovidesa
datacommunicationsinterfacebetweenthehostcomputer
andNORANDRdevices.Thecontrollerisprogrammable
andcanbeconfiguredmanyways.Thepossibleconfigura-
tionfall intotwobasic categories:
"a bisynchronousorasynchronouscommunications
gatewaytoahostcomputer
"ahand-heldcomputer communicationscontroller.
RefertotheGlossaryforotherterms,abbreviations,and
initializations.
Inthefirstconfiguration,thecontrollerisdirectlycon-
nectedtoacustomer’shostcomputerand providesagate-
waythroughwhichdata and datarequestspass fromre-
motecontrollersandhand-heldcomputerstothehoston
logicalchannels.
Inthesecondconfiguration,thecontrollerisusuallylocated
ataremotesiteand providesaninterfacebetween hand-
heldcomputersanda“gateway”controller.Section1pro-
videsapictorialrepresentationofseveralpossibleconfigu-
rations.
Ahost telecommunicationprogramandassociatedsupport
programsarerequiredtointerfacetoa 4980 networkcom-
municationscontroller.Twohostinterfacesareprovided:
"point-to-pointbisynchronous
"asynchronous
Thehostlinkcanbeconfiguredforspeedsupto19,200 bps.

Introduction
2Model4980 NetworkControllerProgrammer’sGuide
Thehost telecommunicationsprograminitializesthecon-
trollerandthenremainsinaloopreadingdata andrequest
recordsfrom thecontroller.Eachrecordfrom thecontroller
isprecededbyalogicalchannel identifierandarecordtype
field.
Thereare eightrecordtypeswhichmaybesentfrom the
controllertothehost.Somearerequestrecordswhichre-
placearesponsefrom thehostcomputer.Eachrecordfrom
thehostcomputerisprecededbyarecordtypefield.There
aresixrecordtypeswhichmaybesentfrom thehost tothe
controller.Notethat thecontrollertranslatesinformation
to/fromEBCDICforEBCDIChosts.Translationofthedata
partofuploadand download datarecordscanbedisabled.
Thisbookhasbeendividedintofivemajorsections.The
followingparagraphsdetail topicsdiscussedineachsection.
Section1coversthehardwareconfigurationofthenet-
work,thephysicalportassignmentsonthecontroller,and
thelogicalportassignments.
Section2coversthedatastructuresyouwill havetobuild
intoyourprograms.
Thefiletypes,theirfunctionsandusesaredescribed,
aswell asthephysicalrecordlayoutswithinthose
files.
Thecontrollerinitializationand portactivationpa-
rametershavebeensplitoutintoseparatesubsections
forease onreferencing.
Thestatusanderror codesthatarereturnedfrom the
controllerarelocatedinSection2.
Section3describesthemodemsthat thecontroller can
communicatewith.Modemconfigurationdatastringsare
listedinSection3.Thecontrollerdisplaypanel isalso
shownindetail.