This is the syntax of the ADAWRK utility. Sample JCL using this syntax is provided elsewhere in this document.
ADAWRK can be specified alone, without any parameters, to produce a summary report (SUMMARY=YES is the default). You can optionally customize the reports produced by ADAWRK by adding other parameter values. Each parameter is described here:
Use the ABEND34 parameter to change a user abend 35 to a user abend 34 when an ADAWRK utility error occurs. This ensures that a dump is produced when the utility terminates abnormally.
Use the CHECKPOINT parameter to indicate whether or not checkpoints found in the autorestart area of Work part 1 should be printed in the ADAWRK report output. Valid values are "YES" and "NO". A value of "YES" indicates that checkpoint records found should be printed; a value of "NO" indicates that they should not. The default is "NO".
Use the CMID parameter to specify up to 24 32-byte communication IDs in hexadecimal format. Only Work part 1 autorestart area records with communication IDs equal to the values specified on the CMID parameter will be processed by the ADAWRK utility and printed on its reports.
Use the ETID parameter to specify up to 32 ETIDs in character format. ETIDs must be one to eight bytes long. When ETIDs are specified, only Work part 1 autorestart area records for those ETIDs are processed by the ADAWRK utility and printed on its reports.
Use the FILES parameter to specify up to 64 file numbers that should be included in the report. Only Work part 1 autorestart area records for files listed in the FILES parameter will be processed by the ADAWRK utility and printed on its reports. However, if the FILES parameter is not specified, all files in the database will be processed by default.
You can specify a range of file numbers for this parameter if needed. For example, FILES=2-20 indicates that all files with file numbers between and including 2 and 20 should be processed by the utility.
Use the FORCE parameter to indicate how ADAWRK processing should proceed when inconsistencies in the autorestart area of Work part 1 are encountered. Valid values are "YES" and "NO". A value of "YES" indicates that the ADAWRK utility should continue to attempt to interpret the data, without abending; a value of "NO" indicates that inconsistencies in the autorestart area of Work part 1 will result in the termination of the utility with an appropriate message and abend.
Use the LWP parameter to specify the size of the work pool used internally by the ADAWRK utility. Valid values are in the range 100K - 1048576K (or 1 Gb). The default is 1024K (1Mb). The LWP must be specified in kilobyte units and if the "K" is not present in the specification, an error will result. For example, LWP=500K is a valid specification, but LWP=500 is not.
Use the NOPPT parameter to indicate that the Associator (ASSO) data set for the database should not be opened by the utility. If you specify this parameter, the ASSO data set will not be opened. When this parameter is not specified, and if the ASSO data set is provided to the utility, the utility will use the PPT.
This parameter provides a workaround in situations where the Work data sets are available, but the Associator is not.
Use the NOUSERABEND parameter to indicate that the utility should terminate with a return code of 20 if a user abend occurs. If you specify this parameter, a return code of 20 will be produced instead of abending. If you do not specify this parameter, the user abend will occur if necessary.
Use the REPORTFILE parameter to indicate whether or not the File Statistics report should be printed. Valid values are "YES" and "NO". "NO" indicates that the File Statistics report should not be printed; "YES" indicates that the File Statistics report should be printed.
The default is "NO".
When the CMID, FILES, USERID, or ETID parameters are specified with the REPORTFILE parameter, only updates that satisfy all of the criteria specified by all of the parameters is included in the File Statistics report.
Use the SUMMARY parameter to indicate whether or not the Summary report should be printed. Valid values are "YES" and "NO". "NO" indicates that the Summary report should not be printed; "YES" indicates that the Summary report should be printed.
The default is "YES".
When the CMID, FILES, USERID, or ETID parameters are specified with the SUMMARY parameter, only updates that satisfy all of the criteria specified by all of the parameters is included in the Summary report.
Use the TEST parameter to test the validity of the parameters you have specified for the ADAWRK utility. When you specify the TEST parameter, no reports are produced.
Use the TIMEZONE parameter to convert the time values to a specific
time zone prior to producing the ADAWRK reports. Valid values for the TIMEZONE
parameter are LOCAL, MACHINE, and an hour difference specification in the
format +|- nn (where
nn is a valid value from 0 to 23).
| Parameter Value | Description |
|---|---|
| LOCAL | Times are adjusted by the local adjustment value found on the machine. This is the default. |
| MACHINE | Times are printed as they are found. |
| -23 to +23 | Times are adjusted backward (if a minus sign is specified) or forward (if a plus sign is specified) by the number of hours specified. |
Use the TRANSACTIONS parameter to indicate whether or not the Transaction report should be printed. Valid values are "YES", "NO", "DETAIL", and "FULL":
| Parameter Value | Description |
|---|---|
| NO | The Transaction report is not printed. This is the default. |
| YES | The Transaction report is printed. |
| DETAIL | Additional details about transaction data found in the autorestart area of Work part 1 are printed, including the files and ISN numbers that have been updated by each transaction. |
| FULL | All data storage and inverted list (descriptor value table DVT) data associated with each update in a transaction is printed. |
When the CMID, FILES, USERID, or ETID parameters are specified with the TRANSACTIONS parameter, only updates that satisfy all of the criteria specified by all of the parameters is included in the Transaction report.
Use the USERID parameter to specify up to 24 user ID values that should be used to filter the Work part 1 autorestart area records processed by the utility. User IDs are stored in the last eight bytes of the communication ID in a record. Only records with communication IDs whose last eight bytes match the user IDs listed in the USERID parameter will be processed by the ADAWRK utility and printed on its reports.
User IDs must be specified as one to eight bytes long and in character or hexadecimal format. If you specify user IDs in character format, you may use an asterisk (*) as a wildcard character; user IDs specified in hexadecimal cannot use wildcards (the specification of an asterisk in a hexadecimal user ID will be converted to X'5C' in ADAWRK processing).
The asterisk wildcard character in character user IDs must be specified at the end of a user ID. For example, USERID=ABC* would cause the ADAWRK utility to process all Work part 1 autorestart area records with user ID values beginning with the letters "ABC". However, if USERID=*ABC were specified, the asterisk wildcard would be ignored and the ADAWRK utility would process all Work part 1 autorestart are records with a user ID value of "ABC".
