;


                    -- Flow Commands --


     -- IF Commands --        -- IF Condition Summaries --
      1 
Transient IF                 T 
Transient IF
      2 
Resident IF                  R 
Resident IF


                        -- Others --
                    3 
IF Status Display
                           4 
ELSE
                            5 
FI
                           6 
XIF

:1


Command:  IF 1.1


Syntax:

     IF cond args
or
     IF ~cond args


Function:

     IƠ test� th� indicate� conditio� t� se� i� i� i� TRUE� �
and�� i� so�� set� th� Flo� Stat� t� TRUŠ (allowin� th� �
followin� command� t� execute)��  I� th� conditio� i� FALSE� �
th� Flo� Stat� i� se� t� FALS� (allowin� onl� Flo� Command� �
to execute).



Options:

     
Option         Meaning
     T              TRUE (Flow State is Set to TRUE)
     F              FALSE (Flow State is Set to FALSE)

     EMPTY afn,...  If all files in the indicated list
                      are EMPTY (size is 0K), then Flow
                      State is Set to TRUE

     ERROR          If the ZCPR3 Error Flag is Set, then
                      Flow State is Set to TRUE

     EXIST afn,...  If all files in the indicated list
                      exist, then Flow State is Set to TRUE

     INPUT          User input is enabled, and if the user
                      strikes T, Y, <CR>, or <SP>, the
                      Flow State is Set to TRUE

     NULL afn       If there is no 'afn' (field is blank),
                      then the Flow State is Set to TRUE

     TCAP           If a Z3TCAP is installed, the Flow State
                      is Set to TRUE

     WHEEL          If the Wheel Byte is Set, the Flow State
                      is Set to TRUE

     reg value      If the indicated register (0-9) has the
                      indicate� valu� (0-255)� th� Flow
                      State is Set to TRUE

     afn1=afn2      If the two AFNs are identical in name
                      (11 char FILENAME.TYP are same), the
                      Flow State is Set to TRUE


Comments:

     I� al� cases�� i� th� indicate� conditio� i� TRUE�� th� �
Flo�� Stat� i� Se� t� TRUE�� i� th� indicate� conditio� i� �
FALSE, the Flow State is Set to FALSE.

     Thi� comman� i� invoke� i� th� curren�� Flo�� Comman� �
