How the RESTARTPARM keyword affects restarting utilities
To restart a utility in a worklist, you can either omit or include the RESTARTPARM keyword in the AEXIN input stream.
Omitting the RESTARTPARM keyword
If you do not specify the RESTARTPARM keyword in the AEXIN input stream, the utility reruns or restarts with the following parameters.
Utility | Method | Parameters |
|---|---|---|
CHECK PLUS for DB2 | Rerun | SSID, UTILID, NEW |
BMC BASIC UNLOAD BMC AMI Copy for Db2 LOADPLUS for DB2 BMC AMI Recover for Db2 UNLOAD PLUS for DB2 | Rerun | SSID, UTILID, NEW/RESTART |
DASD MANAGER PLUS for DB2 components: BMCCPRS, BMCSTATS, BMCTRIG, or BMCUPRS | Rerun | SSID, VCATname, ASUDOPTSname, WORKID For information about parameters, see DASD MANAGER PLUS for DB2. |
REORG PLUS | Restart | SSID, UTILID, NEW/RESTART |
IBM LOAD or other IBM utilities, except IBM REORG | Rerun | SSID, UTILID, lineOneParms The variable lineOneParms represents positional parameters that are allowed on the utility EXEC statement for restarting the utility. The parameters follow the first line of the utility command in the worklist. For information about necessary parameters, see the manual for the IBM utility that you want to restart. For IBM LOAD, Execution issues commands to terminate the execution of the utility. Also, if necessary, Execution issues commands to start table spaces, start index spaces, and delete table rows before rerunning the utility. The worklist contains a -LOAD command and, on the same line, a DELETE FROM clause. The next line of the command contains the LOAD RESUME YES option. For other IBM utilities, except IBM REORG, Execution issues only the command to terminate execution of the utility before rerunning the utility. |
IBM REORG | Restart | SSID, UTILID, RESTART |
Including the RESTARTPARM keyword
If you specify the RESTARTPARM keyword in the AEXIN input stream, the utility restarts with the following parameters:
- SSID, which is the subsystem ID as specified in the worklist
- UTILID, which is the utility ID for the job
restartParmString, which is the parameter string specified with the RESTARTPARM keyword
The variable restartParmString contains positional parameters that are allowed on the utility EXEC statement for restarting. For information about necessary parameters, see the manual or product space for the utility that you want to restart.
In addition, Execution does not perform a cleanup for the utilities (with the exception of the IBM LOAD utility). For example, no commands are issued to terminate the execution of the utility, delete table rows, start table spaces, or start index spaces.
When you specify the RESTARTPARM keyword, use the following guidelines:
- Ensure that the RESTART keyword is also specified in the AEXIN input stream.
Do not enter the SSID and UTILID parameters as part of the restartParmString parameter. Execution passes the SSID and UTILID parameters for you.
- Do not enclose a restartParmString parameter with single quotation marks. This action causes an error.
- Do not specify the RESTARTPARM keyword without the restartParmString parameter. If you do so, Execution ignores the keyword.
The following example shows the AEXIN keywords to restart the REORG PLUS utility for a particular job:
RESTARTPARM NEW/RESTART,,MSGLEVEL(1)
Related topic