ftp.barnyard.co.uk/2015.02.ftp.barnyard.co.uk.tar/ftp.barnyard.co.uk/cpm/walnut-creek-CDROM/ZSYS/SIMTEL20/ZCPR3/IO.HLP

Text File | 2000-06-30 | 12KB | 390 lines

;


           Redirectable I/O Under ZCPR3 and SYSIO

                       -- Concepts --
                  1 - 
ZCPR3 and SYSIO
                  2 - 
ZCPR3 and I/O Redirection

                       -- Commands --
                       C - 
CPSEL
                       D - 
DEVICE
                       E - 
DEV
                       L - 
LDR
                       R - 
RECORD

:1
                
Redirectable I/O Under ZCPR3

     Thσ concep⌠ oµ redirectablσ I/╧ involve≤ thσ assignmen⌠ ì
oµá physica∞á device≤ t∩ logica∞ devices«á  ZCPR│á anΣá CP/═ ì
suppor⌠ fou≥ logica∞ devices:

     CON: - Console - An I/O Device for User/System Commo
     LST: - Printer - An Output-Only Device for Printouts
     RDR: - Reader  - An Input-Only Device
     PUN: - Punch   - An Output-Only Device

     Unde≥ CP/M¼á therσ arσ onl∙ fou≥ physica∞ device≤ whicΦ ì
ma∙ bσ assigneΣ t∩ eacΦ oµ thσ fou≥ logica∞ devices«á  Unde≥ ì
ZCPR3¼á therσá ma∙á bσ a≤ man∙ physica∞ device≤á a≤á desireΣ ì
whicΦ ma∙ bσ assigneΣ t∩ eacΦ oµ thσ fou≥ logica∞ devices.

     ┴á "physica∞á deviceóá iε thσ traditiona∞á sensσá i≤á ß ì
conventiona∞á I/╧ device¼á likσ ß CR╘ o≥ ß Printer«á  Iε thσ ì
sensσ oµ ZCPR3¼á i⌠ i≤ ß devicσ driver¼ o≥ bod∙ oµ software¼ ì
whicΦá i≤á communicateΣ witΦ viß thσá BIOS«á  Thi≤á bod∙á oµ ì
software¼ iε turn¼ ma∙ communicatσ witΦ an∙ devicσ O╥ SE╘ O╞ ì
DEVICE╙ tha⌠ i⌠ wishes.

     SYSI╧á i≤á ßá samplσ se⌠ oµá Redirectablσá I/╧á Driver≤ ì
designeΣá t∩ bσ useΣ witΦ ZCPR│ oε m∙ system«á  Unde≥ SYSIO¼ ì
some of thσ "physica∞ devicesó implemented are:

CON: Devices - TTY
               CRT
               CRT Input and CRT/Remote Computer Output
               CRT and Modem Input and CRT and Modem Output
                    in Parallel
               CRT Input and CRT/Modem Output

LST: Devices - TTY
               CRT
               Modem
               Remote Computer

RDR: and PUN: Devices - Clock


     A≤ yo⌡ caε see¼á thσ "physica∞ devicesó unde≥ ZCPR│ caε ì
bσá combination≤á oµá actua∞ devices«á  Thσá CR╘á Inpu⌠á anΣ ì
CRT/Remotσ Compute≥ Outpu⌠ device¼á fo≥ instance¼ i≤ useΣ t∩ ì
allo≈á ß remotσ compute≥ recorΣ screeε display≤ whicΦ g∩á t∩ ì
thσ CRT.

     Unde≥ ZCPR3¼ a≤ man∙ sets¼ o≥ packages¼ oµ Redirectablσ ì
I/╧á Driver≤á a≤ desireΣ caε bσ created«á  EacΦ packagσá caε ì
givσá thσá use≥á differen⌠á type≤á oµáá capabilities«áá  Fo≥ ì
instance¼á onσá packagσ caε bσ likσ thσ abovσ examplσá whilσ ì
anothe≥ packagσ caε providσ Disδ Recordinτ capability¼á sucΦ ì
a≤ CR╘ Inpu⌠ anΣ CRT/Disδ Filσ Output.


     Thσá ZCPR│á Systeφ oµ Program≤ contain≤ fou≥á utilitie≤ ì
