Check and recover damaged objects http://search400.techtarget.com/news/809898/Check-and-recover-dam...

Search400.com
Check and recover damaged objects

By Ian Showell

1. Display the QHST (history) log by typing DSPLOG and pressing F4 (Prompt).

2. On the prompt display, fill in a starting date and time to limit the number of entries you see.

3. On the display, fill in *PRINT for the Output prompt and press the Enter key.

4. Type: WRKSPLF. You are shown a list of spooled files for your job.

5. Locate the spooled file for the DSPLOG command. Use option 3 to hold the spooled file.

6. Use option 5 to display the spooled file.

7. Look for entries for damaged objects and files that are not synchronized. You can use the Find function
to search for lines that have these character strings: damage and sync. Following are some examples of
messages you might see:

CPF3113
Member damaged

CPF3175
File is not synchronized

CPF3176
Data space is partially damaged

CPF3171
Journal is damaged

CPF3172
Objects are not synchronized with the journal

CPF3173
Journal receiver is damaged

CPF3174
Journal receiver is partially damaged

CPF81xx
General messages about object damage

8. Write down the names and types of the objects you find. Consult the table below for the correct
recovery procedure, based on the type of object that is damaged.

Type of Object - Operating system object in QSYS library Advice - Contact software support for
assistance. You may need to install the operating system again.

1 of 5 22/07/2016 16:03
Check and recover damaged objects http://search400.techtarget.com/news/809898/Check-and-recover-dam...

Type of object - IBM-supplied user profile.

Advice - Perform an abbreviated installation of the operating system.

Type of object - Job description that is specified on the workstation entry for the console in the
controlling subsystem.
Advice - If no other workstation entries exist for the controlling subsystem, the system is not useable.
Contact software support for assistance.

Type of object - Job queue

Advice - Perform an IPL. Restore or re-create the damaged job queue. All entries are lost.

Type of object - Output queue

Advice - Perform an IPL. If the output queue is the default output queue for a printer, it is re-created and
it's entries are rebuilt. Other output queues must be restored or re-created. Their entries are not recovered.

Type of object - Damaged file whose name starts with QAOSS* Advice - Delete the file. Restore it from
a backup copy. Run the RCLDLO DLO(*DOCDTL) command.

Type of object - Database file

Advice - Performing a special IPL during which the system analyzes every disk segment for parts of
database objects can recover some types of object-level damage to database files. Following are examples
of object-level damage:

Lost pointers between the index (access path) and the data.

Unidentified objects on the object recovery list.

If you are experiencing problems with database files, you can display the Licensed Internal Code log to
determine whether a special IPL may resolve the problems.

Note: You must have *SERVICE special authority to perform the tasks that are described in this topic.

Do the following:

1. Type STRSST and press the Enter key. You are shown the System Service Tools (SST) menu.

2. Select option 1 (Start a service tool). You are shown the Start a Service Tool display.

3. Select option 5 (Licensed Internal Code log). You are shown the Licensed Internal Code Log display.

4. Select option 1 (Select entries from the Licensed Internal Code log). You are shown the Specify
Licensed Internal Code Log Selection Values display.

5. Type 0600 for the Major code prompt.

6. Type 145F for the Minor code prompt.

7. For the starting date and time, enter values that approximate when you first started to have problems.

8.For the ending date and time, enter the current date and time.

9. Press the Enter key. If any errors have been recorded that may be resolved by a special IPL, you are
shown a list of the entries. Otherwise, you receive a message that no log entries matched your criteria.

If you have log entries that suggest a special IPL, you need to schedule a time for this IPL. It may take

2 of 5 22/07/2016 16:03
Check and recover damaged objects http://search400.techtarget.com/news/809898/Check-and-recover-dam...

many hours for the system to analyze all the disk segments. As a rough estimate, the analysis phase of the
IPL will take approximately 1 second for each object on your system.

When you are ready to perform the IPL, do the following:

1. Place your system in a restricted state. See "Putting Your System in a Restricted State" in topic 3.1.4.

2. Type STRSST and press the Enter key. You are shown the System Service Tools (SST) menu.

3. Select option 1 (Start a service tool). You are shown the Start a Service Tool display.

4. Select option 4 (Display/Alter/Dump). You are shown the Display/Alter/Dump Output Device display.

5. Select option 1 (Display/Alter storage). You are shown the Select Data display.

