MASK (char-1 [char-2] ) ] NOMASK
[ VOLUME ]
VOLUME (volume-serial) [AGE (number-of-days) [ LIST ]
NOLIST
[CLIST [ (' string-1 ' [' string-2'] ) ] ]
~ GENERIC NOGENERIC VSAM NONVSAM ALL MODEL [WARNING] ]
CLASS(profile-name-class)
specifies the name of the class of profiles to be searched. The valid resource classes are DATASET, USER, GROUP, and those specified in the class descriptor table. If this operand is omitted, the default value is DATASET.
To search for another user's profile you must be the owner of the user's profile, or have the SPECIAL or AUDITOR attribute, or the profile must be within the scope of a group in which you have either the group-SPECIAL or group-AUDITOR attribute.
To list details of all RACF-defined user profiles, you must have either the SPECIAL or AUDITOR attribute.
If CLASS(TAPEVOL) is specified, all volumes that meet the search criteria will be processed independently, even if the volumes belong to a tape volume set.
Note: If you specify a class that allows profile names to contain any character (ICHERCDE with OTHER=ANY), then profiles in the DATASET class that begin with the same first 4 characters as this class name and that satisfy the other criteria you specify on this SEARCH command are also listed.
MASK(char-l[ char-2])
132 RACF Command Language Reference
specifies the strings of alphameric characters used to search the RACF data set. This data defines the range of profile names selected. The two
character strings together must not exceed 44 characters for a DASD data set name, or, for general resource classes, the length specified in the class descriptor table.
char-l
Each profile name selected with this command starts with char-I. The string may be any length up to the maximum allowable length of the resource name. All profile names beginning with char-l are searched.
If lie is specified for char-I:
• For DATASET, your userid is used as the default value for char-I.
• For resource classes specified in the class descriptor table, char-l is ignored and char-2 will identify the character string appearing anywhere in the resource name.
char-2
If you specify char-2, the selected profile names include only those names containing char-2 somewhere after the occurrence of char-I.
This limits the list to some subset of resource names identified with char-I.
If you omit both the MASK and NOMASK operands, your userid is used as the default value for the DATASET class, whereas the entire class is searched for any resource class defined in the class descriptor table. (Note that for any resource class defined in the class descriptor table, omitting both operands is the same as NOMASK.)
NOMASK
specifies that all profiles (to which you are authorized) in the specified class will be selected.
VOLUME
specifies that you want the volume information to be displayed for each DASD data set that meets the search criteria specified by the MASK operand.
This operand is ignored if you specify GENERIC.
For non-VSAM data sets, the volume serial number displayed is the location of the data set. For VSAM data sets, the volume serial number displayed is the location of the catalog entry for the data set.
This operand is valid only for CLASS(DATASET), and is ignored for all other class values.
VOLUME(volume-serial ... )
specifies the volumes to be searched (the volume serial number(s) become part of the search criteria). Non-VSAM DASD data sets.are selected if they reside on the specified volumes. VSAM data sets are selected if the catalog entries for the data sets reside on the specified volumes.
This operand is ignored if you specify GENERIC.
If the selected data set names are displayed at your terminal, the volume information is included with each data set name.
This operand is valid only for CLASS (DATASET) , and is ignored for all other class values.
SEARCH Command 133
AGE(number-of-days)
LIST
specifies the aging factor to be used as part of the search criteria. Only resources that have not been referenced within the specified number of days are selected, unless you specify CLASS(GROUP). In this case, the
SEARCH command uses the date on which the group was defined to determine the age.
You can specify up to 5 digits.
specifies that the selected data set names, volume serial numbers, or terminal names are to be displayed at your terminal. This is the default value if both LIST and NOLIST are omitted.
NOLIST
specifies that the selected data set names, volume serial numbers, or terminal names are not to be displayed at your terminal.
This operand can only be used when the CLIST operand is specified. If NOLIST is used without CLIST, the command will fail.
If you omit both the NOLIST and LIST keywords, LIST is the default value.
CLIST[('string-l'[ 'string-2'])]
134 RACF Command Language Reference
specifies that the selected profile names are to be retained in a CLIST data set. One record is put into the data set for each selected profile name.
'string-l'[ 'string-2']
specifies strings of alphameric characters that are put into the CLisT records along with the selected profile names. Each string must be enclosed in apostrophes. In this way you can build a set of commands that are similar except for the profile name.
The format of the text pdrtion of the CLIST record is as follows:
string-l'data-set name'string-2 or string-1volume-serial-numberstring-2 or string-1terminal-namestring-2
If the result is longer than 243 characters, it is truncated on the right.
An 8-position sequence number is placed on the front of the text.
If both strings are missIng, the CLIST record contains only the profile name. If you want a string of data to appear only after the resource name, specify 'string-I' as ".
Note: The DASD data set name for the CLIST data set is generated in the format:
x.EXEC.RACF.CLIST
where x is the default data set name prefix in your TSO profile.
If a data set with this name is found through the catalog, the records in it are replaced with the new records. If no data set is found, a new one is created and cataloged.
The CLIST data set is a sequential data set with variable length records and a maximum logical record size of 255. This includes a 4 byte length field at the front of the record. The records are numbered in sequence by 10.
GENERIC or NO GENERIC
specifies whether only generic profiles or no generic profiles (that is, only discrete profiles) are to be selected. If neither operand is specified, both profile types are selected.
These operands are ignored unless generic profile command processing is enabled.
VSAM
specifies that only VSAM data sets are to be selected. This operand is ignored for classes other than the DATASET class.
NONVSAM
ALL
specifies that only non-VSAM data sets are to be selected. This operand is ignored for classes other than the DATASET class.
specifies that both VSAM and non-VSAM data set profiles of both the generic type and the discrete type are to be selected. This operand is ignored for classes other than the DATASET class. ALL is the default if VSAM, NONVSAM, GENERIC, NOGENERIC, MODEL, and ALL are omitted.
MODEL
specifies that only data set profiles having the MODEL attribute are to be selected. RACF ignores this keyword for classes other than DATASET.
WARNING
specifies that only resources with the WARNING indicator are to be selected.
This operand is ignored when CLASS is specified as USER or GROUP.
SEARCH Command 135