Syntax Summary

In this section:

This section is a summary of the FSCAN commands, PF keys, and prefix area commands. References to other sections are included.


Top of page

x
Summary of Commands

In this section:

 

FSCAN commands are listed here in alphabetical order. The unique truncation of each command is capitalized.



x
Backward

Scrolls the display one screen backward.

PF keys: PF7 or PF19.



x
CHAnge

Changes character strings within field values. The syntax is

CHAnge field =/oldstring/newstring/ [,$ {*|n}]

where:

field

Is the name of the field whose value you want to change. The field must be alphanumeric and it cannot be a key field.

oldstring

Is the substring of the field value that you want to change.

newstring

Is the character string to replace the substring.

,$ {*|n}

Enables you to change multiple instances counting from the current instance (the current instance included). n is the number of instances to be searched for the substring. If you want all instances in the group searched (starting from the current instance), use an asterisk (*).

You can also change field values by typing over them.



x
CHIld

Displays the child instances relating to the current instance. (In SINGLE mode, displays the first child instance of the current instance.) The syntax is

CHIld [n]

where:

n

Is the number of the child segment as assigned by FSCAN. If you omit this number, FSCAN displays a menu listing the segments and their numbers. Enter a number to display the segment (Displaying Descendant Segments: The CHILD, PARENT, and JUMP Commands).

Prefix area command: C[n]

where:

n

Is the number of the child segment as assigned by FSCAN. If you omit this number, FSCAN displays the menu.



x
DElete

Deletes the current instance and all descendant instances.

Prefix area command: D



x
DOwn [n]

Scrolls the display n lines forward. n defaults to 1.



x
DIsplay Field Name

Displays the segment containing the specified field name.



x
End

Saves all changes made to the database and exits the FSCAN facility (see Exiting FSCAN: The END, FILE, QQUIT, and QUIT Commands).



x
FILe

Saves all changes made to the database and exits the FSCAN facility (see Exiting FSCAN: The END, FILE, QQUIT, and QUIT Commands).



x
FINd

Searches a group of instances (in the root segment, this is all instances in the segment; in descendant segments, this is all instances sharing a common parent instance) for an instance containing field values that fulfill certain conditions. FIND searches the group starting from the current instance. If it finds the instance, it makes that instance the current instance.

The syntax is (entered on one line)

FINd field1 rel1 value1 [OR value1a OR value1b OR ...]
 
[{AND|,} field2 rel2 value2 {AND|,}]

where:

fieldn ...

Is a field in the segment.

reln ...

Is one of the following relations:

EQ 
or
=

Equal to

NE 

Not equal to

GE

Greater than or equal to

GT

Greater than

LE

Less than or equal to

LT

Less than

CONTAINS
or
CO

Contains the character string

OMITS
or
OM

Omits the character string

valuen ...

Is a value for which FSCAN can test. The first instance having the field value that passes the test becomes the current segment. If there are multiple tests, the first instance that passes all the tests becomes the current instance.

OR

Allows you to test a field for multiple values. If the field contains one of the values, it meets the test. You can use AND and OR in the same FIND command.



x
FIrst

Selects the first instance in a group of instances on display to be the current instance. In the root segment, the group of instances consists of all instances in the segment; in a descendant segment, a group consists of all instances that share a common parent instance.



x
FOrward

Scrolls the display one screen forward.

PF keys: PF8 or PF20.



x
Help

Invokes the FSCAN HELP facility.

PF keys: PF01 or PF11.



x
Input

Adds a new segment instance.

Prefix area command: I

Note: This command is valid only in the input area as a prefix command.



x
Jump

Moves to the child of the next parent instance.

PF keys: PF12 or PF24



x
LAst

Selects the last instance of a group of instances on display. In the root segment, the group of instances consists of all instances in the segment; in a descendant segment, a group consists of all instances that share a common parent instance.



x
LEft

Scrolls the display one panel to the left.

PF keys: PF10 or PF22.



x
LOcate

Searches for instances containing field values that fulfill certain conditions. LOCATE searches starting from the current instance. If it finds the instance, it makes that instance the current instance.

The syntax is (entered on one line)

LOcate field1 rel1 value1 [OR value1a OR value1b OR ...]
 
[{AND|,} field2 rel2 value2 {AND|,}]

where:

fieldn ...

Is a field to be tested.

reln ...

Is one of the following relations:

EQ
or
=

