Category : OS/2 Files
Archive   : MIGR.ZIP
Filename : MIGR.INF

HSP
› ›èƒ
ñ2¶ Í2ÓÆvõ§
R§;Notes on Converting C programs to IBM C/set 2

Why this file?


Configuring the compiler

At the beginning!

Migrating from old compilers%

Differences in library functions

Eliminating migration code

Linking with 16-bit code

Linker

Performance hints›®Ëà

&
E
b
m



R$
ÿÀÿÿàÿÿà$ÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿÿSystem ProportionalRCourierRCourier R 
 !"#%&'()*+,-./0110123162255261323276832K386440004865500664K683977188808s:;<=>?@aAbcabendsabout actuallyaddAddafteragainalalignalignedallallowsAlsoalso althoughalwaysAlwaysamanandappreciatearearg argument
argumentsasAsatatexitattemptautomaticallyavoidbbebecausebecomebecomesbeenbefore
beginning behaviorbeingbetweenBewareBINBINARYbinarybitbits boundarybreakBreakbreakerbreaksbsearchbugbugsbutbybytebytescCcallcalledcalleecallscancannotcapcaretcastcdeclChangedchar
charactercharschunkscloseclosescodeCOMcomment commentscompare comparedcomparisoncompile compiled compiler
compilers
computername
ComputernameCONFIG
configureconst constant
constantscontainControl
convertedconvertingCouldnCREATcusipCUSIPcusipsCUSIPS
CUSIPSDIRddatadbdatadbfcmddbprocdealDeclaredeclare declaredDEFdefaultdescribing DESCRIPTION
determinediddiffersDINCLdirDIR
directory
distributingDLLDLVDMdoDodoesdoesnDomaindondonedosDOSdoubledowndpathDPATHdummyduplicatedeEeach
Eliminateeliminatedelseenableenables
encounter encounteredENDendEnterentry equivalentsERRerrorerrorsetetcevereveryexamineexample examples ExamplesEXEexecutable exerciseEXETYPEexistexit
expecting Explanationexplicitly
extensionexternfarfaster fclosallfclose
fcloseallfcntl featuresfewfflushfieldfieldsFILEfilefiles filesizefiller floating
followingfopenForfor FortunatelyfoundfptrfreadFrenchfromfseekftellFTEMP function
functionsfwritegG4gdGdGermangetGfglobalGmgreatlyGsGuidehHhandlehandler handlinghanguphappenshashaveheader HEAPSIZEHELPhelphereHerehithopingHoweverhuge hundredsiIIBMIBMCIBMLANIBMWFiccICCIEEEIfifIninincludeINCLUDE
incorrect incrementedinfoinsert
insidiousinstall
installedinsteadintintegerintend
interceptintoinvokedioIPFIREADisItitiwrankIWRITEJjob junkfilejustKKaKbKc keywords
kilobytesknownKoKpKxLAN langrouplargelatterldleadleadinglibLIBlibpath
librarieslike LikewiselimitedlinelineslinkerlistlistedlllocalLOCALElogfptrlogologoutlonglongerLooklooplseek machinesmademailmainmakemakesmanyMASTERMAXMAXVALmaymemeantmemcpymessage
Microsoft
migrating
migration
Migration
millisecondsmoreMSmuch multiplemustmymyfuncnN10NAMEnamenbytesnCtrlnear
necessaryneedneedonexitNETSRCNetWkstaGetInfonewNewnleftnoNOEnonnornotnoteNotenotesnreadNULLnumnumbernumbersoO occurrencesofoffoffersOldoldomitononesonexitonlyopenopening optimize
optimizesoptionoptionsor
organizedOSOS2OS2BINOS2HOS2LIBotherothersoutoverpPackedpartparticularpascalpassedpassingpathPCperrorpickypointpointer practicepragmaprettypriceprices
primarilyprintfprobesproblem problems producesprogram PROTMODE
prototypeprototypedprototypesprovideProvideptrputQqsortquoteratherrbRDONLYreadreading readonlyrealreallyrecreceive reestablishreferrely rememberremoveReplacereplace requiredresultsreturn returnedreturnsrewritingsridroutinerowrtnrunrunningruntimeSssamesamplesavessayscanfsectionseeSEEKseemSeg16selectsenseserverServerSETsetSetsetlistsets setupargsharedshortshortershouldSIGSIGINTsignalsignedsignificantlysimilarSincesizesizeofslowslowerSmsmaller solutionsolvedsome
something
specifiedspecifyspecifyingSQLSsstack Standard standardstartstaticstdargstdoutstopsstreamsstringstringsstruct
structurestructuresstylesuch suggestionssupplementSYSttakeTEMPtempmem
temporarytendsterminatestextthanthatThethetheirthemthentheseThesetheyTheythirdThisthisthosethroughtimetmptotook TOOLKT20trailertreated
trigraphsTRUNCTYPEtypeUnderunderunlikeunlink unsignedupupdateuseusedusefuluselessUser username UsernameusesusingUsuallyusuallyvavalue variable
variablesvariousvevery vfprintfvoid volatilevprintfW3wantWarningwarning warningswastedwaywellwerewhatwhen Wheneverwherewhilewhywill
WINDOWCOMPATwithwithoutwki10wkstawonworkworsewouldwritewritingwrlogwrongWRONLYXxyyetyouYouyour[\]^_{|}€u/
þÿü8üm%7J@JLü üXiQ*üOüüüt#rEü
ütütügWr9ü[üiüOüütü8\`T_8ü-ü8hcIg5CUp8&:8,`ZSüü8b$f1<=0;`A'ü>ü6_>qjgüPüdIDgü^üHüVü`ÿü[üülüY4ÿÿFü4ÿü82aRüküeüHüGo/DgüüünNüþúüþü8s3ü"üü]ü?Kü
ü.üüü+üBCÿÿü()!ÿÿüMCÿü
  ÿüþ 
!#%'+1:;>BEFGHIMNOUYrs„…‡Œ˜™¯µ·¸ÁÉÐÑÚÜäù


&
*
-
/
0
8
:
I
L
P
T
\
d

Š
‹
Ž
‘
¬
­
°
¹
»
½
É
Ê
Ë
Ñ
Ü
ã
é
ê
(>VWbdfghiknst}…†‡“ ¡¢¨ª±¸V‹äüþüx(K:Rÿüütÿüþüyüü þÿÿúüJ
 ‰4‰
 ‰~‰
 ‰2‰
üÿýlüb
 ‰4‰
 ‰~‰_
 ‰2‰
üÿýlü
 ‰2‰L
 ‰2‰ü1ÿýlü5AüüBüüCüüDüüEüüFüüüSüüƒüqüüü*ü-üü.üüYüüeüüŠü ü,üÿýlüvü[ÿýlüH ‰3‰T‰I
 ‰~‰a
 ‰2‰üIÿýlü; ‰3‰T‰0
 ‰~‰‰`
 ‰2‰ü<ÿýlü| ‰uü‰ÿýÿþúüþü!Zy6ü^ü þÿúÿü@üÿo…ÿýÿüüSÿsÿýÿüqüÿüüyüü")ÿýÿüü*ÿ])üüfw
ÿýÿü-üÿü#üüV7ü'cÿýÿü.üÿUrdÿýÿüYüÿ\ÿýÿüeüÿMÿýÿüŠü ÿ€:‚üü/&üüGükü
ÿýÿü,üÿh)n ÿýþúüþÿXü ÿ9‡ÿü+ÿüzhÿÿQ;ÿü ‰2‰L
 ‰2‰1ÿü8‡>}gy %[N†6?Wü=ü‡Qpÿü+ÿüþúüþüˆO„}pÿüümÿ}yP$üüjyi[ü{
üþúþ

 +,.9?AO`r†‘’±¶ÄÅÎÏÙâéëîóùúýþ








%
1
2
3
4
5
6
7
8
:
;
<
C
G
N
W
X
Y
Z
^
_
`
a
h
i
j
p
v
x

‰

—
˜
›
¤
©
«
­
¯
·
¹
¿
Å
Æ
È
Í
Î
Ï
Û
ß
è
õ
ø
%';<?BEFMX[\acdgorsuƒ„…’™š¥»¼¿Â7ÃÃüþül¨¤ÿü
ü_ÿLT{¤¼ü@üžütü^üƒüÿüAUüÿ?vFÿüHUüÿÿüdUüÿ”!üDüþúüþü¶¼Ž~c°&ü üˆ¡ü)ü¼r:f©!ÿü“ÿü^s„§W¯µ=œ®O'üZ üz~üLüNüEüþúþÿÿ™À‚šÁý3Y¾¿ýbxÀ‘ý3‡ý3j¾¿ý3ªýŒýÿÿ þúüþü£†¸ü6ü,µ fm©‰§›QüKü¤ÿ‡ÿI¸¤»ü-ü¦e"ÿüxÀü‘ÿ”X$G;ÿü“ÿü:Jÿkÿ€ÿü“ÿüþúüþüw¢]ÿüÀü‚ÿ´vü—ü¤7ºaM-%ÿüxÀü‘ÿ©f~ü ü(*i©`üüüþÿükBÿüü(ŸüŠü~ü ü-ü*ü¹.ü³ü¦>Q–08¢¥~üü-ü*üþúüþü2V{ÿ3ÿ«qh©ü+ü^p}ü8ü¤ ýÿÿ üþü…²ÿ/ÿ#ü
üþúüþÿüuü5üÿþÿÿ•3/ýÿÿ üþü½1˜ÿügüÿ©n<ÿüþü3ü•ÿüþ

&()+,-./2<=@DFGIQUVXYZ]bcdelmopqrw}~€„‹Ž–¨©«¬°»¾ÀÂÈÌßæêòö÷ùúü










"
#
.
4
7
8
9
;
=
@
E
F
K
N
P
S
f
g
o
z
|
€
ƒ
„
…
‰
—
˜
¢
§
­
®
³
µ
¶
¹
¼
½
¿
À
É
Ò
Õ
×
á
ë
ì
÷
ø
û
þ
ÿ


#-/3?ABJQRSUY]`abcdfmnpsv{€ƒ„‘œž¡£¤§¨ª±µ»¼¾ÀÂÃÅ: ~uüþüfJWgA2VNü(übB!ü
wü
þúüþüSüG üaR0.ü3ü
þúüþÿüMü&üÿþÿÿDý;ý;ý|ý


ý}ýÿ ÿþúüþÿüHü&üÿþÿÿ^;D;;ý


ý;D;;ý|ý


ý}ýÿÿ þúüþü+IOeÿü

ü
ÿs\nüü
þúüþÿüMü&üÿþÿÿ9_
5ýýpv%Xýÿÿ þúüþÿüHü&üÿþÿÿ^pv%X


ý


ýpv%X


ý|ým{?{Týým{]{TXýqX{Tý/`ýo@X{Tý/@ým{-{Tý}ýÿÿ üþüLühü
ü,
4
üÿüþ)


üküücZüFyEüÿüþütUzü#ü8ÿüFÿü>g:ü ü
ü1ü6QürüjB!üü
d[ þúüþüx"Oi=*nüFüþÿÿ;Dpý|ýýý


ý}ýÿÿ üþü7ü6üYÿ;üÿü
þúüþÿüKÿ<Pgp"'guü$ü
þ
 !#+,-./026FGJLMSTU_krxz{~„‰Ž¤¨ºÉÓÝõ






4
9
:
;
A
E
N
V
g
r
w

”
–
™
š

¦
§
­
°
²
¹
¼
½
¾
à
ë
ð
ò
ó
ô
ÿ
'=CIJKLTUYcdisx{~‚‹Ž•–˜œ£¨«´¸¼¿ÁÂÃÅ&¬Çüþüüoü‹M3”‹üBüÿüš
cüÿ3ÿü~
cÿüÿvÿ3ÿü'ÿüþúüþüi46 Ž¡“zü‘ü#Vü? üW¤ –ü,üÿü©H
üÿ—¥ÿ'ÿüOüþúüþü™iü4ü“ÿ'ÿO`p_X“züü™Uüa ü„!ü_üþúüþÿüuü7üÿþÿÿ]G©ƒ
žýýX
'
G©ƒýD
G©ƒ
—Gdýÿÿ þúüþÿünü7üÿþÿÿŒžG©ƒ
žýŸŒ]mýýžG©ƒ
žýªýªýX
mýªýmý ePE ý©I
ý«ý«ýÿÿ þúüþüq’“‚ÿžÿ\tÿü]ÿüþúüþüÿüJ
üÿ+@ÿü…ÿüþÿÿy
AsýJ
ý…
=kýÿÿ þúüþÿü|ÿ#ÿ2ÿ$x“9L•&"ü%üþúüþÿüuü7üÿþÿÿŒ]8©5
:] :] (ýŒ]b¦h©g¨ýý]8©5
:] :] (ýªý€
5¦ ¨5¦ (¨

5¦ ¨5¦ (¨ý«ýýK
TTr©£T

ýb¦T¨Tý|
br©£Š
]8©5ýÿÿ þúüþÿünü7üÿþÿÿŒ]8©5
:ž :ž
(ýý]8©5
:ž :ž
(ýªý€
5¦
] ¨5¦
] (¨ý


5¦
] ¨5¦
] (¨ý
ý«ýÿÿ þúüþR ü„"Ftz’›ÿ‰ÿ—^ü;/üq’“œ†-“‰O#“fzj)>ÿüŸÿüþÿÿY‰NýýŒž.©O
]‡©˜ { ýýŸŒ]r©1 Z3“O ýý]f
žýªý [“‰O ýX
‰
ˆ.©O‡©Cýw
< [0Oý€
ý«ý¢
r©1ýªýy
=r©1J
ý«ý€
ý«ýýž.©O
]‡©˜ýªý‰
‡©˜.©O }“‰O ýy
§l/Q*S§kýr©1

