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