Equal to

NE 

Not equal to

GE

Greater than or equal to

GT

Greater than

LE

Less than or equal to

LT

Less than

CONTAINS
or
  CO

Contains the character string

OMITS
or
OM

Omits the character string

valuen ...

Is a value for which FSCAN can test. The first instance having the field value that passes the test becomes the current segment. If there are multiple tests, the first instance that passes all the tests becomes the current instance.

OR

Allows you to test a field for multiple values. If the field contains one of the values, it meets the test. You can use AND and OR in the same LOCATE command.



x
Key

Enables you to type over key field values in the current instance.  

Prefix area command: K

where:

K/

Makes the instance the current instance after the key values are changed.



x
Multiple

Displays multiple instances, each on a single line. Entering this command after entering the SINGLE command returns the screen to the normal display (see Displaying a Single Instance on One Screen: The SINGLE and MULTIPLE Commands).



x
Next [n]

Scrolls the display n lines forward. n defaults to 1.



x
Parent

Displays the parent segment. The parent instance becomes the current instance. In SINGLE mode, PARENT displays the parent instance only.



x
QUit

Exits the FSCAN facility if you did not make any changes to the database.

PF keys: PF3 or PF15.



x
QQuit

Exits the FSCAN facility without saving any changes to the database.



x
REPlace

Replaces field values. The syntax is

REPlace field1 = value1[,field2 = value2 ...] [,$ {*|n}]

where:

fieldn...

Is a field in the instance whose value you want to change.

valuen...

Is the new value for the field.

,$ {*|n}

Enables you to change multiple instances counting from the current instance (the current instance included). n is the number of instances to be searched for the field values you want to change. If you want all instances in the group searched (starting from the current instance), use an asterisk (*).

You can also replace field values by typing over them.



x
REPlace KEY

Replaces key field values in the current instance. The syntax is

REPlace KEY key1 = value1[, key2 = value2, ...]

where:

keyn ...

Is a key field in the instance whose value you want to change.

valuen ...

Is the new value for the key field.

You can also replace key field values by typing over them.



x
RESet

Performs the following:

PF keys: PF2 or PF14.

Prefix area command: R

Note: The R prefix-area command recovers only field values on the line that it is typed. If you typed changes on a line not specifying the R prefix, FSCAN enters the changes.



x
RIght

Scrolls the display one panel to the right.

PF keys: PF11 or PF23.



x
SAve

Saves all changes made to the database without exiting FSCAN.



x
SIngle

Displays the current instance alone with all field values on one screen. To return to the normal display, enter the MULTIPLE command.



x
Top

Displays the root segment and makes the first instance in the root segment the current instance, scrolled to the leftmost panel.



x
?

Displays the previous command in stack.

PF keys: PF6 or PF18.



x
=

Executes the previous command entered.

PF key: PF9 or PF21.


Top of page

x
Summary of PF Keys

The following table is a list of FSCAN PF keys and their corresponding functions.

FSCAN Keys

Functions

PF1, PF13

HELP

PF2, PF14

RESET

PF3, PF15

QUIT

PF4, PF16

PARENT

PF5, PF17

CHILD

PF6, PF18

?

PF7, PF19

BACKWARD

PF8, PF20

FORWARD

PF9, PF21

=

PF10, PF22

LEFT

PF11, PF23

RIGHT

PF12, PF24

JUMP



x
Summary of Prefix Area Commands

The following is a summary of prefix area commands. You type these commands in the prefix area that corresponds to the instance you wish to address.

/

Makes the instance the current instance. May be typed after the prefix area commands K, I, and R.

C

Displays child instances (see Displaying Descendant Segments: The CHILD, PARENT, and JUMP Commands).

D

Deletes the instance and all its children.

I

Inputs a new instance (valid only in the input area).

I/

Inputs a new instance and makes the instance the current instance (valid only in the input area).

K

Enables you to type over key field values in the instance.

K/

Enables you to type over key field values in the instance, then makes the instance the current instance.

R

Performs the following:

  • Clears the input area.
  • Recovers all field values on the screen that you typed over, both non-key fields and key fields. To recover non-key field values, you must enter the RESET command before you press the Enter key. Otherwise, you will not recover the typed-over values.

Note that the R prefix area command recovers only field values on the line on which it is typed. If you typed changes on a line not specifying the R prefix, FSCAN enters the changes.


Information Builders