6. Select option 5 (Starting address). You are shown the Specify Starting Address display.

7. Type 000000000E 000000 for the address and press the Enter key. You are shown the Display Storage
display.

8. On the third data line (offset 0020), type 8 in the first character. Press F11 (Alter storage) to make the
change take affect.

9. Press F3 until you return to the Exit System Service Tools display.

10. Press the Enter key (continue ending SST).

11. On the command line, type PWRDWNSYS OPTION(*IMMED) RESTART(*YES)

This causes the system to begin the special IPL.

Attention logical partitioning users! If you are going to use this command on the primary partition, be
sure to power off all secondary partitions before running the command.

Type of object - Journal

Advice - Note: The following steps only apply to recovering a damaged local journal.

Do the following:

1. Type WRKJRN.

2. On the prompt display, type the name of the journal. You are shown the Work with Journals display.

3. Select option 6 (Recover damaged journal).

4. Type: WRKJRNA JRN(library-name/journal-name) OUTPUT(*PRINT). You receive a listing that

shows all the physical files and access paths that are currently being journaled.

5. Start journaling for any physical files that should be journaled but are not on the list by using the
STRJRNPF command.

6. Start journaling for any access paths that should be journaled but are not on the list by using the
STRJRNAP command.

7. If you previously had any remote journals that were associated with the damaged journal, add those

3 of 5 22/07/2016 16:03
Check and recover damaged objects http://search400.techtarget.com/news/809898/Check-and-recover-dam...

remote journals again. You can add the remote journals by using the Add Remote
Journal(QjoAddRemoteJournal) API or the Add Remote Journal (ADDRMTJRN) command.

8. Save each journal, physical file, and access path. You should always save files after you start journaling
them.

Type of object - Journal receiver

Advice - Note: The following steps only apply to recovering a damaged journal receiver that was attached
to a local journal.

Do the following:

1. Type WRKJRN.

2. On the prompt display, type the name of the journal that is associated with the damaged journal
receiver. You are shown the Work with Journals display.

3. Select option 7 (Recover damaged journal receivers).

Type of object - Journaled file

Advice - for a journaled file that is damaged, do the following:

1. Find your most recent saved copy of the file.

2. Delete the file.

3. Load the save media and restore the file. Type:

RSTOBJ OBJ(object-name) OBJTYPE(*FILE)

SAVLIB(library-name)
DEV(media-device-name)

4. Restore any journal receivers that are needed to recover the file, if they are not already on the system.

5. Use the APYJRNCHG command to apply journaled changes.

Do the following for a journaled file that could not be synchronized:

1. Restore the file from your most recent saved copy.

2. Apply journaled changes to bring the file up to date.

Note: You may need to perform this procedure for all the files if there are other files related to the file that
is not synchronized. Otherwise, the files may not be synchronized with each other.

Type of object - All others

Advice - use the following procedure to recover most damaged objects on the system.

1. Find your most recent saved copy of the damaged object.

Note: If the damaged object is in the QSYS library, you may need to restore the operating system. Contact
software support for assistance.

2. Delete the object.

4 of 5 22/07/2016 16:03
Check and recover damaged objects http://search400.techtarget.com/news/809898/Check-and-recover-dam...

3. Load the save media and restore the object. Type:

RSTOBJ OBJ(object-name)
OBJTYPE(object-type)
SAVLIB(library-name)
DEV(media-device-name)

9. Watch for additional indications that objects have been damaged. Some indications are:

You cannot start the system because auxiliary storage is full.

The system has ended abnormally several times since the last time you ran the Reclaim
Storage(RCLSTG) procedure.

You see objects on the Work with Objects by Owner display that have no library associated with them.

The system status display shows an unexpectedly high percentage of auxiliary storage that is used.

You cannot access the data in a database file because a member is damaged. Message CPF8113 indicates
this.

You cannot access objects because a damaged authorization list or authority holder secures them.

If you see these indications on your system, run the RCLSTG procedure.

If you see these indications after a disk unit was replaced and the data was restored from a partial pump,
you should recover the entire ASP that contained the failed disk unit.

Code: CPF3113 - Member damaged

CPF3175 - File is not synchronized

CPF3176 - Data space is partially damaged
CPF3171 - Journal is damaged

12 Mar 2002

All Rights Reserved, Copyright 1999 - 2016, TechTarget | Read our Privacy Statement

5 of 5 22/07/2016 16:03