Table of Contents

IBM VisualAge(R) RPG and CODE/400 README file

Installing from the Workstation CD

Installing Netscape Communicator

Service Pack and PTF Information

Known Problems and Workarounds

  • Installation of the Distributed Debugger
  • Debugging in CODE/400
  • CODE/400 Communication
  • CODE/400 Editor

    • Documentation Corrections

  • CODE/400
  • Debugging Batch Jobs
  • VisualAge RPG
  • GUI Designer
  • VisualAge RPG Compiler
  • DBCS Consideration
  • Using Sample VisualAge RPG Projects
  • Running Java Applets or Applications
  • Parentlist attribute
  • YIncrement attribute

    • Keeping in Touch

    IBM VisualAge(R) RPG and CODE/400 README file

    This file contains additional and last minute information that was not included in the online and printed versions of the VisualAge(R) RPG (VARPG) and Cooperative Development Environment for AS/400 (CODE/400) documentation.

    Installing from the Workstation CD

    To install the product from the workstation CD:

    1. Insert the CD-ROM into the CD drive.
    2. Follow the online instructions.

    If the installation utility does not start automatically, perform the following steps:

    1. From the Windows Start menu, select Run.
    2. Type: 
      x:\qadtswin\setup.exe

      Where x: is your CD-ROM drive.

    Installation Notes:

    1. If you want to install both IBM VisualAge for C++ and VisualAge RPG and CODE/400 on the same workstation, you must install VisualAge RPG and CODE/400 last.

    2. If you are installing on Windows 95 and receive an error message indicating NetQuestion cannot be installed, it is because the PATH statement in your autoexec.bat file is longer than 200 characters. The solution is to shorten the PATH statement.

    3. If you are installing onto Windows NT, you need to have administrator authority to install VisualAge RPG and CODE/400.

    Installing Netscape Communicator

    To use the product help, you require a browser that can handle frames. If you do not have a browser installed on your workstation, you can install Netscape Communicator from the Includes Netscape Communicator CD that was shipped with this product. Follow the instructions in the CDNAVEN.TXT file located in the Netscape directory on this CD.

    Note:After installation, make sure your browser bypasses the proxy server for server name localhost.

    Service Pack and PTF Information

    In order to use all of the VisualAge RPG and CODE/400 V3R2M3 functions, apply the required Service Packs to the product and the required PTFs to the AS/400 host or client products or both. The list of required PTFs has been updated for this release.

    For the most up-to-date information on available Service Packs and PTFs, go to the VisualAge RPG and CODE/400 Web site at:

    http://www.ibm.com/software/ad/varpg

    Select the Support hyperlink from the left hand frame.

    You can download the latest Service Packs and view the most current list of AS/400 PTFs from there.

    Known Problems and Workarounds

    This section lists known problems and workarounds that were not included in the online and printed versions of the VARPG and CODE/400 documentation.

    Installation of the Distributed Debugger

    Note:During the installation of the Distributed Debugger you may notice that the progress indicator will remain stationary for some time. This is normal and does not mean that the installation is hung.

    If you get an error message indicating that installation of the Distributed Debugger was not successful, you will need to do the following:

    1. Shorten the environment variables which are longer than 250 characters.
    2. Manually install the debugger from the CD.

      From the x:\QADTSWIN\MRM\DISTDBG\ directory type the following string: 

      setup -ParentProduct=product name=-HomeMenu=folder name=-InstallDir=y:\IBMDEBUG

      Where:

      Be sure to select the Full install option.

    3. Configure the help for the debugger. Update the IBMVAHLP.CFG file in your Windows directory with the following line at the beginning of the file. (Create the file if it does not exist.) 
      ProductName=y:\ADTSWIN\HELP\HELP.CFG

      where ProductName is 'VisualAge RPG and CODE/400' or your language version of the product name you used during the manual installation of the IBM Distributed Debugger.

    If the product installation appears to hang while installing the IBM Distributed Debugger component, you will need to do the following:

    1. Cancel the product installation.
    2. Uninstall the product. From Control Panel, select Add/Remove Programs -> Install/Uninstall. Click on VisualAge RPG and CODE/400 V3R2M3 and then on the Add/Remove button.
    3. Perform a Custom install of the product. Do not select the IBM Distributed Debugger.
    4. Manually copy the files required by the debugger from the CD.

      From the x:\QADTSWIN\MRM directory, type the following commands: 

      copy NLS29nn\debugger.zip y:\ADTSWIN\HELP
