|
Selection mask : FILENAME-SELECT
Selecting Files by Name
Selection according to a string of characters occurring in the Files/Job variable/ Library element name.
col :col1-col2: | :col: | >:col: | <:col:
If a column range is entered (:col: or :col1-col2:), the specified search string 'string' must begin in this column range. See additional information in the notes on the next page.
- negative selection: All data objects are selected whose name does not contain 'string'.
p > | <
All data objects are selected whose name is greater/less than 'string'.
Standard: = 'string'
'string' Search string.
The single quotes enclosing the search string can mostly be omitted. Selection strings containing CFS keywords, such as FMS/ LMS/ LMR MAC/ NO/ RL/ FSTAT/ STAJV/ RDTFT/ OLDLIST must be enclosed in quotation marks.
Notes:
If no string is given in the FILENAME-SELECT field, then all file/Job variables will be selected whose characteristics match those specified in the other search criteria fields of the mask.
If an empty selection mask is transmitted, then all files of the current userid will be selected.
If a column range is specified in the search argument, then the following differences to EDT column range specification should be noted:
1) :col1-col2: means only that the search string enclosed in quotes must begin within the specified column range.
In EDT the search string must be contained fully within the column range.
2) :col: means that the search string enclosed within the quotes must begin exactly at that column.
Specifying an individual column in EDT will cause the search to be performed from that column to the end of the record. This is achieved in CFS by specifying >:col2: , whereby col2=col-1. By entering <:col: in CFS, a string can be sought from the beginning of the name up to col.
Examples:
LST
The file name must contain the string 'LST'.
#
All temporary files of the current session are selected.
'#'
All regular files (i.e. no temporary files) containing the character '#' somewhere in its name will be selected.
-'.'
The name may not contain a full stop '.' .
:1:<'D'
The name must begin with the letters A, B, or C (characters < 'D').
:1-3:-'.'
The name may not begin with a 3 letter partial qualification.
:9:' '
The name must contain a blank in column 9, i.e. it must be 1 to 8 characters long.
->'Z'
The name may not contain any numerals (no character > 'Z').
Multiple Selection - Format 1: param [op param] [op param] .....
param simple search argument according to the syntax described above.
op Logical operator joining the simple search arguments.
, Or operation.
+ And operation.
* [n] Wildcard operation: And operation, but in addition, the second string must occur after the first in the file name. If the value n is specified, then exactly n positions must exist between the two strings.
Any number of search arguments joined with the Or/And/Wildcard operators may be specified.
Examples:
CFS*SRC
Select all files whose name contains the string 'CFS', and then somewhere later in the name the string 'SRC'.
:1:>'B'+:1:<'H',:1:'X',:1:'Y',:1:'Z'
All files whose names begin with the letter C, D, E, F, G, X, Y or Z.
Multiple Selection - Format 2: ( )
Entering () will display a special search mask. The user will then have 18 lines available to enter any number of search arguments. For a description of the search mask, see page 8-.
Multiple Selection - Format 3: %name | %?
%name is the name of a Parameter Set which contains a complex search argument, and which was saved earlier with the SP %name.
%?: All available parameter sets will be displayed in a list. One of those displayed can be selected by marking it. For further information, see page 8-.
Multiple Selection - Format 4: ( s-fil )
s-fil is the name of a SAM file containing the search arguments. For further information, see page 8-.
Example:
LMS CFS.TESTPLAM,(CFS.SEL.1)
The SAM file CFS.SEL.1 contains the following records:
'OUT'+-'LOGOUT'+'A1'
'CFS'*'SRC'
:1:'S/'
The specified selection records are merged by CFS to give the following search argument: 'OUT'+-'LOGOUT'+'A1','CFS'*'SRC',:1:'S.'
As a result of this statement, all elements from the library CFS.TESTPLAM will be selected whose name fulfills one of the following conditions:
- The element name contains the strings 'OUT' and 'A1', but not 'LOGOUT'
- The element name contains the string 'CFS' and anywhere after that 'SRC'.
- The element name begins with the string 'S/' (Element type S).
Selecting Job variables can be achieved by entering J in the FCBTYPE field of the selection mask. Any number of selection criteria may be entered in the FILENAME-SELECT field according to the syntax described above.
STAJV All Job variables of a particular userid, or partially qualified variables of the userid may be selected by entering STAJV or STAJV [partqual.] respectively.
With a mouseclick you get a describtion of the screen item.
Selection of Library Elements
FMS lib | LMS lib | LMR lib | MAC lib
The "File list" will consist of all elements of the specified library. No conditional selection will occur based on a search string of the name of the elements.
lib Name of the library whose elements should be listed.
FMS lib , param | LMS lib , param | LMR lib , param | MAC lib , param
The file list consists of only those elements of the specified library whose names fulfill the conditions described in param .
param simple or multiple selection condition.
For a description of the syntax, see page 4- "Selection of Files by Name".
With a mouseclick you get a describtion of the screen item.
Notes:
If the 'LMS' keyword is specified, elements from older format libraries (LMS ISAM, 8 digit element names), as well as elements from the new 44 digit name PLAM format libraries will be selected. OML's created with LMR are selected using the LMR keyword.
The full form (FMSLIB/ LMSLIB/ LMRLIB/ MACLIB) may be specified, as well as the abbreviated form FMS/ LMS/ LMR/ MAC.
PLAM: CFS stores the names of PLAM elements internally in the form t/element/ vers. Elements with the standard version description (X'FF') are not displayed on screen. The standard version description is replaced by the @ character.
LMR: CFS can only process LMR librarys in Input mode. This means that there are restrictions on the scope of some Variable Actions and Action Codes. For example, the Action Codes M (Modify), E (Erase), C (Copy) and R (Rename) are not available for LMR libraries.
The Variable Action ONXADD lib can be used to convert LMR modules to a PLAM library.
Examples:
FMS EST.FMSLIB
The entire table of contents of the FMS library EST.FMSLIB is displayed.
LMS MACROLIB,>:10:'001'
Select all elements from the LMS library MACROLIB which have a version number > 001.
LMS-ISAM: Version numbers always begin in column 10.
LMS LIB.PROG,X/
All X type elements from the PLAM library LIB.PROG.
Elements of a particular type may also be selected by entering the type in the FCBTYPE field.
LMS LIB.PROG,:3:'ABC'
Select all elements of the PLAM library LIB.PROG whose names begin with the string ABC. Specifying the column, :3:, is necessary, since CFS stores the names in the form S/ABC.TEST/002.
LMS LIB.PROG,/ß
Select all elements from the PLAM library LIB.PROG which have the standard version X'FF'.
LMS LIB.PROG,/TEST/
Select all elements of the PLAM library LIB.PROG with the fully qualified name TEST. With this type of name selection, the element type and version number play no part.
Selection of Archive Directory Entries
The file list will consist of all the entries belonging to the user from the specified Archive directory, or those entries whose name fulfills the criteria specified in param.
directory Name of the Archive directory whose contents should be listed.
param simple or multiple selection condition for the entry names in the Archive directory. For a description of the syntax, see page 4- "Selection of Files by Name".
With a mouseclick you get a describtion of the screen item.
Notes:
By default, the entries for all catids are displayed. The selection can be restricted to a specific PVS by entering a value in the USER-ID field of the Selection mask. (Enter :pvs:).
By default, only the last (newest) save entry will be displayed for each file or Job variable. Specifying SAVE, or SAVE CNS as a USER OPTION will result in all save entries (FULL/PART), or additionally the CNS entries (Catalogued but not Saved) being displayed.
Entering the Action Code NP next to an entry in a standard directory list will result in a list of all available save entries.
Entering J in the FCBTYPE field of the Selection mask will display all Job variables in the specified Archive directory.
The User Options RETPD and SAVE are additionally available for Archive directory entries. For further information, see page 5-/.
Displaying Volume information from an Archive directory can be done by means of the POOL command. For more information, see page 7-.
Examples:
DIR $TSOS.ARCHIVE.SAVE
The latest save versions of all files belonging to the user will be displayed from the $TSOS.ARCHIVE.SAVE Archive directory.
DIR $TSOS.ARCHIVE.SAVE,'LIB'
The latest save versions of those files whose names contain the string 'LIB' belonging to the user will be displayed from the $TSOS.ARCHIVE.SAVE Archive directory.
Select elements from a ZIP archive
The file list will display all elements of the specified ZIP archive, or only those elements whose names fulfill those search conditions specified in param.
archive Name of the ZIP archive whose elements should be displayed.
param simple or compound search criteria for the entries stored in the Archive directory. For a description of the syntax, see page 4- (Selection of Files by Name).
Hint:
Additional selection criteria for ZIP archives are the AGE and LASTP fields of the Selection mask. There are no User Options for ZIP archives.
Examples:
ZIP TMP.ZIPFILE
All elements in the TMP.ZIPFILE ZIP archive will be displayed.
ZIP TMP.ZIPFILE,SAVE
All elements in the ZIP archive TMP.ZIPFILE, whose name contains the string 'SAVE' will be displayed.
Special Options in the FILENAME-SELECT Field
File selection using partialy/fully qualified names
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
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.
Selecting all Files currently being transfered with FT (NSTAT)
NSTAT All files/PLAM library elements currently being transfered to or from the local host using FT-BS2000 will be selected.
Notes:
The construction of the file list for this option differs from that of the normal file list, and is described on page 3-. In an NSTAT list, the Action Code U will cause thecurrent state of the File Transfer jobs to be updated in the list. For instance, the actual number of bytes (in Kilobytes) of a file currently being transfered would be displayed.
If the NSTAT option is used, no additional selection characteristics may be added to the selection mask. In contrast to the FSTAT command, no operands of the BS2000 NSTAT commands may be specified.
For additional information on transfering files using FT-BS2000, see also Variable Action ONXFT on page 5-, Action-Codes FT/FTS/FTC on page 6-, FT command on page 7- and the JRFT/NJRFT commands on page 11-.
Selecting all Files with Link Names (RDTFT)
RDTFT All files associated with a link name in the current task will be selected. The link names will be displayed together with the file names in the file list.
The userid of the selected files is not relevant in this case. Files of other userid's will be displayed if they are associated with the current task by a link name. If multiple link names exist for a single file, it will be repeated in the file list for each respective link name.
In connection with the RDTFT option, the RL Action Code (Release Link) should be noted. This Action Code can be used to free a link name of a file displayed in the list.
NO No Files/Library elements/Job variables are selected at all. The next CFS mask to be displayed will contain only the command field. In this way all commands can be entered, but no file-specific Action Code. The long form NOLIST can also be entered instead of the abbreviated form NO.
A selection is performed according to the data stored in the parameter set %name.
%name name of the parameter set containing the selection items.
%? All available parameter sets will be displayed in a list. One of those displayed can be selected by marking it.
jrsave name of the JRSAVE file in which the parameter set is stored.
Standard: CFS.JRSAVE.xxxx. For more information see page 27-.
? The selektions mask will be filled with the content stored in the parameter set. The user can view and modify the selection items. By default the selection will be executed immediately.
Note:
The storing of selection items cann be done in the file list with the CFS-command SP %name. For more information see page 7-.
RL The file list last selected is displayed. This option cannot be used if ADOC mode (Automatic Doc file) is not set (Standard: ADOC set).
RL mn The file list saved with the SL mn command is displayed.
Note: The RL mechanism is an abbreviated form of the OLDLIST option (see below).
OLDLIST file [, param] The file list is created from those names contained in:
a) CFS Documentation file. A documentation file is created by entering a file name in the DOCUMENTATION field of the Selection mask. A documentation file can also be created using the DOC and SL (Save List) commands.
b) Reference file. A referance file is any SAM file in which every record contains a file name. A reference file can be created as follows, for example:
- With the following FSTAT command:
/FSTAT ....,LIST=file or /FSTAT ....,LIST=(file,F)
The contents of this List file will be read by CFS.
- In EDT , using @FS 1 and @W'file
- Using the CFS Variable Action DPF: ONXDPF file
param It is possible to perform a multi-stage selection by entering an additional search condition, param, or by entering additional selection criteria in other selection mask fields.
Example:
FILENAME-SELECT : OLDLIST file,:1:'ABC'
AGE : >60
will select all those files from the specified documentation file whose name begins with the string 'ABC', and which have not been amended in the last 60 days.
Notes:
Specifying the NO (Names Only) User Option in conjunction with the OLDLIST option will result in a file list being created in which the actual existence of the files from the reference file list is not checked. A file list can thus contain file names that do not exist on the host.
For additional information on the subject of restoring earlier file lists, see the commands SL/ RL (Save List/Restore List) on page 7-/7-, ADOC (Automatic Documentation) on page 18- and DOC on page 18-, as well as the DOCUMENTATION field of the Selection mask on page 4-.
Example of an application for the OLDLIST option.
Fetching files from a remote computer using FT-BS2000.
A list of file names (Reference file) is created on the remote host with the FSTAT ...,LIST=file command. This Reference file is transfered to the host computer with the NCOPY command. Entering
FILENAME-SELECT : OLDLIST file
USER OPTION : NO
will display on the host computer that file list that was created on the remote computer. Marking the required files with an 'X', and entering the Variable Action ONXFT rem-host,user-id,acct, passw,,,,FROM will result in those marked files being transfered from the remote computer to the host system.
Saving the Selection Mask Entries
CFS maintains an internal table in which all current selection mask entries are stored. The user has access to this "memory" in two ways:
a) sequentially:
Pressing the DUE2 key with an empty FILENAME-SELECT field will display the last entry, then the last but one, and so on.
b) associatively:
string Shift ENTER. The last entry to have been displayed in the FILENAME-SELECT field that begins with the specified string will be restored. Repeatedly pressing the Shift ENTER key will scroll back in the memory.
*string Shift ENTER. The last entry to have been displayed in the FILENAME-SELECT field that has the specified string appearing anywhere within it will be displayed.
Examples:
FILENAME-SELECT : LMS Shift ENTER
will display the last selection entry to begin with LMS; for example, LMS CFS. PLAMLIB,-R/.
FILENAME-SELECT : *PLAM Shift ENTER
will display the last selection entry that contains the string 'PLAM' anywhere within it; for example, LMS CFS.PLAMLIB.
Data Protection: All entries can subsequently be removed from the memory as follows: Repeatedly pressing the Shift ENTER key will restore the entries to be removed. Pressing the K3 key will then delete these entries from the memory.
Selection Mask : USER-ID
Userid / PVS for File Selection
:x: | :*: | user-id | :x: user-id | :*: user-id
:x: Selection of files from PVS (Public Volume Set) x under the current userid.
:*: Selection of files from all locally available Pubsets under the current userid.
:**: Selection of files from all locally and remotely available Pubsets under the current userid.
user-id Selection of files from the default (home) Pubset of the specified userid. The userid must be specified without the preceding $ and the suffixed full stop. If the userid is prefixed with '$', then the first $ character of the userid will be ignored.
:x: user-id Selection of files from Pubset x under the specified userid.
:*: user-id Selection of files from all locally available Pubsets under the specified userid.
:**: user-id Selection of files from all locally and remotely available Pubsets under the specified userid.
Standard: With an empty User-ID field, all files from the home Pubset of the current userid are selected.
Notes:
The user can predefine a userid as standard. Full information on the UID command can be found on page 18-.
Up to BS2000 Version 9.5, the following applies: Under any userid other than TSOS, only shareable files are displayed.
As from BS2000 Version 10, the BACL (Basic Access Control List) and ACL (Access Control List) features are implemented. This means that non-shareable files from a foreign userid may also be displayed if the BACL characteristics for those files are activated, and access (read/write/execute) is allowed. Equally, shareable files of a foreign userid that do not have a BACL attribute allowing access to the current userid will not be displayed.
Examples:
USER2
:B:USER2
Userid $USER2 in Catalog :B:
:B:
Public Volume Set :B: under the current userid.
$$USER3
The userid actually begins with a $ character: $USER3.
The first $ character of the userid is ignored by CFS.
Select Files / Job Variables from Multiple Userid's
(SYSDTA) The required userid's are requested via SYSDTA.
An '*' will appear on screen as input prompt. 'EOF' should be entered following the last userid as the terminating flag.
(file) The userid's are read from the specified file. The file must be SAM format, and Recform=V.
Example:
The file named CFS.USER contains 5 records with the following contents:
:G:TT08
:OPG:TT08
CFS
:1:TSOS
:2:S43
By entering the following selection condition:
NPSAP;(CFS.USER)
all files containing the string 'SAP' in their name from the following userid's will be selected: :G:$TT08. / :OPG:$TT08. / $CFS. / :1:$S43. or :2:$S43..
Selection Mask : LAST PAGE
Selection according to File Size
All files/library elements occupying more than (>), less than (<), or exactly (=) x PAM pages.
Notes:
The '=' character can be omitted. Entering simply x will result in it being interpreted as =x.
When selecting Job variables (FCBTYPE : J), the required size (number of bytes) of the data portion of the Job variable can be specified in the Last Page field.
Examples:
<4 All files with less than 4 written PAM pages.
0 All empty files (0 written PAM pages).
Selection Mask : AGE
Selection according to Age / Date
All files/libraray elements/Job variables that were created/last amended more than (>), less than (<), or exactly (=) x days before/after the specified date will be selected.
Selection by age: >x | =x | <x
Selection by date: >dd. [mm. [yy] ] | <dd. [mm. [yy ] ] | =dd. [mm. [yy] ]
Notes:
The selection takes place according to the BS2000 catalog attribute "Creation Date". The creation date is updated if the file is opened in Output, Outin or Inout mode.
The '=' sign can be omitted, and x can simply be specified. In this case, the '=' sign will be inserted by CFS.
If the month and/or year (mm.yy / yy) is omitted from a date dd.mm.yy specification, then the current month and year will be substituted internally. It should be noted, however, that the last character must be a full stop.
Using the DATE command (page 18-) will cause the age of the file/library elements/ Job variables to be displayed in date format rather than as an age in days.
Examples:
0 all files/library elements/Job variables that were created or amended today.
>7 all files/library elements/Job variables that were created or amended more than 7 days ago.
<15.05. all files/library elements/Job variables that were amended after the 15.05. of the current year.
Selection Mask : FCBTYPE
Selection according to FCBTYPE
All files with a particular FCBTYPE, or all PLAM libraries, or all Job variables, or all elements from a PLAM library of a particular element type.
Files:
[-] S [not] SAM
[-] I [not] ISAM
[-] P [not] PAM
[-] B [not] BTAM
[-] N [not] NONE (NONE = files created with a CAT or FILE command, but not yet opened)
D SAM or ISAM
[-] PL [not] Program libraries (PLAM)
Job variables:
J Selection of Job variables
JM Selection of Monitor Job variables
PLAM Library Elements:
[-] C [not] Core image (bound programs)
[-] D [not] Data
[-] H [not] Data created with H Assembler
[-] J [not] Job Control (Enter files/DO Procedures)
[-] L [not] Data created by the BS2000 linker
[-] M [not] Macro
[-] P [not] Print (printable lists)
[-] R [not] Relocatable (Object modules)
[-] S [not] Source (Source programs)
[-] X [not] Extra (User definable element type)
Note:
Entering a particular element type in the FCBTYPE field will accelerate the selection process for a large PLAM library with many different element types.
See also the NO (Names Only) User Option on page 4-.
FMS Library Elements:
[-] S [not] SAM
[-] I [not] ISAM
[-] U [not] Undefined (Free record format)
Selection Mask : VOLUME
Selection of Files on a particular Medium/Public Volume Set
PUBLIC Files on public volumes.
PRDISC Files on private volumes.
TAPE Catalog entries for tape files.
-TAPE All files except tape files.
FGG File generation groups (Index entries + generations).
-FGG All files except file generations and the respective index entries.
:x: All files on the specified Public Volume Set.
vsn All files occupying space, or for whom a catalog entry exists reserving space on the specified VSN (public or private).
-vsn Files that do not occupy any space on the specified VSN.
vsnT All files stored on a tape with the specified VSN.
For the vsnT option, the Volume Serial Number must be given in full 6 digit form (if necessary, padded with leading zeroes).
VSN with Wildcards
/ stands for any character at that position in the VSN (analogous to the FSTAT command).
Examples:
//A/// All files occupying space on disks, the third letter of whose VSN is an 'A'.
-PVT/// All files not occupying space on a disk whose VSN begins with the string 'PVT'.
1/////T All files on tape whose VSN begins with the number 1.
Note:
If a file is located on a private disk or tape, then it will be flagged in the file list with an asterisk (*) in the first position of the LASTP column.
Selection Mask : SHARE / NONSHARE
Selection according to the SHARE Attribute
S Files / Job variables cataloged as SHARE=YES
Share=Yes files can also be selected by entering Y .
N Files / Job variables cataloged as SHARE=NO
X Files cataloged as SHARE=SPECIAL
SHARE=SPECIAL assumes SHARE=YES, as well as allowing access by the userid $SERVICE.
Notes:
The SHARE=YES characteristic is flagged in the file list with an asterisk before the FCBTYPE.
The SHARE=SPECIAL characteristic is flagged in the file list with the '#' character before the FCBTYPE.
Selection Mask : ACCESS
Selection according to ACCESS Characteristics
R Files / Job variables cataloged as ACCESS=READ
W Files / Job variables cataloged as ACCESS=WRITE
Note:
The characteristic ACCESS=READ is flagged in the file list as an asterisk in the PASS column.
Selection Mask : PASS
Selection of Files / Job variables / PLAM Library Elements according to a Password Type.
W Files / Job variables / PLAM elements with a WRITE password.
R Files / Job variables / PLAM elements with a READ password.
E Files / PLAM elements with an EXEC password.
X | Y Files / Job variables / PLAM elements with any password.
N Files / Job variables / PLAM elements with no password.
Selection Mask : SORT OPTION
Specify Sort Conditions for the File List
Normally, the file list is sorted by name in ascending order. Another field can be specified as the sort criterium by utilising the SORT OPTION. The sort order (ascending/descending) can also be specified. Any identical items are then sorted by name in ascending order.
AGE | NAME [(o,l)] | SIZE | USER | NONE [, A | D ]
NAME [(o,l)] The file list is sorted according to the full file or element name (Standard). Specifying optional parameters (o,l), the names can be sorted on a portion of the file or element name. o specifies the offset, and l the length of the partial field. Standard: NAME(1,44).
Example: With PLAM libraries, specifying Sort Option NAME(3,40) will result in a sorted list whereby elements are sorted by name and then by type.
AGE The file list is sorted according to AGE, or DATE. The time of the last amendment of PLAM library elements is taken into account when sorting.
SIZE The file list is sorted on the contents of the first column (LASTP or ALLOC for files, SPACE for libraries).
USER If a USER OPTION is also specified when selecting files, the sorting is done on the value in the column specified in this option. If no USER OPTION is specified, this sort option has no effect.
NONE The file/element list is displayed unsorted.
A Ascending sort order (Standard).
D Descending sort order.
Note:
The SORT OPTION field is pre-filled with the standard sort sequence if it differs from NAME,A. The standard sort sequence can be set with the SO command (see page 18-), or via the SET mask. The contents of the SORT OPTION field is temporary, and is not saved. See also the SORT command on page 7- regarding dynamic resorting of the file list.
Selection Mask : DOCUMENTATION
The purpose of this field is not for file or library element selection. The name of a file can be specified here, to which the files or library elements that appear on screen can be saved in a printable form.
file The file list should be saved to a file with the specified name. This file can be printed with SPACE=E.
file, E A documentation file that already exists will be opened in EXTEND mode.
file, INF File descriptions that were entered in a CFS data catalog with the IM Action Code (see Chapter 13, "CFS File Information System") will be transfered to the documentation file as well. Only the first 52 non-blank characters will be transfered. In this way, the print positions up to column 132 of each line will be filled with the beginning of the respective file descriptions.
file, INF, ALL [, SKIP]
As above, but the full file description will appear in the list.
SKIP The SKIP option will suppress empty lines in the list.
file, INF, FORM= [f | NO] [, SKIP]
Only those pages will be transfered from the description that contain the format f (one- to three- digit alphanumeric description, see page 13-), or that have no format (FORM=NO).
Notes:
If nothing is entered in this field, then in ADOC mode (Automatic Documentation File, equivalent to the ADOC/NADOC command), the file list will be written to a standard temporary file with the name '#CFS.SAVELIST.[jobname|tsn]' tsn will be used if no job name exists. The prefix '#CFS.SAVELIST.' can be changed by the systems administrator.
If the documentation file is to be used to swop quickly between two file lists (RL function), or for selection according to multiple criteria in different steps (OLDLIST), refer also to the RL and OLDLIST options in the FILENAME-SELECT field on page 4-. Also: SL/RL (Save List/Restore List) commands on page 7-/7-, ADOC (Automatic Documentation) and DOC parameters on pages 18- and 18-.
Selection Mask : USER OPTION
The User Options described below allow other, freely selectable file attributes to be displayed, in addition to those displayed by CFS as standard. The selection can also be influenced by these attributes, if a selection condition is specified. Multiple User Options should be separated by commas. Up to five User Options may be specified.
The value for the User Option specified first is displayed in its own User Option column in the file list. The values for the second, third and fourth User Options, if specified, will replace the PASS, AGE and LASTP (SPACE) columns. The fifth User Option can only be used for selection purposes, since its value cannot be displayed.
The user can define one or more User Options as standard User Options. Full information can be found on page 18-.
Examples:
ALLO2;ALCNT;EXTNT;ALLOC
Here, the User Option is used to display the size of the secondary allocation (ALLO2). The PASS column will contain the number of secondary allocations (ALCNT), the AGE column will contain the number of extents (EXTNT), and the LASTP column will contain the amount of space reserved for the file (ALLOC).
ALCNT;EXTNT;;ALLOC
Here, the User Option column contains the number of secondary allocations (ALCNT), and the PASS column contains the number of extents (EXTNT). The AGE column is not overwritten (;;). The LASTP column will contain the amount of allocated space (ALLOC).
;;;VSN
This specification results in the first column of the file list (LASTP) containing the VSN of each file. The AGE and PAS columns are not affected.
Two successive semicolons ";;" cause the respective columns of the file list not to be overwritten with a User Option. See the last two examples.
When entering selection parameters, the value x may be specified alone instead of =x. The "=" sign will be substituted by CFS.
The Access Counter for a file is incremented by 1 up to a maximum of 255 for every read or write access.
Selection parameter: >x | <x | =x
This User Option indicates whether a Full Access Control List (FACL) has been defined for this file.
Selection parameter: Y | N
ADMINFO Administrator Information (from OSD V3.0).
This User Option displays the contents of the Administrator Information for the file. The ONXSET ADMINFO Variable Action (see page 5-) or the ADM-INFORMATION parameter to the /MODIFY-FILE-ATTR command can be used by the system administrator to store up to eight bytes of Administrator Information text for the file.
Selection parameter: Y | N | 'info'
Y | N Administrator Information available ? Yes/No
'info' Select all files whose Administrator Information contains the specified value.
ALCNT Secondary Allocation Counter.
The Secondary Allocation Counter displays the number of times a secondary allocation of disk space has been performed.
Selection parameter: >x | <x | =x
Number of PAM pages for the secondary allocation. ALLO2 is always a multiple of 3.
Selection parameter: >x | <x | =x
The total disk space allocated to a file is displayed. The first column of the file list normally displays the actual space used by the file (Last Page). To display the allocated, but presently unused disk space, see the FREE User Option on page 4-.
Selection parameter: >x | <x | =x
ATTR For PLAM library elements: File attributes.
This User Option displays the Fcbtype and Recform characteristics that the PLAM library element would have as a BS2000 file.
Selection parameter: = S | I | P | V | F | SV | -SV
S: Sam | I: Isam | P: Pam | V: Recform=V | F: Recform=F | SV: Sam and Recform=V | -SV: not Sam or not Recform=V
Note:
Additional information for a particular library element to that provided by the ATTR User Option may be obtained by entering the Action Code F for the respective element (see page 6-).
Examples:
ATTR F all files stored in the library with Recform=F.
ATTR I all Isam files stored in the library.
ATTR -SV all files stored in the library which are either non-SAM files, or are not Recform=V.
Gives the information stored in the catalog for file access control via System Exit routines.
Selection parameter: NONE | SUCC | FAIL | ALL
AVAIL Availability of the file (from OSD V3.0).
This User Option indicates whether any special requirements exist for the security of the file. Files with increased security requirements may only be created by the system on specified media (e.g. DRV volumes).
The ONXSET AVAIL Variable Action (see page 5-), the AV[H|S] Action Code or the AVAILABILITY parameter of the /MODIFY-FILE-ATTR command can be used to modify the availability status of the file.
STD: The file has no particular availabilty requirements.
HIGH: The file is designated as high availability.
Selection parameter: H[IGH] | S[TD]
BACL[F] Basic Access Control List for files/Job variables/PLAM library elements.
This User Option displays if, and if so, in what form, an Access Control List has been defined for a file/Job variable/PLAM library element. More information about this can be found on page 6-. Using an Access Control List, more accurate control can be exercised over access to the respective data object than is possible with the global attributes Share=YES|NO, Access=WRITE|READ. The access can be restricted for writing (W), reading (R) or in the case of procedures and programs, executing (X). A list of userids may be created for each of the above access methods which will restrict access to everybody (-), the creator of the file (U), a defined user group (G), or all other users (O). Any combination of the above is possible.
Output format for the User Option: For each of the three access methods, REA, WRI, and EXE a three letter description of the access domains is displayed. UGO, for instance, would indicate that User, Group and Others all have access to the data object. U-- would indicate that only the owner (User), but not the Group or Others would have access to the data object. The first three letter combination represents read access (REA), the second for write access (WRI), and the right hand group for execute access (EXE). An example of the output format would be:
REA WRI EXE
UG- U-- UGO
F FSTAT-compatible output format. Instead of appearing in the format described above, the Access Control attributes will be displayed in an FSTAT-type format. The display will not be arranged according to the access method (see above), rather according to the three access domains, USER (OWNER), GROUP and OTHERS. The access rights of each domain will still be displayed in a 3 letter format. RWX, for example, implies that read, write and execute access is allowed for the data object. R-X will allow only read and execute access. An example of the output format is:
USR GRP OTH
RWX R-X ---
Selection parameter:
Y: All files/Job variables/PLAM library elements for which a Basic Access Control List exists will be selected.
N: All files/Job variables/PLAM library elements for which no Basic Access Control List exists.
[W ><= x] [, R ><= y] [, X ><= z]
W = Write, R = Read, X = Execute access.
The access domains N, U, G, O are ranked as follows: N < U < G < O, O > U > G > N. Example: see below.
x, y, z: N | U | G | O (None / Userid / Userid Group / Other users)
Selection can be according to one or more access methods simultaneously. Other domains may be specified sequentially by using an '=' sign.
[U = a] [, G = b] [, O = c]
U = User, G = Group, O = Others
a, b, c: R | W | X (Read / Write / Exec). Multiple access methods may be specified sequentially.
Examples:
BACL W>U,R>U
All files for which a user group greater than the owner (User) is allowed read and write access are selected. In contrast to the display of BACL characteristics in the FSTAT command, the abbreviated description of the domains is displayed, showing READ, WRITE and EXEC access.
BACLF G=RWX
All elements from a PLAM library are selected for which the user Group have read, write and execute access. BACLF: the display of the BACL characteristics is analogous to the FSTAT command representation i.e. the access rights of each of the domains, USER, GROUP, OTHERS, are displayed.
Note:
For further information concerning BACL, see page 6- (Action Codes for Amending Access Rights).
Selection parameter: A | B | C | D | E or >x | <x | =x
(x: A | B | C | D | E)
For example, 2 means a file blocked with the factor of 2 (STD,2).
Selection parameter: >x | <x | =x
This User Option is ony relevant for tape files. The number of blocks used by the file on the tape is displayed.
Selection parameter: >x | <x | =x
This User Option identifies if, and in what form, the Pam keys are stored as part of the file.
PAMK File with Pam keys which are stored in the area on disk reserved for them.
DATA File with Pam keys which are stored in a header at the beginning of each Pam page.
NO File without Pam keys.
Isam Files with BLKCTRL=DATA can be processed by NK Isam.
Selection parameter: =PAMKEY | =DATA | =NO
CATBL # of Catalog Block. Displays the PAM block number in the TSOSCAT under which the catalog entry for the respective file is stored.
Selection parameter: >x | <x | =x
All files are displayed whose catalog entries are contained in the catalog blocks specified.
Example:
CATBL>4711
Produces a list of all files within a userid whose catalog entries are stored in blocks >4711 in the TSOSCAT.
The system administrator can use the CATBL User Option to determine whether the catalog entry for a file is stored in a contiguous area, or if it is spread over more than one block.
CCS Name of the character set with which the file or PLAM element should be processed (as from BS2000 V11.0). The selection parameter Y | N can be used to select all files to be processed with a Coded Character Set, or those files for which no Coded Character Set has been defined.
Selection parameter: Y | N | [-]ccs-name
The internal catalog number of the file will be displayed as a four byte hexadecimal value. Every file possesses a unique CFID.
Selection parameter: >x | <x | =x
x represents an 8 character hexadecimal value in the form: X'...'
CREA For PLAM Library elements: Creation Date of Element.
Number of days since the element first appeared in the library. This date is not the same as the date the element was last amended.
Selection parameter: >x | <x | =x or
in Date format: >dd. [mm. [yy] ] | <dd. [mm. [yy] ] | =dd. [mm. [yy] ]
If mm.yy or yy is omitted, the current month and year will be substituted.
Notes:
When a library is reorganised, the CREA date of the element is lost. The CREA date of all elements will be the date of the reorganisation.
If, as in LMS, the User date should be used for the selection of PLAM elements, then the UDAT command should be used. See page 18-.
The DATE command (page 18-) will cause the Creation Date of an element to be displayed in the form of a date, and not as an age in number of days.
Since the User Option column in a file list is only 5 bytes wide, the date will be compressed into the form YMMDD. Y indicates the last digit of the year (i.e. 0 for 1990).
Examples:
CREA=0
All elements first appearing in the PLAM library today will be selected.
CREA<7
All elements inserted into the library within the last 7 days will be selected.
CREA<15.05.
All elements which were inserted into the library after the 15.05 of the current year will be selected.
DELDATE Deletion release date for file (from OSD V3.0).
The number of days, or the actual date in/from which the file may be deleted without reference to the protection attributes. Before this date, the file may still be modified at any time, and even deleted if not prohibited by the protection attributes.
The ONXSET DELDATE Variable Action (see page 5-), the DD Action Code or the FREE-FOR-DELETION parameter to the /MODIFY-FILE-ATTR command can be used to modify this date.
Selection parameter: >x | <x | =x or
in Date format: >|<|= dd. [mm. [yy] ]
If mm.yy or yy is omitted, the current month and year will be automatically substituted.
Notes:
The DATE command (see page 18-) will cause the Retention Period to be displayed as a date in the format YMMDD, and not as a number of days. In this case, Y represents the last digit of the year (e.g. 6 for 1996).
DELTA[1] Delta storage in PLAM librarys.
Delta storage means that different versions of the same element can be saved by only saving the differences to the preceding version. In contrast to a full save of the element, the delta technique achieves a significant reduction in the required storage space.
The Delta User Option achieves the following:
a) If the User Option DELTA, or DELTA Y is entered when selecting library elements, all available delta versions are displayed in the file list as an entry. Normally, i.e. if the DELTA User Option is not specified, or is specified in the form DELTA H, then only the highest version of an element is selected.
b) For each element version, the base version necessary for the Delta creation is displayed in the User Option column. Naturally the first version of an element has itself as a predecessor. The first version is flagged in the list with an asterisk (*).
DELTA: The base version is displayed according to the internal version counter (analogous to LMS with PAR TOC=D).
DELTA1: The last four digits of the actual version description of the base element is displayed.
c) If an element saved in Delta format is displayed in a file list, and is transfered to another PLAM library (where no element with this name exists) with a Variable Action ONXADD, then the element will be transfered in Delta format. Normally, i.e. without the Delta User Option, a delta-stored element will be transfered using ONXADD as a full element, so long as no element with this name exists in the target library.
Selection parameter: Y | H | N
Y Only elements of the PLAM library stored in Delta format will be selected. All versions of the element will be displayed in the file list.
H Only elements of the PLAM library stored in Delta format will be selected. Only the highest (current) version of each Delta element will be displayed in the file list.
N Only non-Delta format elements of the PLAM library will be selected.
DIWR Disk Write (as from BS2000 V11.0)
This User Option indicates whether or not the file is suitable for processing in DAB Store-in-Cache.
C: The file is suited to Store-in-Cache. The file data need only exist on the disk in a consistent state after a CLOSE (BS2000 default for temporary files).
I: The file is not suited for Store-in-Cache. The file also needs to exist in a consistent state on the disk, even after a system failure (BS2000 default for permanent files).
Selection parameter: =C | =I
An extent is a contiguous storage area on a disk in which the file, or a part of the file is stored.
Selection parameter: >x | <x | =x
DEVICE Device type (disk type) on which the file is stored.
This User Option indicates the device type of the disk or tape file. When specifying a particular device type, the VSN's of the selected files with this device type will be displayed as well.
Selection parameter: =device
Any disk or tape device, as they would appear in an FSTAT command, may be specified for device.
Search for a String in the Contents or Names of Files/Library Elements/ Job Variables
FIND [n,] param [=W datei [, E|O ] ] [, N] [, NO] [, C|NC] [, F] [, SKIPF] [, TYPE= t1, t2,...]
Selection of files/library elements/Job variables which contain one or more search items in their name or data contents.
The resulting records with their file names can also be written to a printable list file (=W file). A value will appear in the file list in the User Option column which will indicate the number of records in which the specified search condition was found at least once.
n Restrict the search to the first n records. (Standard: all records).
param simple or multiple search statement.
simple search statement: [ col ] [p] item
col Column range in which the search item should begin.
:col1-col2: The first character of the search string must begin in the column range between col1 and col2.
:col1: The string must begin in col1.
>:col1: | <:col1: The string is sought in the range from col1 to the end of the record (>), or from the beginning of the record to col1 (<).
Standard: The search is carried out from the beginning of each record to the end.
p > Search for a character string > item
< Search for a character string < item
- Search for a character string not equal to item
Standard: Search for a character string = item
item Search string: C'string' | L'string' | X'string'
C'string' can be abbreviated to 'string'.
L'string': Lowercase letters in string are not converted to uppercase.
If string contains single quotes ('), these should be entered twice ('').
Multiple Search - Format 1: param [op param] [op param] .....
param simple search argument following the syntax described above.
op Logical operator joining the two simple search arguments.
, Or operator.
+ And operator.
*[n] Wildcard operator: An And operation, but in addition, the second search string must appear after the first in the record. Optionally, there must be n positions between the first and second search strings.
Any number of search arguments may be joined by Or/And/Wildcard operators.
Notes:
The And/Or operation is restricted to a record. This means that both of the search strings must occur in the same record.
A full description of the logical operators can be found on page 8-.
Multiple Search - Format 2: ( )
Entering () will display a special search mask. This mask provides the user with 18 lines in which to enter a series of complex search arguments. A description of this mask may be found on page 8-.
Multiple Search - Format 3: %name | %? [, jrsave]
%name is a description of a parameter set which contains a complex set of search arguments which had been previously been saved using the SP %name command. For further information, see page 8-.
%?: All available parameter sets will be displayed in a list. One of those displayed can be selected by marking it.
jrsave is the name of file to which the parameter set is saved. Standard: CFS.JRSAVE [.jobname] .
Multiple Search - Format 4: ( s-fil )
s-fil is the name of a SAM file in which the search arguments are contained. For further information, see page 8-.
Multiple Search - Format 5: ? | ?,%name
Entering ? will display the last search argument to have been used.
Entering ?,%name will display the search mask pre-filled with the search arguments contained in %name (see Format 2).
Writing away the Search Results
=W file [, E | O ] [, N ] [, NO ] [, NC]
The search results are written away to a printable output file. The names of the respective data objects are also written to the file. If the NO option (see below) is specified, only the names are saved.
E The Write file is opened with Open=Extend.
O The Write file is opened with Open=Output.
The =W file [, E | O ] option can also be specified in the search mask (see above: Multiple Search - Format 2), or in the s-fil (see above: Multiple Search - Format 4) at the end of the last search string.
FIND ..., N The names of the files/library elements currently being searched are displayed on the screen.
FIND ..., NO Names Only. Only the names of the files/library elements are searched for the specified string. The names of the files or elements which contain the string are written to the Write file. The primary area of application for the NO option is in searching multiple libraries for elements of a particular name. For a demonstration of this, see Example 2 below.
FIND ..., NC No Check for Continuation. Checking for continuation of a BS2000 command, or a macro or source program statement, is suppressed.
Normally, i.e. if the NC option is not specified, procedure/macro/source records are treated as a logical unit if they are linked with a continuation character. If the search string is found in such a record, then all lines forming the logical record are written to the Write file. The line containing the search item is flagged with an 'X' in the second column.
FIND ..., C All procedure/macro/source code records linked with a continuation character will be treated as a logical unit. This means that, for example, a compound search string such as 'FCB'*'BLKCTRL=DATA' will be flagged as a hit, even if the partial string 'FCB' occurs in one line, and the partial string 'BLKCTRL=DATA' in a continuation line.
If the option of writing to a file was selected, all records belonging to a logical unit which was flagged as a hit will be written. If the search string was contained wholly in a partial record, then this partial record will be flagged with an 'X' in column 2.
FIND ..., F Find First. The search will be terminated after the first item has been found. One hit will be recorded. This provides a quick way of determining whether the data object contains the specified string or not. By default, the whole file is searched for the string, even after a hit has been found. In this case, the number of hits will show the correct value.
FIND ..., SKIPF
Skip Found. The data object in which the search string does not appear in any record will be transferred to the list.
FIND ..., TYPE=t1,t2, ...
This parameter is only relevant for searching files which represent PLAM libraries.
The search will then be restricted to elements of the specific type within that library. Example: TYPE=J or TYPE=J,S
By default, all elements in the library will be searched, irrespective of type.
Notes:
The REWR command (Rewriting from the Write file to the original source file) should be noted in conjunction with the Write option (=W ..). This Rewrite command (see page 7-) provides the reverse mechanism to the Write option.
Files saved to the Write file will not be sorted in alphabetical order.
If neither the E nor the O option (Extend/Overwrite) is specified after the name of the Write file, then the following rules apply:
If the Write file is being accessed for the first time in this current CFS process, then it will always be opened in O (Overwrite) mode; i.e. the file will be created or overwritten.
If the same file is specified in successive selection runs, then it will be opened in Extend mode.
The E/O option can be used to set an open mode that differs from the standard value.
Tape files and migrated HSMS files are excluded from the FIND user option.
CFS will search BS2000 files that represent libraries at the library element level, and not at the individual record or block level. The FIND User Option will provide the total number of occurrences of a particular search string across all elements in a library, or the number of library element names.
Examples:
FIND 'FLAG'*'STATEMENTS'=W FIL.FLAGS
All files/library elements are searched for the occurrence of at least one record which contains the string 'FLAG' and somewhere after that the string 'STATEMENTS'. The resulting records are written to the SAM file, FIL.FLAGS.
FIND 'A1015'=W L.FNDLIST,NO
Problem: A source program named A1015 exists in multiple libraries of the owners userid, or across the system, and needs to be found. The libraries are first pulled into a list by specifying LIB in the FILENAME-SELECT field. The FIND User Option specified above can then be used to search the names of all elements of the libraries for the occurrence of the string 'A1015'. The element name providing a search hit, together with its respective library name is written to the file L.FINDLIST. Only those libraries will be listed in the file list that contain at least one element with the specified name. The user can then display the table of contents of each library with the NP or NPF Action Code.
FIND :1:'$T'
The Job variable must begin in column 1 with '$T' (i.e. Monitor Job variables indicating a normal job termination).
Further examples of search arguments, in particular the logical joining of multiple search arguments, can be found in Chapter 8 "CFS Display/Editor" on pages 8- to 8-.
FREE[%][ISAM][,PLAM] Number of free PAM pages for the file, i.e. space allocated, but not yet used. Free = Allocated Space - Last Page
% Percentage of free PAM pages compared to the full size of the file.
ISAM Behaves like an ISAM file, so that the number of unused data blocks will be displayed, with the help of the SHOW-FREE-ISAM-SPACE command. The ISAM option can only be issued under the TSOS userid. The FSC software product SPACEOPT V2.0 must additionally be installed.
PLAM If the file is actually a PLAM library, the free space within the library is added to the number of free PAM pages. The PLAM option can be utilised as from LMS Version 3.0.
Selection parameter: >x | <x | =x
GUARD Guard Protection for files/PLAM library elements (from BS2000 V11.0).
Note: Data objects with Guard protection are flagged with a '$' character before the FCB type.
R Read access is protected with Guard
If N appears instead of R, Guard has not been set for Read access, i.e the data object cannot be read.
W Write access is protected with Guard
If N appears instead of W, Guard has not been set for Write access, i.e the data object cannot be modified.
X Execute access is protected with Guard
If N appears instead of X, Guard has not been set for Execute access, i.e the data object cannot be executed.
Using the Y | N selection parameter, all files can be selected for which Guard protection is or is not set.
The selection parameters [-] R|W|E [=name] can be used to select all files for which a particular access type is or is not protected with any Guard, or with a Guard with the specified name. The pseudo-Guard name 'NONE' can be used to select data objects that are protected by Guard, but which have no Guard attributes defined for that particular access type. No access of the specified kind (R/W/X) is thus possible.
Selection parameter: Y | N | [-]R|W|E [=name]
Examples:
GUARD W
All files or library elements that are write-protected with Guard will be selected.
GUARD R=$TSOS.READGUARD
All files or library elements which are read-protected with a Guard named $TSOS.READGUARD will be selected.
GUARD X=NONE
All files or library elements protected by Guard, and for which no Guard has been defined for execution, will be selected. These selected data objects cannot be executed.
HOLD Hold-Status für PLAM-Elemente. As from LMS Version 3.0, library elements can be loaned. This means that the userid of the borrower will be marked in the library table of contents. Only users logged in under this userid can amend or copy an identical or higher version of this element.
The HOLD User Option indicates the loan status of the individual elements. 'N' indicates that the element has not been loaned. If the element has been loaned, the userid of the borrower will be displayed.
Selection parameter: N | Y [:userid] (userid without $ and full stop)
Entering the selection parameter Y will result in all elements on loan being selected.
Y:userid will select all library elements on loan from a selected userid.
Notes:
Library elements can be loaned by means of the HOLD Action Code. The loan status can be reset with NHOLD. For further information, see page 6-.
For a full description of the HOLD function, refer to the LMS User Manual Version 3.0, chapter 3 (Elements), Section 3.6 (Element/Data Protection), "Overview of necessary Access Rights for LMS Actions".
HSMS HSMS Storage Level. The file migration status will be displayed.
Files that are not accessed with either a read or write operation within a specified time frame will automatically be migrated to the background storage level 1 by HSMS (Hierarchical Storage Management System). If it is also not accessed here within the specified time limit, it is automatically migrated to level 2. Storage level 1 may, for example, consist of slow disk storage. Level 2 normally consisits of tape cartridges.
S0: The file is located in the public area (foreground).
S1: The file is located in background level 1
S2: The file is located in background level 2.
Selection parameter: Sn or >Sn | <Sn ( n = 0, 1, 2 )
Notes:
Migrated files are flagged in the file list by a '#' character is the LASTP column.
See also page 4- (MIGRATE User Option ), and 6- (MA/ML/MI Action Codes).
INF Indicates whether or not there is a CFS information catalog entry for the file or Job variable, and if so, which format was used. (See I/IM Action Codes on page 6- and Chapter 13 "CFS File Information System").
Selection parameter: [Y | N | S] [, FORM=xxx] [, 'string']
Y | N Inf Text available ? Yes/No
S Same as Y. Additionally, the first 15 bytes of the information text is displayed in the file list.
FORM=xxx Selection according to the format used at the time of entry.
'string' Selection of all files/Job variables/library elements that contain the specified search string in their information text.
Notes:
If the FORM= parameter is specified, or if the selection is made on a search string, then the selection parameter Y is substituted internally by CFS, and need not be specified by the user.
More than one selection parameter may be specified. The individual parameters should be separated by commas.
FORM=SX0,'UTM' for example, selects all file/library elements for which documentation text via the user-defined mask SX0 was entered. In addition, the text must contain the string 'UTM'. The text is not case sensitive.
INDEX Displays the number of created indices for an ISAM file. For KISAM files and NKISAM files without secondary indices, the value of 1 is displayed, since these files only have a single index structure. For NKISAM files with n secondary indices (BS2000 command CREate Alternate Index), the value n+1 is output.
Selection parameter: >x | <x | =x
Notes:
Specifying a value greater than 1 will select all those NKISAM files for which at least 1 secondary index has been created.
For complete name and keypos/keylen information of all secondary indices of a file, the Action Code SI (Show Alternate Index, see page 6-) can be given.
To display an NKISAM file in secondary key sequence, the DA command (Data Access, see page 8-) can be used.
IOP Disk IO Performance (as from BS2000 V11.0)
This User Option indicates whether or not the file is suitable for processing in connection with a cache.
STD: The file should not be processed with a cache.
HIGH: The file is well suited to cache operation, and should, whenever possible, be processed with a cache.
VHIGH: The file is very well suited to cache operation. Whenever possible, all pages should be stored in memory.
Selection parameter: =STD | =HIGH | =VHIGH
IOU Disk IO Usage (as from BS2000 V11.0)
This User Option indicates to which operation the file's IO Performance attribute (IO-Performance, see above) refers.
RW: The performance attribute refers to both read and write operations.
W: The performance attribute refers only to write operations.
R: The performance attribute refers only to read operations.
Selection parameter: =RW | =W | =R
JVREF Job variable Reference. Indicates whether, at that particular moment, there are any active references to the Job variable (Monitoring Job variable / ON command).
Selection parameter: R | N (Referenced/Not referenced)
KEYLEN Length of ISAM file key.
Selection parameter: >x | <x | =x
Example:
KEYLEN>8
All ISAM files with a key length greater than 8 bytes long will be selected.
KEYPOS Position of ISAM file key.
Selection parameter: >x | <x | =x
Examples:
KEYPOS>5
All ISAM files whose key starts at the beginning of the record will be selected.
KEYPOS;KEYLEN>0
All ISAM files will be selected, with the Keypos and Keylen being displayed as attributes.
LACC[A] Last Access Date. Time in number of days since the file or library element was last accessed in read or write mode.
A The parameter A will result, as from OSD V1.0, in the file or library element AGE and TIME fields being filled with the Last Access Date and Last Access Time. The age of the data object will be displayed in the User Option column.
Selection parameter: >x | <x | =x or
in Date format: >|<|= dd. [mm. [yy] ]
If mm.yy or yy is omitted, the current month and year will be automatically supplied.
Notes:
In order to utilse the LACC User Option for PLAM library elements, the installed version of LMS must be 3.0 or above. The updating of the Last Access Date must be activated for the library. This can be done by entering the LAKL Action Code for the library itself, or for any library element. The system administrator can set an indicator in the CFSMAIN module that will cause new libraries created by CFS to utilise the Last Access Date Option.
The DATE command (page 18-) causes the Last Access Date to be displayed in date form, rather than age in days.
Examples:
LACC=0
All files are selected that have been accessed today, either read or write.
LACC>7
All files are selected that were last accessed more than 7 days ago.
LACC<15.05.
All files are selected that were last accessed after the 15.05. of the current year.
MANCLASS This User Option indicates whether the HSMS functions of data security, archiving, and long-term storage are controlled by means of a HSMS-defined Management Class. This User Option is available from OSD V3.0.
The ONXSET MANCLASS Variable action (see page 5-) or the MANAGEMENT-CLASS parameter to the /MODIFY-FILE-ATTR command can be used to modify the Management Class attribute of SM files.
Selection parameter: class | N[ONE]
MAXRL Length of the longest record in the file / library element / Job variable.
This User Option will cause all records of the file/library element to be read sequentially from the first record to the last, in order to determine the length of the longest record. Files with Recform=F, or Rectype=PAM, as well as tape files are excluded, since the record length can be determined from the catalog entry.
Selection parameter: >x | <x | =x
MIGRATE Suitability of files to be migrated to background storage by the Hierarchical Storage Management System (HSMS).
A Migration Allowed.
I Migration Inhibited.
Selection parameter: A | I
For further information regarding HSMS, see page 4- (User Option HSMS) and page 6- (Action-Codes MA/ML/MI) .
NO Names Only: Only the names of the selected files/library elements/Job variables are displayed in the file list. The other characteristics, such as LASTP, TYPE, AGE, etc. are replaced in the file list by blanks.
Notes:
This User Option results in a significant reduction in the seek times when selections are made across the whole system, within a large userid, or in a large PLAM library.
For additional information on minimising the search times in PLAM libraries, see the note on page 4-.
When using the NO (Names Only) User Option, selection criteria may only be entered in the FILENAME-SELECT and USER-ID fields. Only J (Job variable), or a PLAM library element type may be entered in the FCBTYPE field. If a selection condition is entered in any other field, the NO User Option will be ignored.
The U (Update File list)Action Code should be noted in connection with the NO User Option. This Action Code will enter the rest of the file attributes for the flagged data objects.
NOC No Catid. When selecting files using the FSTAT option in the FILENAME-SELECT field, the preceding Catids are removed from the file names, and so do not appear in the file list.
This option may be needed when saving files with ARCHIVE. If the Archive statement PARAM CATID=NO is specified, the names of the files to be saved may not contain catid's.
OPEN This User Option displays all open files under the current userid. A prerequisite for this User Option is that the system administrator has first started the CFS-Holdertask under TSOS (/ENTER CFS.S. LMSLIB(CFSHT) ).
Selection parameter: [ I | O | E | N | PR | SEC[EX] ] [ ... ] [, TSN=tsn] [, LINK [=link]] [, POOL=isam-pool ] [,D-IO[S] [><=x] [,INT=sec] [, RW] ]
I all files opened for Input
O all files opened for Output, Outin, Inout, Update, Extend
E all files opened with Exec (loaded programs, SDF syntax files)
N all files assigned with a FILE command, but not yet, or no longer, open (inactive TFT entries)
PR all files locked by a print command (PR ...,LOCK=YES)
SEC all files reserved with a shareable or exclusive SECURE command
Standard: IOSECPR
The options I O E N PR SEC[EX] may be used in any combination, and in any order (e.g. IO / OIE / IOENSEC).
TSN=tsn Display all TFT entries of the specified TSN. The description of a system task can be specified instead of a TSN. Example: TSN=M.
LINK The link names used to open the files will be displayed. Standard: No file link names will be displayed.
link Only those files with the specified link name will be selected and displayed. Example: LINK=ECERDLOD will select all loaded programs.
POOL=isam-pool
By specifying a pool name, all NK-ISAM files belonging to that pool will be selected.
D-IO [><=x]
The number of IO's incurred by each file during a particular time interval (default = 30 seconds) will be displayed in the AGE column. In contrast to the D-IOS option (see below), files opened by more than one task will be displayed for each instance in the list, along with the respective TSN and the number of IO's. All files that have used less than, more than, or exactly x IO's can be selected by entering ><=x . For example: OPENS D-IO>0
D-IOS [><=x]
The number of IO's incurred by each file during a particular time interval (default = 30 seconds) will be displayed in the AGE column. Files which have been opened by more than one task will have the total number of IO's performed by all tasks displayed. '****' will appear in the TSN column, indicating that the IO value does not represent one particular task. All files that have used less than, more than, or exactly x IO's can be selected by entering ><=x .
Example:
User Option: OPENS,D-IOS>0 and Sort Option: AGE,D
The names of the open files will be selected and sorted in ascending order by number of IO's used.
INT=sec
Length of the interval for D-IO, in seconds. Standard: INT=30.
In order to calculate the IO values, CFS will be placed in a wait state for the specified number of seconds.
RW The number of read and write IO's incurred by each file will be displayed in the first two columns in place of LASTP and TYP.
If no selection parameters are specified, all files opened in input or output mode will be displayed. The following files will not be displayed:
- those opened in EXEC mode (loaded programs, SDF syntax files)
- those assigned with a File command, but not yet opened
Output of the OPEN User Option:
The TSN of the task that opened the file (or that which issued the File command) will be displayed in the User Option column. Next to the TSN, the mode in which the file was opened will be displayed:
I Input
O Output
IO Inout
OI Outin
U Update
E Extend
EX Exec
R Reverse
_ Inactive TFT entry. File is presently not open.
S File is reserved with a shareable Secure command
SE File is reserved with an exclusive Secure command
PR File is being printed with PRINT ...,LOCK=YES
An asterisk (*) in front of the open mode indicates that the file has been opened with SHARUPD=YES.
Open NK-ISAM files will have the name of the ISAM pool displayed in the first column of the file list (LASTP column).
Notes:
If no SORT OPTION was specified, the files selected by the OPEN User Option will be listed in TSN order, and then in the order of the FILE commands. A file can appear more than once in the list, if it was opened by more than one task.
Displaying all TSN's that have opened a particular file can be achieved by executing an OPN Action Code for the file. The OPN Action Code will display, in contrast to the OPEN User Option, the TSN's belonging to userid's other than the current userid.
After files have been selected with the OPEN User Option, the Action Code S will perform a /STA tsn command for the specified TSN.
The current contents of SAM and PAM files opened in output mode can be displayed with the Action Code D.
IO calculation with the D-IO option: the KDCMON program cannot be used for the duration of the IO evaluation. Conversely, the D-IO option cannot be used during a KDCMON measurement period. A D-IO evaluation can also not be performed by more than one user at a time. A "KDCMON active" message will be displayed if a second user attempts to use the option. If this message appears, and KDCMON is not loaded, the lock situation can be resolved by specifying the X-IO option instead of D-IO.
A file list created with D-IO can be sorted with the CFS command SORT D-IO,D on ascending IO usage. Sorting can also be achieved by entering AGE,D in the SORT OPTION field of the selection mask.
Examples:
OPEN O
All files opened in output mode by tasks running under the current userid.
OPEN PR
All files locked with a print command issued with a LOCK=YES parameter.
OPEN SEC
All files requested or secured with a Secure command.
OPEN TSN=9011
All TFT entries assigned to TSN 9011 that exist at the time of selection.
OPEN IOEN,LINK
All active or inactive TFT entries, together with the respective link names.
OPEN POOL=$TASK01
All NK-ISAM files attached to the pool $TASK01.
File List Format for OPEN User Option:
With a mouseclick you get a describtion of the screen item.
OPEN mit IO-Statistik:
With a mouseclick you get a describtion of the screen item.
Select all active Monitor Job Variables
ONEVT All Monitor Job variables under the current userid which are presently being monitored by means of an ONEVT command or macro will be displayed. The ONEVT User option can also be made available in a limited form to non-TSOS users if the system administrator has started a CFS holder task from TSOS (/ENTER CFS.S.LMSLIB (CFSHT) ).
Selection parameter: none
Output from the ONEVT User Option:
The TSN's of those tasks monitoring a Job variable with an ONEVT command will be displayed in the User Option column. If multiple tasks are monitoring a single Job variable, the JV name will appear in the list for each task seperately.
Notes:
If no SORT OPTION has been specified, the Job variables selected by specifying the ONEVT User Option will be displayed in TSN order. A Job variable can appear more than once in the list if it is being monitored by different tasks.
Selecting Job variables with the ONEVT User Option can be combined with all other conditions, particularly the selection criteria specified in the FILENAME-SELECT field.
After selecting Job variables with the ONEVT User Option, the status of the TSN's listed can be requested by entering the Action Code S alongside the entry.
Save Open Files under ARCHIVE ?
OPNBACK For each file an indicator will be set to show whether or not that file will be included in an ARCHIVE run while in an open state (Open=Output/Update/ Extend/Inout/Outin). A prerequisite for this is that PARAM OLS=YES has been specified. UDS files can be saved while in Open Output mode, and is indicated in byte IDCEDMS2 (IDCEFAR indicator) in the system catalog. Open UDS files can be saved, and the IDCEDMS2 byte (IDCEFAR indicator) can be permanently set in the system catalog.
This indicator can be set or reset under CFS for any user files by means of the ONXOPNBACK [=Y|N] Variable Action. For further information about OPNBACK functions, see page 5-.
Selection parameter: = Y | N
PASS Current passwords for File/Job variable/Library element.
This User Option indicates if any READ/WRITE/EXEC passwords are defined for the data object. This option enables the BACL's and passwords to be displayed in the same list. To achieve this, enter BACL;;PASS in the USER OPTION field. The type of password will then be displayed in the AGE column.
Selection parameter: W | R | E | X | Y | N
The selection parameter can be given in the PASS field of the selection mask.
RECNT Number of records (blocks) in a file/library element.
This User Option will cause all files/library elements to be read sequentially from the first to the last record.
PAM files are an exception. The number of data blocks can be ascertained from the catalog entry.
Selection parameter: >x | <x | =x
RECFORM Record Format of the File.
V variable record length
F fixed, with RECSIZE being displayed
U undefined
Selection parameter: V|U|F [>x|<x|=x]
The optional parameter n can be used to select all files with a fixed record length of n (RECFORM=F,RECSIZE=n).
RECSIZE Record length of the file.
The record length of the file, as determined by the catalog entry will be displayed. The Recform parameter (F/V) will also be displayed.
Selection parameter: >x | <x | =x
Example:
RECSIZE>0
Select all files whose Recsize value is greater than 0, both Recform=F and Recform=V.
RELSP Ignore Space Minus ? (as from BS2000 V11.0)
N: Commands to release unneccessary disk space (e.g. FILE ..,SPACE=-nnn) will be executed for the file.
Y: Releasing unneccessary space is not possible for the file, on account of the catalog entry.
Selection parameter: =Y | =N
REPAIR File in an inconsistent state?
Y The file is in an inconsistent state due to a system crash, and cannot be opened (e.g. by ARCHIVE). To repair the file, the VERIFY ...,REPAIR=YES command must be issued.
N The file is not damaged.
Selection parameter: =Y | =N
RETPD Retention Period. Number of days until the expiry date of the file is reached.
Selection parameter: >x | <x | =x or
in Date format: >dd. [mm. [yy] ] | <dd. [mm. [yy] ] | =dd. [mm. [yy] ]
If mm.yy or yy is omitted, the current month and year will be substituted.
Notes:
The DATE command (page 18-) allows the Retention Period to be displayed in date format, rather than as an age in days. Since the User Option column is only 5 bytes wide, the date will be truncated to YMMDD. Y represents the last digit of the year (e.g. 0 for 1990).
When displaying Archive directory entries, the RETPD User Option will display the expiry date of the data media (tape or cassette) on which the file was saved.
Examples:
RETPD=0
Select all files with an expiry date of today; i.e. those files that may be overwritten today.
RETPD>7
Select all files with a retention period of more than 7 days (calculated from today).
RETPD>01.01.95
Select all files with an expiry date in 1995 or later.
Selection according to a particular record type in a PLAM library element.
Selection parameter (mandatory): >x | <x | =x
x : Number between 0 and 255.
Example:
RT=26
Select all elements from a PLAM library that contain REP records (Record type 26). This record type normally only appear in R (Relocatable) type records. These may be displayed and/or modified with the D/M Action Codes.
S0MIGR This User Option indicates whether or not the file within the S0 level may be stored on another Volume set of the same SMS pubset. The storage can be achieved either explicitly with HSMS or implicitly through BS2000.
This User Option is available from OSD V3.0.
The S0 migratability of SM files can be modified by the ONXSET S0MIGR Variable Action (see page 5-) or by means of the S0-MIGRATION parameter to the /MODIFY-FILE-ATTR command.
A Allowed. Migration is allowed
F Forbidden. Migration is prohibited
Selection parameter: A | F
SAVE Is the file to be saved in the next ARCHIVE run, following modification of the data? If the modified file has already been saved in a previous ARCHIVE run, then the catalog entry of the file will have an identical Current Version # and Backup Version # .
Selection parameter: Y | N (Y: File will be saved with ARCHIVE following modifications).
SAVE If with the option DIR in the field FILENAME-SELECT entries of an Archive-Directory are selected, User Option SAVE without parameters has the effect that all Save versions of files/ jobvariables will be displayed in the file list. Ba default only the latest (most recent) save version of each data object will be shown in the file list.
Wit SAVE CNS there will be also displayed all CNS-entries ("Catalogued but not Saved") in the file list.
SDAT For PLAM library elements:
The System Date of the element is recalculated as the number of days to today.
5 means, for example, that the element was last written to 5 days ago.
Selection parameter: >x | <x | =x or
in Date format: >dd. [mm. [yy] ] | <dd. [mm. [yy] ] | =dd. [mm. [yy] ]
If mm.yy or yy are omitted, then the current month and year will be substituted.
Notes:
When reorganising the library, the System Date of all elements will be updated to today's date, but the original User Date will be maintained.
For PLAM elements, the System Date has the same effect as the Creation Date for files, i.e. it is automatically updated by the system each time the element is written to. The User Date can be set by the user (see Variable Action ONXSETUDAT).
If the selection of PLAM library elements is to be made according to the System Date instead of the User Date, the SDAT command should be used (See page 18-).
Using the DATE command (page 18-) will result in the System Date of the library element being displayed in date form, and not as an age in days. Since the User Option column is only 5 bytes wide, the date will be truncated to YMMDD. Y is the last digit of the year (0, for example, represents 1990).
SNAM For PLAM library elements:
Selection proceeds according to a particular secondary name (or their attributes) in the table of contents of the PLAM library.
Selection parameter (mandatory):
sname specific secondary name, any attribute
sname/attr specific secondary name, specific attribute
/attr any secondary name with this attribute
-sname specific secondary name must not appear
-/attr specific attribute must not appear
STOCLASS This User Option indicates whether a particular Storage Class has been defined for the file. A Storage Class determines the storage location of the file within a SM pubset.
This User Option is available from OSD V3.0.
The ONXSET STOCLASS Variable Action (see page 5-) or the STORAGE-CLASS parameter to the /MODIFY-FILE-ATTR command can be used to modify the Storage Class of the file.
Selection parameter: N | Y | class
TIME For PLAM library elements:
Selection according to the time of the last update.
TIMEX For files: the time of the last modification will be displayed as a six digit value, i.e. including seconds.
Selection parameter (mandatory): >x | <x | =x
x Time in the format hh:mm
If :mm is omitted, :00 will be substituted.
UDAT For PLAM library elements:
USER Date of the element calculated in days to today.
5 means, for example, that the element has a User Date of 5 days earlier than today.
Selection parameter: >x | <x | =x or
in Date format: >dd. [mm. [yy] ] | <dd. [mm. [yy] ] | =dd. [mm. [yy] ]
If mm.yy or yy are omitted, then the current month and year will be substituted.
Notes:
When reorganising a library, the User Date of the elements remains unchanged, in contrast to the System Date.
If the selection of PLAM library elements is to be made according to the User Date instead of the System Date, then the UDAT command should be used (See page 18-).
Using the DATE command (page 18-) will result in the User Date of the library element being displayed in date form, and not as an age in days. Since the User Option column is only 5 bytes wide, the date will be truncated to YMMDD. Y is the last digit of the year (0, for example, represents 1990).
USERINFO User Information (from OSD V3.0).
This User Option displays the contents of the User Information associated with the file. The ONXSET USERINFO Variable Action (see page 5-) or the USER-INFORMATION parameter to the /MODIFY-FILE-ATTR command can be used to associate a one to eight byte text string with a file as User Information.
Selection parameter: Y | N | 'info'
Y | N User Information available ? Yes/No
'info' Select all files whose User Information contains the specified value.
VAR For PLAM library elements:
Library element variant. The variant of a library element is a 4 digit number that begins at 1 and is incremented by 1 with each write access.
Selection parameter: >x | <x | =x
VER For LMS-ISAM/PLAM library elements:
All versions with the specified element name will normally be displayed. Specifying the VER User Option will display only the highest version of each element. This is also true even for LMS-ISAM libraries and PLAM elements not saved in delta format. For PLAM elements saved in delta form, only the highest version will be displayed, even without specifying the VER User Option.
Selection parameter: >x | <x | =x
VCNT Volume Counter. Number of disks (tapes) being occupied by the file.
Selection parameter: >x | <x | =x
VSN First VSN being occupied by the file. If the file exists across more than one VSN, this will be flagged in the list with a '+' character to the right of the VSN.
The VSN User Option can also be used with Archive directories (NPDIR directory). In this case, the VSN of the first tape volume to which the file has been saved will be displayed.
Selection parameter: vsn
VOLSET This User Option displays the Volume Set on which the file is stored within an SM pubset. The User Option is available from OSD V3.0.
The Volume set for new files can be determined by means of the VOLUME-SET parameter of the /CREATE-FILE command.
Selection parameter: catid (e.g. TST)
VOLSP The number of PAM pages utilised by the file on the specified disk (VSN) will be displayed.
Selection parameter (mandatory): vsn [ >x | <x | =x ]
Optionally, the >|<|=x parameter can be specified to select all files which occupy less than, more than, or exactly, x pages on the specified volume.
WORK This User Option indicates whether the file has been given the status of a Work file within the SM pubset, and hence whether it can be erased after a particular time period. This User Option is available from OSD V3.0.
The ONXSET WORK Variable Action (see page 5-) or the WORK-FILE parameter to the /MODIFY-FILE-ATTR command can be used to assign Workfile status to a file.
Selection parameter: Y | N
WRCNT Write Count for Job variables: Displays the number of times the Job variable has been modified since its inception.
Selection parameter: >x | <x | =x