PDS Change Command screen

The following figure provides a summary of the PDS CHANGE command parameters in a fill-in-the-blank format. This screen is invoked by entering the CHANGE (C) command on the PDS Find/Change screen without any parameters. The CHANGE command and its parameters can also be entered and processed directly on the PDS Find/Change screen.

Important

When processing a CA Panvalet or CA Librarian data set, File-AID does not allow the CHANGE command.

PDS Change Command screen

Field Descriptions

From string, To string

Specify the character string that you want to change in the From string field. Specify the new string of characters to replace the From string value in the To string field. The supported data types are described in Find string.

When the from and to strings are equal length, the character replacement does not affect any other data in the record.

When the replacement string is shorter than the original string, File-AID left-shifts the remaining data to fill in the gap and inserts extra blanks at the first blank found or the end of the record. When the replacement string is longer than the original string, File-AID right-shifts the remaining data. When there is not a sufficient number of contiguous blanks to the right of the original string, truncation occurs.

The Change Report displays the number of records in error in the upper-right corner of the report. The long message displays the number of records listed, changed, truncated, and skipped.

When The Process in JCL format parameter is set to Y (Yes) on the PDS Processing Options screen, File-AID processes a Change as follows:

- JOB, EXEC, DD, and PROC statements are processed as one logical record. The Change Report shows all JCL lines that make up the logical JCL statement. When the replacement data is longer than the original data, File-AID shifts the complete JCL phrase from one line to the next. However, the JCL statement is truncated if all the physical lines are used.
- File-AID does not search columns 72 through 80 for the original string, it skips what it assumes is the comments area. Data in columns 72 through 80 is never modified or shifted due to data of unequal lengths. We recommend not specifying column boundaries when processing in JCL format.

Start column, End Column

Specify a starting and ending column value for File-AID to search. You may restrict the find operation to a single column by specifying only the Start column value or give File-AID a search range by specifying the Start column and End column values. Data specified for a single column must begin at the Start column position. Data specified for a column range must be contained within the column range.

The End column must be greater than or equal to the Start column. You can enter a Start column without specifying an End column; but you cannot specify an End column without specifying a Start column.

Specifying a Start column and no End column changes the default relational operator to EQ.

If you leave both the Start and End columns blank, File-AID searches the entire length of each record in the member.

Relational operator

Specify one of the following valid relational operators:

CO - Contains (default).

NC - Does not contain.

EQ - Equal.

NE - Not equal.

LT - Less than.

LE - Less than or equal.

GE - Greater than or equal.

GT - Greater than.

Confirm changes

Specify whether you want to preview the intended changes to the PDS member before the actual updating is performed. File-AID saves the Confirm changes setting in your profile from session to session:

Yes (default). File-AID displays the PDS Change Report listing all the changes for your review. See Change Report Screen. After checking the report, you specify whether you want the changes completed, the preview changes report printed, and the number of changes you want File-AID to perform.

No. File-AID makes the changes without a confirmation screen and redisplays the member list.

Condense member list

Specify whether you want the current member list condensed as a result of the Change processing. File-AID saves the Condense member list setting in your profile from session to session:

Yes (default. Redisplays the member list with only those members that contain a match to the Change string value. The number of changes per member are reported in the HITS column.

No. Redisplays the member list, without condensing it, with a HITS column reporting the number of Change string matches.

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 changes

Specify a value to set a limit for the Change operation. 0 through 999,999 are valid values. The default value is 0 or ALL. 0 (zero) or ALL changes all occurrences of the Change string value.

Important

Only numeric values are allowed for the MAX(n) parameter on the CHANGE primary command. Entering the 0 default value has the same effect as not entering the parameter; no limits are placed on the number of changes.

For example, if you enter 10, File-AID stops searching for the Find string after it finds the tenth occurrence.

File-AID saves the Maximum changes setting in your profile from session to session.