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 / ZSYS / SIMTEL20 / ZCPR3 / Z3UTIL2.HLP < prev    next >
Text File  |  2000-06-30  |  21KB  |  764 lines

  1. The ZCPR3 System-Oriented Utilities
  2. CMDRUN    Extended Command Processor (ECP)
  3. ERRORn    Error Handlers
  4. LDR       ZCPR3 System Segment Loader
  5. PATH      Path Display and Set
  6. QUIET     Display and Set the Quiet Flag
  7. REG       Register Display and Manipulation
  8. SETFILE   System File Assignment
  9. SHCTRL    Shell Stack Display and Manipulation
  10. SHOW      System Configuration Display and Error Handler
  11. Z3INS     ZCPR3 System Installation Program
  12. Z3LOC     ZCPR3 System Segment Locator
  13. :The ZCPR3 System-Oriented Utilities
  14.  
  15.      Thi≤á HEL╨á filσá contain≤ informatioε oεá thosσá ZCPR│ ì
  16. utilitie≤áá whicΦá acces≤á feature≤á oµá thσá ZCPR│áá Systeφ ì
  17. specifically.  These features include:
  18.  
  19.           o Extended Command Processors
  20.           o Error Handlers
  21.           o the ZCPR3 System Segments
  22.           o the ZCPR3 Command Search Path
  23.           o the System Registers
  24.           o the System Files
  25.           o the ZCPR3 System Addresses
  26.           o the ZCPR3 System Status
  27.  
  28. :CMDRUN    Extended Command Processor (ECP)
  29.  
  30. Command:  CMDRUN
  31.  
  32. Syntax:
  33.  
  34.      CMDRUN text    (this command is usually executed by
  35.                          ZCPR3 itself and not the user)
  36. Function:
  37.  
  38.      CMDRU╬á i≤ ß samplσ ExtendeΣ CommanΣ Processor«á  I⌠ i≤ ì
  39. invokeΣ automaticall∙ b∙ ZCPR│ wheε thσ use≥ commanΣ i≤á no⌠ ì
  40. founΣá vißá thσ commanΣ searcΦ patΦ anΣ n∩ erro≥ handle≥á i≤ ì
  41. engaged.
  42.  
  43.      Thσá tex⌠á whicΦ follow≤ thσ verΓ i≤ thσá tex⌠á oµá thσ ì
  44. original command line.
  45.  
  46.  
  47. Options:
  48.  
  49.      None
  50.  
  51. Comments:
  52.  
  53.      CMDRU╬á i≤á onl∙ ß simplσ sample«á  I⌠ show≤á tha⌠á thσ ì
  54. origina∞á commanΣ linσ i≤ no≈ availablσ iε thσ commanΣá tai∞ ì
  55. buffe≥ (a⌠ 80H)«á  Thσ forma∞ CMDRU╬ whicΦ thσ use≥ program≤ ì
  56. fo≥á hi≤ ZCPR│ Systeφ caε extrac⌠ thσ origina∞ commanΣá linσ ì
  57. from this buffer and manipulate it as desired.
  58.  
  59. Selected Error Messages:
  60.  
  61.      None
  62.  
  63. Examples of Use:
  64.  
  65.      None
  66.  
  67. :ERRORn    Error Handlers
  68.                                                               ERROR1
  69. Command:  ERROR1 1.0
  70.  
  71. Syntax:
  72.  
  73.      ERROR1
  74.  
  75. Function:
  76.  
  77.      ERROR▒á i≤á aε Erro≥ Handler«á  Iµ thσ use≥á run≤á thi≤ ì
  78. program¼ i⌠ install≤ itselµ a≤ thσ systeφ erro≥ handler«  Iµ ì
  79. ZCPR│ canno⌠ finΣ thσ CO═ filσ referenceΣ b∙ ß commanΣ verb¼ ì
  80. i⌠á invoke≤á thσá installeΣ Erro≥á Handle≥á anΣá passe≤á thσ ì
  81. commanΣ linσ t∩ it.
  82.  
  83. Options:
  84.      None
  85.  
  86.                                                               ERROR1
  87. Comments:
  88.  
  89.      ERROR▒ display≤ thσ erro≥ linσ t∩ thσ use≥ anΣ provide≤ ì
  90. hiφ witΦ fou≥ option≤ a≤ t∩ ho≈ t∩ proces≤ thi≤ line:
  91.  
  92.        1. Replace the command in error with a new command
  93.        2. Skip the command in error and resume execution
  94.           with the next command
  95.        3. Replace the entire command line
  96.        4« Thro≈ awa∙ thσ commanΣ linσ anΣ resumσ user
  97.           control
  98.  
  99. Selected Error Messages:
  100.      Self-Explanatory
  101.  
  102. Examples of Use:
  103.  
  104.      ERROR1
  105.           -- install Error Handler
  106.                                                               ERROR2
  107. Command:  ERROR2 1.0
  108.  
  109. Syntax:
  110.  
  111.      ERROR2
  112.  
  113. Function:
  114.  
  115.      ERROR2á i≤á aε Erro≥ Handler«á  Iµ thσ use≥á run≤á thi≤ ì
  116. program¼ i⌠ install≤ itselµ a≤ thσ systeφ erro≥ handler«  Iµ ì
  117. ZCPR│ canno⌠ finΣ thσ CO═ filσ referenceΣ b∙ ß commanΣ verb¼ ì
  118. i⌠á invoke≤á thσá installeΣ Erro≥á Handle≥á anΣá passe≤á thσ ì
  119. commanΣ linσ t∩ it.
  120.  
  121. Options:
  122.      None
  123.  
  124.                                                               ERROR2
  125. Comments:
  126.  
  127.      ERROR2 display≤ thσ erro≥ linσ t∩ thσ use≥ anΣ provide≤ ì
  128. hiφ witΦ fou≥ option≤ a≤ t∩ ho≈ t∩ proces≤ thi≤ line:
  129.  
  130.        1. Replace the command in error with a new command
  131.        2. Skip the command in error and resume execution
  132.           with the next command
  133.        3. Replace the entire command line
  134.        4« Thro≈ awa∙ thσ commanΣ linσ anΣ resumσ user
  135.           control
  136.  
  137.      Unlikσ ERROR1¼ ERROR▓ i≤ screen-oriented¼ havinτ ß mucΦ ì
  138. "flashier" display.  It uses the Z3TCAP for support.
  139.  
  140. Selected Error Messages:
  141.      Self-Explanatory
  142.  
  143.                                                               ERROR2
  144. Examples of Use:
  145.  
  146.      ERROR2
  147.           -- install Error Handler
  148.  
  149.                                                               ERROR3
  150. Command:  ERROR3 1.0
  151.  
  152. Syntax:
  153.  
  154.      ERROR3
  155.  
  156. Function:
  157.  
  158.      ERROR3á i≤á aε Erro≥ Handler«á  Iµ thσ use≥á run≤á thi≤ ì
  159. program¼ i⌠ install≤ itselµ a≤ thσ systeφ erro≥ handler«  Iµ ì
  160. ZCPR│ canno⌠ finΣ thσ CO═ filσ referenceΣ b∙ ß commanΣ verb¼ ì
  161. i⌠á invoke≤á thσá installeΣ Erro≥á Handle≥á anΣá passe≤á thσ ì
  162. commanΣ linσ t∩ it.
  163.  
  164. Options:
  165.      None
  166.  
  167.                                                               ERROR3
  168. Comments:
  169.  
  170.      ERROR│á display≤ thσ namσ oµ thσ CO═ filσ whicΦ wa≤ no⌠ ì
  171. founΣ anΣ theε flushe≤ thσ commanΣ line¼á returninτá contro∞ ì
  172. to the user.
  173.  
  174. Selected Error Messages:
  175.      None
  176.  
  177. Examples of Use:
  178.  
  179.      ERROR3
  180.           -- install ERROR3
  181.  
  182.                                                               ERROR4
  183. Command:  ERROR4 1.0
  184.  
  185. Syntax:
  186.  
  187.      ERROR4
  188.  
  189. Function:
  190.  
  191.      ERROR4á i≤á aε Erro≥ Handler«á  Iµ thσ use≥á run≤á thi≤ ì
  192. program¼ i⌠ install≤ itselµ a≤ thσ systeφ erro≥ handler«  Iµ ì
  193. ZCPR│ canno⌠ finΣ thσ CO═ filσ referenceΣ b∙ ß commanΣ verb¼ ì
  194. i⌠á invoke≤á thσá installeΣ Erro≥á Handle≥á anΣá passe≤á thσ ì
  195. commanΣ linσ t∩ it.
  196.  
  197. Options:
  198.      None
  199.  
  200.                                                               ERROR4
  201. Comments:
  202.  
  203.      ERROR┤á print≤á thσ namσ oµ thσ CO═ filσ whicΦ wa≤á no⌠ ì
  204. founΣá anΣ theε advance≤ t∩ thσ nex⌠ commanΣ iε thσá commanΣ ì
  205. linσ buffer«á  Iµ therσ i≤ n∩ nex⌠ command¼á use≥ contro∞ i≤ ì
  206. resumed«á  Iµá therσ i≤ ß nex⌠á command¼á commanΣá executioε ì
  207. resumes there.
  208.  
  209. Selected Error Messages:
  210.      None
  211.  
  212. Examples of Use:
  213.  
  214.      ERROR4
  215.           -- install Error Handler
  216.  
  217.                                                               ERRORX
  218. Command:  ERRORX 1.0
  219.  
  220. Syntax:
  221.  
  222.      ERRORX
  223.  
  224. Function:
  225.  
  226.      ERROR╪ disengage≤ thσ curren⌠ erro≥ handler¼ leavinτ n∩ ì
  227. erro≥á handle≥ enabled«á  Thσ defaul⌠ erro≥ contro∞ facilit∙ ì
  228. oµ ZCPR│ i≤ no≈ iε effect¼á wherσ iµ aε erro≥ occur≤ iεá thσ ì
  229. commanΣá line¼á thσ commanΣ linσ froφ tha⌠ poin⌠ forwarΣá i≤ ì
  230. printed (followed by a '?').
  231.  
  232. Options:
  233.      None
  234.  
  235.                                                               ERRORX
  236. Comments:
  237.  
  238.      None
  239.  
  240. Selected Error Messages:
  241.  
  242.      No error messages are generated by ERRORX.
  243.  
  244. Examples of Use:
  245.  
  246.      ERRORX
  247.           -- disengage any Error Handler currently enabled
  248.  
  249. :LDR       ZCPR3 System Segment Loader
  250.  
  251. Command:  LDR 1.0
  252.  
  253. Syntax:
  254.  
  255.      LDR ufn1,ufn2,...
  256.  
  257. Function:
  258.  
  259.      LD╥á i≤á ßá general-purposσ Systeφ Segmen⌠á loade≥á fo≥ ì
  260. ZCPR3«  I⌠ load≤ al∞ oµ thσ ZCPR│ Systeφ Segment≤ int∩ thei≥ ì
  261. appropriatσá buffers¼á checkinτ oε thei≥ forma⌠ anΣá conten⌠ ì
  262. beforσá approvinτá anΣ completinτ eacΦá load«á  EacΦá Systeφ ì
  263. Segment is specified unambiguously.
  264.  
  265. Options:
  266.  
  267.      None
  268.  
  269. Comments:
  270.  
  271.      Thσá followinτ Systeφ Segment≤ arσ loadeΣá int∩á memor∙ ì
  272. buffers by LDR:
  273.  
  274.           *.ENV files - Environment Descriptors
  275.           *.FCP files - Flow Command Packages
  276.           *.IOP files - Input/Output Packages
  277.           *.NDR files - Named Directory Files
  278.           *.RCP files - Resident Command Packages
  279.           *.Z3T files - Z3TCAP Entries
  280.  
  281.      Fo≥á eacΦá filσ loaded¼á thσ content≤ oµ thσá filσá arσ ì
  282. loadeΣ int∩ ß memor∙ buffe≥ anΣ examined«  BaseΣ oε thσ filσ ì
  283. type¼á segment-uniquσá structura∞ check≤ arσ performed«á  Iµ ì
  284. thσá check≤á arσá passed¼á thσ segmen⌠ i≤á copieΣá int∩á thσ ì
  285. correc⌠á memor∙á buffe≥ baseΣ oε thσ datß containeΣá iεá thσ ì
  286. Environmen⌠ Descriptor«á  Iµ thσ check≤ arσ no⌠á passed¼á aε ì
  287. erro≥á messagσá i≤ issueΣ anΣ thσ nex⌠ filσ iε thσá lis⌠á i≤ ì
  288. processed.
  289.  
  290.      Sincσá thσá Environmen⌠ Descripto≥ (whicΦ i≤á currentl∙ ì
  291. residinτá iεá it≤á memor∙ buffer⌐ i≤á useΣá t∩á providσá thσ ì
  292. addres≤á t∩ whicΦ t∩ cop∙ thσ loadeΣ Systeφ Segment¼á i⌠á i≤ ì
  293. importan⌠á tha⌠á thσá Environmen⌠ Descripto≥á bσá thσá firs⌠ ì
  294. segmen⌠á loadeΣ b∙ LDR«á  Aε alternativσ t∩ thi≤ i≤ tha⌠ thσ ì
  295. BIO╙ ma∙ initializσ thσ Environmen⌠ Descripto≥ oε ColΣ Boot¼ ì
  296. bu⌠á thi≤á woulΣ requirσ ß relativel∙á largσá BIO╙á overheaΣ ì
  297. (over 128 bytes for the initial Environment Descriptor).
  298.  
  299.      Wheε LD╥ load≤ aε Environmen⌠ Descriptor¼á i⌠ place≤ i⌠ ì
  300. a⌠á thσá addres≤á oµ thσ Environmen⌠á Descripto≥á whicΦá wa≤ ì
  301. installeΣ iε LD╥ durinτ thσ ZCPR│ Systeφ installation«á  An∙ ì
  302. othe≥á Systeφ Segmen⌠ i≤ loadeΣ baseΣ oε thσ content≤ oµ thσ ì
  303. current Environment Descriptor in memory.
  304.  
  305.  
  306. Selected Error Messages:
  307.  
  308.      "filename.ty≡ i≤ no⌠ ß ValiΣ Typeó mean≤ tha⌠ thσá filσ ì
  309. typσ oµ thσ indicateΣ filσ i≤ no⌠ onσ oµ ENV¼ FCP¼ IOP¼ NDR¼ ì
  310. RCP, or Z3T.
  311.  
  312.      "filename.ty≡á Contain≤á ß Forma⌠ Flawó mean≤ tha⌠á thσ ì
  313. structure of the indicated file was not correct.
  314.  
  315. Examples of Use:
  316.  
  317.      LDR SYS.ENV,MYIO.IOP,MYCMDS.RCP,MYIFS.FCP
  318.           -- loaΣ SYS.ENV¼ and¼ baseΣ oε thσ datß iε thi≤ 
  319.                Environment Descriptor, load the I/O Package
  320.                MYIO.IOP, the Resident Command Package
  321.                MYCMDS.RCP, and the Flow Command Package MYIFS.FCP
  322.  
  323.      LDR TERM1.Z3T
  324.           -- replace the current Z3TCAP entry with TERM1.Z3T
  325. :PATH      Path Display and Set
  326.  
  327. Command:  PATH 3.0
  328.  
  329. Syntax:
  330.  
  331.      PATH
  332. or
  333.      PATH path-expression
  334.  
  335. Function:
  336.  
  337.      PAT╚á allow≤ thσ use≥ t∩ d∩ tw∩ thing≤á -- displa∙á thσ ì
  338. curren⌠ patΦ o≥ se⌠ ß ne≈ path«á  Thσ displa∙ show≤ thσ patΦ ì
  339. iεá threσá formats║á  Symbolic¼á Absolutσá (DU)¼á anΣá NameΣ ì
  340. Director∙á (DIR)«á  Thσ patΦ expressioε ma∙ intermi° an∙á oµ ì
  341. thesσ format≤ a≤ desireΣ t∩ expres≤ thσ ne≈ path.
  342.  
  343. Options:
  344.  
  345.      None
  346.  
  347. Comments:
  348.  
  349.      Thσá PAT╚á CommanΣá i≤ useΣá t∩á dynamicall∙á changσá ß ì
  350. memory-baseΣá filσá searcΦ patΦ o≥ thσ ZCPR│ commanΣá searcΦ ì
  351. path«á  WitΦá PATH¼á thσá use≥ caε definσ ß ne≈ patΦá t∩á bσ ì
  352. followeΣ o≥ hσ caε vie≈ wha⌠ thσ curren⌠ patΦ is.
  353.  
  354.      PAT╚ determine≤ thσ addres≤ oµ thσ patΦ i⌠ i≤ goinτá t∩ ì
  355. work with from the ZCPR3 Environment Descriptor.
  356.  
  357.      Thσá PAT╚ commanΣ deal≤ witΦ patΦ expressions«á  ┴ patΦ ì
  358. expressioεá i≤á ß sequencσ oµ director∙ name≤ whicΦá caεá bσ ì
  359. expresseΣá a≤ "ambiguousó D╒ forms¼á absolutσ D╒á forms¼á o≥ ì
  360. NameΣ Director∙ forms.
  361.  
  362.  
  363.      Aεá absolutσá D╒á forφ indicate≤á jus⌠á ßá disδá lette≥ ì
  364. (curren⌠ use≥ i≤ assumed)¼á jus⌠ ß use≥ numbe≥ (curren⌠ disδ ì
  365. i≤á assumed)¼á o≥ botΦ ß disδ lette≥ anΣ ß use≥ number«á  Aε ì
  366. "ambiguousó D╒ forφ i≤ onσ iε whicΦ thσ disδ lette≥ o≥á use≥ ì
  367. numbe≥á o≥á botΦ i≤ replaceΣ witΦ ß "$óá character¼á meaninτ ì
  368. "curren⌠ diskó o≥ "curren⌠ user"«á  ┴ NameΣ Director∙á form¼ ì
  369. oµ course¼ i≤ simpl∙ thσ namσ oµ ß directory.
  370.  
  371.      T∩ illustrate¼á let'≤ sa∙ tha⌠ thσ use≥ i≤ loggeΣá int∩ ì
  372. B1«  Thσ path
  373.  
  374.           $0 A$ A0 ROOT
  375.  
  376. represents the sequence
  377.  
  378.           B0 to A1 to A0 to ROOT
  379.  
  380.  
  381. Selected Error Messages:
  382.  
  383.      "BaΣ Expressioε a⌠ <text>ó indicate≤ therσ wa≤ aε erro≥ ì
  384. in the path expression at the indicated point.
  385.  
  386. Examples of Use:
  387.  
  388.      PATH $0 A$ A15
  389.       - se⌠á patΦ froφ curren⌠ disk/use≥ ░ t∩ disδ A/curren⌠ ì
  390. use≥ t∩ disδ A/use≥ 15
  391.  
  392.      PATH A$ ROOT
  393.       - set path from disk A/current user to ROOT:
  394.  
  395. :QUIET     Display and Set the Quiet Flag
  396.  
  397. Command:  QUIET 1.0
  398.  
  399. Syntax:
  400.  
  401.      QUIET o
  402.  
  403. Function:
  404.  
  405.      QUIE╘ i≤ useΣ t∩ set¼ reset¼ anΣ displa∙ thσ Quie⌠ Flaτ ì
  406. in the ZCPR3 Environment Descriptor.
  407.  
  408. Options:
  409.  
  410.      D - Display the Quiet Flag
  411.      R - Reset (turn OFF) the Quiet Flag
  412.      S - Set (turn ON) the Quiet Flag
  413.  
  414.  
  415. Comments:
  416.  
  417.      Man∙á ZCPR│ utilitie≤ reaΣ thσ Quie⌠ Flaτ iε thσá ZCPR│ ì
  418. Environmen⌠á Descripto≥á anΣ responΣá accordingly«á  Iµá thσ ì
  419. Quie⌠á Flaτ i≤ Se⌠ (ON)¼á theε certaiε informativσá message≤ ì
  420. arσá suppresseΣ iε orde≥ t∩ cu⌠ dowε oε thσ "noiseóá createΣ ì
  421. b∙ thσ command«á  Iµ thσ Quie⌠ Flaτ i≤ Rese⌠ (OFF)¼ theε al∞ ì
  422. messages are displayed.
  423.  
  424. Selected Error Messages:
  425.  
  426.      N∩á Erro≥ Message≤ arσ generated«á  Aε invaliΣá commanΣ ì
  427. results in the Help screen being displayed.
  428.  
  429.  
  430. Examples of Use:
  431.  
  432.      QUIET R
  433.           - turn OFF (Reset) the Quiet Flag
  434.  
  435.      QUIET DISPLAY
  436.           - Display the Quiet Flag
  437.  
  438. :REG       Register Display and Manipulation
  439.  
  440. Command:  REG 1.0
  441.  
  442. Syntax:
  443.  
  444.      REG Dr or REG r     <-- Display Register r
  445.      REG Mr              <-- Minus (r=r-1) Register r
  446.      REG Pr              <-- Plus (r=r+1) Register r
  447.      REG Sr value        <-- Set (r=value) Register r
  448.  
  449. Function:
  450.  
  451.      RE╟ displays¼á add≤ ▒ to¼á subtract≤ ▒ from¼ anΣ set≤ ß ì
  452. valuσ t∩ thσ indicateΣ register«  ┴ ZCPR│ Registe≥ i≤ ß one-ì
  453. byte buffer (values are ranged from 0 to 255 decimal).
  454.  
  455.      Thσá valuσá useΣ t∩ indicatσ ß registe≥ i≤ ßá characte≥ ì
  456. froφ '0º t∩ '9'«á  Thσ characte≥ '#º indicate≤ al∞ register≤ ì
  457. ("REG S# 0" stores 0 to all ten registers).
  458.  
  459.  
  460. Options:
  461.  
  462.      Shown Above
  463.  
  464. Comments:
  465.  
  466.      Registers are used for two purposes:
  467.  
  468.        1. to support looping in ZEX command files
  469.           (do something N times)
  470.  
  471.        2. to pass parameter values from one program to
  472.           another program which is executed later
  473.  
  474.      RE╟á ha≤ ß counterpar⌠ commanΣ iε thσá Systeφá Residen⌠ ì
  475. Command Package provided in the ZCPR3 distribution.
  476.  
  477.  
  478. Selected Error Messages:
  479.  
  480.      "InvlΣ Reτ ID║ có mean≤ tha⌠ thσ registe≥ indicateΣ wa≤ ì
  481. not symbolized by '0' to '9' or '#'.
  482.  
  483. Examples of Use:
  484.  
  485.      REG S5 25
  486.           -- Register 5 = 25
  487.  
  488.      REG M#
  489.           -- 1 is subtracted from all registers
  490.  
  491. :SETFILE   System File Assignment
  492.  
  493. Command:  SETFILE 1.0
  494.  
  495. Syntax:
  496.  
  497.      SETFILE n afn
  498. or
  499.      SETFILE n
  500.  
  501. Function:
  502.  
  503.      SETFIL┼ se⌠ thσ namσ oµ ZCPR│ Systeφ Filσ ε (wherσ ε i≤ ì
  504. ▒ t∩ 4⌐ t∩ thσ indicateΣ ambiguou≤ filσ name«á  Iµ n∩ AF╬ i≤ ì
  505. given¼á thσ curren⌠ content≤ oµ thσ indicateΣ Systeφ Filσ i≤ ì
  506. displayed.  A file number is required.
  507.  
  508. Options:
  509.  
  510.      None
  511.  
  512. Comments:
  513.  
  514.      ZCPR│á Systeφ File≤ arσ referenceΣ b∙ somσ oµ thσ ZCPR│ ì
  515. utilities¼á MEN╒á anΣ ALIA╙ iε particular«á  SETFIL┼ i≤á thσ ì
  516. mean≤á b∙ whicΦ thσ content≤ oµ thesσ filσ namσá buffer≤á i≤ ì
  517. defined.
  518.  
  519. Selected Error Messages:
  520.  
  521.      "InvaliΣ Filσ Namσ Numbe≥ (no⌠ 1-4)ó mean≤ tha⌠ ß valiΣ ì
  522. filσá numbe≥ wa≤ no⌠ giveε afte≥ thσ SETFIL┼ verΓ (SETFIL┼ ε ì
  523. afn).
  524.  
  525. Examples of Use:
  526.  
  527.      SETFILE 1 myfile.txt
  528.           - System File 1 is set to MYFILE.TXT
  529.  
  530.      SETFILE 4
  531.           - the name of System File 4 is displayed
  532. :SHCTRL    Shell Stack Display and Manipulation
  533.  
  534. Command:  SHCTRL 1.0
  535.  
  536. Syntax:
  537.  
  538.      SHCTRL o
  539.  
  540. Function:
  541.  
  542.      SHCTR╠á i≤á useΣ t∩ providσ somσ contro∞ oµá thσá ZCPR│ ì
  543. Shel∞á Stacδá froφ thσ commanΣ line«á  Thσ content≤á oµá thσ ì
  544. Shel∞ Stacδ caε bσ displayeΣ anΣ poppeΣ onσ leve∞ o≥ cleareΣ ì
  545. completely.
  546.  
  547.  
  548. Options:
  549.  
  550.      C - Clear the Shell Stack (no Shell is in effect)
  551.      D - Display Shell Stack
  552.      P - Pop the Shell Stack (the current Shell is stopped
  553.           and the next Shell on the stack is invoked)
  554.  
  555. Comments:
  556.  
  557.      Onl∙á onσá optioε ma∙ bσ useΣ iε conjunctioεá witΦá thσ ì
  558. SHCTR╠á command«á  An∙ character≤ followinτ thi≤ optioεá arσ ì
  559. ignored.
  560.  
  561.      SHCTR╠á i≤á intendeΣ t∩ bσ useΣ iε situation≤á wherσá ß ì
  562. director∙ changσ i≤ desireΣ anΣ ß Shell¼ sucΦ a≤ MENU¼ i≤ iε ì
  563. execution«á  Thσá Shel∞ Stacδ caε bσ popped¼á thσá director∙ ì
  564. changσáá performed¼áá anΣá thσá origina∞á Shel∞áá explicitl∙ ì
  565. reinvoked.
  566.  
  567.  
  568. Selected Error Messages:
  569.  
  570.      None - Help is printed if invalid option
  571.  
  572. Examples of Use:
  573.  
  574.      SHCTRL P
  575.           - pop the Shell Stack one level
  576.  
  577.      SHCTRL D
  578.           - display the contents of the Shell Stack
  579.  
  580.  
  581. :SHOW      System Configuration Display and Error Handler
  582.  
  583. Command:  SHOW 1.0
  584.  
  585. Syntax:
  586.  
  587.      SHOW o
  588.  
  589. Function:
  590.  
  591.      SHO╫ i≤ thσ ZCPR│ Environmen⌠ Displa∙ utility«  Detail≤ ì
  592. oµ thσ ZCPR│ Environmen⌠ Descriptor¼á wha⌠ systeφ facilitie≤ ì
  593. arσá available¼á anΣ wha⌠ thσ statu≤ oµ thesσ facilitie≤á i≤ ì
  594. arσá somσá oµ thσ item≤ includeΣ iεá thσá numerou≤á display≤ ì
  595. which are generated by SHOW.
  596.  
  597.      SHO╫ caε bσ invokeΣ a≤ aε Erro≥ Handler¼á iε whicΦ casσ ì
  598. it≤á Erro≥ Handle≥ displa∙ caε givσ thσ commanΣ linσá statu≤ ì
  599. anΣá it≤ othe≥ displays¼á sucΦ a≤ memor∙ examine¼á ma∙ provσ ì
  600. useful to analyze the state of the ZCPR3 System.
  601.  
  602. Options:
  603.  
  604.      E - Install SHOW as an Error Handler
  605.           (no SHOW displays are invoked)
  606.  
  607. Comments:
  608.      SHOW provides the following displays to the user:
  609.  
  610.   1. Package Data                  3. ZCPR3 System
  611.      - Flow Command Package           - Environment Descriptor
  612.      - Input/Output Package           - Message Buffers
  613.      - Resident Command Package       - CRT and Printer Data
  614.                                       - System File Definitions
  615.   2. Environment Data
  616.      - Error Handler
  617.      - Memory Display Utility
  618.      - Named Directory Display
  619.      - Path Expression
  620.      - Shell Stack
  621.  
  622.  
  623.      SHO╫ i≤ screen-orienteΣ anΣ wil∞ no⌠ functioε correctl∙ ì
  624. withou⌠ prope≥ Z3TCA╨ support«á  Thσ Environmen⌠á Descripto≥ ì
  625. MUST be installed with a valid Z3TCAP entry.
  626.  
  627. Selected Error Messages:
  628.  
  629.      Self-Explanatory
  630.  
  631. Examples of Use:
  632.  
  633.      Tr∙á i⌠á - you'l∞ likσ itíá  SHO╫á i≤á totall∙á screen-ì
  634. orienteΣá anΣá wil∞ no⌠ begiε t∩ functioε correctl∙á withou⌠ ì
  635. prope≥á Z3TCA╨á support«á  Iµ thσ use≥ enter≤á SHO╫á withou⌠ ì
  636. proper support, the X command exits SHOW.
  637.  
  638. :Z3INS     ZCPR3 System Installation Program
  639.  
  640. Command:  Z3INS 1.0
  641.  
  642. Syntax:
  643.  
  644.      Z3INS ufn1 ufn2
  645.  
  646.           UFN1 must be an Environment Descriptor
  647.           UFN2 must be a Z3INS Installation File
  648.  
  649. Function:
  650.  
  651.      Z3IN╙á install≤ thσ file≤ nameΣ iε ß Z3IN╙ Installatioε ì
  652. Filσá witΦ datß froφ thσ Environmen⌠á Descripto≥á specified«  ì
  653. All files must be ZCPR3 Utilities.
  654.  
  655.      Thσáá defaul⌠áá filσá type≤á arσá EN╓á fo≥á UFN▒áá (thσ ì
  656. Environment Descriptor) and INS (the Installation File).
  657.  
  658.  
  659. Options:
  660.  
  661.      None
  662.  
  663. Comments:
  664.  
  665.      Z3IN╙ i≤ thσ installatioε prograφ fo≥ thσ ZCPR│ System«  ì
  666. Al∞ utilitie≤ provideΣ iε thσ ZCPR│ distributioε excep⌠á fo≥ ì
  667. ZEX may be installed for a target system by using Z3INS.
  668.  
  669.      ┴á ZCPR│á Installatioεá Filσá i≤á simpl∙á ßá tex⌠á filσ ì
  670. containinτ tw∩ type≤ oµ lines║  ß commen⌠ line¼ whicΦ begin≤ ì
  671. witΦá ß semicoloε (;)¼á anΣ ß linσ containinτ aε unambiguou≤ ì
  672. file name, which is a file to be installed.  Example:
  673.  
  674.  
  675.      ; This is an installation file for my new utilities
  676.       util1.com
  677.           util2.com
  678.      ; UTIL3 is really neat
  679.      util3.com
  680.  
  681.             -- Sample Z3INS Installation File --
  682.  
  683.  
  684.      Casσ i≤ no⌠ significant«á  Leadinτ space≤ oε eacΦá linσ ì
  685. are ignored.  Any file name MUST be unambiguous.
  686.  
  687.      Thσá Environmen⌠á Descripto≥ referenceΣ iε thσá commanΣ ì
  688. linσ i≤ ß standarΣ ZCPR│ Systeε Environmen⌠ descripto≥ whicΦ ì
  689. is created by assembling a file like SYSENV.ASM.
  690.  
  691.  
  692. Selected Error Messages:
  693.  
  694.      Al∞áá erro≥á message≤á arσá ver∙á completσá anΣáá self-ì
  695. explanatory.
  696.  
  697. Examples of Use:
  698.  
  699.      Z3INS SYS.ENV NEWFILES.INS
  700.           -- Install the files listed in NEWFILES.INS with
  701.                the data contained in SYS.ENV
  702.  
  703.      Z3INS NEWENV DIST
  704.           -- Install the files listed in DIST.INS with
  705.                the data contained in NEWENV.ENV
  706.  
  707. :Z3LOC     ZCPR3 System Segment Locator
  708.  
  709. Command:  Z3LOC 1.0
  710.  
  711. Syntax:
  712.  
  713.      Z3LOC o
  714.  
  715. Function:
  716.  
  717.      Z3LO├á i≤ useΣ t∩ locatσ anΣ displa∙ thσá addresse≤á oµ ì
  718. thσ runninτ ZCPR│ CommanΣ Processo≥ Replacement¼á BDOS¼á anΣ ì
  719. BIOS«á  I⌠ ma∙ als∩ bσ ruε unde≥ conventiona∞ CP/═ t∩ locatσ ì
  720. anΣá displa∙á thσ addresse≤ oµ thσ runninτ CP/═ 2.▓á Consolσ ì
  721. Command Processor, BDOS, and BIOS.
  722.  
  723.      Z3LO├ i≤ als∩ ablσ t∩ displa∙ thσ addresse≤ oµ ß numbe≥ ì
  724. oµá ZCPR│ Systeφ Segment≤ anΣ datß area≤ iµ thσ ┌ optioεá i≤ ì
  725. given«á  Thσá ┌ optioε shoulΣ no⌠ bσ giveε iµ runninτá Z3LO├ ì
  726. under CP/M 2.2.
  727.  
  728.  
  729. Options:
  730.  
  731.      Z - Display addresses and data on ZCPR3 System Segments
  732.           and data areas
  733.  
  734. Comments:
  735.  
  736.      Iµá thσá ┌ optioε i≤ giveε (┌ shoulΣ onl∙ bσá giveεá iµ ì
  737. runninτá Z3LO├á unde≥á ZCPR3)¼áá thσá followinτáá additiona∞ ì
  738. address information is provided:
  739.  
  740.      ∩ Externa∞ PatΦ           ∩ Residen⌠ CommanΣ Package
  741.      o Input/Output Package    o Flow Command Package
  742.      o Named Directory Buffer  o Command Line Buffer
  743.      o Shell Stack             o Environment Descriptor
  744.      o External FCB            o ZCPR3 Message Buffer
  745.      o External Stack          o Wheel Byte
  746.  
  747.  
  748. Selected Error Messages:
  749.  
  750.      Z3LO├á generate≤ n∩ erro≥ messages«á  Aε invaliΣ optioε ì
  751. invokes a help screen.
  752.  
  753. Examples of Use:
  754.  
  755.      Z3LOC
  756.           -- run Z3LOC for CPR/CCP, BDOS, and BIOS display
  757.                (may be used this way under CP/M 2.2)
  758.  
  759.      Z3LOC Z
  760.           -- display ZCPR3 data as well
  761.                (may be used this way under ZCPR3 only)
  762.  
  763.  
  764.