designeΣá t∩á suppor⌠ thσ Redirectablσá I/╧á System«á  Thesσ ì
utilitie≤ anΣ thei≥ function≤ are:

          LDR      -- Load a Redirectable I/O Package
          DEVICE   -- Display and Select Physical I/O Devices
          DEV      -- Shorthand form of DEVICE
          RECORD   -- Turn on and off the Recording Facility

     Thi≤á HEL╨ Filσ discusse≤ thesσ utilitie≤ anΣ ho≈á the∙ ì
arσ intendeΣ t∩ bσ used.

     Implementatioεá detail≤ fo≥ I/╧ Package≤ arσ lef⌠ t∩á ß ì
stud∙á oµ thσ sourcσ codσ oµ thσ samplσ I/╧ Packagσ anΣá thσ ì
ZCPR3 book.

:L
          
Loading Redirectable I/O Drivers -- LDR

     Onσá oµá thσ man∙ function≤ oµ LD╥ i≤ t∩á loaΣá aεá I/╧ ì
Packagσá int∩ thσ prope≥ memor∙ buffer«á  LD╥ perform≤á thi≤ ì
function when given a file specification of type IOP:

          LDR myio.iop

will load MYIO.IOP as an I/O Package.

     LD╥á perform≤á ß structurσ checδ beforσá approvinτá thσ ì
load.

:D


Command:  DEVICE3 1.0  (DEVICE)


Syntax:

     DEVICE              <-- Enter Interactive Command Mode


Function:

     DEVIC┼á i≤á useΣá t∩ allo≈ thσá use≥á t∩á interactivel∙ ì
