(JOIN) | () | [:x:|:*[*]:] ( )[-]string
(JOIN) Es werden die Default Cat-ID's aller Benutzerkennungen nach Dateien/Jobvariablen mit den gewünschten Eigenschaften durchsucht. Anstelle von (JOIN) kann auch die Abkürzung ( ) angegeben werden.
:x:(JOIN) Es wird der angegebene Pubset x auf allen Benutzerkennungen nach Dateien mit den gewünschten Eigenschaften durchsucht.
:*:(JOIN) Es werden alle Benutzerkennungen in allen lokal verfügbaren Pubsets nach Dateien mit den gewünschten Eigenschaften durchsucht.
:**:(JOIN) Es werden alle Benutzerkennungen in allen lokal und remote zugreifbaren Pubsets nach Dateien mit den gewünschten Eigenschaften durchsucht.
()[-]string | [:x:|:*[*]:] ()[-]string Es werden nur diejenigen Kennungen zur Selektion herangezogen, die den String in ihrem Namen enthalten, bzw. nicht enthalten (-string).
Hinweise:
Normalerweise wird von CFS für jede Benutzerkennung eine Meldung ausgegeben, unter der keine Dateien der gewünschten Art gefunden wurden: "NO FILES FOUND FOR USER-ID xxxxxx". Durch Setzen des Prozeßschalters 4 (/SETSW ON=4) können diese Meldungen am Bildschirm unterdrückt werden. Um auch ohne SETSW ON=4 die NO-FILES-FOUND Meldungen zu unterdrücken, muß der Systemverwalter in der PAM-Seite 6 von CFS bzw. im Modul CFSMAIN einen Indikator setzen (Hinweise hierzu siehe Source-Listing von CFSMAIN).
Um die Suchzeiten für die Dateiselektion zu minimieren, kann die JOIN-Funktion mit der User Option NO (Names Only) gekoppelt werden.
Die gefundenen Dateien werden pro Benutzerkennung nach den im Feld SORT-OPTION angegebenen Bedingung sortiert. Durch das Kommando SORT opt kann die Dateienliste insgesamt nach einem vorgegebenem Kriterium sortiert werden.
USER-ID : (JOIN) darf nicht zusammen mit USER OPTION : OPEN angegeben werden.
Beispiel:
()UTM
Durch diese Vorgabe werden bei der Selektion alle Benutzerkennungen berücksichtigt, die in ihrem Namen irgendwo die Zeichenfolge UTM enthalten.
[:cat-with-wildcard:] [user-id-with-wildcard]
cat-with-wildcard
Cat-ID Auswahl mit Namensmuster gemäß FSTAT- (SHOW-FILE-ATTR) Syntax.
Das Konstrukt <x:y> darf nicht angegeben werden.
user-id-with-wildcard
User-ID Auswahl mit Namensmuster gemäß FSTAT- (SHOW-FILE-ATTR) Syntax.
:C/<1,2,3>:SYS*
Durch diese Vorgabe werden bei der Selektion alle Benutzerkennungen selektiert, die mit SYS beginnen. Außerdem werden alle Cat-ID's berücksichtigt, die mit C beginnen, an der zweiten Stelle ein beliebiges Zeichen enthalten und an der dritten Stelle eine der Ziffern 1 bis 3 enthalten.
(datei) Die USER-IDs (auch mit Suchmustern) werden aus der angegebenen Datei gelesen. Die Datei muß die Eigenschaften Recform=V und Fcbtype=SAM besitzen.
Die Datensätze zur Auswahl von Cat-ID's und/oder Benutzerkennungen dürfen auch Wildcards enthalten (siehe oben). Die Sätze können auch länger als 14 Stellen angegeben werden (Länge des Feldes User-ID in der Selektionsmaske).
Beispiel:
Die Datei mit dem Namen CFS.USER enthält 4 Datensätze mit folgendem Inhalt:
:G:TT08
:OPG:T*
CFS
:<1,2>:S43
NPSAP;(CFS.USER)
Durch dieses NP-Kommando werden alle Dateien ausgewählt, die in ihrem Namen die Zeichenfolge 'SAP' enthalten und unter :G:$TT08., :OPG:$T*., $CFS., :1:$S43. oder :2:$S43. katalogisiert sind.