.he                     SYSLIB 3.0 Upgrade Notes
.fo                                                    Page #

                   Notes on Changes in SYSLIB
                  From SYSLIB 2.7 to SYSLIB 3.0

                          Richard Conn
                        February 1, 1984

     Thi documen summarize th change mad t SYSLI  unde 
Versio 3. fro th previou version 2.7  SYSLI 3. consist 
o ove 21 routine i ove 15 modules eac modul residin i 
 separat file.

A  Change Mad t Existin Routine an Modules

     1 Al o th ZCPR2-specifi routine hav bee remove fro 
SYSLIB  Thes ar no place i  separat librar an hav bee 
update t reflec ZCPR rathe tha ZCPR2  SYSLI 2. i stil 
t b use t suppor ZCPR2 whil SYSLI 3. an Z3LI ar t b 
use t suppor ZCPR3.

     2 Disk-Base Name Directorie ar no supporte i Z3LIB  
Th ZDNAMŠ routin ha bee omitted an ZCPRQ2 ZFNINIT 
ZDNFIND an ZFNAMŠ hav bee change t remov an feature 
relatin t disk-base name directories  Memory-base name 
directorie ar stil supported  Modules  SZFNAME.MAà an 
SZGPINS.MAà change an no name Z3FNAME.MAà an Z3GPINS.MAC  
Also t tes th valu o thi change X wa reassembled an 
th ne CO fil i 1 block (almos 1.5K smalle tha th ol 
version.

     3  Al mat routine hav bee broke ou int separat 
module a appropriate  Ther ar no 1 mat module i SYSLIB  
Modules  SMATH.MA removed SMTHn (0 < n < 12 added.

     4   bu ha bee correcte i EVAL1 whic prohibite 
accurat processin o number greate tha  bits  Module  
SEVAL1.MAC.

     5  Versio Numbe i no 3.0  Module  SVERSION.MAC.

     6  bu ha bee correcte i DIR an DIRF i whic th 
prope retur cod wa no returne i A/PSW  Interna 
documentatio wa als cleane up  Also th SDIR.MA modul wa 
broke u int  se o independen modules name SDIRxx.MA (0 
< x < 10) SDIR.MAC SDIRHDR.LIB an SDIRBF.MAC.

     7  Th SU modul wa broke u int SUD1.MAC SUD2.MAC 
an SUD3.MAC.

     8  Th routine F$MAKE F$READ an F$WRIT wer change t 
retur prope PSנ fla settings  No retur code ca b 
examine withou a OR  afte th routin call  Modules  
SFMAKE.MAC SFREAD.MAC SFWRIT.MAC.


     9  Th followin SYSLI routine hav bee modifie o 
improved:

          Routine   Module         Routine   Module
          -------   ------         -------   ------
          PADC      SPADC          PA2HC     SPA2HC
          PHL4HC    SPHL4HC        PHL5DC    SPHL5DC
          PHLDC     SPHL5DC        LADC      SLADC
          LA2HC     SLA2HC         LHL4HC    SLHL4HC
          LHL5DC    SLHL5DC        LHLDC     SLHLDC



B.  New SYSLIB Routines and Modules

     1.  The following numeric output routines have been added:

     Routine   Module    Function
     -------   ------    --------
     LAFDC     SLAFDC    Print A as Floating Decimal to LST:
     LHLFDC    SLHLFDC   Print HL as Floating Decimal to LST:

     MAFDC     SMAFDC    Print A as Floating Decimal to Memory
     MHLFDC    SMHLFDC   Print HL as Floating Dec to Memory

     PAFDC     SPAFDC    Print A as Floating Decimal to CON:
     PHLFDC    SPHLFDC   Print HL as Floating Decimal to CON:

     SA2HC     SSA2HC    Print A as 2 Hex Chars to S Output*
     SA3DC     SSADC     Print A as 3 Dec Chars to S Output
     SADC      SSADC     Print A as Decimal Chars to S Output
     SAFDC     SSAFDC    Print A as Floating Dec to S Output
     SHL4HC    SSHL4HC   Print HL as 4 Hex Chars to S Output
     SHL5DC    SSHL5DC   Print HL as 5 Dec Chars to S Output
     SHLDC     SSHL5DC   Print HL as Dec Chars to S Output
     SHLFDC    SSHLFDC   Print HL as Floating Dec to S Output

 Ӡ Outpu i th ne SYSLI  Switche Outpu feature wher 
outpu ca b selecte t g t an on o fou combination o 
CON o LST dynamically.

     2.  The following S-Output Routines have been added:

     Routine   Module    Function
     -------   ------    --------
     SCOUT     SSCOUT    Print Char A with Ctrl Char Processing
                              to S Output
     SCRLF     SSCRLF    Print New Line to S Output
     SCTLFL    SSCTLFL   Switch Control Flag
     SOUT      SSOUT     Print Char A to S Output
     SPRINT    SSPRINT   Print String at Ret Adr to S Output
     SPSTR     SSPSTR    Print String at HL to S Output


B.  New SYSLIB Routines and Modules, Con't

     3  Th followin Byte-Oriente Fil I/Ϡ routines whic 
suppor variable-size buffer fo blocking/deblocking hav bee 
added  Al ar i th SFXIO.MA Module.

     Routine   Function
     -------   --------
     FXI$OPEN  Open File for Input
     FXI$CLOSE Close Input File
     FXO$OPEN  Open File for Output
     FXO$CLOSE Close Output File
     FX$GET    Get Byte from Input File
     FX$PUT    Put Byte to Output File

     4  A F$SIZ routin ha bee adde whic compute th fil 
siz o  fil t th neares K ignorin groupin factors  Jus 
th firs 1 byte o th FC ar passe t F$SIZE  Module  
SFSIZE.MAC.

     5   se o routine hav bee adde fo characte testin 
an strin parsin functions  Eac i containe i it ow 
module whic i name afte i wit a  prefix  Thes routine 
are:

     Routine   Function
     -------   --------
     ISALNUM   Is Alphanumeric
     ISALPHA   Is Alphabetic
     ISCTRL    Is Control
     ISDIGIT   Is Digit
     ISGRAPH   Is Graphic
     ISHEX     Is Hexadecimal
     ISPRINT   Is Printable
     ISPUN     Is Punctuation
     ISSP      Is Space Char

     SKNPUN    Skip Over Non-Punctuation Chars
     SKNSP     Skip Over Non-Space Chars
     SKPUN     Skip Over Punctuation Chars
     SKSP      Skip Over Space Chars

     6  Ne dynami buffe allocatio routine hav bee added  
Bot ar i th SALLOC.MA Module.

     Routine   Function
     -------   --------
     ALLOC     Allocate N Bytes from Dynamic Buffer
     IALLOC    Specify Bounds of Dynamic Buffer


B.  New SYSLIB Routines and Modules, Con't

     7.  The following character I/O routines have been added:

     Routine   Module    Function
     -------   ------    --------
     BIN       SBIN      Input CON: Char via BDOS
     BIST      SBIST     Input CON: Char Status via BDOS
     BOUT      SBOUT     Output Char to CON: via BDOS

     CAPIN     SCAPIN    Input CON: Char and Capitalize
     CAPINE    SCAPIN    CAPIN and Echo

     8  Ther ar no eigh SYSTES programs designe t tes 
th堠 variou feature o SYSLI  3.0  Thes program ar 
SYSTEST.MAC and SYSTESTn.MAC (1 <= n <= 7).

     9  Th followin FC Fil Nam an Typ Outpu routine 
have been added:

CON:   LST:   Switched  Memory    Function
----   ----   --------  ------    --------
PFN1   LFN1   SFN1      MFN1      12 Chars, Embedded Spaces
PFN2   LFN2   SFN2      MFN2      N-Chars, No Spaces
PFN3   LFN3   SFN3      MFN3      12 Chars, Trailing Spaces

     Eac routin i i it ow module whic i name afte th 
routin bu i prefixe wit a  (ie PFN i i SPFN1.MAC).


    10  Th followin Use Are Manipulatio routine hav bee 
added:

Routine   Module         Function
-------   ------         --------
GUA       SGUA.MAC       Get Current User Area in A
SUA       SSUA.MAC       Set User Area in A

    11  Th followin fil attribut manipulatio routine hav 
been added:

Routine   Module         Function
-------   ------         --------
GFA       SGFA.MAC       Return File Attributes
SCFA      SSCFA.MAC      Set and Clear File Attributes
SFA       SFA.MAC        Set File Attributes



B.  New SYSLIB Routines and Modules, Con't

    12  Th followin rando fil acces routine hav bee 
added:

Routine   Module         Function
-------   ------         --------
R$READ    SRREAD         Random Block Read
R$WRITE   SRWRITE        Random Block Write



C.  Documentation

     1  Al o th SYSLIB.HL file hav bee rewritten an 
man ne file hav bee added  Thes file completel documen 
SYSLI 3.0  Ther ar 2 SYSLI 3. HL Files.

     2  Realizin th investmen som peopl hav i har cop 
o th SYSLI 2. documentation  d no inten t releas ne 
SYSLI 3. manual a thi time  Thi updat an th fou Z2SYS-
n.MOĠ file wil serv t brin you documentatio u t date  
Th SYSLIBx.HL file shoul b use a th complete on-lin 
authoritativ reference.


                                        Richard Conn

