Difference between revisions of "UpdateMacroDefFile"

From Vital Soft Wiki
Jump to: navigation, search
>Johno
(Updating the Macro Definition File)
>Johno
(Updating the Macro Definition File)
 
(21 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
== Updating the Macro Definition File ==
 
== Updating the Macro Definition File ==
  
The macro definition file is a text file that should be uploaded using an ASCII transfer.
+
The macro definition file is a text file that should be uploaded using an ASCII transfer. '''Vital Signs users should perform the test at the end of these instructions after updating the macro file.'''
 
   
 
   
Rename the current '''/ASKPLUS/visimage/macrodef''' to '''/ASKPLUS/visimage/macrodefv26'''. Transfer the macrodef file to the Unix box, using an ASCII transfer. Issue a chmod 644 on the macrodef file so that it is readable by everyone.
+
Download the macro definition file [https://www.vital-soft.com/product-downloads/ here].
 +
:* Scroll to the bottom of the page and choose the version appropriate for Visimage3 and AskPlus version E.8.3.3.
  
Download the macro definition file [https://www.vital-soft.com/product-downloads/ here].
+
'''1. Transfer the file to UNIX:'''
:* Scroll to the bottom of the page and choose the version appropriate for AskPlus version E.8.3.3.
+
:* Transfer the '''samp''' macrodef file, using an ASCII transfer, to the /ASKPLUS/visimage directory.
 +
 
 +
::Using vi, verify that the file is a valid UNIX file. In vi, you should '''not''' see any ^M characters at the end of each line. If ^M characters appear at the end of each line, convert the file using the following commands.
 +
 
 +
:::mv macrodef_e83.samp macrodef_e83.dos
 +
:::dos2ux <macrodef_e83.dos >macrodef_e83.samp
  
Once the definition file You will then need to rebuild the /ASKPLUS/visimage/macro file. This is the binary file Visimage and Askplus use. To rebuild the /ASKPLUS/visimage/macro file you will need to have all Visimage users exit server. 
+
'''2. Backup the old definition file and copy the new one:'''
 +
:* Logon to HPUX as '''askplus'''
 +
::cd /ASKPLUS/visimage
 +
::mv macrodef macrodefv26
 +
::cp macrodef_e83.samp macrodef (The downloaded macrodef file may have a different name.)
 +
::chown askplus macrodef (Make sure the file is owned by askplus)
 +
::chmod 644 macrodef
  
1. Login as the askplus user.
+
'''3. Rebuild the indexed macro file used by AskPlus and Visimage:'''
2. cd visimage
+
:* While still logged in as '''askplus'''
3. Compile the macro source file by running the following script:
+
::cd /ASKPLUS/visimage
load_macros
+
::rm macro (if the purge fails, make sure the file is owned by askplus)
 +
::/ASKPLUS/load_macros
  
It might be necessary to bring the listener down to ensure that the file is not being accessed.   
+
::Note, Visimage users will need to restart server to see the new macro definitions.   
  
To kill the listener:
+
To test that the new setup is valid, start server from Visimage or run a test job that uses AskPlus. 
  
1. Login as root
+
'''Vital Signs users should run the following test:'''
2. Issue this command to stop the listener:
 
/ASKPLUS/kill_vsrvtcp -stop_all
 
 
*Note, the above command will kill both the regular listener as well as the beta listener.
 
  
Run the load_macros script again, remember to login as the askplus user and cd visimage.
+
:* Login as bolive
 +
:: /VSJOBS/JVSLOAD_MBRSHLN
  
To restart the listener:
+
::Once the job has started successfully and built at least one extract file successfully, kill the job, then ''clean up'' any created files as follows:
 +
:::cd /var/summit/spectrum/LIVE/vsdata/data/mbrshln  (Check /ASKPLUS/vsdata/vitalsigns.ini for the correct path)
 +
:::ls (if the files are all extract files MBRFILECCYYMMDD, SHFILECCYYMMDD, etc - you are in the correct directory)
 +
:::rm *  ('''Make sure you are in the correct location before issuing this command!''')
  
1. Login as root
+
::Contact support if you are unsure about any of these steps.
2. Issue this command to start the non beta listener: /ASKPLUS/vsrvtcp –n30501 -a >/dev/null
 
3. Issue this command to start the beta listener: /ASKPLUS/vsrvtcp_4913 -a -t –n30503 –a >/dev/null
 

Latest revision as of 18:21, 10 November 2014

Updating the Macro Definition File

The macro definition file is a text file that should be uploaded using an ASCII transfer. Vital Signs users should perform the test at the end of these instructions after updating the macro file.

Download the macro definition file here.

  • Scroll to the bottom of the page and choose the version appropriate for Visimage3 and AskPlus version E.8.3.3.

1. Transfer the file to UNIX:

  • Transfer the samp macrodef file, using an ASCII transfer, to the /ASKPLUS/visimage directory.
Using vi, verify that the file is a valid UNIX file. In vi, you should not see any ^M characters at the end of each line. If ^M characters appear at the end of each line, convert the file using the following commands.
mv macrodef_e83.samp macrodef_e83.dos
dos2ux <macrodef_e83.dos >macrodef_e83.samp

2. Backup the old definition file and copy the new one:

  • Logon to HPUX as askplus
cd /ASKPLUS/visimage
mv macrodef macrodefv26
cp macrodef_e83.samp macrodef (The downloaded macrodef file may have a different name.)
chown askplus macrodef (Make sure the file is owned by askplus)
chmod 644 macrodef

3. Rebuild the indexed macro file used by AskPlus and Visimage:

  • While still logged in as askplus
cd /ASKPLUS/visimage
rm macro (if the purge fails, make sure the file is owned by askplus)
/ASKPLUS/load_macros
Note, Visimage users will need to restart server to see the new macro definitions.

To test that the new setup is valid, start server from Visimage or run a test job that uses AskPlus.

Vital Signs users should run the following test:

  • Login as bolive
/VSJOBS/JVSLOAD_MBRSHLN
Once the job has started successfully and built at least one extract file successfully, kill the job, then clean up any created files as follows:
cd /var/summit/spectrum/LIVE/vsdata/data/mbrshln (Check /ASKPLUS/vsdata/vitalsigns.ini for the correct path)
ls (if the files are all extract files MBRFILECCYYMMDD, SHFILECCYYMMDD, etc - you are in the correct directory)
rm * (Make sure you are in the correct location before issuing this command!)
Contact support if you are unsure about any of these steps.