copy NLS29nn\debug400.zip y:\ADTSWIN\HELP
copy NLS29nn\debugrpg.zip y:\ADTSWIN\HELP
copy NLS29nn\va45udbg.zip y:\ADTSWIN\HELP
copy NLS29nn\va45udrp.zip y:\ADTSWIN\HELP
copy NLS29nn\va45udui.zip y:\ADTSWIN\HELP
copy codedbg2.exe y:\ADTSWIN\SYSTEM
copy codedbg.exe y:\ADTSWIN
copy dlogoff.exe y:\ADTSWIN

      where nn is the language identifier: 

      English		24	
German		29
Spanish		31
Japanese        62
Korean 		86
Chinese		89
      x: is the CD ROM drive. y:\ADTSWIN is the directory where you have installed the VARPG and CODE/400 product.
    5. Manually install the debugger from the CD.

      From the x:\QADTSWIN\MRM\DISTDBG\ directory type the following string: 

      setup -ParentProduct=product name=-HomeMenu=folder name=-InstallDir=y:\IBMDEBUG

      Where:

      Be sure to select the Full install option.

    6. Select the No, I will restart my computer later choice.
    7. Update the IBMVAHLP.CFG file in your Windows directory with the following line at the beginning of the file: 
      ProductName=y:\ADTSWIN\HELP\HELP.CFG

      where ProductName is 'VisualAge RPG and CODE/400' or your language version of the product name.

    8. Restart your computer.
    9. Update the navigation entries and search for the help system. From a DOS prompt, change to the y:\imnnq_directory directory. Run the following commands: 
      vahcfg remove /p va400 /f y:\imnnq_directory /l language
 
vahcfg install /w y:\adtswin\help /l language

      where

    Debugging in CODE/400

    Tip:When invoking the debugger outside of CODE, you are presented with the Debugger AS/400 Logon dialog box if you click any one of the Job List, Advanced, or Load push buttons in the Load Program dialog box. If you plan to log on to the same host for subsequent invocations of the debugger, click the Advanced push button to enter the host name. By specifying the host with this method, you will not be presented with the Debugger AS/400 Logon dialog box each time you start a session for that same host.

    CODE/400 Communication

    If you define a TCP/IP server or create a new APPC connection while the CODE Daemon is already running, and one of the following occurs:

    Enter the following command from a DOS prompt: 

    CODESRV REFRESH

    CODE/400 Editor

    Documentation Corrections

    This section lists additions, corrections, and changes that were made after the VARPG and CODE/400 documentation went to print.

    CODE/400

    The following sections list additions, corrections, and changes that were made after the CODE/400 documentation went to print.

    Debugging Batch Jobs

    VisualAge RPG

    The following sections list additions, corrections, and changes that were made after the VisualAge RPG documentation went to print.

    GUI Designer

    Animation Control Part
    This part has a new attribute, FrameRate. This attribute determines the time, in milliseconds, to pause between frames in an animated GIF file.

    Free form example 
    *...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----
 *
C                   EVAL      %setatr('main': 'ANI': 'FrameRate')=Type
 *

    Fixed form example 
    *...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----
 *
C     'ANI'         SETATR    1000          'FRAMERATE'
 *

    Window Part
    The Filename attribute is used to set the icon that is to appear in the system menu for the window. It is of type string, settable, and for Java(TM) only.

    AddSrcEvent Attribute
    This is a new attribute for the Component Reference part.

    Allowed Value
    The format of this attribute is: 
    COMPONENTNAME | WINDOWNAME | PARTNAME | EVENTNAME

    Free form example 
    *...1....+....2....+....3....+....4....+....5....+....6....+....7....+.
