Select files/Job variables from all userids (JOIN)

(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.