ý«ýÿÿ þ


+,-./024578>CFGIKMPTUYZ\^fghijnryƒ„ˆŠ“—š¡©¼ÊÔÖ×ØÛßçïñõ






!
(
)
.
4
5
7
8
;
>
B
D
E
H
J
N
P
Q
U
r
y
‚
†
‡
”
—
š
Ÿ
£
§
«
­
¯
³
´
¹
¼
Á
Ý
Þ
ç
ì
î
ö

,0128HJLNYZ_bdejnsz|Š‘”–—š£¦¯»½¾¿ÀÂÃÅG+·âüþüœ…_Nmüƒü
¯e8ž%"–ÿüüJÿüwü
OüüªŠ¡g•›üDüI£Q”5|§€]?x§$Tübü
þúüþü6ÿüPÿüÿüiÿüÿü<ÿüÿü'ÿüÿü{ÿüü[ü
þúüþü‚%¡ÿüuªü*ÿyHTÿüV
Küÿ"%¡ÿüADI=ÿü
‘®la^¡€«ü ü°+š¡güŽü
þúüþÿürü+üÿþÿÿ(P zýULý¤`nkýýSLu0q³~µq³ ý;&™u-4ýý M¡T) ýz¦ .³2ýnýk`“˜.³2³† d³/³3ý¨k´ýSký
hý7ý
hUkýhLzhýSh!ýz
hýk hýn
hý¶ýp³.³2n“˜„³2³†ýý*Lýÿÿ üþxüS?X\¡£üüüZüþÿÿnL.³2“.³2ýÿÿ þÿÿ¨“ŒLŒ“Œý´ý¶ýÿÿ üþüx©ü­ü§v?Bü«üþÿÿSLuGq³,µq³¢µq³µq³¬ý‡³Wµ‡³Y ýÿÿ üþüR®sŸüüf#ü üt Tü?üˆ4ü:ü
þúüþÿüjü+üÿþÿÿ> CýýSoCA0}ý;&™u-4ýp³.³2D.³2“.³2±²d³/³3Cý=Cýÿÿ þúüþüxTbþÿÿ¨DŒ“ŒCýÿÿ þúüþüR|¥ÿcÿ¡1?ü’üNX—ü+üþÿÿEC‰³9ý@FCýEC‰³‹ýÿÿ þ


