HP 3000 Manuals

HP VPLUS/Windows Programmer's Guide

Version and Forms Appearance Verification Utility 

Whenever a user runs an application, the version of the forms file on the
HP 3000 host must match the version on the PC. You can check for matching
values without running the application by running the VPLUS utility,
VCYCLE. In addition to verifying forms file versions, a system
administrator can also use this utility to:

 *  Verify the color and enhancement options of a specific set of forms
    in the PC forms file by viewing the forms on the PC screen.

 *  Verify the color and enhancement options of all forms in the PC forms
    file by viewing the forms on the PC screen.

VCYCLE cycles through a specified VPLUS forms file, VCYCLEFF, based on
the form names contained in FNAMES, a file of form names.

Perform the following steps to run the VCYCLE utility to verify forms
file versions:

   1.  Specify the run-time information needed for VCYCLE by doing the
       following:

       a.  Click Define Application from the presentation server Action
           menu to access the Define Application dialog box.

       b.  Specify VCYCLE for the application name and click Edit to
           access the Define Application Options dialog box.

       c.  Specify HP 3000 and PC options in the Define Application
           Options dialog box as shown in Figure 5-7.

       d.  Click Save to save the definition.


          Figure 5-7.  Specifying HP 3000 and PC Options for VCYCLE 

   2.  Create an Application Support File containing the following
       commands:

            FILE VCYCLEFF=myff 
            FILE FNAMES=$NULL

       Note that myff must be the fully qualified name if it is not in
       the logon group.  You can optionally capture VCYCLE activity
       messages with a file statement for MSGS.

   3.  Run the VCYCLE utility by selecting it from the Start Application
       dialog box and then clicking Start.

The procedure for running the VCYCLE utility to verify color and
enhancement options is almost identical as for verifying forms file
versions.  If you want to verify the color and enhancement options of a
specific set of forms in the PC forms file, specify an actual file for
FNAMES in the Application Support File, as shown in the following
example:

     FILE FNAMES=myfname 

Note that myfname is the qualified name if it is not in the logon group.
You can use an editor on the HP 3000 to create the file FNAMES. The file
should contain one record for the name of each form you want to verify.

If you want to verify the color and enhancement options of all forms in
the PC forms file, you can use the VPLUS utility VFNAMES to generate the
FNAMES file.  Your Application Support File would contain the following
commands:

     RUN VFNAMES.PUB.SYS;INFO="myff  $NEWPASS"
     FILE VCYCLEFF=myff 
     FILE FNAMES=$OLDPASS

MPE/iX 5.0 Documentation