Difference between revisions of "Visimage3Install"

From Vital Soft Wiki
Jump to: navigation, search
>Johno
(Update Macro Definition File)
>Johno
Line 13: Line 13:
 
Visimage3 includes new macro functionality that requires a new macro definition file.  The new file format allows for additional macro attributes to be specified in the comment area.  After the last character of the comment, there are two dash marks followed by the group name of the macro and the length needed for the data displayed by the macro.  This is followed by two more dash marks.
 
Visimage3 includes new macro functionality that requires a new macro definition file.  The new file format allows for additional macro attributes to be specified in the comment area.  After the last character of the comment, there are two dash marks followed by the group name of the macro and the length needed for the data displayed by the macro.  This is followed by two more dash marks.
  
{{{
 
 
     macro name = definition << Description -- GroupName Len=30-- >>
 
     macro name = definition << Description -- GroupName Len=30-- >>
}}}
 
  
Attached is a new macrodef file that contains the syntax for grouping macro's.  This will not impact current Visimage 2.6 users.  The macros will still appear in the Tools -> Macros window.
+
For example:
 
Rename the current /ASKPLUS/visimage/macrodef to /ASKPLUS/visimage/macrov26.  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.
 
  
If you have custom macro's defined in the /ASKPLUS/visimage/usermdef, we suggest adding them to a Custom grouping.  The groups are defined in the comment area’s of the macrodef file.  The comment lines begin with << and end with >>:
+
    macro CVT-FIRST+INIT(insert-name) = !splitname(insert-name,"FM")&
 +
    <<print first name and middle initial--Name Len=30-->>
  
macro CVT-FIRST+INIT(insert-name) = !splitname(insert-name,"FM")&
+
The above defines a macro called CVT-FIRST+INIT that takes a parameter called ''insert-name''.  In Visimage3 this macro will be included in the ''Name'' group (when displayed in ''Tree Mode'') and will (by default) occupy 30 characters when printed in a report.
<<print first name and middle initial--Name Len=30-->>
 
  
  For your custom macro, it should look like this:
+
Vital Soft provides a standard macro definition file for use by Fiserv Spectrum Credit Unions.  Sites that maintain their own macro definition files should include a comment with appropriate attributes to take full advantage of Visimage3 functionality.
  
macro CU-NAME = "Vital Soft Employee's Credit Union"
+
:* [[UpdateMacroDefFile | Updating Macro Definition File]]
<< The name of the CU to print on reports.--Custom Len=34-->>
 
 
 
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. 
 
 
 
1. Login as the askplus user.
 
2. cd visimage
 
3. Compile the macro source file by running the following script:
 
load_macros
 
 
 
It might be necessary to bring the listener down to ensure that the file is not being accessed. 
 
 
 
To kill the listener:
 
 
 
1. Login as root
 
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.
 
 
 
To restart the listener:
 
 
 
1. Login as root
 
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
 

Revision as of 22:49, 9 November 2014

Visimage3 Installation Summary

To prepare to install Visimage3 you must first prepare for the installation by installing a new version of VsrvTcp and updating the macro definition file on the host. Also, any Visimage users that have not already installed version 2.6 should do so as Visimage3 will only open existing CTW files that have been saved in version 2.6.

Install VsrvTcp Version 4.9.1.4

VsrvTcp version 4.9.1.4 supports encrypted passwords and is required for Visimage3. This version is not compatible with Visimage 2.6 (unless the Visimage 2.6 update which includes encrypted password support, and VisiPass, has been installed). If this encrypted password update has not been installed, we strongly recommend that VsrvTcp be installed on a separate port initially. Utilizing a second port will allow clients to run both Visimage 2.6 and Visimage3 concurrently.

Update Macro Definition File

Visimage3 includes new macro functionality that requires a new macro definition file. The new file format allows for additional macro attributes to be specified in the comment area. After the last character of the comment, there are two dash marks followed by the group name of the macro and the length needed for the data displayed by the macro. This is followed by two more dash marks.

   macro name = definition << Description -- GroupName Len=30-- >>

For example:

   macro CVT-FIRST+INIT(insert-name) = !splitname(insert-name,"FM")&
   <<print first name and middle initial--Name Len=30-->>

The above defines a macro called CVT-FIRST+INIT that takes a parameter called insert-name. In Visimage3 this macro will be included in the Name group (when displayed in Tree Mode) and will (by default) occupy 30 characters when printed in a report.

Vital Soft provides a standard macro definition file for use by Fiserv Spectrum Credit Unions. Sites that maintain their own macro definition files should include a comment with appropriate attributes to take full advantage of Visimage3 functionality.