Clarity Service Management

Expand all | Collapse all

SDM 12.7 C2 RO68594 "TabBanner" error on Attachments

  • 1.  SDM 12.7 C2 RO68594 "TabBanner" error on Attachments

    Posted 05-25-2014 10:04 PM

    Hello Everyone,

    There have been a few reports of a "TabBanner" error when trying to load Attachments on Service Desk Manager 12.7, after applying Cumulative Patch 2 RO68594.

    There is a data file that should be loaded within this patch, which is causing this issue. I'll follow through with our CA Software Engineering team to see if there is a problem with the distribution, but in the meantime, here is a workaround.

    Note: Only use this if you observe this problem. Sites with the data file loaded will not this see problem and should not use this workaround.

    ======================================== START WORKAROUND             
    ISSUE                                                                 
    -------------                                                         
    Applied SDM 12.7 Cumulative Patch 2. Error comes up on attaching files:
    "AHD04622:Undefined arguments Style supplied to PDM_MACRO TABBANNER."
                                                                           
    RESOLUTION                                                            
    -------------                                                         
    Cumulative Patch RO68594 contains USRD 2601, patch T5N6419.           
    This T patch contained instructions in the .JCL file for loading an additional "ascii.dat" file which contained an update.                
                                                                           
    This can be worked around by following these steps:                   
    Modify data_USRD_2601_UPDATE.dat file to add the name column from:    
                                                                           
    TABLE usp_pdmMacro                                                    
      id text                                                              
                                                                           
      { "1174", "if (typeof &{btnfunc} == \"function\") {\\0012            
    tab_banner(\"&{title}\", &{add_btns}, &{show_bar}, &{btns_in_two_rows},
    &{btnfunc}, \"&{style}\");\\0012}\\0012else {\\0012                   
    tab_banner(\"&{title}\", &{add_btns}, &{show_bar}, &{btns_in_two_rows},
    void(0), \"&{style}\");\\0012}" }                                   

    to:                                                                    
                                                                            
    TABLE usp_pdmMacro                                                     
      id name text                                                          
                                                                            
      { "1174", "tabBanner", "if (typeof &{btnfunc} == \"function\") {\\0012
    tab_banner(\"&{title}\", &{add_btns}, &{show_bar}, &{btns_in_two_rows},
    &{btnfunc}, \"&{style}\");\\0012}\\0012else {\\0012                    
    tab_banner(\"&{title}\", &{add_btns}, &{show_bar}, &{btns_in_two_rows},
    void(0), \"&{style}\");\\0012}" }                                      
                                                                            
    where the "name" column with value "tabBanner" are new.                
                                                                            
    Then load  the data file again:                                        
    pdm_load -u -f data_USRD_2601_UPDATE.dat                               
                                                                            
    Refresh the cache:                                                     
    pdm_cache_refresh -t usp_pdmMacro                                      
           

    Please check out this solution on your test environment and confirm it works.                                                                         
    ======================================== END WORKAROUND                
                                                         

    The data is clearly there in the origianl T patch in a file called "ascii.dat" which *is* loaded in the T patch, but which is not loaded in the Cumulative Patch. I am not recommending loading of the ascii.dat file at present, as the above line is sufficient to resolve the issue, and as I'm not sure of the impacts of the language pack distribution.

    I hope that helps someone. Please add a post here if it does!

    Thanks, Kyle_R.



  • 2.  RE: SDM 12.7 C2 RO68594 "TabBanner" error on Attachments

    Posted 05-26-2014 09:06 PM
    Kyle_R:

    There have been a few reports of a "TabBanner" error when trying to load Attachments on Service Desk Manager 12.7, after applying Cumulative Patch 2 RO68594.
    .
    .
    .

    "AHD04622:Undefined arguments Style supplied to PDM_MACRO TABBANNER."   


    Hello Everyone,

    Root cause has been identified, and the good news is - you don't have to use the above workaround!

    The root cause was not following the Post Installation Steps exactly.

    This is the section which tripped up several sites:

    ------------------------------------------------------------------------

    Patch RO68585 POST INSTALLATION STEPS

    ======================== IMPORTANT NOTE: ===============

    Steps 1 through 5 are required steps. You need follow them to complete the installation.
    .
    .
    .
    d. Update the usp_pdmMacro and usp_pdmMacroParam tables by running
    the following commands on the command prompt:
    pdm_load -i -f data_USRD_2601_INSERT.dat
            pdm_load -u -f data_USRD_2601_UPDATE.dat

    ------------------------------------------------------------------------

    If the "-u" (update) is replaced by a "-i" (insert only), then the table is not updated as this row already exists. An error is thrown, but it is possible to miss this and continue on.

    The end result is no working Attachments tab.

    I can understand how this happened. My guess is that the user was going down a long list of data loads at the command line, using "up arrow" to replace the file name, and missed the variable change. It probably doesn't help that the patch notes are not lined up in this section, which may have made that easier to spot.

    Take Away Tip

    Use "Copy and Paste" when following Post Installation Steps.
    Don't type them out or use "up arrow" if in doubt.

     

    It's a good idea to make up your own "run sheet" in a plain text file, and adjust any changes to the commands that need to be issued, such as putting in your own server names.

    If you script it in a batch file, perhaps with a "pause" command at key places, there is less chance in having a difference between the UAT/test environment and the production run.

     

    Anyway, I'm pleased that there is not a problem with the deliverables in this area, and I still hope that this thread may help someone!

    Note that the workaround is still valid if you did encounter this issue. *

    Thanks, Kyle_R.

    * EDIT: But following the above command also works and is recommended instead of the first workaround.
    Also, for clarity, there is no problem with the ascii.dat deliverable.



  • 3.  Re: SDM 12.7 C2 RO68594 "TabBanner" error on Attachments

    Posted 08-12-2015 02:32 AM

    Update: Now with a screenshot!

     

    An example of a PDM_MACRO TABBANNER error found in the wild:

     

    AHD04622 PDM_MACRO TABBANNER error.png

     

    Fixed by following the same post-installation steps noted earlier. Note the "-u" and not the "-i" in these steps:

     

              pdm_load -u -f data_USRD_2601_UPDATE.dat  


    Thanks, Kyle_R.




  • 4.  Re: SDM 12.7 C2 RO68594 "TabBanner" error on Attachments

    Posted 01-05-2016 12:44 PM

    Hi Kyle_R.

     

     

    After I ran the patches RO72246 and RO72249, I had this error too.

    So, I did what you say and fix the problem.

    Thanks for all.



  • 5.  Re: SDM 12.7 C2 RO68594 "TabBanner" error on Attachments

    Posted 01-05-2016 05:53 PM

    You're welcome!

     

    Kyle_R.