displa∙áá thσá name≤á oµá thσá availablσá physica∞áá device≤ ì
(actually¼á devicσá drivers⌐á whicΦ ma∙ bσ assigneΣá t∩á thσ ì
logica∞á device≤ anΣ t∩ allo≈ thσ use≥ t∩ assigε ßá physica∞ ì
devicσ t∩ ß logica∞ devicσ b∙ name.



Options:
     None


Comments:

     DEVIC┼á onl∙ run≤ iε aε interactivσ mode«á  I⌠ respond≤ ì
t∩áá single-characte≥á commands¼áá completinτá thσáá commanΣ ì
sequences in response and prompting the user.

     The following commands are recognized by DEVICE:

          D - Display Device Names

          C - Select Console Device (CON:)
          L - Select List Device (LST:)
          P - Select Punch Device (PUN:)
          R - Select Reader Device (RDR:)

          X - Exit


     Thσ Displa∙ Devicσ Name≤ commanΣ (D⌐ ask≤ thσ use≥á fo≥ ì
the devices to display.  His responses are:

          A - All
          C - Consoles
          L - Lists
          P - Punches
          R - Readers

     Thσá Exi⌠ commanΣ exit≤ t∩ ZCPR│ withou⌠ promptinτá fo≥ ì
confirmation.

     Thσ othe≥ fou≥ command≤ (C¼ L¼ P¼ anΣ R⌐ assigε device≤ ì
IMMEDIATELY«á  Thσá use≥ type≤ thσ namσ oµ thσ devicσ t∩á bσ ì
assigned«á  Iµ hσ strike≤ ß returε iε responsσ t∩ thσ devicσ ì
name prompt, the command is aborted.



Selected Error Messages:

     Self-Explanatory


Examples of Use:

     DEVICE
          -- invoke utility

:E


Command:  DEV 1.0


Syntax:

     DEV command,command,...


Function:

     DE╓á i≤ ß utilit∙ whicΦ enable≤ thσ use≥ t∩á manipulatσ ì
thσá ZCPR│ redirectablσ I/╧ devicσ drivers«á  I⌠ allow≤á thσ ì
use≥á t∩ displa∙ thσ name≤ oµ thσ curren⌠ device≤ anΣ selec⌠ ì
them.

     Unlikσ it≤ counterpart¼á DEVICE¼á DE╓ accept≤ al∞ inpu⌠ ì
from the command line and is not interactive.


Options:
     None


Comments:

     An∙ DE╓ commanΣ ma∙ takσ thσ followinτ forms«  Onl∙ thσ ì
first letters are significant in the these commands:

          DISPLAY ALL    <-- Display names of all devices
          DISPLAY CON    <-- Display consoles
          DISPLAY LST    <-- Display printers
          DISPLAY PUN    <-- Display punches
          DISPLAY RDR    <-- Display readers

     D A is the same as DISPLAY ALL.

     Thσá ful∞á devicσ namσ mus⌠ bσ giveε iεá thσá followinτ ì
commands«áá  Onl∙á thσá firs⌠á characte≥á anΣá thσá '=ºá arσ ì
significant in the rest of the command.

     CON:=name      LST:=name      PUN:=name      RDR:=name

     C=name is the same as CON:=name.


Selected Error Messages:

     "DE╓á NO╘á InitializeΣ witΦ I/╧ Baseó mean≤á tha⌠á thi≤ ì
ZCPR3 System does not support Redirectable I/O.

     "Redirectioεá No⌠á Supportedóá mean≤á tha⌠á thσá loadeΣ ì
drivers in the I/O Package do not support redirection.


Examples of Use:

     DEV C=CRT,L=TTY
          -- assign CRT to CON: and TTY to LST:


:R


Command:  RECORD 3.0


Syntax:

   RECORD ON or OFF              <-- Console Recording
or
   RECORD ON or OFF PRINTER      <-- Printer Recording


Function:

     RECOR─á i≤ useΣ t∩ contro∞ thσ Disδ Outpu⌠ Facilit∙á oµ ì
thσ Redirectablσ I/╧ Drivers«  Copie≤ oµ Consolσ anΣ Printe≥ ì
output≤á caεá bσ createΣ iε disδ file≤ b∙ thσá usσá oµá thi≤ ì
facility¼á anΣá i⌠á ma∙ bσ extendeΣ int∩ ß numbe≥á oµá othe≥ ì
application≤ a≤ well.



Options:

     ON  - Enable Recording
     OFF - Disable Recording

     P   - Reference Printer


Comments:

     Fo≥á RECOR─á t∩á perforφá it≤á function¼áá i⌠á mus⌠á bσ ì
implementeΣ iε thσ Redirectablσ I/╧ Drivers«á  Thi≤ i≤á lef⌠ ì
a≤ aε exercisσ fo≥ thσ reader«  Thσ Redirectablσ I/╧ Driver≤ ì
supplieΣá witΦ ZCPR│ havσ simplσ RETurε instruction≤ a≤á thσ ì
subroutine≤ executeΣ b∙ thσ RECOR─ functions.


     Fou≥á routine≤á arσá accesseΣ iε thσá Redirectablσá I/╧ ì
Drive≥ packagσ t∩ contro∞ thσ RECOR─ function«  The∙ are:

          COPEN  -- Enable Recording Console Output
          LOPEN  -- Enable Recording List Output
          CCLOSE -- Disable Recording Console Output
          LCLOSE -- Disable Recording List Output

     RECOR─ i≤ indirectl∙ tieΣ int∩ DEVICE«  Invokinτ RECOR─ ì
itselµá doe≤á no⌠á necessaril∙ star⌠ thσá recordinτá proces≤ ì
immediately«áá  Tw∩á function≤á mus⌠á takσá placσá t∩á begiε ì
recordinτ outpu⌠ ont∩ disδ files:

    1) RECORD has to turn the appropriate Driver ON
    2) DEVICE has to select the appropriate Driver


     B∙ turninτ RECOR─ OF╞ durinτ ß recordinτá session¼á thσ ì
outpu⌠á filσá i≤ closeΣ anΣ availablσ fo≥á othe≥á uses«á  Iµ ì
RECOR─á i≤ late≥ turneΣ ON¼á thσ outpu⌠ filσ ma∙ bσá deleteΣ ì
(iµ thσ samσ filσ i≤ selecteΣ t∩ recorΣ into)«á  However¼ iµ ì
ßá ne≈á devicσ i≤ selecteΣ whilσ RECOR─ i≤ O╬á (say¼á DEVIC┼ ì
CON:=CR╘ i≤ issued)¼ theε recordinτ i≤ SUSPENDE─ (NO╘ turneΣ ì
off⌐á unti∞ thσ recordinτ devicσ i≤á selecteΣá again«á  WitΦ ì
thi≤á capability¼á iµ i⌠ look≤ likσ thσ recordinτ sessioε i≤ ì
no⌠á goinτ well¼á recordinτ caε bσá suspended¼á thσá probleφ ì
fixed¼ anΣ theε recordinτ caε bσ resumed.

     Thi≤á combineΣá systeφ oµ DEVIC┼ anΣ RECOR─ provide≤á ß ì
flexiblσ outpu⌠ recordinτ system«á  Iε addition¼á thσ outpu⌠ ì
recordinτ neeΣ no⌠ necessaril∙ g∩ t∩ ß disδ file«á  I⌠ coulΣ ì
bσ se⌠ u≡ t∩ senΣ CON║á outpu⌠ t∩ thσ CR╘ and¼ say¼ ß Remotσ ì
Compute≥ fo≥ processing.



Selected Error Messages:

     "I/╧ Drive≥ Addres≤ NO╘ Definedó mean≤ tha⌠ therσ i≤ n∩ ì
I/O Package in this ZCPR3 System.

     "Disδá Drive≥á Modulσ NO╘ Loadedó mean≤á tha⌠á thσá I/╧ ì
Package does not support the RECORD facility.

     "N∩á I/╧á Drive≥ Modulσ Loadedó mean≤ tha⌠ LD╥ ha≤á no⌠ ì
been run to load an *.IOP file.


Examples of Use:

     RECORD ON
          - turn on recording for the console

     RECORD ON P
          - turn on recording for the printer

:2


           
Redirectable I/O and the ZCPR3 System

     Thσáá ZCPR│á Systeφá caεá functioεá witΦáá o≥áá withou⌠ ì
Redirectablσá I/╧á a≤á implementeΣ b∙ thσá Redirectablσá I/╧ ì
Drive≥á Package≤á anΣá thσá LDR¼á DEV¼á DEVICE¼á anΣá RECOR─ ì
programs«á  Obviously¼á thσá ZCPR│ Systeφ i≤ madσ mucΦá morσ ì
flexiblσ b∙ employinτ thesσ facilities.

     DEVIC┼ anΣ RECOR─ arσ tieΣ directl∙ t∩ thσ Redirectablσ ì
I/╧á Package≤ themselves«á  The∙ don'⌠ usσ an∙ oµ thσá othe≥ ì
feature≤á oµá thσ ZCPR│ Systeφ t∩ speaδá of¼á anΣá the∙á arσ ì
installeΣ b∙ Z3INS.


     Thσá program≤ controllinτ thσ Redirectablσ I/╧á Driver≤ ì
arσ tieΣ togethe≥ iε thi≤ manner:

          LDR       loads the drivers
          DEVICE    controls the drivers
          DEV       controls the drivers
          RECORD    enables and disables the recording
                         facilities of the drivers

:C


Command:  CPSEL 1.0


Syntax:

     CPSEL cmd1,cmd2,...


Function:

     CPSE╠á (CRT/Printe≥á SELect⌐ i≤ ß ZCPR│á utilit∙á whicΦ ì
permit≤ thσ use≥ t∩ dynamicall∙ selec⌠ thσ CR╘ (oµ CR╘ ░ anΣ ì
CR╘á 1⌐ anΣ Printe≥ (oµ Printer≤ 0¼á 1¼á 2¼á anΣ 3⌐ froφ thσ ì
curren⌠á ZCPR│á Environmen⌠á Descriptor«á  Thi≤á dynamicall∙ ì
change≤ thσ characteristic≤ oµ thσ printe≥ anΣ CR╘ whicΦ arσ ì
used by other ZCPR3 utilities, such as PRINT.


Options:
     None



Comments:

     The commands may be any of the following:

          Cc, c=0 or 1   -- Select CRT 0 or CRT 1

          Pp, p=0-3      -- Select Printer 0-3

          Dd, d=A (All), C (CRT), P (Printer)
               -- Display Selection Values

     Thσ value≤ affecteΣ b∙ thesσ selection≤ includσá numbe≥ ì
oµá line≤á anΣá column≤ oε thσ CR╘ anΣ numbe≥ oµá line≤á anΣ ì
column≤ oε thσ printer«á  Thσ abilit∙ oµ thσ printe≥ t∩ forφ ì
feed is also included.



Selected Error Messages:
     None


Examples of Use:

     CPSEL DA
          - display all devices

     CPSEL C1,P3,DA
          - Select CRT 1 and Printer 3; display all devices
               when done