|
USER-ID : Userid
: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..
-------------------------------------------------------- TSOS:
(JOIN) | () | [:x:|:*[*]:] ( )string
(JOIN) All userids and all Pubsets (PVS) will be searched for files or Job variables that match the specified criteria. The abbreviation () may be given instead of (JOIN).
:x:(JOIN) All userids on the specified Pubset (PVS) will be searched for files that match the specified criteria.
:*:(JOIN) All locally available Pubsets and all userids will be searched for files that match the specified criteria.
:**:(JOIN) All pubsets in all local and remote userids will be searched for files with the specified characteristics.
()string | [:x:|:*[*]:] ()string
Those userids that contain the specified string within their name will be searched for files that match the specified criteria.
Example:
()UTM
All userids that contain the string UTM somewhere within their name will be searched.
Notes:
Normally, CFS will display the following message for each userid in which no files were found: "NO FILES FOUND FOR USERID xxxxxx". These messages can be supressed if task switch 4 is set (/SETSW ON=4). It can also be suppressed if the system administrator sets an indicator in PAM page 4 of CFS, or in the CFSMAIN module (For further information, see the source listing of CFSMAIN).
In order to keep the search times reasonable, the JOIN function can be combined with the NO (Names Only) User Option. For a full description of the NO User Option, see page 4-.
The file list will be sorted by userid according to the condition specified in the SORT OPTION field. The full list can then be sorted by entering a CFS command, SORT sortopt.
USER-ID : (JOIN) may not be specified in conjunction with the USER OPTION : OPEN .
[:cat-with-wildcard:] [user-id-with-wildcard]
cat-with-wildcard
Cat-ID selection following the FSTAT (SHOW-FILE-ATTR) syntax.
The construct <x:y> may may not be specified.
user-id-with-wildcard
User-ID selection following the FSTAT (SHOW-FILE-ATTR) syntax.
Example:
:C/<1,2,3>:SYS*
This example will result in the selection of all userids beginning with SYS. In addition, all catid's which begin with C, which have any character as the second character, and which have a 1, 2 or 3 as their third character will be selected.
(file) The USER-IDs will be read from the specified file. The file must have the attributes Recform=V and Fcbtype=SAM .
Example:
A file CFS.USER contains 5 records as follows:
:G:TT08
:OPG:TT08
CFS
:1:TSOS
:2:S43
By entering the following selection conditions:
NPSAP;(CFS.USER)
all files containing the string 'SAP' in their name existing under the userids :G:$TT08. / :OPG:$TT08. / $CFS. / :1:$S43. or :2:$S43. will be selected.