home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / JSAGE / ZSUS / PROGPACK / V42-DOCS.LBR / V42LIB.TZC / V42LIB.TOC
Text File  |  1990-06-07  |  30KB  |  577 lines
  1. .op
  2. .hm1
  3. .fm1
  4. .sr0
  5.  
  6.                                    ||||||||||||||||||||||||||||||
  7.                                    ||||||||||||||||||||||||||||||
  8.                                    ||||||||||||||||||||||||||||||
  9.                                    ||||||||||||||||||||||||||||||
  10.                                    ||||||||||||||||||||||||||||||
  11.                                    ||||||||||||||||||||||||||||||
  12.                                    ||||||||||||||||||||||||||||||
  13.                                    ||||||||||||||||||||||||||||||
  14.                                    ||||||||||||||||||||||||||||||
  15.                                    ||||||||||||||||||||||||||||||
  16.                                    ||||||||||||||||||||||||||||||
  17.                                    ||||||||||||||||||||||||||||||
  18.  
  19.                                         ZCPR3║ TH┼ LIBRARIES
  20.                                             Versioε 4.2
  21.  
  22.                                          A Referencσ Manual
  23.                                                 and
  24.                                             User'≤ Guide
  25.                                                 for
  26.                                    SYSLIB¼ Z3LIB¼ VLIB¼ anΣ DSLIB
  27.  
  28.                                              Writteε by
  29.                                      RicharΣ Conε¼ HarolΣ Bower
  30.                                              anΣ Others
  31.  
  32.                                     Copyrigh⌠ 198┤ RicharΣ Conn
  33.                                     Copyrigh⌠ 198╣ Alphß Systems
  34.  
  35.                                    ||||||||||||||||||||||||||||||
  36.                                    ||||||||||||||||||||||||||||||
  37.                                    ||||||||||||||||||||||||||||||
  38.                                    ||||||||||||||||||||||||||||||
  39.                                    ||||||||||||||||||||||||||||||
  40.                                    ||||||||||||||||||||||||||||||
  41.                                    ||||||||||||||||||||||||||||||
  42.                                    ||||||||||||||||||||||||||||||
  43.                                    ||||||||||||||||||||||||||||||
  44.                                    ||||||||||||||||||||||||||||||
  45.                                    ||||||||||||||||||||||||||||||
  46.                                    ||||||||||||||||||||||||||||||
  47.                                    ||||||||||||||||||||||||||||||
  48.                                    ||||||||||||||||||||||||||||||
  49.                                    ||||||||||||||||||||||||||||||
  50.                                    ||||||||||||||||||||||||||||||
  51.                                    ||||||||||||||||||||||||||||||
  52.                                    ||||||||||||||||||||||||||||||
  53.                                    ||||||||||||||||||||||||||||||
  54.                                    ||||||||||||||||||||||||||||||
  55.                                    ||||||||||||||||||||||||||||||
  56.                                    ||||||||||||||||||||||||||||||
  57.                                    ||||||||||||||||||||||||||||||
  58.                                    ||||||||||||||||||||||||||||||
  59. .paè
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.                Thi≤ pagσ intentionall∙ lef⌠ blank.
  69. .paè.he                                          ZCPR3: THE LIBRARIES 4.2
  70. .fo                               iii
  71.  
  72.                         Tablσ oµ Contents
  73.  
  74.  
  75.      Prefacσ  « « « « « « « « « « « « « « « « « « « « « « « «   1
  76.      Introductioε « « « « « « « « « « « « « « « « « « « « « «   2
  77.  
  78.   I« SYSLI┬ -¡ Genera∞ Routine≤ « « « « « « « « « « « « « « «   5
  79.      Introductioε « « « « « « « « « « « « « « « « « « « « « «  10
  80.           Comment≤ oε Softwarσ Engineerinτ  « « « « « « « « «  10
  81.           Definition≤ anΣ Term≤ « « « « « « « « « « « « « « «  11
  82.           Parameter-Passinτ Convention≤ « « « « « « « « « « «  12
  83.           Overvie≈ oµ Routine≤  « « « « « « « « « « « « « « «  13
  84.      Director∙ Manipulatioε « « « « « « « « « « « « « « « « «  15
  85.           Director∙ Buffe≥ Structurσ  « « « « « « « « « « « «  16
  86.           Ho≈ T∩ Usσ Thesσ Routine≤ « « « « « « « « « « « « «  16
  87.           Buffe≥ Allocatioε « « « « « « « « « « « « « « « « «  18
  88.                DBUFFER
  89.           Disδ Freσ Spacσ « . « « « « « « « « « « « « « « « «  18
  90.                DFREE
  91.           Director∙ Alphabetizatioε « « « « « « « « « « « « «  18
  92.                DIRALPHA
  93.           GeneralizeΣ Di≥ectory Routine≤  « « « « « « « « « «  19
  94.                DIRF¼ DIRFS
  95.           Director∙ LoaΣ Routine≤ « « « « . « « « « « « « « «  20
  96.                DIRLOAD¼ DIRSLOAD
  97.           Director∙ Pacδ Routine≤ « « « « « « « « « « « « « «  21
  98.                DIRPACK¼ DIRNPACK
  99.           Optima∞ Director∙ Routine≤  « « « « « « « « « « « «  21
  100.                DIRQ¼ DIRQS
  101.           Director∙ Entr∙ Selectioε Routinσ « « « « « « « « «  22
  102.                DIRSEL
  103.           Disk Paramete≥ Informatioε  « « « « « « « « « « « «  23
  104.                DPARAMS¼ BLKSH╞ (global)¼ BLKMS╦ (global),
  105.                EXTEN╘ (global)¼ BLKMA╪ (global)¼ DIRMA╪ (global)
  106.           Filσ Sizσ Computatioε « « « . « « « « « « « « « « «  23
  107.                FSIZE
  108.      Byte-OrienteΣ Filσ Input/Outpu⌠ Routine≤ « « « « « « « «  24
  109.           Byte-OrienteΣ I/╧ Filσ Opeε « « « « « « « « « « « «  25
  110.                FI0$OPEN¼ FI1$OPEN¼ FI2$OPEN¼ FI3$OPEN,
  111.                FO0$OPEN¼ FO1$OPEN¼ FO2$OPEN¼ FO3$OPEN
  112.           Byte-OrienteΣ I/╧ Filσ Closσ  « « « « « « « « « « «  25
  113.                FI0$CLOSE¼ FI1$CLOSE¼ FI2$CLOSE¼ FI3$CLOSE,
  114.                FO0$CLOSE¼ FO1$CLOSE¼ FO2$CLOSE¼ FO3$CLOSE
  115.           Byte-OrienteΣ Input/Outpu⌠  « « « « « « « « « « « «  26
  116.                F0$GET¼ F1$GET¼ F2$GET¼ F3$GET,
  117.                F0$PUT¼ F1$PUT¼ F2$PUT¼ F3$PUT
  118.           Erro≥ Returε Code≤  « « « « « « « « « « « « « « « «  27
  119.      Byte-OrienteΣ Filσ I/╧ witΦ Variablσ Buffer≤ « « « « « «  28
  120.           Inpu⌠ anΣ Outpu⌠ Filσ Opeε  « « « « « « « « « « « «  30
  121.                FXI$OPEN¼ FXO$OPEN
  122.           Inpu⌠ anΣ Outpu⌠ Filσ Closσ « « « « « « « « « « « «  30
  123.                FXI$CLOSE¼ FXO$CLOSE
  124.           Inpu⌠ anΣ Outpu⌠  « « « « « « « « « « « « « « « « «  30
  125.                FX$GET¼ FX$PUTè.pa
  126. .fo                               iv
  127.      Byte-OrienteΣ Filσ I/╧ witΦ Variablσ Buffer≤ anΣ UNGE╘ «  31
  128.           Inpu⌠ anΣ Outpu⌠ Filσ Opeε  « « « « « « « « « « « «  33
  129.                FYI$OPEN¼ FYO$OPEN
  130.           Inpu⌠ anΣ Outpu⌠ Filσ Closσ « « « « « « « « « « « «  33
  131.                FYI$CLOSE¼ FYO$CLOSE
  132.           Input¼ Unget¼ anΣ Outpu⌠  « « « « « « « « « « « « «  33
  133.                FY$GET¼ FY$UNGET¼ FY$PUT
  134.      General-Purposσ CP/═ Filσ Manipulatioε Routine≤  « « « «  34
  135.           Closσ ß Filσ  « « « « « « « « « « « « « « « « « « «  34
  136.                F$CLOSE
  137.           Deletσ ß Filσ « « « « « « « « « « « « « « « « « « «  34
  138.                F$DELETE
  139.           Tes⌠ Filσ Existencσ « « « « « « « « « « « « « « « «  35
  140.                F$EXIST
  141.           Create ß Filσ « « « « « « « « « « « « « « « « « « «  35
  142.                F$MAKE
  143.           Opeε ß Filσ « « « « « « « « « « « « « « « « « « « «  35
  144.                F$OPEN¼ F$MOPEN
  145.           AppenΣ t∩ ß Filσ  « « « « « « « « « « « « « « « « «  35
  146.                F$APPEND¼ F$APPL
  147.           ReaΣ Blocδ froφ Filσ  « « « « « « « « « « « « « « «  36
  148.                F$READ
  149.           Renamσ ß Filσ « « « « « « « « « « « « « « « « « « «  37
  150.                F$RENAME
  151.           Computσ Filσ Size « « « « « « « « « « « « « « « « «  37
  152.                F$SIZE
  153.           Writσ ß Blocδ t∩ ß Filσ « « « « « « « « « « « « « «  37
  154.                F$WRITE
  155.           Returε Randoφ RecorΣ Nuφbe≥ « « « « « « « « « « « «  37
  156.                GETRR¼ GETRR1
  157.           Returε Filσ Sizσ  « « « « « « « « « « « « « « « « «  38
  158.                GETFS¼ GETFS1
  159.           Ge⌠ Filσ Attribute≤ « « « « « « « « « « « « « « « «  38
  160.                GFA
  161.           ReaΣ Filσ Blocδ Randoφ  « « « « « « « « « « « « « «  38
  162.                R$READ
  163.           Writσ Filσ Blocδ Randoφ « « « « « « « « « « « « « «  39
  164.                R$WRITE
  165.           Se⌠ o≥ Clea≥ Filσ Attribute≤  « « « « « « « « « « «  39
  166.                SCFA¼ SFA
  167.      Librar∙ Filσ Manipulatioε  « « « « « « « « « « « « « « «  40
  168.           Initializσ Librar∙  « « « « « « « « « « « « « « « «  40
  169.                LUINIT
  170.           Returε Library Director∙  « « « « « « « « « « « « «  40
  171.                LUDIR
  172.           Opeε ß Librar∙ Filσ « « « « « « « « « « « « « « « «  41
  173.                LUOPEN
  174.           Closσ ß Librar∙ Filσ  « « « « « « « « « « « « « « «  41
  175.                LUCLOSE
  176.           ReaΣ ß Librar∙ Filσ « « « « « « « « « « « « « « « «  41
  177.                LUREAD
  178.      Filσnamσ Strinτ Parse≥ « « « « « « « « « « « « « « « « «  41
  179.                FNAME
  180.      Filσ Contro∞ ┬lock Initializatioε  « « « « « « « « « « «  42
  181.                INITFCBè.fo                                v
  182.      Disk/User Manipulatioε « « « « « « « « « « « « « « « « «  42
  183.           Ge⌠ and Se⌠ Curren⌠ Use≥ Areß « « « « « « « « « « «  43
  184.                GUA¼ SUA
  185.           Returε thσ Curren⌠ Disδ anΣ Use≥  « « « « « « « « «  43
  186.                RETUD
  187.           Loτ int∩ ß SpecifieΣ Disδ anΣ Use≥  « « « « « « « «  43
  188.                LOGUD
  189.           Savσ anΣ Restorσ Curren⌠ Disδ anΣ Use≥  « « « « « «  44
  190.                PUTUD¼ GETUD
  191.           Se⌠ DM┴ Transfe≥ Addres≤  « « « « « « « « « « « « «  44
  192.                SETDMA
  193.      Numeriπ Strinτ Evaluatioε  « « « « « « « « « « « « « « «  44
  194.           Genera∞ ╨urpose Numeriπ Strinτ Evaluatioε « « « « «  44
  195.                EVAL
  196.           Hexadecima∞ Strinτ Evaluatioε « « « « « « « « « « «  45
  197.                EVAL16
  198.           Decima∞ Strinτ Evaluatioε « « « . « « « « « « « « «  45
  199.                EVAL10
  200.           Octa∞ Strinτ Evaluatioε « « « « « « « « « « « « « «  45
  201.                EVAL8
  202.           Binar∙ Strinτ Evaluatioε  « « « « « « « « « « « « «  46
  203.                EVAL2
  204.      The L¼ M¼ P¼ anΣ ╙ Numeriπ Outpu⌠ Routine≤ « « « « « « «  46
  205.           Samplσ Numeriπ Output≤  « « « « « « « « « « « « « «  47
  206.           ▓ Hexadecima∞ Characters  « « « « « « « « « « « « «  47
  207.                LA2HC¼ PA2HC¼ SA2HC¼ MA2HC
  208.           │ Decimal Character≤  « « « « « « « « « « « « « « «  47
  209.                LA3DC¼ PA3DC¼ SA3DC¼ MA3DC
  210.           ▒ t∩ │ Decimal Characters witΦ Leadinτ Space≤ « « «  48
  211.                LADC¼ PADC¼ SADC¼ MADC
  212.           ▒ t∩ │ Decima∞ Character≤ « « « « « « « « « « « « «  48
  213.                LAFDC¼ PAFDC¼ SAFDC¼ MAFDC
  214.           ┤ Hexadecima∞ Characters  « « « « « « « « « « « « «  48
  215.                LHL4HC¼ PHL4HC¼ SHL4HC¼ MHL4HC
  216.           ╡ Decima∞ Character≤  « « « « « « « « « « « « « « «  49
  217.                LHL5DC¼ PHL5DC¼ SHL5DC¼ MHL5DC
  218.           ▒ t∩ ╡ Decimal Characters witΦ Leadinτ Space≤ « « «  49
  219.                LHLDC¼ PHLDC¼ SHLD├¼ MHLDC
  220.           ▒ t∩ ╡ Decima∞ Character≤ « « « « « « « « « « « « .  49
  221.                LHLFDC¼ PHLFDC¼ SHLFDC¼ MHLFDC
  222.      Inpu⌠ Linσ Editor≤ « « « « « « « « « « « « « « « « « « «  50
  223.           BDOS-BaseΣ Inpu⌠ Linσ Editor≤ « « « « « « « « « « «  50
  224.                BBLINE¼ BLINE
  225.           Independen⌠ Inpu⌠ Linσ Edito≥ « « « « « « « « « « «  51
  226.                INLINE
  227.      Strinτ anΣ SwitcheΣ Outpu⌠ « « « « « « « « « « « « « « «  52
  228.           Prin⌠ Strinτ froφ Stacδ « « « « « « « « « « « « « «  53
  229.                PRINT¼ EPRINT¼ LPRINT¼ SPRINT
  230.           Prin⌠ Strinτ froφ H╠  « « « « « « « « « « « « « « «  53
  231.                PSTR¼ EPSTR¼ LPSTR¼ SPSTR
  232.      Filσnamσ Outpu⌠  « « « « « « « « « « « « « « « « « « « «  53
  233.           Prin⌠ Filσnamσ  « « « « « « « « « « « « « « « « « «  54
  234.                LFNn¼ PFNn¼ SFNn
  235.           Storσ Filσnamσ iε Memor∙  « « « « « « « « « « « « «  54
  236.                MFNnè.fo                               vi
  237.      Character-OrienteΣ Input/Outpu⌠  « « « « « « « « « « « «  55
  238.           Cha≥acter Inpu⌠ Viß BDO╙  « « « « « « « « « « « « «  56
  239.                BIN
  240.           Cha≥acter Inpu⌠ Statu≤ Viß BDO╙ « « « « « « « « « «  56
  241.                BIST
  242.           Cha≥acter Outpu⌠ Viß BDO╙ « « « « « « « « « « « « «  56
  243.                BOUT
  244.           Cha≥acter Inpu⌠ and Capitalization witΦ Ech∩  « « «  56
  245.                CAPIN¼ CAPINE
  246.           Cha≥acter Inpu⌠ « « « « « « . « « « « « « « « « « «  56
  247.                CIN¼ RIN
  248.           Characte≥ Outpu⌠  « « « « « « « « « « « « « « « « «  57
  249.                COUT¼ COUT7,áLOUT¼ POUT¼ SOUT
  250.           Cha≥acter Outpu⌠ witΦ Contro∞ Character≤  « « « « «  57
  251.                CCOUT¼ CLOUT¼ CPOUT¼ CSOUT
  252.           Conditiona∞ Inpu⌠ « « « « « « « « « « « « « « « « «  57
  253.                CONDIN
  254.           Ne≈ Linσ Outpu⌠ « « « « « « « « « « « « « « « « « «  58
  255.                CRLF¼ LCRLF¼ SCRLF
  256.           Consolσ Statu≤  « « « « « « « « « « « « « « « « « «  58
  257.                CST
  258.      Branchinτ  « « « « « « « « « « « « « « « « « « « « « « «  58
  259.           Casσ viß ┴ Registe≥ « « « « « « « « « « « « « « « «  59
  260.                ACASE1¼ ACASE2¼ ACASE3
  261.           Casσ viß H╠ Reτister Pai≥ « « « « « « « « « « « « «  61
  262.                HCASE1¼ HCASE2¼ HCASE3
  263.           ComputeΣ GOT╧ viß ┴ « « « « « « « « « « « « « « « «  62
  264.                AGOTO1¼ AGOTO2¼ BGOTO1¼ BGOTO2
  265.           ComputeΣ GOT╧ viß H╠  « « « « « « « « « « « « « « «  63
  266.                HGOTO1¼ HGOTO2¼ DGOTO1¼ DGOTO2
  267.           Arithmetiπ I╞ viß ┴ « « « « « « « « « « « « « « « «  65
  268.                AIF1¼ AIF2
  269.           Arithmetiπ I╞ viß H╠  « « « « « « « « « « « « « « «  66
  270.                HIF1¼ HIF2
  271.      Parsinτ Aid≤ « « « « « « « « « « « « « « « « « « « « « «  67
  272.           UNIX-Stylσ ARGC/ARG╓ Strinτ Parsinτ « « « « « « « «  67
  273.                ARGV
  274.           Capitalizatioε  « « « « « « « « « « « « « « « « « «  68
  275.                CAPS¼ CAPSTR
  276.           Characte≥ Tes⌠ Routine≤ « « « « « « « « « « « « « «  68
  277.                ISALNUM¼ ISALPHA¼ ISCTRL¼ ISDIGIT¼ ISGRAPH¼
  278.                ISPRINT¼ ISPUN¼ ISSP
  279.           Characte≥ Ski≡ Routine≤ « « « « « « « « « « « « « «  69
  280.                SKNPUN¼ SKNSP¼ SKPUN¼ SKSP
  281.      General-Purposσ Arithmetiπ « « « « « « « « « « « « « « «  69
  282.           Arithmetiπ -¡ Add¼ Subtract¼ Multiply¼ Dividσ « « «  69
  283.                ADDHD¼ SUBHD¼ MULHD¼ DIVHD
  284.           Complemen⌠ -¡ Negatσ (2'≤) anΣ Complemen⌠ (1's⌐ « «  70
  285.                NEGH¼ CMPH
  286.           Logica∞ -¡ And, Or¼ Xo≥ « « « « « « « « « « « « « «  71
  287.                ANDHD¼ ORHD¼ XORHD
  288.           Rotatσ and Shif⌠ -¡ Lef⌠ anΣ Righ⌠  « « « « « « « «  71
  289.                ROTLH¼ ROTRH¼ SHFTLH¼ SHFTRH
  290. .paè.fo                               vii
  291.      CR├ Calculatioε  « « « « « « « « « « « « « « « « « « « «  72
  292.           Initialization  « « « « « « « « « « « « « « « « « «  72
  293.                CRCCLR¼ CRC1CLR¼ CRC2CLR¼ CRC3CLR¼ CRC3INIT
  294.           CR├ Updatinτ  « « « « « « « « « « « « « « « « « « «  73
  295.                CRCUPD¼ CRC1UPD¼ CRC2UPD¼ CRC3UPD
  296.           CR├ Completioε  « « « « « « « « « « « « « « « « « «  73
  297.                CRCDONE¼ CRC1DONE¼ CRC2DONE¼ CRC3DONE
  298.      Randoφ Numbe≥ Generatioε « « « « « « « « « « « « « « « «  73
  299.           Initializσ Randoφ Numbe≥ Generato≥ SeeΣ « « « « « «  73
  300.                RNDINI╘
  301.           Se⌠ Knowε SeeΣ Valuσ  « « « « « « « « « « « « « « «  73
  302.                RNDSEE─
  303.           Returε 8-bi⌠ Pseudo-Randoφ Numbe≥ « « « « « « « « «  74
  304.                RN─
  305.      Strinτ anΣ Valuσ Comparisoε  « « « « « « « « « « « « « «  74
  306.           Comparσ Vector≤ « « « « . « « « « « « « « « « « « «  74
  307.                COMPB¼ COMPBC
  308.           Comparσ Filename≤ « « « « « « « « « « « « « « « « «  74
  309.                @FNCMP¼ @AFNCMP
  310.           Comparσ H╠ t∩ D┼  « « « « « « « « « « « « « « « « «  75
  311.                COMPHD
  312.           Substrinτ SearcΦ  « « « « « « « « « « « « « « « « «  75
  313.                INSTR
  314.           Vecto≥ SearcΦ « . « « « « « « « « « « « « « « « « «  76
  315.                SCANNER
  316.      Memor∙ Allocatioε  « « « « « « « « « « « « « « « « « « «  76
  317.           Allocatσ ß Blocδ oµ Memor∙  « « « « « « « « « « « «  77
  318.                ALLOC
  319.           Initializσ Memor∙ Allocatioε Systeφ « « « « « « « «  78
  320.                IALLOC
  321.           Checδ fo≥ To≡ oµ Availablσ Memor∙ « « « « « « « « «  78
  322.                GMEMTOP
  323.      Sor⌠ Routine≤  « « « « « « « « « « « « « « « « « « « « «  78
  324.           Sor⌠ Specification Blocδ Initialize≥  « « « « « « «  79
  325.                SSBINIT
  326.           Maiε Sor⌠ Routinσ « « « « « « « « « « « « « « « « «  80
  327.                SORT
  328.      Miscellaneou≤ Routine≤ « « « « « « « « « « « « « « « « «  80
  329.           BDO╙ anΣ BIO╙ Routine≤  « « « « « « « « « « « « « «  80
  330.                BDOS¼ BIOS
  331.           Characte≥ anΣ Nybblσ Conversion≤  « « « « « « « « «  81
  332.                CATH¼ @B2HH¼ @B2HL
  333.           CommanΣ Linσ Tai∞ Extractioε  « « « « « « « « « « «  82
  334.                CLINE
  335.           EnΣ oµ Codσ « « « « « « « « . « « « « « « « « « « «  82
  336.                CODEND¼ $MEMR┘ (global)
  337.           Exchangσ Nybble≤  « « « « « « « « « « « « « « « « «  83
  338.                EN
  339.           Memor∙ Fil∞ Routine≤  « « « « « « « « « « « « « « «  83
  340.                FILLB¼ FILLBC¼ HFILB¼ HFILBC
  341.           Memor∙ Movσ Routine≤  « « « « « « « « « « « « « « «  83
  342.                MOVEB¼ MOVEBC, HMOVB¼ HMOVBC
  343.           Dela∙ Routinσ « « « « « « « « « « « « « « « « « « «  84
  344.                PAUSE
  345. .paè.fo                              viii
  346.           Versioε Numbe≥ oµ SYSLI┬  « « « « « « « « « « « « «  84
  347.                VERSION
  348.  
  349.  II« Z3LI┬ -¡ ZCPR│ Suppor⌠ anΣ Acces≤ Routine≤ « « « « « « «  85
  350.      Introductioε « « « « « « « « « « « « « « « « « « « « « «  87
  351.           ExtendeΣ Environmen⌠ Descriptioε  « « « « « « « « «  87
  352.      Acces≤ t∩ thσ ZCPR│ Environmen⌠  « « « « « « « « « « « «  90
  353.           Command Linσ  « « « « « « « « « « « « « « « « « « «  91
  354.                APPCL¼ CLRCL¼ GETCL1¼ GETCL2¼ PUTCL
  355.           CR╘ anΣ PRT Datß  « « « « « « « « « « « « « « « « «  92
  356.                GETCRT¼ GETPRT¼ PUTCRT¼ PUTPRT
  357.           External Filσ Contro∞ Blocδ « « « « « « « « « « « «  94
  358.                GETEFCB
  359.           Environmen⌠ « « « « « « « « « « « « « « « « « « « «  94
  360.                GETENV¼ GETVID
  361.           Flo≈ Command Packagσ (FCP) Addres≤  « « « « « « « «  95
  362.                GETFCP
  363.           Filename≤ « « « « « « « « « « « « « « « « « « « « «  95
  364.                GETFN1, GETFN2¼ GETFNX¼ PUTFNX
  365.           ╔nitializσ  « « « « « « « « « « « « « « « « « « « «  96
  366.                WHRENV¼ Z3INIT
  367.           System Datß « « « « « « « « « « « « « « « « « « « «  97
  368.                ZSYSCHK¼ Z33CHK¼ GETBDOS¼ GETCCP¼ GETECP
  369.           Input-Outpu⌠ Packagσ (IOP) Concept≤ « « « « « « « «  99
  370.                GETION¼ GETIOP¼ GETIOS¼ IOMATCH¼ PUTIOD
  371.           Input-Outpu⌠ Packagσ (IOP) Recordinτ  « « « « « « « 101
  372.                IORCOFF, IORCON, IORLOFF, IORLON
  373.           Drive/Use≥  « « « « « « « « « « « « « « « « « « « « 101
  374.                GETDUOK¼ GETMDISK¼ GETMUSER¼ PUTDUOK,
  375.                PUTMDISK¼ PUTMUSER¼ HIGHUSER¼ GCMDDU
  376.           Message≤  « « « « « « « « « « « « « « « « « « « « « 103
  377.                GETMSG¼ GETSHM¼ PUTSHM
  378.           Named Directorie≤ « « « « « « « « « « « « « « « « « 104
  379.                ADDNDR¼ DIRNDR¼ DUNDR¼ GETNDR¼ SUBNDR
  380.           PatΦ  « « « « « « « « « « « « « « « « « « « « « « « 106
  381.                GETPATH
  382.           Processor SpeeΣ « « « « « « « « « « « « « « « « « « 106
  383.                GETSPEED¼ PUTSPEED
  384.           Quiet Flaτ  « « « « « « « « « « « « « « « « « « « « 107
  385.                GETQUIET¼ PUTQUIET
  386.           Residen⌠ CommanΣ Packagσ (RCP) Addres≤  « « « « « « 107
  387.                GETRCP
  388.           Shell Stacδ « « « « « « « « « « « « « « « « « « « « 108
  389.                GETSH1¼ GETSH2
  390.           Wheel Bytσ  « « « « « « « « « « « « « « « « « « « « 108
  391.                GETWHL¼ PUTWHL
  392.      Flo≈, ZE╪¼ anΣ SUBMIT Contro∞  « « « « « « « « « « « « « 109
  393.           Flow Contro∞  « « « « « « « « « « « « « « « « « « « 109
  394.                IFEND¼ IFT, IFF¼ IFTEST¼ IFELSE
  395.           ZEX Access and Contro∞  « « « « « « « « « « « « « « 111
  396.                ZEX Datß « « « « « « « « « « « « « « « « « « « 112
  397.                     GETZFC¼ GETZNC¼ GETZRUN¼ PUTZNC¼ PUTZRUN
  398.                ZEX Status and Contro∞ « « « « « « « « « « « « 113
  399.                     GETZEX¼ PUTZEX¼ HALTZEX¼ STOPZEX¼ STRTZEX
  400. .paè.fo                               ix
  401.           SUBMIT and XSUB Contro∞ « « « « « « « « « « « « « « 114
  402.                SUBMIT Data and Contro∞  « « « « « « « « « « « 115
  403.                     SUBON¼ HALTSUB¼ GETSRUN¼ GETSFCB
  404.                XSUB Data and Contro∞  « « « « « « « « « « « « 116
  405.                     STOPXSUB¼ GXSUB¼ PXSUB
  406.      ZCPR3 Message≤ « « « « « « « « « « « « « « « « « « « « « 116
  407.           Command Status Messagσ  « « « « « « « « « « « « « « 118
  408.                GETCST¼ PUTCST¼ QERROR¼ QSHELL
  409.           Error Flag and Error CommanΣ  « « « « « « « « « « « 119
  410.                ERRADR¼ GETER1¼ PUTER1¼ GETERC¼ PUTERC
  411.           Inter-Transient Error Codσ  « « « « « « « « « « « « 121
  412.                GETER2¼ PUTER2
  413.           Command Error Flag and Handle≥  « « « « « « « « « « 121
  414.                GETER3¼ PUTER3¼ INVERROR
  415.           Command Status Flaτ « « « « « « « « « « « « « « « « 122
  416.                SETEPB¼ RESEPB¼ RETCST
  417.           Register Acces≤ « « « « « « « « « « « « « « « « « « 123
  418.                GETREG¼ PUTREG
  419.           Default Drive/User Buffe≥ « « « « « « « « « « « « « 124
  420.                GDEFDU¼ PDEFDU
  421.      ZCPR│ Utilitie≤  « « « « « « « « « « « « « « « « « « « « 124
  422.           Named Directory-Drive/User Conversioε « « « « « « « 124
  423.                DIRTDU¼ DUTDIR
  424.           Resolve Directory Reference≤  « « « « « « « « « « « 125
  425.                DNSCAN¼ DUSCAN¼ DIRSCAN
  426.           Parse Command Linσ  « « « « « « « « « « « « « « « « 126
  427.                PARSER
  428.           Path Search for Filσ  « « « « « « « « « « « « « « « 126
  429.                PFIND
  430.           Program Loading (Chaining⌐  « « « « « « « « « « « « 126
  431.                PRGLOAD
  432.           Console Quie⌠ Outpu⌠  « « « « « « « « « « « « « « « 127
  433.                QCOUT¼ QCRLF¼ QOUT¼ QPRINT¼ QPSTR
  434.           Locate ROOT Director∙ « « « « « « « « « « « « « « « 128
  435.                ROOT
  436.           Shell Stack Routine≤  « « « « « « « « « « « « « « « 128
  437.                SHEMPTY¼ SHFULL¼ SHPOP¼ SHPUSH
  438.           Delay Routine≤  « « « « « « « « « « « « « « « « « « 129
  439.                WAIT1S¼ WAIT1MS¼ WAITP1S
  440.           Log into ZCPR3 Filσ Contro∞ Block Drive/Use≥  « « « 130
  441.                Z3LOG
  442.           Return Z3LIB Versioε  « « « « « « « « « « « « « « « 130
  443.                Z3LVER
  444.           Parse Tokeε « « « « « « « « « « « « « « « « « « « « 131
  445.                ZPRSFN, ZFNAME
  446.           ZCPR 3.3 Parser≤  « « « « « « « « « « « « « « « « « 131
  447.                Z33FNAME¼ PARSE2¼ REPARSE¼ SCAN
  448.           Check ZCP╥ 3.3 Parse Result≤  « « « « « « « « « « « 132
  449.                FCB1CHK, FCB2CHK¼ FCBCHK
  450.           Print Load Module Datß  « « « « « « « « « « « « « « 133
  451.                PRTTYPE
  452.           ZCP╥ 3.3 Internal Program Namσ  « « « « « « « « « « 133
  453.                GETNAME¼ PRTNAME
  454.           Highest Useable Memor∙  « « « « « « « « « « « « « « 134
  455.                GZMTOPè.pa
  456. .fo                                x
  457. III« VLI┬ -¡ Vide∩ Termina∞ Interfacσ « « « « « « « « « « « « 135
  458.      Introductioε « « « « « « « « « « « « « « « « « « « « « « 136
  459.           Usinτ VLI┬  « « « « « « « « « « « « « « « « « « « « 136
  460.           Termina∞ Ca≡abilities (TCAP⌐ ExtendeΣ Definitioε  « 137
  461.      Basiπ VLI┬ Routine≤  « « « « « « « « « « « « « « « « « « 143
  462.           Screeε, Curso≥, anΣ Miscellaneou≤ Routine≤  « « « « 143
  463.                CLS¼ CLREOS¼ EREOL¼ AT¼ GOTOXY¼ DELLIN¼
  464.                INSLIN¼ ISCUR¼ VVERS
  465.           Initializatioε  . « « « « « « « « « « « « « « « « « 146
  466.                VIDINIT¼ Z3VINIT¼ VIDPT╥ (global)
  467.           Prin⌠ Routine≤  « « « « « « « « « « « « « « « « « « 146
  468.                GXYMSG¼ VPRINT¼ VPSTR
  469.           Standou⌠ Modσ « « « « « « « « « « « « « « « « « « « 147
  470.                STNDOUT¼ STNDEND
  471.           Terφinal Ini⌠ializatioε anΣ De-Initializatioε « « « 148
  472.                TINIT¼ DINIT
  473.      Graphic≤ . « « « « « « « « « « « « « « « « « « « « « « « 149
  474.           Ini⌠ializatioε  « « « « « « « « « « « « « « « « « « 149
  475.                GZ3INIT¼ GRXON¼ GRXOFF
  476.           Blocδ Graphic≤  « « « « « « « « « « « « « « « « « « 150
  477.                DRFULL¼ DRHASH
  478.           Corne≥s anΣ Intersection≤ « « « « « « « « « « « « « 150
  479.                ULEFT¼ URIGHT¼ LLEFT¼ LRIGHT¼ LTISEC¼
  480.                RTISEC¼ UISEC¼ LISEC¼ ISEC
  481.           Horizonta∞ anΣ Vertica∞ Bar≤  « « « « « « « « « « « 151
  482.                DRHBAR¼ DRHORZ¼ ERAHORZ¼ GHBAR¼ ERAHBAR,
  483.                DRVBAR¼ DRVERT¼ ERAVERT¼ GVBAR¼ ERAVBAR
  484.           Bo° Dra≈ing Routine≤  « « « « « « « « « « « « « « « 155
  485.                DRFBOX¼ DRBOX¼ ERABOX¼ GFBOX¼ GBOX¼
  486.                GERBOX¼ CHKBOX
  487.           Pull-Dowε Menu≤ « « « « « « « « « « « « « « « « « « 156
  488.                SETPDM¼ CLRPDM¼ SELPDM¼ MCLS¼ PDMINI¼
  489.                ISPDM¼ SPDMCHR
  490.           Readinτ thσ Termina∞ Screeε « « « « « « « « « « « « 159
  491.                GETCUR¼ GETLIN
  492.  
  493.  IV« DSLI┬ -¡ Clocδ anΣ Filσ Stam≡ Suppor⌠  « « « « « « « « « 161
  494.      Introductioε « « « « « « « « « « « « « « « « « « « « « « 162
  495.           Systeφ Identit∙ « « « « « « « « « « « « « « « « « « 163
  496.                TIMINI¼ GETDOS¼ FINDCK¼ CKTDF¼ DOSTY╨ (global)¼
  497.                DOSVE╥ (global)¼ TIMTY╨ (global)
  498.           Clocδ Readinτ « « « « « « « « « « « « « « « « « « « 164
  499.                RCLOCK¼ RDCLK
  500.           Filσ Stam≡ Routine≤ « « « « « « « « « « « « « « « « 165
  501.                GSTAMP¼ PSTAMP¼ GETTD¼ SETTD
  502.           Director∙ Selectioε « « « « « « « « « « « « « « « « 167
  503.                DDIRQS¼ DDIRQ¼ DDIRNPAK¼ DDIRPAK¼ DDIRSEL
  504.           Timσ Conversion≤  « « « « « « « « « « « « « « « « « 169
  505.                U2PTIM¼ P2UTIM¼ U2MTIM¼ M2UTIM
  506.           Utilit∙ Routine≤  « « « « « « « « « « « « « « « « « 172
  507.                FSTNXT¼ BCD2BIN¼ BIN2BCD¼ DVERS
  508.           DateStampe≥ TIME&DA╘  « « « « « « « « « « « « « « « 173
  509.                OPENTD¼ CLOSTD¼ RWTD
  510.  
  511.      INDE╪ O╞ ROUTINES  « « « « « « « « « « « « « « « « « « « 175è.pa
  512. .he
  513. .fo
  514.                                    ||||||||||||||||||||||||||||||
  515.                                    ||||||||||||||||||||||||||||||
  516.                                    ||||||||||||||||||||||||||||||
  517.                                    ||||||||||||||||||||||||||||||
  518.                                    ||||||||||||||||||||||||||||||
  519.                                    ||||||||||||||||||||||||||||||
  520.                                    ||||||||||||||||||||||||||||||
  521.                                    ||||||||||||||||||||||||||||||
  522.                                    ||||||||||||||||||||||||||||||
  523.                                    ||||||||||||||||||||||||||||||
  524.                                    ||||||||||||||||||||||||||||||
  525.                                    ||||||||||||||||||||||||||||||
  526.  
  527.                                         ZCPR3║ TH┼ LIBRARIES
  528.                                             Versioε 4.2
  529.  
  530.                                          A Referencσ Manual
  531.                                                 and
  532.                                             User'≤ Guide
  533.                                                 for
  534.                                    SYSLIB¼ Z3LIB¼ VLIB¼ anΣ DSLIB
  535.  
  536.                                              Writteε by
  537.                                      RicharΣ Conε¼ HarolΣ Bower
  538.                                              anΣ Others
  539.  
  540.                                     Copyrigh⌠ 198┤ RicharΣ Conn
  541.                                     Copyrigh⌠ 198╣ Alphß Systems
  542.  
  543.                                    ||||||||||||||||||||||||||||||
  544.                                    ||||||||||||||||||||||||||||||
  545.                                    ||||||||||||||||||||||||||||||
  546.                                    ||||||||||||||||||||||||||||||
  547.                                    ||||||||||||||||||||||||||||||
  548.                                    ||||||||||||||||||||||||||||||
  549.                                    ||||||||||||||||||||||||||||||
  550.                                    ||||||||||||||||||||||||||||||
  551.                                    ||||||||||||||||||||||||||||||
  552.                                    ||||||||||||||||||||||||||||||
  553.                                    ||||||||||||||||||||||||||||||
  554.                                    ||||||||||||||||||||||||||||||
  555.                                    ||||||||||||||||||||||||||||||
  556.                                    ||||||||||||||||||||||||||||||
  557.                                    ||||||||||||||||||||||||||||||
  558.                                    ||||||||||||||||||||||||||||||
  559.                                    ||||||||||||||||||||||||||||||
  560.                                    ||||||||||||||||||||||||||||||
  561.                                    ||||||||||||||||||||||||||||||
  562.                                    ||||||||||||||||||||||||||||||
  563.                                    ||||||||||||||||||||||||||||||
  564.                                    ||||||||||||||||||||||||||||||
  565.                                    ||||||||||||||||||||||||||||||
  566.                                    ||||||||||||||||||||||||||||||
  567. .paè
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.                This pagσ intentionall∙ lef⌠ blank.
  577. .paè