
" This file is not used by NOS/VE.  However, it is provided as a template so
" that you may create your own exception policies for the
" MANAGE_EXCEPTION_POLICY utility.

" Exception policies are automatically installed after a deadstart by the
" ACTIVATE_PRODUCTION_ENVIRONMENT command.

" The NOS/VE system default exception policies are provided below.  You may
" want to change the default policies.  For example:

"   - If you feel that the system should not wait for cycle busy in a batch
"     job, you may want to add the following policy:

"         chaep job_mode=batch cycle_busy=exit

"   - If you have a missing or unavailable volume, you expect repair to
"     successfully reinstate the data, and you know approximately how long it
"     will take to repair the disk unit, you may want to adjust the polling
"     frequency to reduce unnecessary swaps of the affected jobs.  Each
"     affected job will retry access to the affected file or catalog every
"     POLLING_FREQUENCY seconds.

"   - Likewise, you may want to adjust the POLLING_FREQUENCY for other common
"     conditions such as CYCLE_BUSY, CYCLE_RESTORATION_REQUIRED, or
"     DATA_RETRIEVAL_REQUIRED.

" You may also want to create additional policies to address disaster
" situations.  It is recommended that you append additional policies after
" the set of default policies to ensure that all conditions will have a
" policy.  If multiple policies could apply for a particular condition, the
" last one defined takes effect.

" If you want to make any changes to the system default exception policies,
" this is the process we recommend:

"     1.  Copy this file to $SYSTEM.MAINFRAME.OSF$SITE_EXCEPTION_POLICIES,
"         if you have not previously done so.

"     2.  Edit $SYSTEM.MAINFRAME.OSF$SITE_EXCEPTION_POLICIES to add, modify,
"         or delete exception policies.

"     3.  Execute the command INSTALL_EXCEPTION_POLICIES from the command
"         library $SYSTEM.OSF$BUILTIN_LIBRARY.  (This step is only necessary
"         if you are installing exception policies after the system is
"         activated for production and do not plan an immediate deadstart.)

"     4.  NOS/VE will automatically execute the file
"         $SYSTEM.MAINFRAME.OSF$SITE_EXCEPTION_POLICIES when the
"         command ACTIVATE_PRODUCTION_ENVIRONMENT is executed.  This ensures
"         that policies that you define are carried across deadstarts.

"     5.  If you have defined exception policies for an emergency
"         situation, remember to delete the extraneous exception policies
"         after the emergency has passed.

" NOTES:

"   o It is not recommended that you change the policy for the System Job
"     unless absolutely necessary.  It is vital to your ability to get
"     through deadstart that the EXIT option be chosen for most conditions.
"     The WAIT option was selected for CYCLE_BUSY to allow the use of the
"     Removable Media Management System (RMS) from the System Console; if you
"     do not have this product installed, you may select the EXIT option
"     instead.

"   o The value selected for the POLLING_FREQUENCY is important to system
"     performance.

"       - A value of 7 seconds or greater will ensure that a job affected by
"         an exception condition will swap out while waiting for the
"         condition to clear.  A value less than 7 seconds may keep the job
"         in memory and it will take a share of the CPU as well.

"       - By selecting a wise value for POLLING_FREQUENCY you may improve the
"         performance of the system for certain conditions.  If you use a
"         large number of seconds, the user may have to wait almost that long
"         after the condition clears before regaining the CPU.  So be
"         careful.  If you expect the condition to last N seconds, you may
"         want to select a POLLING_FREQUENCY that is N/2 or N/4 to ensure
"         some responsiveness to the user when the condition clears.

SYSTEM_OPERATOR_UTILITY
  MANAGE_EXCEPTION_POLICIES

    " Policies for jobs other than the System Job
    change_exception_policies files=all catalog_volume_unavailable=wait ..
          cycle_restoration_required=wait volume_unavailable=wait ..
          polling_frequency=60

    change_exception_policies files=all data_retrieval_required=wait ..
          polling_frequency=35

    change_exception_policies files=all file_server_inactive=wait ..
          polling_frequency=30

    change_exception_policies files=all space_unavailable=wait ..
          polling_frequency=10

    change_exception_policies files=all cycle_busy=wait ..
          polling_frequency=7

    " Policies for the System Job
    change_exception_policies jobs=$aaa_0000 catalog_volume_unavailable=exit ..
          cycle_busy=wait cycle_restoration_required=exit ..
          data_retrieval_required=exit file_server_inactive=exit ..
          space_unavailable=wait volume_unavailable=exit polling_frequency=5

    "Insert your CHANGE_EXCEPTION_POLICY subcommands here"

    install_exception_policies
  QUIT
QUIT

