Job log considerations

The job logs that are generated by a Restore Authority (RSTAUT) command running on a system in a nonrestricted state are significantly different than those for a system in a restricted state.

When the RSTAUT command runs on a system in a restricted state, one job log is generated. When the RSTAUT command runs on a system in a nonrestricted state, each prestarted job (run by RSTAUT) generates a job log that contains some of the information that is found in the single job log that is produced on a system running in a nonrestricted state. If only one user profile is being restored, only one job log is produced.

You might encounter a situation where job logs that contain diagnostic messages from prestarted jobs that ran during the RSTAUT get deleted. If this occurs, you can rerun the RSTAUT command at any time before running another Restore User Profiles (RSTUSRPRF) command or Reclaim Storage (RCLSTG) command. The system will attempt to regrant the failed private authorities, and will generate new job logs.

Figure 1 through Figure 3 show a sample job log and message information for a RSTAUT USRPRF(QPGMR) command run on a system in a restricted state.

Figure 1. Sample job log for RSTAUT on a system in a restricted state

>RSTAUT USRPRF(QPGMR)
Authority not restored for user QPGMR.
Some authorities not restored for user profile QPGMR.
Not all user profiles had all authorities restored.

The expanded text for message CPF3736 appears as follows:

Figure 2. Expanded text for message CPF3736

              Additional Message Information

Message ID......:  CPF3736        Severity......:  20
Message type....:  Diagnostic
Date sent ......:  04/24/97     Time sent......:  19:35:17

Message....:  Authority not restored for user QPGMR.
Cause......:  Private authority for DTAARA DTAARA1 in library QGPL was
 not restored. Either the object does not exist, is damaged, or was not
 available at the time authority was being granted.
Recovery...:
  Do one of the following:
 --If the system was dedicated while the RSTAUT command was running,
 display the description of the object (DSPOBJD command). If the object was
 damaged or not found, restore the user profile (RSTUSRPRF command), restore
 the object (RSTOBJ command), and restore the authorizations (RSTAUT command).
 If the object exists and is not damaged, report the problem (ANZPRB command).

The expanded text for message CPF3845 appears as follows:

Figure 3. Expanded text for message CPF3845

              Additional Message Information

Message ID......:  CPF3845        Severity......:  20
Message type....:  Diagnostic
Date sent ......:  04/24/97     Time sent......:  19:35:17

Message....:  Some authorities not restored for user profile QPGMR.
Cause......:  1434 authorities were restored and 1 authorities were not
 restored for user profile QPGMR at 04/24/97 19:21:36.
   The prestart job name used to restore private authorities for this user
 profile is *N. The prestart job name that contains messages about
 authorities not restored is *N.
  --If the job name above is *N then a prestart job was not used to restore
  authorities for this user profile.
  --If a job name other than *N is listed above, then a prestart job was
  used to restore private authorities for this user profile and messages can
  be found in the joblog for the job name listed. Use one of the following
  commands to display the joblog for the prestarted job:

In the case of a system in a restricted state, all messages appear in the user's main job log. When the name of the prestarted job that is used in message CPF3845 is *N, then no prestarted job was used.

Figure 4 and Figure 5 show a sample job log and message information for a RSTAUT USRPRF(QPGMR QUSR) command run on a system in a nonrestricted state.

Figure 4. Sample job log for RSTAUT on a system in a nonrestricted state

>RSTAUT USRPRF(QPGMR QUSR)
Start of prestart jobs in progress.
Some authorities not restored for user profile QPGMR.
Private authorities restored for user profile QUSR.
End of prestart jobs.
Not all user profiles had all authorities restored.

The expanded text for message CPF3845 appears as follows:

Figure 5. Expanded text for message CPF3845

              Additional Message Information

Message ID......:  CPF3845        Severity......:  20
Message type....:  Diagnostic
Date sent ......:  04/24/97     Time sent......:  19:35:17

Message....:  Some authorities not restored for user profile QPGMR.
Cause......:  1433 authorities were restored and 2 authorities were not
 restored for user profile QPGMR at 04/24/97 19:21:36.
   The prestart job name used to restore private authorities for this user
 profile is 010648/QUSER/QSRRATBL. The prestart job name that contains
 messages about authorities not restored is 010648/QUSER/QSRRATBL.
  --If the job name above is *N then a prestart job was not used to restore
  authorities for this user profile.
  --If a job name other than *N is listed above, then a prestart job was
  used to restore private authorities for this user profile and messages might
  be found in the joblog for the job name listed. Use one of the following
  commands to display the joblog for the prestarted job:

In Figure 5, the name of the prestarted job used is 010648/QUSER/QSRRATBL, and it appears in the CPF3845 message. The CPF3736 message for the data area DTAARA1 in library QGPL whose authority was not restored, does not appear in the user's main job log. Instead, all messages that are related to restoring of individual private authorities are in the job log for the prestarted job. To view these messages, you would run the command DSPJOB JOB(010648/QUSER/QSRRATBL), and then select option 4 to view the job log for the prestarted job. The expanded message text for CPF3736 appears in that job log.

You should pay special attention to any CPF3845 message that states that *N authorities were not restored. This might indicate a problem such as damaged objects or a function check. Any CPF3845 message with *N authorities that are not restored should be investigated further by checking the job log of the prestarted job that is named.

If all authorities in an authority reference table were restored successfully, then message CPC3706 is sent for the user profile instead of CPF3845. CPC3706 will also contain the name of the prestarted job that is used to restore authorities for the user profile. If all authorities restored from a prestarted job were restored successfully, then the job log for the prestarted job will contain only job start and end messages.

The order of CPC3706 and CPF3845 messages depends on whether you run the RSTAUT command on a system that is in a restricted or nonrestricted state. These messages are for user profiles with restored private authorities. The order of these messages is as follows:

Restricted state system: The order will generally be alphanumeric because only one authority table is being restored at a time, in alphanumeric order
Nonrestricted state system: The order will generally be that these messages will appear first for the user profiles with fewer private authorities, then later for the user profiles with many private authorities. This is because multiple authority reference tables are being restored at once and the smaller authority reference tables typically complete first.