DFS4429E RETURN CODE rc WAS SET DUE TO AN ERROR. CORRECT THE ERROR AND RERUN THE JOB.


or

CONTROL STATEMENT ERROR. REASON CODE=rs.

Explanation

The IMS Catalog Record Purge utility encountered a problem with the utility control statements in either the SYSIN or SYSUT1 data set. If the problem is in the SYSIN data set, in most cases the utility continues to process the remaining statements; however, if MODE BOTH is specified, in most cases the utility terminates before the purge function executes. If the problem is in the SYSUT1 data set, for most errors the utility terminates immediately without processing the subsequent statements.

In the message text:
rs
The reason code that identifies the cause of the error. Depending on the severity of the error, the return code that is issued by the utility upon termination might be 4 or 8.

DFS4429E can include any one of the following possible reason codes.

01
More than one MODE statement was found in the SYSIN DD statements.
02
The MODE type is either missing or invalid.
03
An UPDATE statement was submitted without either the DBD or PSB keyword.
04
The member name in either an UPDATE statement or a DELDBVER statement is missing, too long, or otherwise invalid.
05
More than one wildcard character (*) was used in a member name.
06
Either the number of instances to retain was not specified or the number was longer than 5 characters.
07
The specified number of DBD or PSB instances to retain is invalid.
08
The specified number of DBD or PSB instances to retain is greater than the maximum of 65535.
09
The specified number of days to retain DBD or PSB instances is longer than 5 characters.
10
The specified number of days to retain DBD or PSB instances is an invalid number.
11
The specified number of days to retain DBD or PSB instances is greater than the maximum of 65535.
12
The UPDATE statement for the utility contains a duplicate member name but with a different number of instances or days. The retention criteria in the member record was not updated.
13
Invalid statement in the SYSIN data set. The statement might be specified incorrectly or two or more statements might be incompatible with each other.
14
Missing input for the SYSIN statement.
15
Invalid DELETE statement. Any statements that were specified before this one in the SYSUT1 data set were executed successfully. Subsequent statements were not processed.
16
Invalid DELDBVER statement. With MODE PURGE, any statements that were specified before this one in the SYSUT1 data set were executed successfully. Subsequent statements were not processed.
17
No matching records for the UPDATE statement.
Execution continues normally and the utility issues return code 4 upon completion.
18
Invalid use of a wildcard character (*).
19
Invalid statement in the SYSUT1 data set.
20
An error occurred that generated one of the following messages:
  • DFS4420E
  • DFS4421E
  • DFS4422E
  • DFS4423E
  • DFS4424E
  • DFS4485E
This code is no longer issued with DFS4429E.
24
Open print_DCB failure.
This code is no longer issued with DFS4429E.

System action

If the error was encountered in the SYSIN data set, in most cases the utility continues processing the remaining control statements in the SYSIN data set; however, if MODE BOTH is specified, the utility terminates before the purge function executes. If the error was encountered in the SYSUT1 data set, in most cases, the utility terminates without processing the remaining control statements in the SYSUT1 data set.

Depending on the severity of the reason code in DFS4429E, the utility issues return code 4 or, in most cases, 8 upon termination.

User response

Review the explanation for the code, correct the underlying error, and run the utility again.

Module

DFS3PU10