Troubleshooting
Problem
This document provides a quick way to verify if GO RESTORE Option 21 was successful. This document is not intended to verify other types of restores.
Diagnosing The Problem
This document provides a quick way to verify if GO RESTORE Option 21 was successful. This document is not intended to verify other types of backups.
GO RESTORE Option 21 contains the following save commands:
The following are the completion messages, which can be found in the History Log or joblog:
When you perform a Go Restore Option 21, 22, 33, and so on, whether it is successful or whether it fails, you will see one of the following messages:
CPC2356 - Save or restore option completed successfully.
CPF2361 - Error occurred with the option.
You can display the history log and the above messages with the following command (message CPC3703 was not included in the command below because, if message CPC3709 is logged, this is enough to verify all libraries restored successfully):
1. CALL QCMD
2. DSPLOG PERIOD(('hh:mm:ss' 'mm/dd/yy') ('hh:mm:ss' 'mm/dd/yy')) MSGID(CPF0936 CPF0968 CPC3705 CPF3775 CPC3738 CPF377C CPC3709 CPF3770 CPF3773 CPF3779 CPC9023 CPF9003 CPF909B CPF370E CPF370F CPF3839 CPC3710 CPF3845 CPF3776)
where hh:mm:ss is the time and mm/dd/yy is the date (the format will differ, depending on the QDATE system value). If any of the above CPCxxxx messages are missing, that portion of the save did not complete successfully.
Note: If an error occurred with the option, you will need to review the complete joblog of the save to determine what was not saved and why. The following are some additional messages which may be logged in the joblog that may help determine why the restore failed for some objects. This is not a complete list.
CPC8D01 - Document &2 restored in folder &7.
CPC8D10 - Document &2 not restored.
CPC9052 - &1 folders restored.
CPC9053 - &1 document library objects restored.
CPC3716 - No objects restored, all objects were excluded.
CPF379C - &2 &1 was excluded.
CPD37A0 - &2 &1 in library &3 not restored.
CPD37A1 - &2 &1 in library &3 not restored.
CPD37A2 - &2 &1 not restored to library &3.
CPD37A3 - Object not restored, &2.
CPD37A4 - Object not restored, &2.
CPD37A5 - &1 not restored, &2.
CPD370E - Object &1 in &3 not restored.
CPD370F - Object &1 in &3 not restored.
CPD3722 - Object &1 type &2 in &3 not restored.
CPF377B - No objects restored. &3 objects excluded.
CPI373B - All objects completed for DFRID &1.
CPF32C7 - Deferred file not restored.
CPI321E - File &1 in library &2 deferred.
CPF0633 - File &1 not restored to library &2.
CPF3744 - &2 &1 not restored to library &3.
CPF373B- &2 &1 not restored to library &3.
CPF3756 - &2 &1 not restored to &3.
CPF3706 - &2 &1 not restored to library &3.
CPF378D - &2 &1 not restored to library &3.
CPF378F - &2 &1 in library &3 not restored.
CPF0C47 - Folder &5 for product &1 was restored.
CPF90B4 - &1 folders restored to system, &2 not restored.
CPF90E7 - Document library objects not restored.
CPF90A3 - System object name &5 already exists.
CPD377A - Object not restored, &4.
CPC3706 - Private authorities restored for user profile &1.
CPD3776 - Authority not restored for user &1.
CPF3736 - Authority not restored for user &4.
CPD2206 - Private authorities not restored.
GO RESTORE Option 21 contains the following save commands:
| Command | Description |
| ENDSBS SBS(*ALL) | Ends system to a restricted state. |
| RSTUSRPRF | Restores User Profiles and authority objects. |
| RSTCFG | Restores Configuration objects. |
| RSTLIB SAVLIB(*NONSYS) | Restores *IBM and *ALLUSR libraries. |
| RSTDLO | Restores documents and folders. |
| RST | Restores directories and objects in the Integrated File System. |
| RSTAUT | Restores private authorities. |
The following are the completion messages, which can be found in the History Log or joblog:
| Command | Completion Message |
| ENDSBS | CPF0936 - ENDSBS SBS(*ALL) command being processed. CPF0968 - System ended to restricted condition. |
| RSTUSRPRF | CPC3705 - &1 user profiles restored at &3. CPF3775 - Not all user profiles or authority objects restored. |
| RSTCFG | CPC3738 - &1 objects restored. &6 objects excluded. CPF377C - &1 objects restored; &2 not restored; &6 excluded. |
| RSTLIB | CPC3703 - &1 objects restored from &3 to &4. CPC3709 - &1 libraries restored at &3. CPF3770 - No objects saved or restored for library &1. CPF3773 - &1 objects restored. &2 not restored to &4. CPF3779 - &1 libraries restored; &4 partially restored; &2 not restored. |
| RSTDLO | CPC9023 - &1 document library objects restored. CPF9003 - &1 document library objects restored. &10 not restored. CPF909B- &1 document library objects restored. &10 not restored. |
| RST | CPC370E - &1 objects restored. CPC370F - &1 objects restored. CPF3839 - &1 objects restored. &2 not restored. |
| RSTAUT | CPC3710 - Private authorities restored for &1 user profiles at &2. CPF3845 - Some authorities not restored for user profile &4. CPF3776 - Not all user profiles had all authorities restored. |
When you perform a Go Restore Option 21, 22, 33, and so on, whether it is successful or whether it fails, you will see one of the following messages:
CPC2356 - Save or restore option completed successfully.
CPF2361 - Error occurred with the option.
You can display the history log and the above messages with the following command (message CPC3703 was not included in the command below because, if message CPC3709 is logged, this is enough to verify all libraries restored successfully):
1. CALL QCMD
2. DSPLOG PERIOD(('hh:mm:ss' 'mm/dd/yy') ('hh:mm:ss' 'mm/dd/yy')) MSGID(CPF0936 CPF0968 CPC3705 CPF3775 CPC3738 CPF377C CPC3709 CPF3770 CPF3773 CPF3779 CPC9023 CPF9003 CPF909B CPF370E CPF370F CPF3839 CPC3710 CPF3845 CPF3776)
where hh:mm:ss is the time and mm/dd/yy is the date (the format will differ, depending on the QDATE system value). If any of the above CPCxxxx messages are missing, that portion of the save did not complete successfully.
Note: If an error occurred with the option, you will need to review the complete joblog of the save to determine what was not saved and why. The following are some additional messages which may be logged in the joblog that may help determine why the restore failed for some objects. This is not a complete list.
CPC8D01 - Document &2 restored in folder &7.
CPC8D10 - Document &2 not restored.
CPC9052 - &1 folders restored.
CPC9053 - &1 document library objects restored.
CPC3716 - No objects restored, all objects were excluded.
CPF379C - &2 &1 was excluded.
CPD37A0 - &2 &1 in library &3 not restored.
CPD37A1 - &2 &1 in library &3 not restored.
CPD37A2 - &2 &1 not restored to library &3.
CPD37A3 - Object not restored, &2.
CPD37A4 - Object not restored, &2.
CPD37A5 - &1 not restored, &2.
CPD370E - Object &1 in &3 not restored.
CPD370F - Object &1 in &3 not restored.
CPD3722 - Object &1 type &2 in &3 not restored.
CPF377B - No objects restored. &3 objects excluded.
CPI373B - All objects completed for DFRID &1.
CPF32C7 - Deferred file not restored.
CPI321E - File &1 in library &2 deferred.
CPF0633 - File &1 not restored to library &2.
CPF3744 - &2 &1 not restored to library &3.
CPF373B- &2 &1 not restored to library &3.
CPF3756 - &2 &1 not restored to &3.
CPF3706 - &2 &1 not restored to library &3.
CPF378D - &2 &1 not restored to library &3.
CPF378F - &2 &1 in library &3 not restored.
CPF0C47 - Folder &5 for product &1 was restored.
CPF90B4 - &1 folders restored to system, &2 not restored.
CPF90E7 - Document library objects not restored.
CPF90A3 - System object name &5 already exists.
CPD377A - Object not restored, &4.
CPC3706 - Private authorities restored for user profile &1.
CPD3776 - Authority not restored for user &1.
CPF3736 - Authority not restored for user &4.
CPD2206 - Private authorities not restored.
Resolving The Problem
Let's take a look at a real world example.
A customer has recently run a GO RESTORE 21 to restore their entire system, and feels that everything completed normally, but the next day they find that their system data is taking a lot less space than it used to, and many programs do not work, though operating system commands are fine. The help text for GO RESTORE shows that option 21 runs the following commands:
......................................................................
: Option 21 - Help :
: :
: This option runs the following commands: :
: :
: ENDTCPSVR SERVER(*ALL) :
: ENDHOSTSVR SERVER(*ALL) ENDACTCNN(*DATABASE *FILE) :
: DLYJOB JOB(number-of-seconds) :
: ENDTCP CONFIRM(*NO) :
: DLYJOB JOB(number-of-seconds) :
: ENDSBS SBS(*ALL) OPTION(*IMMED) :
: RSTUSRPRF :
: RSTCFG OBJ(*ALL) :
: RSTLIB SAVLIB(*NONSYS) :
: RSTDLO DLO(*ALL) SAVFLR(*ANY) :
: RST OBJ(('/*') ('/QSYS.LIB' *OMIT) ('/QDLS' *OMIT)) :
: RSTAUT USRPRF(*ALL) :
: STRSBS SBSD(controlling-subsystem) :
:....................................................................:
Because we know that the system libraries were restored, we can check and see if the DLO was restored. From the table above we can see that the RSTDLO messages are CPC9023, CPF9003, and CPF909B, so the command we run to check if DLO installed is:
DSPLOG PERIOD(('hh:mm:ss' 'mm/dd/yy') ('hh:mm:ss' 'mm/dd/yy')) MSGID(CPC9023 CPF9003 CPF909B)
In the case of this customer, the reply "(No messages available)" was seen, meaning that the DLO was not restored. Which also meant that the IFS had not been restored. It turned out that a Cancel had been pressed some time during the restore operation, and the customer needed to restore DLO, the IFS, and then run the RSTAUT USRPRF(*ALL) as seen in the help text above.
A customer has recently run a GO RESTORE 21 to restore their entire system, and feels that everything completed normally, but the next day they find that their system data is taking a lot less space than it used to, and many programs do not work, though operating system commands are fine. The help text for GO RESTORE shows that option 21 runs the following commands:
......................................................................
: Option 21 - Help :
: :
: This option runs the following commands: :
: :
: ENDTCPSVR SERVER(*ALL) :
: ENDHOSTSVR SERVER(*ALL) ENDACTCNN(*DATABASE *FILE) :
: DLYJOB JOB(number-of-seconds) :
: ENDTCP CONFIRM(*NO) :
: DLYJOB JOB(number-of-seconds) :
: ENDSBS SBS(*ALL) OPTION(*IMMED) :
: RSTUSRPRF :
: RSTCFG OBJ(*ALL) :
: RSTLIB SAVLIB(*NONSYS) :
: RSTDLO DLO(*ALL) SAVFLR(*ANY) :
: RST OBJ(('/*') ('/QSYS.LIB' *OMIT) ('/QDLS' *OMIT)) :
: RSTAUT USRPRF(*ALL) :
: STRSBS SBSD(controlling-subsystem) :
:....................................................................:
Because we know that the system libraries were restored, we can check and see if the DLO was restored. From the table above we can see that the RSTDLO messages are CPC9023, CPF9003, and CPF909B, so the command we run to check if DLO installed is:
DSPLOG PERIOD(('hh:mm:ss' 'mm/dd/yy') ('hh:mm:ss' 'mm/dd/yy')) MSGID(CPC9023 CPF9003 CPF909B)
In the case of this customer, the reply "(No messages available)" was seen, meaning that the DLO was not restored. Which also meant that the IFS had not been restored. It turned out that a Cancel had been pressed some time during the restore operation, and the customer needed to restore DLO, the IFS, and then run the RSTAUT USRPRF(*ALL) as seen in the help text above.
[{"Type":"MASTER","Line of Business":{"code":"LOB68","label":"Power HW"},"Business Unit":{"code":"BU070","label":"IBM Infrastructure"},"Product":{"code":"SWG60","label":"IBM i"},"ARM Category":[{"code":"a8m0z000000cwp6AAA","label":"Save Restore"}],"ARM Case Number":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"All Versions"}]
Was this topic helpful?
Document Information
Modified date:
14 October 2024
UID
nas8N1020174