-- IF Commands -- -- IF Condition Summaries --

;

-- 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