DName+++++++++++ETDsFrom+++To/L+++IDc.Keywords+++++++++++++++++++++++++
D Event           S            100
*
*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----
 *
C                   EVAL      Event='compb|win02|ef02|change'
C                   EVAL      %setatr('win01': 'CRP1': 
C                             'AddSrcEvent')=Event
 *

    Fixed form example 
    *...1....+....2....+....3....+....4....+....5....+....6....+....7....+.
DName+++++++++++ETDsFrom+++To/L+++IDc.Keywords+++++++++++++++++++++++++
D Event 
*
*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----
 *
C                   EVAL      Event='compb|win02|ef02|change'
C     'CRP1'        SETATR    Event         'ADDSRCEVENT'
 *

    AutoScroll, CompName Attributes
    These attributes are also settable.

    BindPart Attribute
    This attribute is not gettable.

    BlankChar, BufferDec, ColorMix, FieldExit, SizeToFit Attributes
    These attributes are also gettable.

    Height, Left, Top, Width Attributes
    These attributes are now settable in the properties notebook in the GUI Designer.

    RmvSrcEvent
    This is a new attribute for the Component Reference part.

    Allowed Value
    The format of this attribute is: 
    COMPONENTNAME | WINDOWNAME | PARTNAME | EVENTNAME

    Free form example 
    *...1....+....2....+....3....+....4....+....5....+....6....+....7....+.
DName+++++++++++ETDsFrom+++To/L+++IDc.Keywords+++++++++++++++++++++++++
D Event           S            100
*
*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----
 *
C                   EVAL      Event='compb|win02|ef02|change'
C                   EVAL      %setatr('win01': 'CRP1': 
C                             'RmvSrcEvent')=Event
 *

    Fixed form example 
    *...1....+....2....+....3....+....4....+....5....+....6....+....7....+.
DName+++++++++++ETDsFrom+++To/L+++IDc.Keywords+++++++++++++++++++++++++
D Event 
*
*...1....+....2....+....3....+....4....+....5....+....6....+....7....+....8
CSRN01Factor1+++++++Opcode(E)+Factor2+++++++Result++++++++Len++D+HiLoEq----
 *
C                   EVAL      Event='compb|win02|ef02|change'
C     'CRP1'        SETATR    Event         'RMVSRCEVENT'
 *

    %SrcCompName Event Attribute
    This new attribute is for the Notify event. It is of type string. The attribute is used to retrieve the source component name of the event being notified. In the case that the user program monitors multiple events with one component reference, it can determine the exact source of the event that triggers the Notify event using the %SrcCompName attribute in combination with the following attributes: %SrcWinName, %SrcPartName, and %SrcEvtName.

    Visual Age RPG Applets
    To run VisualAge RPG applets in Netscape Navigator or Microsoft Internet Explorer, you need Java 2 Runtime Environment (JRE). You can download the JRE from:

    VisualAge RPG Compiler

    DBCS Consideration

    The DBCS CCSID 1399 is not supported for Java.

    Using Sample VisualAge RPG Projects

    Before compiling sample VisualAge RPG projects, read the source code (vpg file) for prerequisite actions.

    Running Java Applets or Applications

    Tip:When running java applets or applications using the JRE (Java run-time environment) make sure you use the international version of JRE.

    Parentlist attribute

    Type: String

    A new PARENTLIST, gettable attribute has been added for the CONTAINER part . Use this attribute to retrieve the blank delimited list of parent ids for the current record. Before using this attribute set the RECORDID attribute to the current record's id.

    YIncrement attribute

    Type: Numeric

    A new YINC attribute has been added for the GRAPH part. Use this attribute to set equal tick marks on the Y axis of the graph part. A settable/gettable number will equally divide the Y axis between the maximum and minimum values into the specified number of tick marks.

    Keeping in Touch

    Contact us in one of the following ways: