PDS processing options
PDS Processing Options screen
COMMAND ===>
Dataset: USERID9.FASAMP.JCL
Include record information ===> N (Y = Yes; N = No)
Process in JCL format ===> N (Y = Yes; N = No)
Maintain PDS statistics ===> Y (Y = Yes; N = No; A = Add)
Specify Member Selection Options (Blank for All Members)
Member name mask ===>
Member name range ===> to ===>
Last modified userid ===> to ===>
Creation date ===> to ===> (YY/MM/DD)
Modification date ===> to ===> (YY/MM/DD)
Display member selection list ===> Y (Y = Yes; N = No)
Use ENTER to continue, END to return to dataset specification screen
Field Descriptions
The following list describes all PDS processing options that File-AID can present.
Main Dataset - Processing Options
Copy/Edit entire member
Specify Y (Yes) and File-AID browses, edits, or copies the entire member containing selected records. Use the N (No) value to have File-AID process only the records that match the selection criteria. The default is set with option 0.4 Processing Parameters (see Copy/Edit entire member).
Copy empty member
Specify Y (Yes) or N (No -- default). This parameters specifies whether File-AID copies FROM members that contain no records to the TO dataset. Specify Y (Yes) and File-AID copies empty members from the input PDS to the output PDS. Use the N (No) value and File-AID does not copy empty members.
Include record information
Specify Y (Yes) or N (No -- default). When set to Y (Yes), the File-AID Search/Update utility (option 3.6) displays an informational line that shows each record number relative to the beginning of the data set, record length for variable-length records, and readable key for all keyed data sets.
Process in JCL format
Specify Y (Yes) or N (No -- default). Process in JCL format enables File-AID to handle JCL statements that span multiple records and must be treated as a single logical record.
This field applies only to PDS data sets that contain fixed block or unblocked records up to 80 bytes long. It allows processing of these records as logical JCL (bytes 1 to 71 only). The Process in JCL format field corresponds to the FORM=JCL parameter in File-AID/Batch. When used, logically connected JCL records (JOB, EXEC, DD, PROC, JCLLIB, OUTPUT, SET, and XMIT) are treated as a single record for count, examination, and display purposes. Specify Y (Yes) to have File-AID treat the data as logical JCL statements. If this field is set to Y for a data set that does not match the proper format (fixed up to 80 bytes long), it is ignored and no error message is produced.
Use the N (No) value to have File-AID treat the data as physical records.
UPDATE or COPY To Dataset - Processing Options
Replace like-named members
Specify Y (Yes -- default) or N (No). Specify Y (Yes) to have File-AID copy members to the output PDS, even if the member name already exists. Use the N (No) value to prevent copying the member to the output PDS if the name already exists.
Rename copied members mask
Specify a mask to apply to each “To” member name and construct a new member name when copying members from one partitioned dataset (PDS) to another.
When constructing the new member name, File-AID interprets each ? (question mark) or & (ampersand) in the mask as a null character which preserves the original character at that location. An * (asterisk) or blank at the end of the mask means retain the balance of the original member name. All other characters are treated as constants and are placed in the new member name.
For example, applying the mask A??P to a copied member name of TEST01 results a new member name of AESP01.
If the old member name is smaller than the mask, unused null characters are ignored. The mask A??P applied to a copied member name of XY would result in a new member name of AYP. The last 2 bytes of 10-byte Panvalet names are dropped.
New member names are checked against the target PDS and are replaced based on the setting of the Replace like-named members parameter.
Maintain PDS statistics
This parameter controls the updating of PDS member statistics when changes are applied in the Search/Update utility option M or U. Specify one of the following values:
Y - (Default) Update PDS statistics for members that have statistics.
N - Do not update PDS statistics.
A - Add statistics for any member that does not currently have PDS statistics and update statistics for any member that does.
Maximum number of generations to list
Specify a number between 1 and the MAXGENS number for this Version 2 PDSE. Or specify 0 to list all generations.
In Browse or Edit for a Version 2 PDSE with Member Generations you can use line command G for a member from the member selection list. The G line command displays a list of current generations for that member (Member Generation Selection List). By specifying a number between 1 and the MAXGENS number (see Maximum Generations) for the PDSE in this field you can limit the number of generations displayed in the list. When 0 (zero) is specified all generations are listed.
Keep in mind that the number of generations you select to display in the list will impact your region size.
Maximum generations to copy
Specify a number between 1 and the MAXGENS number for this Version 2 PDSE. Or specify 0 to copy all generations. Leave blank to only copy the current member (0 generation). For example, specify 2 to copy the current member (0), (-1) and (-2) generation members.
By specifying a number between 1 and the MAXGENS number (see Maximum Generations) for the PDSE in this field you can limit the number of generation members to be copied. When 0 (zero) is specified all generations are copied.
Search/Update Utility Option B, Browse with Version 2 PDSE
Maximum number of generations to include in search
Specify a number between 1 and the MAXGENS number for this PDSE. Or specify 0 to search all generations. Leave blank to only search the current generation (0) member. For example, specify 2 to search the current member (0), (-1) and (-2) generation members.
By specifying a number between 1 and the MAXGENS number (see Maximum Generations) for the PDSE in this field you can limit the number of generation members to be searched. When 0 (zero) is specified all generations are searched.
The search results will identify each member by its name and relative generation number, for example ***MEMBER MEMBER1(-2) *** as shown in Sample Search/Update Browse Results for a Version 2 PDSE.
Specify Member Selection Options:
Member name mask
Specify a member name mask to select a subset of members based on the mask criteria. A pattern member name or mask consists of explicit characters or a combination of explicit and pattern characters. See Pattern dataset names for a complete description.
Member name range
Specify a member name range to select a subset of members based on the characters in the member name. The endpoint member names (FROM and TO) can be complete or partial and are included in the member list when found. Pattern characters are not allowed.
If the FROM member field is blank and a TO member is specified, File-AID selects the members less than or equal to the TO member padded with high values.
If a FROM member field is specified and the TO member is blank, File-AID selects members greater than or equal to the FROM member padded with low values.
Entering the same characters in the FROM and TO fields selects all members beginning with those characters.
Last modified userid
Specify a user identification range to select a subset of members based on the user ID that last updated and saved a member. This information is a PDS statistic that is stored in the directory.
The endpoint userids (FROM and TO) can be complete or partial and are included in the member list when found. Pattern characters are not allowed. As with member name range, the FROM field is padded with low values and the TO field is padded with high values.
Members without PDS statistics, because they were not created (STATS OFF) or the statistics were deleted, are not selected.
Creation date
Specify a creation date range to select a subset of members based on their creation date(s). This is a PDS statistic that is stored in its directory.
The endpoint (FROM and TO) dates can be complete or partial and are included in the member list when found. Leading zeros are required when specifying the year, month, and day.
If the FROM date field is blank and a TO date is specified, File-AID selects all members created on or before the specified TO date.
If a FROM member date is specified and the TO date is blank, File-AID selects all members created on or after the specified FROM date.
Entering the same dates in the FROM and TO fields selects members created only on that date. The two-character year is assumed between 1960 and 2059. Partial creation dates are treated positionally (YY/MM/DD) and are padded with default values.
For example, if you enter blanks the default FROM value becomes 60/01/01 and the TO value becomes 59/12/31. If you enter 85, the defaults are 85/01/01 and 85/12/31. If you enter 85/09, the defaults are 85/09/01 and 85/09/30.
Members without PDS statistics, because they were not created (STATS OFF) or the statistics were deleted, are not selected.
Modification date
Specify a modification date range to select a subset of members based on the last modified date(s). This is a PDS statistic that is stored in its directory. The last modified date is updated with the current date each time a member is updated and saved.
See the description of the Creation date field for more information on specifying a modification range. The specifications are identical.
Members without PDS statistics, because they were not created (STATS OFF) or the statistics were deleted, are not selected.
Display member selection list
Specify Y (Yes -- default) or N (No). This field controls the display of the member S/X (select/exclude) list after PDS processing options are applied. If Y is specified, a member S/X list is displayed. See Member S/X List. When N is specified, a member list is not displayed after the PDS processing options are applied.
This field is displayed for Copy, Print, Search/Update options B and U, and Compare.
Include Compiler Options
Specify Y (Yes) or N (No). This field only appears for Option 3.1, Library Utility, Batch processing mode (see Process Option) and controls whether compiler options for load modules that have CSECTs compiled with any IBM COBOL compiler (excluding OS/VS COBOL) or any IBM Enterprise PL/I for z/OS and OS/390 compiler starting with Release 3.1 will be included in the report.
Create a CSV file
Specify Y (Yes) or N (No). This field only appears for Option 3.1, Library Utility, Batch processing mode (see Process Option) and controls whether the report will also be output to a CSV (Comma Separated Values) file type in addition to the SYSLIST file. When you specify Y, the CSV Dataset Specification panel displays (CSV Dataset Specification).