$TXT Created by SCHMITZ,STEVEN at MNTVBB.FO-WASH.MED.VA.GOV (KIDS) on Wednesday, 11/09/05 at 08:01 ============================================================================= Run Date: DEC 22, 2005 Designation: PRC*5.1*93 Package : PRC - IFCAP Priority: Mandatory Version : 5.1 SEQ #77 Status: Released Compliance Date: JAN 22, 2006 ============================================================================= Subject: CHANGE EXISTING TRANSACTION NUMBER ERROR Category: - Routine Description: ============ A null subscript error occurs when accessing Change Existing Transaction Number [CHANGE EXISTING TRANSACTION NU] option under the Create 2237 [CREATE 2237 (PPM) PRCN NX PPM 2237] menu option. The error occurs when the user has access to multiple control points at a specific site and one is not selected properly. ASSOCIATED REMEDY TICKET: ========================= HD55253 SBY-1001-32600 ERROR - CP+12~PRCSUT:1, %DSM-E-NULLSUBSCR ASSOCIATED IT SERVICE REQUEST(S): ================================= N/A PARTICIPATING TEST SITES: ========================= Saginaw, MI Fayetteville, NC West LA HCS, CA REMEDY OVERVIEW: ================ HD55253 SBY-1001-32600 ERROR - CP+12~PRCSUT:1, %DSM-E-NULLSUBSCR Problem: -------- A null subscript error occurs when accessing Change Existing Transaction Number [CHANGE EXISTING TRANSACTION NU] option under the Create 2237 [CREATE 2237 (PPM) PRCN NX PPM 2237] menu option. This occurs when a user has access to multiple control points at a specific site and one is not selected properly. Resolution: ----------- A change needed to be made to routine PRCSUT to account for a possible null value in the control point variable. Technical Description ===================== HD55253 SBY-1001-32600 ERROR - CP+12~PRCSUT:1, %DSM-E-NULLSUBSCR The user was running another option that set the PRC("CP") variable to null. This caused an error to be thrown because only $D was used to validate the data in PRC("CP"), which is equivalent to asking if the variable exists. The variable did exist so it used the null value in a global reference. An additional check for IF PRC("CP") was added. This seemed to best solution and not to clear/kill/new the PRC("CP") variable. By leaving the value in PRC("CP"), the feature that allows the system to remember what the last Control Point the user selected will remain. ROUTINE SUMMARY =============== The following is a list of the routines included in this patch. The second line of the routine looks like: V ;;5.1;IFCAP;**93**;Oct 20, 2000 OLD CHECK^XTSUMBLD results Routine Before Patch After Patch Patch List ------- ------------ ----------- ---------- PRCSUT 11633431 11679232 93 NEW CHECK1^XTSUMBLD results Routine Before Patch After Patch Patch List ------- ------------ ----------- ---------- PRCSUT 54436046 54556386 93 ====================INSTALLATION INSTRUCTIONS=========================== This patch can be installed with users on the system. Install Time - less than 2 minutes. 1. LOAD TRANSPORT GLOBAL --------------------- Choose the PackMan message containing this patch and invoke the INSTALL/CHECK MESSAGE PackMan option. 2. START UP KIDS ------------- Start up the Kernel Installation and Distribution System Menu [XPD MAIN]: Edits and Distribution ... Utilities ... Installation ... Select Kernel Installation & Distribution System Option: INStallation --- Load a Distribution Print Transport Global Compare Transport Global to Current System Verify Checksums in Transport Global Install Package(s) Restart Install of Package(s) Unload a Distribution Backup a Transport Global 3. Select Installation Option: --------------------------- NOTE: The following are OPTIONAL - (When prompted for the INSTALL NAME, enter PRC*5.1*93): a. Backup a Transport Global - This option will create a backup message of any routines exported with this patch. It will not backup any other changes such as DD's or templates. b. Compare Transport Global to Current System - This option will allow you to view all changes that will be made when this patch is installed. It compares all components of this patch (routines, DD's, templates, etc.). c. Verify Checksums in Transport Global - This option will allow you to ensure the integrity of the routines that are in the transport global. 4. Select Installation Option: Install Package(s) ------------------ **This is the step to start the installation of this KIDS patch: a. Choose the Install Package(s) option to start the patch install. b. When prompted 'Want KIDS to INHIBIT LOGONs during the install? YES//' answer NO c. When prompted 'Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES//' answer YES d. When prompted 'Enter options you wish to mark as 'Out Of Order':' Enter the following options: CHANGE EXISTING TRANSACTION NUMBER [PRCSANTN] e. When prompted 'Enter protocols you wish to mark as 'Out Of Order':' press . INSTALLATION EXAMPLE: ===================== Select Installation Option: 6 Install Package(s) Select INSTALL NAME: PRC*5.1*93 Loaded from Distribution 11/9/05@09:37:1 9 => PRC*5.1*93 This Distribution was loaded on Nov 09, 2005@09:37:19 with header of PRC*5.1*93 It consisted of the following Install(s): PRC*5.1*93 Checking Install for Package PRC*5.1*93 Install Questions for PRC*5.1*93 Want KIDS to INHIBIT LOGONs during the install? YES// NO Want to DISABLE Scheduled Options, Menu Options, and Protocols? YES// Enter options you wish to mark as 'Out Of Order': CHANGE EXISTING TRANSACTION NU PRCSANTN Change Existing Transaction Number Enter options you wish to mark as 'Out Of Order': Enter protocols you wish to mark as 'Out Of Order': Delay Install (Minutes): (0-60): 0// Enter the Device you want to print the Install messages. You can queue the install by enter a 'Q' at the device prompt. Enter a '^' to abort the install. DEVICE: HOME// TCP PRC*5.1*93 -------------------------------------------------------------------------- Install Started for PRC*5.1*93 : Nov 09, 2005@09:38:37 Build Distribution Date: Nov 09, 2005 Installing Routines: Nov 09, 2005@09:38:37 Updating Routine file... Updating KIDS files... PRC*5.1*93 Installed. Nov 09, 2005@09:38:38 Install Message sent #438423 -------------------------------------------------------------------------- +------------------------------------------------------------+ 100% | 25 50 75 | Complete +------------------------------------------------------------+ Install Completed Routine Information: ==================== The checksums below are new checksums, and can be checked with CHECK1^XTSUMBLD. Routine Name: PRCSUT Before: B54436046 After: B54556386 **93** ============================================================================= User Information: Entered By : SCHMITZ,STEVEN Date Entered : NOV 07, 2005 Completed By: CROSSMAN,PAM Date Completed: DEC 21, 2005 Released By : NELSON,VICKI M Date Released : DEC 22, 2005 ============================================================================= Packman Mail Message: ===================== $END TXT