home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / zsus / z3help / z.lbr / Z3LIB.HZP / Z3LIB.HLP
Encoding:
Text File  |  1991-11-18  |  7.0 KB  |  208 lines
  1. ;
  2.                                   Z3LIB.REL                                   
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5. Z3LIB.REL     11k (88)   A768  4.4a       Harold Bower 7/91        Z3LIB4
  6. Z3LIBS.REL    10k (80)   D062  4.4a       Harold Bower 7/91        Z3LIB4
  7.  
  8.   1- Introduction  2- Extended Environment Definition  3- Help Files          
  9.  
  10.    Z3LIB, the ZCPR3-specific libraries, provide:
  11.    Access to the ZCPR3 Environment - (Command Line, CRT/PRT Data, External
  12.                                       FCB, Environment, FCP Address, File 
  13.                                       Names, Initialize)
  14.    Access to the ZCPR3 Environment - (IOP, DU/Max DU, Messages, Named Dir,
  15.                                       Path, Processor Speed, Quiet Flag, 
  16.                                       RCP Address, Shell Stack, Wheel Byte)
  17.    Flow and ZEX Control Under ZCPR3   
  18.    Access to the ZCPR3 Messages
  19.    General-Purpose ZCPR3 Utilities
  20.  
  21. :1
  22.  Introduction - 1/2 
  23.  
  24.    Z3LIB is one  of three libraries provided with the ZCPR3 System,  the other
  25. two being SYSLIB and VLIB.   Z3LIB contains  a host of support utilities which 
  26. provide access to ZCPR3-specific features and capabilities.   SYSLIB is a host
  27. of general-purpose  utilities and VLIB is  a set  of machine-independent  (via
  28. Z3TCAP) utilities which support CRT control and utilitization.
  29.  
  30.    SYSLIB is documented in a collection of SYSLIB*.HLP files, as is VLIB.
  31.  
  32.  Introduction - 2/2 
  33.      Z3LIB routines can be divided into four categories:
  34.  
  35.           1.   ZCPR3 Environment Access 
  36.                -- Those utilities which allow the programmer to easily extract
  37. data from the Z3 Environment  Descriptor  and  modify  certain  Z3 environment 
  38. parameters
  39.  
  40.           2.  ZCPR3 Flow Control 
  41.                -- Those  utilities  which  permit  the  programmer  to  easily 
  42. manipulate  the flow  control environment of ZCPR3,  enabling him to raise the 
  43. level or lower the level of the current IF condition and to toggle the current
  44. IF condition as desired
  45.  
  46.           3.  ZCPR3 Messages 
  47.                -- Those utilities  providing  access  to  the  ZCPR3 messages, 
  48. allowing the program to read and write messages from and to the system
  49.  
  50.           4.  ZCPR3 Utilities 
  51.                -- Useful  utilities   which   relieve   the   programmer  from 
  52. constantly reprogramming some  commonly-used ZCPR3 features
  53. :2
  54.  Extended Environment Description 
  55.  
  56.    Version 4 of Z3LIB incorporates  many enhanced functions  developed  by Joe 
  57. Wright and Jay Sage in NZCOM and  ZCPR33 and 34.   Due to redefinition of some 
  58. of the bytes in the Environment Descriptor, a few of the original modules will
  59. not  perform  as originally intended.   For example,  only  one  Console  (CRT 
  60. device) is  supported.   The remaining space  in  the  ENV contains vectors to 
  61. system segments.
  62.  
  63.    Some programs such as  Plu*Perfect Systems' JETLDR and Alpha Systems' NZCOM 
  64. set  an  existing Environment Descriptor  to  reflect  the  necessary extended 
  65. definitions.  If you do not routinely use either of these products, you should 
  66. create a  new SYS.ENV file for  use with your existing ZCPR3 system.   The new
  67. definitions  are  marked with  an asterisk (*) in  the  following  source code 
  68. sample Environment Descriptor.
  69.  
  70.  ; Library:  NZENV.LIB
  71.  ; Author:   Joe Wright
  72.  ; Version:  1.0
  73.  ; Date:     29 Nov 87
  74.  
  75.  ; Adapted from Rick Conn's original SYSENV.LIB circa 1984
  76.  
  77. Z3ENV:    JP    CBIOS+6        ;* Real BIOS Addr (+6) for your
  78.                 ;  system (* Was JP 0 *)
  79.  
  80.     DEFB    'Z3ENV'        ; Environment ID
  81.  
  82.     DEFB    80H        ;* Extended Env shown by Bit 7
  83.  
  84.     DEFW    EXPATH        ; External Path address
  85.     DEFB    EXPATHS        ; # of 2-byte elements in Path
  86.  
  87.     DEFW    RCP        ; RCP address
  88.     DEFB    RCPS        ; # of 128-byte blocks in RCP
  89.  
  90.     DEFW    IOP        ; IOP address
  91.     DEFB    IOPS        ; # of 128-byte blocks in IOP
  92.  
  93.     DEFW    FCP        ; FCP address
  94.     DEFB    FCPS        ; # of 128-byte blocks in FCP
  95.  
  96.     DEFW    Z3NDIR        ; NDR address
  97.     DEFB    Z3NDIRS        ; # of 18-byte entries in NDR
  98.  
  99.     DEFW    Z3CL        ; ZCPR3 Command Line
  100.     DEFB    Z3CLS        ; # of bytes in Command Line
  101.  
  102.     DEFW    Z3ENV        ; ZCPR3 Environment Descriptor
  103.     DEFB    Z3ENVS        ; # of 128-byte blks in ENV
  104.  
  105.     DEFW    SHSTK        ; Shell Stack address
  106.     DEFB    SHSTKS        ; # SHSIZE-byte entries in Stk
  107.     DEFB    SHSIZE        ; Size of a Shell Stack entry
  108.  
  109.     DEFW    Z3MSG        ; ZCPR3 Message Buffer
  110.  
  111.     DEFW    EXTFCB        ; ZCPR3 External FCB
  112.  
  113.     DEFW    EXTSTK        ; ZCPR3 External Stack
  114.  
  115.     DEFB    0        ; Quiet flag (0=not quiet)
  116.  
  117.     DEFW    Z3WHL        ; Address of Wheel Byte
  118.  
  119.     DEFB    4        ; Processor Speed in MHz
  120.  
  121.     DEFB    'P'-'@'        ; Maximum Disk
  122.     DEFB    31        ; Maximum User
  123.     DEFB    1        ; 1=Ok to accept DU:, 0=Not Ok
  124.  
  125.     DEFB    0        ;* CRT Selection   (* Unused *)
  126.     DEFB    0        ; Printer Sel (only 0 or 1)
  127.  
  128.     DEFB    80        ; Width of CRT 0
  129.     DEFB    24        ; Number of lines on CRT 0
  130.     DEFB    22        ; Number of text lines on CRT 0
  131.  
  132.  ; CRT 1 descriptor is replaced with this Valid Drive Vector.
  133.  ; The Command Processor ignores 'Maximum disk' above, and uses
  134.  ; this vector instead.  This allows 'holes' in the disk map.
  135.  ; A user might have drives A, B, E, F and G for example. In
  136.  ; this case, his vector would look like:
  137.  ;    DEFW    0000000001110011B
  138.  ; The Command Processor will treat drive C the same as drive H
  139.  ; (unavailable) and take appropriate action.  
  140.  
  141.     DEFW    1111111111111111B ;* Valid drive vector (16)
  142.     DEFB    0        ;* Not used
  143.  
  144.     DEFB    80        ; Width of Printer 0
  145.     DEFB    66        ; Number of lines on Printer 0
  146.     DEFB    58        ; Number of text lines on Ptr 0
  147.     DEFB    1        ; H/W Form Feed (0=can't,1=can)
  148.  
  149.     DEFB    102        ; Width of Printer 1
  150.     DEFB    66        ; Number of lines on Printer 1
  151.     DEFB    58        ; Number of text lines on Ptr 1
  152.     DEFB    1        ; H/W Form Feed (0=can't,1=can)
  153.  ;* Descriptors for Printers 2 and 3 replaced with System Data
  154.  
  155.     DEFW    CCP        ;* ZCPR 3.x start loc'n       3FH
  156.     DEFB    CCPS        ;* Size in records       41H
  157.  
  158.     DEFW    DOS        ;* DOS starting location   42H
  159.     DEFB    DOSS        ;* Size in records       44H
  160.  
  161.     DEFW    BIOS        ;* NZBIO starting location 45H
  162.  
  163.     DEFB    'SH      '    ; Shell Variable Filename
  164.     DEFB    'VAR'        ; Shell Variable Filetype
  165.  
  166.     DEFB    '        '    ; Filename 1
  167.     DEFB    '   '        ; Filetype 1
  168.  
  169.     DEFB    '        '    ; Filename 2
  170.     DEFB    '   '        ; Filetype 2
  171.  
  172.     DEFB    '        '    ; Filename 3
  173.     DEFB    '   '        ; Filetype 3
  174.  
  175.     DEFB    '        '    ; Filename 4
  176.     DEFB    '   '        ; Filetype 4
  177.  
  178.     DEFB    0        ;* Public drive OFF       7EH
  179.     DEFB    0        ;* Public user OFF       7FH
  180.                 ;  (* Only defined for ZRDOS *)
  181.  
  182.  ; This dummy Terminal Capabilities description (Z3TCAP) will
  183.  ; normally be replaced with a tailored MYTERM.Z3T on start up.
  184.  
  185. ENVORG2: DEFB    '               ' ; Terminal Name (15 chars)
  186.     DEFB    0        ; No terminal attributes
  187.     DEFB    'E'-'@'        ; Cursor Up
  188.     DEFB    'X'-'@'        ; Cursor Down
  189.     DEFB    'D'-'@'        ; Cursor Right
  190.     DEFB    'S'-'@'        ; Cursor Left
  191.     DEFB    0        ; Cl delay
  192.     DEFB    0        ; Cm delay
  193.     DEFB    0        ; Ce delay
  194.  
  195.     DEFB    0        ; Cl string
  196.     DEFB    0        ; Cm string
  197.     DEFB    0        ; Ce string
  198.     DEFB    0        ; So string
  199.     DEFB    0        ; Se string
  200.     DEFB    0        ; Ti string
  201.     DEFB    0        ; Te string
  202.  
  203.  ; File filled with Zeros to end of 128-byte segment
  204. :3
  205.  Help Files 
  206.  
  207.    Comprehensive help on Z3LIB can be accessed from Z3HELP-Y.LBR.
  208.