| DESCRIPTION OF ENHANCEMENTS |
"A4A7*1.01*9" IN DHCP PATCHES FILE:ESCRIPTION NOV 19,1996 PAGE 1
If the report indicates there are routines or DDs that reference these
IMPLEMENTATION: This patch consists of three routines, two of which (A4A7B
and A4A7B0) search for references to Files 3/6/16/20 and a third,
(A4A7B1), which will print out the results of the most recent search.
This patch contains no templates or options, only the routines. It is
designed to be used at the site in programmer mode to allow checking and
correcting your site's modifications that may point to the files to be
removed.
files, a programmer should be consulted to update the pointers. If the
This is a programmer set of routines intended to be run in IRM by a
programmer in programmer mode. To run the utility, D ^A4A7B from
programmer mode to scan ========
and D ^A4A7B1 to print the results.
=========
It is suggested that, for Full Database runs, this utility be run during
off-peak hours (at night or over a weekend). Estimated Run time is about 4
hours.
report indicates a pointer referenced in a nationally released package,
The user is first asked whether to run a partial database search (P) or all
(A). If "A" is chosen, the user is given the option of queuing it to be
run as a background task. (The process of a complete database search can
be quite lengthy.) If you chose not to queue the task, it will be done
immediately.
------------------------------------------------------------------------
CAPTURED EXAMPLES OF USE:
-------------------------
COMPLETE DATABASE SEARCH:
check to see if you have the latest version and patches. If it is the
-------------------------
>D ^A4A7B
========
Partial or All (A or P) default A // <return>
=
TASK THE COMPLETE SEARCH? Y/N (CAPS ONLY) // Y
latest and a reference is found, please contact customer support.
=
Requested Start Time: NOW// <return> (OCT 28, 1996@07:14:05)
=
TASK 88452
------------------------------------
P(artial) - PARTIAL DATABASE SEARCH:
------------------------------------
If you select a partial run, you will be asked what part you wish to do
(Data Dictionary, Routines, or Other [templates/forms/blocks]) and then
what part, if any, of that choice you wish to further limit. This can be
done to a file number, a single letter range of routines, or a family of
templates. These partial runs may take as little as 2 to 10 minutes on a
lightly loaded machine, hence they are not queueable.
----------------
Data Dictionary:
In the near future, Files 3/6/16/20 will be removed and only File 200 will
----------------
>D ^A4A7B
========
Partial or All (A or P) default A // P
=
Which section? (Data Dictionary (D) Routines (R)
or templates/forms/blocks (O) // D
remain. A patch will be released soon to perform step two and remove the
=
Please enter start and end file numbers in the form (start,end) // 400,500
=======
---------
Routines:
---------
>D ^A4A7B
========
data dictionaries and the data for Files 3/6/16/20. That patch will also
Partial or All (A or P) default A // P
=
Which section? (Data Dictionary (D) Routines (R)
or templates/forms/blocks (O) // R
=
FOR WHICH SINGLE LETTER RANGE (CAPS ONLY) // L
=
remove any cross references used in File 200 to point to these files.
------
Other:
------
>D ^A4A7B
========
Partial or All (A or P) default A // P
=
Which section? (Data Dictionary (D) Routines (R)
or templates/forms/blocks (O) // O
=
SELECT INPUT TEMPLATES (I), SORT TEMPLATES (S), PRINT TEMPLATE (P),
FUNCTIONS (F), FORMS (A), BLOCKS (B) (CAPS ONLY) // I
=
------
PRINT:
------
PATCH HISTORY:
>D ^A4A7B1
=========
This report could take some time, remember to QUEUE the report
DEVICE: HOME // QUEUE TO PRINT ON
=
DEVICE:
--------------------------------------------------------------------------
The job is stoppable while in the background by D STOP^A4A7B. If the
==============
============
tasked job is stopped or is simply crunched, the job can later be retasked
by D TASK^A4A7B. The search will restart from a safe recovery point.
============
The crunch may be from a OS or MUMPs crash or simply losing the partition
due to some reason. The restart capability was designed for full database
scans. It is suggested for less than full database scans the scan be rerun
from scratch in local since the run time is short.
When the search run is complete, you will run the print routine A4A7B1 to
print the results. The results will be sent to a printer or displayed on
the screen. The Global ^Utility("A4A7B", is used to hold the data for this
utility. WARNING: When a new run is started, the old data from the last
search is removed from the global (except for recoveries).
The A4A7B* routines are to be deleted after the 3/6/16/20 sterilization
routines are run (coming as a separate patch).
NOTE: the ^UTILITY("A4A7B", is not automatically removed upon completion
of the runs, but must be removed manually at the time the A4A7B* routines
This patch was generated to give the developers and sites one more tool
are deleted. The code to be used is K ^UTILITY("A4A7B").
===================
to make a last check to ensure that none of their code or FileMan data
points to the files 3/6/16/20. The decision was made years ago to go to
a single new file New Person (200) so that the 4 logically equivalent
files would be combined.
OVERVIEW: This patch is step one in the process of removing Files 3, 6,
Routine Summary:
================
The following is a list of the routines included in this patch. The
second line value of each of these routines will look like:
<tab>;;1.01;New Person File;**9**;2/9/96
* *
16, and 20. It provides the means to examine your site's routines,
Routine Name Before Patch After Patch Patch List
============ ============ =========== ==========
A4A7B n/a 19871326 9
A4A7B0 n/a 11784974 9
A4A7B1 n/a 13417104 9
* from CHECK^XTSUMBLD
screens, templates and data dictionaries for all references to Files 3, 6,
Environmental Check Routine
===========================
None
Installation Instructions:
==========================
HOW LONG?: Installation will take less than 2 minutes.
16, and 20. It next prints a report of all cross references, regular
1. Use the INSTALL/CHECK MESSAGE option on the PackMan and respond YES
===
at the prompt 'Want to Continue with load? YES//' (Press return).
2. Review your Mapped Routine set. If any of the routines listed in
the ROUTINE SUMMARY section are mapped on your system, they should
be removed from the Mapped set at this time.
3. From the Kernel Installation and Distribution System Menu, select
pointers, routines, and templates with pointers that use these files so
the Installation menu.
4. From the Installation menu, you may elect to use the following
options: (when prompted for the install name enter A4A7*1.01*9)
===========
a. Back up the Transport Global - This option will create a backup
message of any routines exported with this patch. It will NOT
back up any other changes such as DDs or templates.
b. Verify checksums in the transport global - this option will
that you know where the references are that must be removed.
allow you to ensure the integrity of the routines that are in
the Transport Global.
5. Use the Install Package(s) options and select the package:
A4A7*1.01*9.
===========
6. When prompted 'Want to DISABLE Scheduled Options, Menu Options,
and Protocols? Yes//', respond NO.
==
7. MSM sites: Please ensure you answer YES when asked if you want
===
to move the routines to other systems and indicate the appropriate
CPUs. Alternatively, you can wait until the installation is
complete and move the routines listed in the Routine Summary
Section to all systems.
8. If the routines were unmapped as part of step 2, they should be
returned to the Mapped set once the installation has run to
completion.
|
