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