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 / IF.HLP < prev    next >
Text File  |  2000-06-30  |  13KB  |  458 lines
  1. ;
  2.  
  3.  
  4.                     -- Flow Commands --
  5.  
  6.  
  7.      -- IF Commands --        -- IF Condition Summaries --
  8.       1 Transient IF                 T Transient IF
  9.       2 Resident IF                  R Resident IF
  10.  
  11.  
  12.                         -- Others --
  13.                     3 IF Status Display
  14.                            4 ELSE
  15.                             5 FI
  16.                            6 XIF
  17.  
  18. :1
  19.  
  20. Command:  IF 1.1
  21.  
  22. Syntax:
  23.  
  24.      IF cond args
  25. or
  26.      IF ~cond args
  27.  
  28. Function:
  29.  
  30.      I╞á test≤ thσ indicateΣ conditioε t∩ seσ iµ i⌠ i≤ TRUE¼ ì
  31. and¼á iµá so¼á set≤á thσ Flo≈ Statσ t∩á TRU┼á (allowinτá thσ ì
  32. followinτ command≤ t∩ execute)«á  Iµ thσ conditioε i≤ FALSE¼ ì
  33. thσá Flo≈ Statσ i≤ se⌠ t∩ FALS┼ (allowinτ onl∙ Flo≈ Command≤ ì
  34. to execute).
  35.  
  36.  
  37. Options:
  38.  
  39.      Option         Meaning
  40.      T              TRUE (Flow State is Set to TRUE)
  41.      F              FALSE (Flow State is Set to FALSE)
  42.  
  43.      EMPTY afn,...  If all files in the indicated list
  44.                       are EMPTY (size is 0K), then Flow
  45.                       State is Set to TRUE
  46.  
  47.      ERROR          If the ZCPR3 Error Flag is Set, then
  48.                       Flow State is Set to TRUE
  49.  
  50.      EXIST afn,...  If all files in the indicated list
  51.                       exist, then Flow State is Set to TRUE
  52.  
  53.      INPUT          User input is enabled, and if the user
  54.                       strikes T, Y, <CR>, or <SP>, the
  55.                       Flow State is Set to TRUE
  56.  
  57.      NULL afn       If there is no 'afn' (field is blank),
  58.                       then the Flow State is Set to TRUE
  59.  
  60.      TCAP           If a Z3TCAP is installed, the Flow State
  61.                       is Set to TRUE
  62.  
  63.      WHEEL          If the Wheel Byte is Set, the Flow State
  64.                       is Set to TRUE
  65.  
  66.      reg value      If the indicated register (0-9) has the
  67.                       indicateΣ valuσ (0-255)¼ thσ Flow
  68.                       State is Set to TRUE
  69.  
  70.      afn1=afn2      If the two AFNs are identical in name
  71.                       (11 char FILENAME.TYP are same), the
  72.                       Flow State is Set to TRUE
  73.  
  74. Comments:
  75.  
  76.      Iε al∞ cases¼á iµ thσ indicateΣ conditioε i≤ TRUE¼á thσ ì
  77. Flo≈á Statσ i≤ Se⌠ t∩ TRUE╗á iµ thσ indicateΣá conditioεá i≤ ì
  78. FALSE, the Flow State is Set to FALSE.
  79.  
  80.      Thi≤á commanΣá i≤ invokeΣ iµ thσ curren⌠á Flo≈á CommanΣ ì
  81. Packagσá ha≤á thσ IF.CO═ facilit∙ enabled«á  Iµ thi≤ i≤á thσ ì
  82. case¼á wheneve≥ aε I╞ commanΣ i≤ issued¼á thσ FC╨ wil∞á loaΣ ì
  83. IF.CO═á froφ thσ ROO╘ director∙ int∩ memor∙ anΣ executσá it«  ì
  84. Thσá commanΣ tai∞ i≤ passeΣ t∩ IF.COM¼á anΣ IF.CO═ act≤ a≤ ß ì
  85. conventiona∞ CO═ filσ froφ tha⌠ poin⌠ forward«á  Al∞ buffer≤ ì
  86. arσá loadeΣ correctl∙ (FCB≤ a⌠ 5C╚ anΣ 6CH¼á TBUF╞á a⌠á 80H¼ ì
  87. etc).
  88.  
  89.  
  90.      ┴á leadinτá tildßá (~⌐á characte≥á beforσá ßá conditioε ì
  91. negate≤á thσ effec⌠ oµ thσ condition«á  Iµ thσ conditioεá i≤ ì
  92. FALSE¼á thσá Flo≈á Statσá i≤ Se⌠ t∩á TRUE¼á anΣá vice-versa«  ì
  93. Example:
  94.  
  95.           "IF ~T" is the same as "IF F"
  96.           "IF ~NULL arg" is TRUE if 'arg' is non-blank
  97.           "IF ~EXIST afn,..." is TRUE if 'afn,...' do NOT
  98.                exist (AFN and AFN ... must each not exist)
  99.  
  100.      Fo≥ eacΦ conditioε given¼ onl∙ thσ firs⌠ tw∩ character≤ ì
  101. are significant (eg, NU for NULL).
  102.  
  103. Selected Error Messages:
  104.  
  105.      "N∩á I╞á Conditioεá Givenóá mean≤á tha⌠á thσá conditioε ì
  106. expressed was not one of the valid conditions.
  107.  
  108.  
  109. Examples of Use:
  110.  
  111.      IF NULL $1
  112.           - if the indicated parameter (from within a SUBMIT
  113.                or ZEX command file) is not provided, set the
  114.                Flow State to TRUE
  115.  
  116.      IF ~EXIST ZEX.ASM,ZEX.ZEX
  117.           - if any one of these files does not exist, the
  118.                Flow State is set to TRUE
  119.  
  120.      IF EXIST ZEX.ASM,ZEX.ZEX
  121.           - if any one of these files does not exist, the
  122.                Flow State is set to FALSE (ie, all files
  123.                must exist for a TRUE Flow State)
  124.  
  125.  
  126.      IF NEC=$1
  127.           - if the first passed parameter is the same as
  128.                the file name "NEC.", then the Flow State
  129.                is Set to TRUE
  130.  
  131.      IF 5 5
  132.           - if Register 5 = 5, the Flow State is Set to TRUE
  133.  
  134. :2
  135.  
  136. Command:  IF (as implemented in SYSFCP 1.0)
  137.  
  138. Syntax:
  139.  
  140.      IF cond arg
  141. or
  142.      IF ~cond arg
  143.  
  144. Function:
  145.  
  146.      I╞á test≤ thσ indicateΣ conditioε t∩ seσ iµ i⌠ i≤ TRUE¼ ì
  147. and¼á iµá so¼á set≤á thσ Flo≈ Statσ t∩á TRU┼á (allowinτá thσ ì
  148. followinτ command≤ t∩ execute)«á  Iµ thσ conditioε i≤ FALSE¼ ì
  149. thσá Flo≈ Statσ i≤ se⌠ t∩ FALS┼ (allowinτ onl∙ Flo≈ Command≤ ì
  150. to execute).
  151.  
  152.      Thσ I╞ commanΣ describeΣ herσ i≤ residen⌠ withiε SYSFC╨ ì
  153. 1.0 when the COMIF equate is set to FALSE.
  154.  
  155.  
  156. Options:
  157.  
  158.      Option         Meaning
  159.      T              The Flow State is Set to TRUE
  160.      F              The Flow State is Set to FALSE
  161.  
  162.      EMPTY afn      If the indicated file is empty (size is
  163.                       0K), the Flow State is Set to TRUE
  164.  
  165.      ERROR          If the ZCPR3 System Error Flag is SET,
  166.                       the Flow State is Set to TRUE
  167.  
  168.      EXIST afn      If the indicated file exists, the Flow
  169.                       State is Set to TRUE
  170.  
  171.      INPUT          The user is prompted for input, and if
  172.                       he responds with T, Y, <CR>, or <SP>,
  173.                       the Flow State is Set to TRUE
  174.  
  175.  
  176.      NULL afn       If the 2nd FCB (afn) is blank, the Flow
  177.                       State is Set to TRUE
  178.  
  179.      TCAP           If the ZCPR3 TCAP entry is available,
  180.                       the Flow State is Set to TRUE
  181.  
  182.      WHEEL          If the Wheel Byte is TRUE, the Flow
  183.                       State is Set to TRUE
  184.  
  185.      reg val        If the indicated register (0-9) contains
  186.                       the indicated value (0-255), the
  187.                       Flow State is Set to TRUE
  188.  
  189.      afn1=afn2      If the two AFNs are the same, the Flow
  190.                       State is Set to TRUE
  191.  
  192.  
  193. Comments:
  194.  
  195.      Iε al∞ cases¼á iµ thσ indicateΣ conditioε i≤ TRUE¼á thσ ì
  196. Flo≈á Statσ i≤ Se⌠ t∩ TRUE╗á iµ thσ indicateΣá conditioεá i≤ ì
  197. FALSE, the Flow State is Set to FALSE.
  198.  
  199.      Thi≤á commanΣá i≤ invokeΣ iµ thσ curren⌠á Flo≈á CommanΣ ì
  200. Packagσá ha≤ thσ IF.CO═ facilit∙ disabled«á  Iµ thi≤ i≤á thσ ì
  201. case¼ wheneve≥ aε I╞ commanΣ i≤ issued¼ thσ FC╨ wil∞ resolvσ ì
  202. i⌠ internally.
  203.  
  204.      EacΦá oµ thσ option≤ oµ thσ Residen⌠ I╞ ma∙ o≥ ma∙á no⌠ ì
  205. bσ enabled«á  Thesσ option≤ arσ installation-dependent¼á anΣ ì
  206. thσ SHO╫ commanΣ wil∞ displa∙ thσ availablσ option≤ fo≥á an∙ ì
  207. installation.
  208.  
  209.  
  210.      ┴á leadinτá tildßá (~⌐á characte≥á beforσá ßá conditioε ì
  211. negate≤á thσ effec⌠ oµ thσ condition«á  Iµ thσ conditioεá i≤ ì
  212. FALSE¼á thσá Flo≈á Statσá i≤ Se⌠ t∩á TRUE¼á anΣá vice-versa«  ì
  213. Example:
  214.  
  215.           "IF ~T" is the same as "IF F"
  216.           "IF ~NULL arg" is TRUE if 'arg' is non-blank
  217.           "IF ~EXIST afn" is TRUE if 'afn' does NOT
  218.                exist
  219.  
  220.      Fo≥ eacΦ conditioε given¼ onl∙ thσ firs⌠ tw∩ character≤ ì
  221. are significant (eg, NU for NULL).
  222.  
  223. Selected Error Messages:
  224.  
  225.      None
  226.  
  227.  
  228. Examples of Use:
  229.  
  230.      IF NULL $1
  231.           - if the indicated parameter (from within a SUBMIT
  232.                or ZEX command file) is not provided, set the
  233.                Flow State to TRUE
  234.  
  235.      IF ~EXIST ZEX.ASM
  236.           - if any ZEX.ASM does not exist, the
  237.                Flow State is set to TRUE
  238.  
  239.      IF NEC=$1
  240.           - if the first passed parameter is the same as
  241.                the file name "NEC.", then the Flow State
  242.                is Set to TRUE
  243.  
  244.      IF 5 5
  245.           - if Register 5 = 5, the Flow State is Set to TRUE
  246.  
  247. :3
  248.  
  249. Command:  IFSTAT 1.0
  250.  
  251. Syntax:
  252.  
  253.      IFSTAT
  254.  
  255. Function:
  256.  
  257.      IFSTA╘ i≤ useΣ t∩ displa∙ thσ curren⌠ I╞ level«  IFSTA╘ ì
  258. wil∞á repor⌠á witΦ ß Leve∞ Numbe≥ froφ ▒ t∩ ╕á (IF≤á ma∙á bσ ì
  259. nesteΣ u≡ t∩ ╕ level≤ deep⌐ o≥ i⌠ wil∞ repl∙ witΦ "N∩ Activσ ì
  260. IF".
  261.  
  262. Options:
  263.  
  264.      None
  265.  
  266.  
  267. Comments:
  268.  
  269.      Thσ Flo≈ Statσ MUS╘ bσ TRU┼ fo≥ IFSTA╘ t∩ run¼ sincσ i⌠ ì
  270. is a COM file like any other.
  271.  
  272. Selected Error Messages:
  273.  
  274.      None
  275.  
  276. Examples of Use:
  277.  
  278.      IFSTAT
  279.           -- the current IF level is displayed
  280.  
  281. :T
  282.              Summary of Transient IF Conditions
  283.  
  284.      Option         Meaning
  285.      T              TRUE (Flow State is Set to TRUE)
  286.      F              FALSE (Flow State is Set to FALSE)
  287.  
  288.      EMPTY afn,...  If all files in the indicated list
  289.                       are EMPTY (size is 0K), then Flow
  290.                       State is Set to TRUE
  291.  
  292.      ERROR          If the ZCPR3 Error Flag is Set, then
  293.                       Flow State is Set to TRUE
  294.  
  295.      EXIST afn,...  If all files in the indicated list
  296.                       exist, then Flow State is Set to TRUE
  297.  
  298.      INPUT          User input is enabled, and if the user
  299.                       strikes T, Y, <CR>, or <SP>, the
  300.                       Flow State is Set to TRUE
  301.  
  302.      NULL afn       If there is no 'afn' (field is blank),
  303.                       then the Flow State is Set to TRUE
  304.  
  305.      TCAP           If a Z3TCAP is installed, the Flow State
  306.                       is Set to TRUE
  307.  
  308.      WHEEL          If the Wheel Byte is Set, the Flow State
  309.                       is Set to TRUE
  310.  
  311.      reg value      If the indicated register (0-9) has the
  312.                       indicateΣ valuσ (0-255)¼ thσ Flow
  313.                       State is Set to TRUE
  314.  
  315.      afn1=afn2      If the two AFNs are identical in name
  316.                       (11 char FILENAME.TYP are same), the
  317.                       Flow State is Set to TRUE
  318.  
  319. :R
  320.              Summary of Resident IF Conditions
  321.  
  322.      Option         Meaning
  323.      T              The Flow State is Set to TRUE
  324.      F              The Flow State is Set to FALSE
  325.  
  326.      EMPTY afn      If the indicated file is empty (size is
  327.                       0K), the Flow State is Set to TRUE
  328.  
  329.      ERROR          If the ZCPR3 System Error Flag is SET,
  330.                       the Flow State is Set to TRUE
  331.  
  332.      EXIST afn      If the indicated file exists, the Flow
  333.                       State is Set to TRUE
  334.  
  335.      INPUT          The user is prompted for input, and if
  336.                       he responds with T, Y, <CR>, or <SP>,
  337.                       the Flow State is Set to TRUE
  338.  
  339.  
  340.      NULL afn       If the 2nd FCB (afn) is blank, the Flow
  341.                       State is Set to TRUE
  342.  
  343.      TCAP           If the ZCPR3 TCAP entry is available,
  344.                       the Flow State is Set to TRUE
  345.  
  346.      WHEEL          If the Wheel Byte is TRUE, the Flow
  347.                       State is Set to TRUE
  348.  
  349.      reg val        If the indicated register (0-9) contains
  350.                       the indicated value (0-255), the
  351.                       Flow State is Set to TRUE
  352.  
  353.      afn1=afn2      If the two AFNs are the same, the Flow
  354.                       State is Set to TRUE
  355.  
  356. :4
  357.  
  358. Command:  ELSE (from SYSFCP 1.0)
  359.  
  360. Syntax:
  361.  
  362.      ELSE anytext
  363.  
  364. Function:
  365.  
  366.      Iµá thσ curren⌠ Flo≈ Statσ i≤ TRUE¼á ELS┼ toggle≤ i⌠ t∩ ì
  367. FALSE.
  368.  
  369.      Iµ thσ curren⌠ Flo≈ Statσ i≤ FALS┼ anΣ thσ previou≤á I╞ ì
  370. Leve∞á i≤á iε ß TRU┼ State¼á ELS┼ toggle≤ thσ Flo≈ Statσá t∩ ì
  371. TRUE«á  Iµ thσ previou≤ I╞ Leve∞ i≤ iε ß FALS┼á State¼á ELS┼ ì
  372. does nothing.
  373.  
  374. Options:
  375.  
  376.      None (any text may follow the verb ELSE)
  377.  
  378. Comments:
  379.  
  380.      None
  381.  
  382. Selected Error Messages:
  383.  
  384.      No error messages are generated
  385.  
  386. Examples of Use:
  387.  
  388.      IF NEC=$1
  389.           < statements >
  390.      ELSE
  391.           < statements >
  392.      FI
  393.  
  394. :5
  395.  
  396. Command:  FI (from SYSFCP 1.0)
  397.  
  398. Syntax:
  399.  
  400.      FI anytext
  401.  
  402. Function:
  403.  
  404.      F╔á terminate≤á thσ curren⌠ I╞ Level«á  Iµ therσ i≤á n∩ ì
  405. current IF level, FI does nothing.
  406.  
  407. Options:
  408.      None (any text may follow the verb FI)
  409.  
  410. Comments:
  411.      None
  412.  
  413. Selected Error Messages:
  414.      None
  415.  
  416. Examples of Use:
  417.  
  418.      IF EXIST MYFILE.ASM
  419.           < statements >
  420.      ELSE
  421.           < statements >
  422.      FI
  423.  
  424. :6
  425.  
  426. Command:  XIF (from SYSFCP 1.0)
  427.  
  428. Syntax:
  429.  
  430.      XIF anytext
  431.  
  432. Function:
  433.  
  434.      Iµá thσá curren⌠á Flo≈ Statσ i≤á TRUE¼á XI╞á exit≤á al∞ ì
  435. pendinτá IFs«á  I⌠á reduce≤á thσ I╞ Leve∞ t∩á ░á (n∩á I╞á iε ì
  436. effect).
  437.  
  438.      If the current Flow State is FALSE, XIF does nothing.
  439.  
  440. Options:
  441.      None
  442.  
  443.  
  444. Comments:
  445.      None
  446.  
  447. Selected Error Messages:
  448.      None
  449.  
  450. Examples of Use:
  451.  
  452.      ;=LOOP
  453.      XIF
  454.           <statements>
  455.      IF 1 3
  456.           GOTO LOOP
  457.      FI
  458.