UpdateMacroDefFile

Updating the Macro Definition File

The macro definition file is a text file that should be uploaded using an ASCII transfer.

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

dos2unix <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

chmod macrodef_e83.samp 644 (The downloaded macrodef file may have a different name.)

cp macrodef_e83.samp macrodef

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

This step requires that the macro file (/ASKPLUS/visimage/macro) is not in use. All Visimage users must exit server and no AskPlus jobs should be running.

• While still logged in as askplus

cd /ASKPLUS/visimage

./load_macros

If you get an error that the file is in use and cannot be created (or purged), it might be necessary to bring the listener(s) down to ensure that the file is not being accessed.

• To kill the listener:

• Login as root

/ASKPLUS/kill_vsrvtcp -stop_all

Note, the above command will kill all copies of the listener running on any port.

Run the load_macros script again, remember to login as the askplus user and cd visimage.

• To restart the listener:

• Login as root

/ASKPLUS/vsrvtcp -a -t –n30501 –a >/dev/null

/ASKPLUS/vsrvtcp_49 -a -t –n30503 –a >/dev/null

Remember to start two listeners (on two different ports) if you have users running Visimage 2.6 and Visimage3. Use port numbers appropriate on your system. Please note, the default port number is normally defined in /etc/services under the askplus entry. There is no need to specify the -n parameter to start server on the default port.

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.