Batch Component › Move Request Processing Jobs › Process Selected Move Requests › Restart Procedures for APIR5423

Restart Procedures for APIR5423

As APIR5423 is running it writes messages out to the printer. These messages are key to determining what APIR5423 has done, and what is necessary to restart. To restart APIR5423 you might have to specify a PVREXXIN DD statement (if you don't have one already) and specify some combination of the RestartGroup, RestartStep, and RestartMems parameters.

Message APIR5423‑03 is issued as each new group of moves begins processing (members are in the same group when they are for the same Library Code and being moved from the same origin to the same destination). The message contains a generated name associated with the group. Unless you were processing the first or only group at the time that APJP5423 stopped, you need to specify the last group name that was being processed with the RestartGroup parameter in the PVREXXIN file. For example, if you need to restart with group name MQACICS, specify: RestartGroup="MQACICS".

Message APIR5423-21 is issued as each logical step begins. This message contains the name of the logical step. In file PVREXXIN you need to specify the name of the step you were last processing, unless APIR5423 stopped before the first logical step for the current group began (perhaps due to a problem with the RestartGroup parameters. For example, if you need to restart at step DEST1XFER, specify: RestartStep="DEST1XFER".

Notes:

If you were in a step that deletes members to CA-Panvalet protection files and you received message APIR5423-16 (informing you to check the status of the output protection file) then you must first look at the PAN#2 output to determine if the protection file that was cataloged was written to. If it was not written to, then you need to scratch it before you restart.

If you were in a PAN#2 Library to Library transfer step and you are using a version of CA-Panvalet prior to 14.1, or your PVOPT default restore status is PROD, and some of the members were successfully transferred, then you need to create a restart member list. (A Library to Library step is when all the steps end in name XFER.) Otherwise, when the transfer step is restarted it fails because the members exist in the target library.

To use a restart member list:

1. Copy a member in the APTMDLO data set whose name is the group name appended with an M to another file. This file contains a record for each member being moved for this Library Code. The records contain REXX assignment statements. Variable TN is assigned to the To member name.
2. Edit this new file and delete the entries with TN names matching those that were successfully transferred.
3. Restart APIR5423 allocating this new file to any DDname you choose, and specify the DDname for the RestartMems parameter. This causes the first logical step of the restart (which should be overridden with the RestartStep parameter) to operate on a subset of the group of members being moved.