; -- 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, , or , 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, , or , 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, , or , 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, , or , 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 IF 1 3 GOTO LOOP FI