FSTAT/SHFA File selection using the FSTAT/SHFA command

string , Q Qualified Selection. Only the fully qualified file string is selected. If string ends with a full stop, then those partially qualified files are selected.

Notes:

The Q option is a simple and quick method for selecting partially qualified files and Job variables.

Without the Q option, partially qualified file selection can only be achieved by specifying :1:'string.' or FSTAT string. .

File Selection using the FSTAT/SHFA Command

FSTAT xxx [, param]

xxx File selection string according to the FSTAT syntax (wildcards are also possible).

par additional FSTAT selection parameters (e.g. SIZE=30:300).

The LIST operand may not be specified, since it is used internally by CFS.

SHFA xxx [, param] | SHFA ?

xxx File selection using the SHFA syntax (wildcards are also possible).

? The assisted SDF dialog of the SHFA command (SHOW File Attributes) will be started.

par additional selection parameters for SHFA command e.g. (SELECT=(SIZE=*INT(FROM=30,TO=300)).

The OUTPUT= operand of the SHFA command cannot be used here, since it is used internally by CFS.

Examples:

FSTAT *CFS*DO*

FSTAT VOL=PVT002,VTOC=YES

Notes:

Normally, the catid's and userid's of the selected files are not displayed in the file list. The CFN command (Complete File Names), see page 18- will cause the selected files to be displayed with both catid and userid.

The catid's of files selected using the FSTAT command are displayed in the file list. In addition, all files within a userid can be selected from across all Pubsets (PVS): FSTAT :*:.. The same result can be achieved by entering :*: in the USER-ID field.

If a connection is established to a remote computer with the RFASTART command before loading CFS, then FSTAT :*: or FSTAT :x: can also result in the selection of files from the remote computer. Selecting remote files with the FSTAT option is faster than selection using the USER-ID field (entering :x:). The selection will proceed even faster if the NO (Names Only) option is specified in the USER OPTION field.

The catid's of the files selected with the FSTAT option are generally displayed in the file list. The userid's are also displayed, if necessary.

Temporary files may only be selected by entering FSTAT #. The Tempfile indicator '#' may be redefined by an optional BS2000 REP to the alternative character '@'.

Temporary Job variables can be selected by entering STAJV # or STAJV @.

If the catid's of the files are not required (e.g. for an Archive save run created using the ONXARCHIVE Variable Action), they may be suppressed be specifying NOC (No CatId's) in the USER OPTION field.

If an extremely large number of files are to be managed in a userid, then CFS might issue the following message when trying to select them: "FSTAT-Area too small. Some Files will be missing from the File-List". This restriction may be overcome by selecting the files using the FSTAT option.