Chapter 2: Installation Verification

This chapter describes the installation verification procedure (IVP) you can use to check that the Mainframe Transaction Option software is installed and working properly. The installation verification procedure involves starting an enterprise server and terminal emulation, signing on and running a transaction.

The steps involved in running the installation verification procedure are:

  1. Start Enterprise Server Administration
  2. Configure an enterprise server
  3. Start an enterprise server
  4. Connect to the enterprise server
  5. Run the installation verification procedure

These steps are covered in the following sections.

Unless stated otherwise, the information in the following sections applies whether you are running the installation verification procedure under Enterprise Server for UNIX or Enterprise Server for Windows.

Starting Enterprise Server Administration

To start Enterprise Server Administration, enter the following commands:

su root
cd $COBDIR/bin
mfds &
exit

then open a Web browser and specify http://host:86, where host is the machine on which Enterprise Server for UNIX is installed.

Note: Once you have entered the su root command, you need to ensure that your Server Express environment variables are still set up, as some UNIX systems lose these environment variables when the su root command is run.

Configuring an Enterprise Server

Once you have started Enterprise Server Administration, you need to configure an enterprise server to enable it to run CICS applications and to specify the location of the files it will need.

To configure an enterprise server for use with the installation verification procedure:

  1. In the table of servers on the Home page of Enterprise Server Administration, click Edit to the left of the row for the server that you want to edit.
  2. Click Properties > MTO.
  3. Check Mainframe Transaction Option enabled.
  4. Specify DFH\$IVP in System Initialization Table.

    Note the use of the slash (\) character to escape the dollar sign.

  5. Specify the location of the transaction programs in Transaction Path, for example: .
    /opt/lib/cobol/cics/mto-bms 
  6. Specify the location of the data files in VSAM File Path, for example:
    /opt/lib/cobol/cics/mto-bms
  7. Specify the location of the BSM maps in Map Path, for example:
    /opt/lib/cobol/cics/mto-bms
  8. Click OK.

    At this point you have enabled CICS support for this enterprise server and specified the location of the relevant files. The directory names used in the examples above are for illustration only - you should change them to use the directories in which the installation verification procedure files are installed on your system.

  9. Click the Listeners tab
  10. Click Add in the Listeners column for Communications process 1.
  11. Specify the following information to enable you to use a TN3270 emulator:
    Field Value
    Name tn3270
    Endpoint address *.nnnn, where nnnn is between 5000 and 65535. Check with the system administrator to ensure you choose a number that is not used by other applications.
    Supported Conversation Type Check TN3270
  12. Click Add.

Starting an Enterprise Server

Having enabled the enterprise server for CICS applications and specified the location of the files required for the installation verification procedure, the next step is to start the enterprise server.

To start an enterprise server for use with the installation verification procedure:

  1. In the table of servers on the Home page of Enterprise Server Administration, find the row for the server that you want to start, and click Start in the Current Status column.

    The value in Current Status changes to "Starting".

  2. After a few seconds, click Refresh on the Home page.

    The value in Current Status changes to "Started".

Connecting to an Enterprise Server

Once you have configured and started an enterprise server, you need to start a 3270 emulator from which you can run the installation verification procedure.

To connect to the enterprise server:

  1. Start a TN3270 emulator.
  2. Specify the following connection information (if appropriate):
    Field Value
    Host name The name of the computer the enterprise server is running on. This is localhost if it is the current machine.
    Port The number you specified for the field Endpoint address in the section Configuring an Enterprise Server.
  3. Connect.

Running the Installation Verification Procedure

This section describes how to run the installation verification procedure once you have configured and started the enterprise server and connected to it with a 3270 emulator. When you first connect, a 3270 terminal is displayed with a screen prompting you for a USERID and PASSWORD.

To run the installation verification procedure:

  1. Press Clear (3270 key).

    The display clears.

  2. Enter the following command:
    CFCR ACCTFIL

    The following messages are displayed:

    Base - ACCTFIL KSDS Key 1 for 5 VARIABLE 63 to 383
    ACCTIX     ALTR   Key    6 for   12
    
    CFCR - File successfully created
  3. Press Clear (3270 key).

    The display clears.

  4. Enter the following command:
    acct

    The following screen is displayed.

    Running the Installation Verification Procedure

    Figure 2-1: Running the Installation Verification Procedure

  5. Press Tab until the cursor is positioned in the field immediately following the label REQUEST TYPE.
  6. Enter ACCT. A screen headed ACCOUNT FILE: MENU appears. You can now add a record to the demonstration account file. Tab to the REQUEST TYPE field and type in the character A; then enter 22222 in the ACCOUNT field.
  7. Fill in the fields as follows:
    Field Value
    SURNAME SMITH
    FIRST JOHN
    MI S
    TITLE MR
    TELEPHONE 501234
    ADDRESS (1) 59 THE COURT
    ADDRESS (2) WOODED AVENUE
    NO. CARDS ISSUED 1
    DATE ISSUED 03 04 98
    REASON N
    CARD CODE X
    APPROVED BY GGC

    Other fields are optional, so you can leave them blank.

  8. Press Enter.
  9. Display the record you have just entered by typing SMITH into the SURNAME field and pressing Enter.
  10. Press Clear (3270 key).

    The display clears.

  11. Enter exit to disconnect the 3270 emulator.
  12. In the table of servers on the Home page of Enterprise Server Administration, find the row for the server that you are using, and click Stop in the Current Status column.

    The value in Current Status changes to "Stopping". After a few seconds the value in Current Status changes to "Stopped".


Copyright © 2006 Micro Focus (IP) Ltd. All rights reserved.