If Record Not Active

This is a process control command, i.e., it will control whether a command, or group of commands, will be executed. This is one part of a complete command structure.

IFNA file_num

Required - The number/handle of the file to be checked.

what_to_do - sac The action to take if the record is not active. Possible actions include:

DO - Do the following commands until the program reaches an ELSE, ELSE_IF or ENDIF command. This is the default value and doesn't have to be specified.

THEN - Execute the following command. The command to execute in this case may follow on the same physical line or it will execute the command on the following line.

GOTO - Goto the line label specified in the goto_gosub_label.

GOSUB - Gosub the line label specified in the goto_gosub_label.

RET - Execute the RET (Return) command.

NOTE: DO NOT use this option to return a value. The RET here is just a return. If you want to return a value you would use:

IFNA file_num THEN RET value

goto_gosub_label

If the what_to_do option is GOTO or GOSUB then you must specify the label name here.

COMMENTS

The IFNA() function is similar in that it checks for an active record and returns .TRUE. or .FALSE.

For more information on the different structured programming commands, and the IF command in particular, please see Structured Programming Commands.