+,-./2GIKOUWacfnrtvw|~‚„›žŸ ®²³´ÃËÍÎÒÕØíðøùûÿ













"
'
+
,
5
7
8
:
E
K
M
N
R
V
[
]
c
n
s
z
{
}
~
‡
‰
”
•
ž
 
§
¨
©
­
±
²
³
·
¼
¾
Â
Ã
Ä
Ç
É
Ð
Ô
Ø
ì
ù
ú
û
ü
ÿ
 
 &)*.456789:CHQY^acdhlqsy}€Š–£¦°²³¶º»¼½¾ÀÂÃÄÅ­.xð
üþüb.+Ro`]Y;Zü
üa`Iü ü>54d+üoü
þúüþümO9Mdü üü3ü:B!dÿüwWÿü
ic9-6` 9S0_üOü6sfküüsB!ü1ü
þúüþÿüHü#üÿþÿÿ"'ýý)*
XP2Qn&

ý'ýÿÿ þúüþÿüEü#üÿþÿÿ)*
XP2Qn&

ý"wW'ýÿÿ þúüþ?üsB\ÿüü=ÿlNÿü8ÿü
þúüþümO9Uü ü#üüTj23JLGü^ü:B!üüeüü
ü/üþÿÿAcw@
&"(* ý


ýDF
"qw7wK[qw7wKCýr
%V,VhVuC
ý"qw7wKtv
pw$ý"qw7wKtv
pw<ý"qw7wKtv
pwgýÿÿ þ
 (*+,.2GILMRUVcmnu{~„œž£¤¥¦½¿àáèê

"
/
8
?
E
N
P
a
b
e
k
m
o
Œ
—
š
¥
§
²
¹
¼
Â
É
Ò
Ö
Ù
Ú
à
ä
å
æ
ï
 !"$%8BDRUdhins{ƒˆ‰Œ£¤¥ª¬­´»¾¿ÀÂ.03‰üþü&üüüüþÿÿ 0ý
-#
ý"ýý$ýÿÿ üþ/ü2(ÿÿ,)
+üü,
ü1
ü*ü%ü ü2
ü!,üü.üü('ÿüÿüþ $+2Gm¢ª­ãåù


$
(
7
8
N
l
q
t
ˆ

“
˜
œ

©
Ì
ì
í
@BJYadmn›©®»õ1lY
þúüþüReZaF!ü#üÿÿ c

ýýcbcdýÿÿ þúüþü4fH&B%üYüJÿüüGüUKüÿWDWüHü X_WT#`["=CDWMT"`B)5W,ü/ü þúüþü4WH&B+WZÿü;ÿüI(O\ü0üþÿÿ^iP^ýjýkýý6;^ýjý ýÿÿ üþ8üLB?ZQü
üAZWü9ü XN
EW,/.ü<ü þúüþü$13]V@Bÿ-ÿüüVü7ü:ZYü/üZÿüSÿüü* 2 üþÿÿS6>^ýS'cg hýÿÿ þ

"+,.235>?GIKLMOU[pr~”•§¹»ÂÆÇÈÞãìôù



7
:
E
N
O
q
u
‚
’
–
™
¡
¢
ª
­
¸
¹
º
Ó
â
ì
ñ
ô
ý
'+BGJOPbdmnsw‘–Ÿ¨²·¸¹»½¾ÀÂÃÅIjl½6!]'µ,/”0?€  €8€
¿€~€þ€^€ì€
þ
쀮€j€"‚ €`@ 
@€
€ €" 
~€<~€<€?€€€@€€  ˆ€@€ @€ €¸¿€€®€ €€š€€Ā ¾€" ¨(€ @ &    #  € ü€€$ 6€€ ¾€@€ €`0@@€€ €€
€0(
  
€ @€@€€€ €  € €@@€€ € D@€€ @€€€(@
€€
 @"@€@ @€  å€` @@ |€ 3€ €0€@@@ !@€€@€|@ !& 
@€ €€(‚€@@@xL@m€ï0Ԁx@  @>€ @€$€€€ª €@@@@€@@@B€ 0@@@
"@
€
€@@$ @ €€    
d€€
€@€€
€ja€@
€ €@>E€H€ü€ H,  D€ú€€€>°` @@@¦€€
@@@€"€  @€@ €€@€€0-€
€€@ `$€ 4   € € 
  $Á€@ž€€€
€@@ BP€€€   @@€`
 c€@@€ 9€@€€$" 2€€@=@@  e¨€t
 À†’€!€«€@ @þ€€@ €2„$€b`À€€  2(€@€€@H
0@ €€ €>"B  °€
¢
 € €€€o€t €.€Z.€~€<€<€ù
n