Installation Verification

This appendix describes the OSC Installation Verification Procedure (OIVP) to check that OSC is installed and running properly using the COBOL compiler.

1. Overview

The OIVP has been developed to verify that the OSC system is installed and running properly. Using the OIVP, the administrator can identify any error in installation faster and more accurately than before.

2. OSC Installation Verification Procedure (OIVP)

OIVP is installed using an OSC installer. A sample file is available in the ${OPENFRAME_HOME}/osc/oivp directory.

The following describes setting the OIVP region, registering the application server, and running the OIVP.

2.1. Configuring OSC Region

Before configuring a region, the administrator must prepare application server binaries, create application server data sets, and define application server resources. These prerequisite tasks are completed by the installer.

The following steps show how to configure the region.

  1. Prepare application server binaries

    Use the oscbuild tool to create binaries.

  2. Create application server data sets and file resources

    Create OSC SD table, TDQ table, and TSQ table that are defined in the application server. Also create file resources for OIVP.

  3. Define Resources

    Use the oscdgen tool to define the application server and OIVP resources in the OSC SD. The macro containing resource definitions is available in the ${OPENFRAME_HOME}/osc/resource and ${OPENFRAME_HOME}/osc/oivp/resource directories.

  1. For more information about configuring OSC regions, refer to "Chapter 3: Configuring OSC Regions" in OpenFrame OSC Administrator’s Guide.

  2. For information about scripts required to configure OSC regions, refer to ${OPENFRAME_HOME}/scripts.

2.2. Registering Application Server

After configuring the OSC region, compile and register maps and COBOL source codes.

The following steps explain how to compile and register maps and COBOL source codes. These tasks are completed by the installer.

  1. Compile maps

    Copy and compile maps. There are currently seven maps.

  2. Compile COBOL source codes

    Copy and compile COBOL source codes. There are eight COBOL source codes used now.

  3. Deploy the compilation results

    To use the OIVP, use the osctdlinit tool or the osctdlupdate tool to deploy the compilation results.

  4. Boot OSC and the application server.

  1. For more information about configuring the application server, Refer to "Chapter 4: Developing and Preparing OSC Applications" in OpenFrame OSC Administrator’s Guide.

  2. For information about scripts required to configure the application server, refer to ${OPENFRAME_HOME}/scripts.

2.3. Running OIVP

The OIVP uses an application that manages user information and verifies OSC resources and commands.

The following steps show how to call the OIVP to verify OSC resources and commands.

  1. Log into the system and open a terminal to connect to the OIVP region (OSCOIVP1). Enter the following command.

    LOGON APPLID(OSCOIVP1) <ENTER>
    figure ofgw 1
    Connecting to OpenFrame GW

  2. When the OSC logo screen is displayed, enter <CLEAR> to clear the display, and call the OIVP transaction by entering the following command.

    <CLEAR>
OIVP <ENTER>
    figure ofgw 2
    Calling OIVP Transaction
OIVP Function Keys

The following describes keys, their functions, and the application displays they can be used on.

Key Function Application Display

CLEAR

Exit OIVP

All

ENTER

Proceed

All

PF1

Display the start screen

All

PF2

Move to the previous page

BROS

PF3

Move to the next page

BROS
OIVP Screens

The following shows the OIVP home screen.

figure oivp 1
OIVP Home Screen

The OIVP screen is divided into three regions.

  • Top region

    Displays the date, time, and terminal information.

  • Top region

    Displays the OIVP application output.

  • Bottom region

    Displays the license information.

There are five menus in the OIVP server: BROS, INQR, INSR, UPDT, and DELT. Accessing each menu requires a CODE or both CODE and ID.

  1. An invalid ID displays an error in the home screen.

  2. Before using BROS, INQR, UPDT, and DELT menus, records must be created in the file using the INSR menu.

  • BROS

    The BROS screen displays all records stored in the file. Up to five records per page are displayed.

    figure oivp 2
    OIVP BROS Screen

  • INQR

    The INQR screen displays information about a specific record stored in the file.

    figure oivp 3
    OIVP INQR Screen

  • INSR

    The INSR screen is used to create a new record. The ID field is filled by the OSC Named Counter. The NAME and DEPT fields must be filled manually. Note that each field allows a specific number of characters. NAME allows up to 10 characters; DEPT 15 characters; PHONE 15 characters; EMAIL 20 characters; and ADDRESS 40 characters.

    figure oivp 4
    OIVP INSR Screen

  • UPDT

    The UPDT screen allows modification of existing records.

    figure oivp 5
    OIVP UPDT Screen

  • DELT

    The DELT screen allows deletion of existing records.

    figure oivp 6
    OIVP DELT Screen

  • QUIT

    The QUIT screen shows that the OSC OIVP is terminated. After the QUIT screen, OpenFrame executes ISSUE DISCONNECT, and the OpenFrame GW screen is displayed.

    figure oivp 7
    OIVP QUIT Screen
    figure oivp 8
    ISSUE DISCONNECT After OpenFrame GW Screen
Commands for Verified Resources

The following describes commands for managing resources verified by the OIVP.

Resource Command

File

WRITE

REWRITE

READ

DELETE

STARTBR

ENDBR

READNEXT

READPREV

TDQ

WRITEQ TD

READQ TD

DELETEQ TD

TSQ

WRITEQ TS

READQ TS

DELETEQ TS

Named Counter

DEFINE COUNTER

DELETE COUNTER

GET COUNTER

QUERY COUNTER

etc.

START

LINK

RETURN

ENQ

DEQ

ISSUE DISCONNECT

SEND MAP

RECEIVE MAP

SEND TEXT

ASKTIME

DELAY

FORMATTIME

SYNCPOINT

RETRIEVE