Packag� ha� th� IF.CO� facilit� enabled��  I� thi� i� th� �
case�� wheneve� a� I� comman� i� issued�� th� FC� wil� loa� �
IF.CO͠ fro� th� ROO� director� int� memor� an� execut� it�  �
Th� comman� tai� i� passe� t� IF.COM�� an� IF.CO� act� a� � �
conventiona� CO� fil� fro� tha� poin� forward��  Al� buffer� �
ar� loade� correctl� (FCB� a� 5C� an� 6CH�� TBUFƠ a�� 80H� �
etc).


     �� leadin� tild� (~�� characte� befor� � conditio� �
negate� th� effec� o� th� condition��  I� th� conditio� i� �
FALSE�� th� Flo�� Stat� i� Se� t� TRUE�� an� vice-versa�  �
Example:

          "IF ~T" is the same as "IF F"
          "IF ~NULL arg" is TRUE if 'arg' is non-blank
          "IF ~EXIST afn,..." is TRUE if 'afn,...' do NOT
               exist (AFN and AFN ... must each not exist)

     Fo� eac� conditio� given� onl� th� firs� tw� character� �
are significant (eg, NU for NULL).


Selected Error Messages:

     "N� IƠ Conditio� Given�� mean� tha�� th� conditio� �
expressed was not one of the valid conditions.



Examples of Use:

     IF NULL $1
          - if the indicated parameter (from within a SUBMIT
               or ZEX command file) is not provided, set the
               Flow State to TRUE

     IF ~EXIST ZEX.ASM,ZEX.ZEX
          - if any one of these files does not exist, the
               Flow State is set to TRUE

     IF EXIST ZEX.ASM,ZEX.ZEX
          - if any one of these files does not exist, the
               Flow State is set to FALSE (ie, all files
               must exist for a TRUE Flow State)


     IF NEC=$1
          - if the first passed parameter is the same as
               the file name "NEC.", then the Flow State
               is Set to TRUE

     IF 5 5
          - if Register 5 = 5, the Flow State is Set to TRUE

:2


Command:  IF (as implemented in SYSFCP 1.0)


Syntax:

     IF cond arg
or
     IF ~cond arg


Function:

     IƠ test� th� indicate� conditio� t� se� i� i� i� TRUE� �
and�� i� so�� set� th� Flo� Stat� t� TRUŠ (allowin� th� �
followin� command� t� execute)��  I� th� conditio� i� FALSE� �
th� Flo� Stat� i� se� t� FALS� (allowin� onl� Flo� Command� �
to execute).

     Th� I� comman� describe� her� i� residen� withi� SYSFC� �
1.0 when the COMIF equate is set to FALSE.



Options:

     
Option         Meaning
     T              The Flow State is Set to TRUE
     F              The Flow State is Set to FALSE

     EMPTY afn      If the indicated file is empty (size is
                      0K), the Flow State is Set to TRUE

     ERROR          If the ZCPR3 System Error Flag is SET,
                      the Flow State is Set to TRUE

     EXIST afn      If the indicated file exists, the Flow
                      State is Set to TRUE

     INPUT          The user is prompted for input, and if
                      he responds with T, Y, <CR>, or <SP>,
                      the Flow State is Set to TRUE


     NULL afn       If the 2nd FCB (afn) is blank, the Flow
                      State is Set to TRUE

     TCAP           If the ZCPR3 TCAP entry is available,
                      the Flow State is Set to TRUE

     WHEEL          If the Wheel Byte is TRUE, the Flow
                      State is Set to TRUE

     reg val        If the indicated register (0-9) contains
                      the indicated value (0-255), the
                      Flow State is Set to TRUE

     afn1=afn2      If the two AFNs are the same, the Flow
                      State is Set to TRUE



Comments:

     I� al� cases�� i� th� indicate� conditio� i� TRUE�� th� �
Flo�� Stat� i� Se� t� TRUE�� i� th� indicate� conditio� i� �
FALSE, the Flow State is Set to FALSE.

     Thi� comman� i� invoke� i� th� curren�� Flo�� Comman� �
Packag� ha� th� IF.CO� facilit� disabled��  I� thi� i� th� �
case� wheneve� a� I� comman� i� issued� th� FC� wil� resolv� �
i� internally.

     Eac� o� th� option� o� th� Residen� I� ma� o� ma�� no� �
b� enabled��  Thes� option� ar� installation-dependent�� an� �
th� SHO� comman� wil� displa� th� availabl� option� fo� an� �
installation.


     �� leadin� tild� (~�� characte� befor� � conditio� �
negate� th� effec� o� th� condition��  I� th� conditio� i� �
FALSE�� th� Flo�� Stat� i� Se� t� TRUE�� an� vice-versa�  �
Example:

          "IF ~T" is the same as "IF F"
          "IF ~NULL arg" is TRUE if 'arg' is non-blank
          "IF ~EXIST afn" is TRUE if 'afn' does NOT
               exist

     Fo� eac� conditio� given� onl� th� firs� tw� character� �
are significant (eg, NU for NULL).


Selected Error Messages:

     None



Examples of Use:

     IF NULL $1
          - if the indicated parameter (from within a SUBMIT
               or ZEX command file) is not provided, set the
               Flow State to TRUE

     IF ~EXIST ZEX.ASM
          - if any ZEX.ASM does not exist, the
               Flow State is set to TRUE

     IF NEC=$1
          - if the first passed parameter is the same as
               the file name "NEC.", then the Flow State
               is Set to TRUE

     IF 5 5
          - if Register 5 = 5, the Flow State is Set to TRUE

:3


Command:  IFSTAT 1.0


Syntax:

     IFSTAT


Function:

     IFSTA� i� use� t� displa� th� curren� I� level�  IFSTA� �
wil� repor�� wit� � Leve� Numbe� fro� � t� �� (IF� ma�� b� �
neste� u� t� � level� deep� o� i� wil� repl� wit� "N� Activ� �
IF".


Options:

     None



Comments:

     Th� Flo� Stat� MUS� b� TRU� fo� IFSTA� t� run� sinc� i� �
is a COM file like any other.


Selected Error Messages:

     None


Examples of Use:

     IFSTAT
          -- the current IF level is displayed

:T
             
Summary of Transient IF Conditions

     
Option         Meaning
     T              TRUE (Flow State is Set to TRUE)
     F              FALSE (Flow State is Set to FALSE)

     EMPTY afn,...  If all files in the indicated list
                      are EMPTY (size is 0K), then Flow
                      State is Set to TRUE

     ERROR          If the ZCPR3 Error Flag is Set, then
                      Flow State is Set to TRUE

     EXIST afn,...  If all files in the indicated list
                      exist, then Flow State is Set to TRUE

     INPUT          User input is enabled, and if the user
                      strikes T, Y, <CR>, or <SP>, the
                      Flow State is Set to TRUE

     NULL afn       If there is no 'afn' (field is blank),
                      then the Flow State is Set to TRUE

     TCAP           If a Z3TCAP is installed, the Flow State
                      is Set to TRUE

     WHEEL          If the Wheel Byte is Set, the Flow State
                      is Set to TRUE

     reg value      If the indicated register (0-9) has the
                      indicate� valu� (0-255)� th� Flow
                      State is Set to TRUE

     afn1=afn2      If the two AFNs are identical in name
                      (11 char FILENAME.TYP are same), the
                      Flow State is Set to TRUE

:R
             
Summary of Resident IF Conditions

     
Option         Meaning
     T              The Flow State is Set to TRUE
     F              The Flow State is Set to FALSE

     EMPTY afn      If the indicated file is empty (size is
                      0K), the Flow State is Set to TRUE

     ERROR          If the ZCPR3 System Error Flag is SET,
                      the Flow State is Set to TRUE

     EXIST afn      If the indicated file exists, the Flow
                      State is Set to TRUE

     INPUT          The user is prompted for input, and if
                      he responds with T, Y, <CR>, or <SP>,
                      the Flow State is Set to TRUE


     NULL afn       If the 2nd FCB (afn) is blank, the Flow
                      State is Set to TRUE

     TCAP           If the ZCPR3 TCAP entry is available,
                      the Flow State is Set to TRUE

     WHEEL          If the Wheel Byte is TRUE, the Flow
                      State is Set to TRUE

     reg val        If the indicated register (0-9) contains
                      the indicated value (0-255), the
                      Flow State is Set to TRUE

     afn1=afn2      If the two AFNs are the same, the Flow
                      State is Set to TRUE

:4


Command:  ELSE (from SYSFCP 1.0)


Syntax:

     ELSE anytext


Function:

     I� th� curren� Flo� Stat� i� TRUE�� ELS� toggle� i� t� �
FALSE.

     I� th� curren� Flo� Stat� i� FALS� an� th� previou� I� �
Leve� i� i� � TRU� State�� ELS� toggle� th� Flo� Stat� t� �
TRUE��  I� th� previou� I� Leve� i� i� � FALSŠ State�� ELS� �
does nothing.


Options:

     None (any text may follow the verb ELSE)


Comments:

     None


Selected Error Messages:

     No error messages are generated


Examples of Use:

     IF NEC=$1
          < statements >
     ELSE
          < statements >
     FI

:5


Command:  FI (from SYSFCP 1.0)


Syntax:

     FI anytext


Function:

     Fɠ terminate� th� curren� I� Level��  I� ther� i� n� �
current IF level, FI does nothing.


Options:
     None (any text may follow the verb FI)


Comments:
     None


Selected Error Messages:
     None


Examples of Use:

     IF EXIST MYFILE.ASM
          < statements >
     ELSE
          < statements >
     FI

:6


Command:  XIF (from SYSFCP 1.0)


Syntax:

     XIF anytext


Function:

     I� th� curren�� Flo� Stat� i� TRUE�� XIƠ exit� al� �
pendin� IFs��  I�� reduce� th� I� Leve� t� �� (n� IƠ i� �
effect).

     If the current Flow State is FALSE, XIF does nothing.


Options:
     None



Comments:
     None


Selected Error Messages:
     None


Examples of Use:

     ;=LOOP
     XIF
          <statements>
     IF 1 3
          GOTO LOOP
     FI