Chapter 7: CICS Installation Verification

This chapter describes the installation verification procedure (IVP) you can use to check that the CICS Option software is installed and working properly.

7.1 Use of Keys in CICS Option

When you run a CICS application in Mainframe Express, you use particular PC keyboard keys to emulate the action of 3270 terminal keys:

• You use the Escape key (marked Esc) as the equivalent of the 3270 Clear key.

• You use the right-hand Control key (marked Ctrl) as the equivalent of the 3270 Enter key. If you have problems with this on your PC, try the Enter key at the far right of the keyboard, or Ctrl+Return (hold down Ctrl while pressing Return).

  Whenever the instructions in this chapter tell you to enter a value, the meaning is that you type the value, then press the 3270 Enter key

7.2 The Installation Verification Procedure

Running the IVP involves starting a single-tasking CICS Option region and terminal emulation, signing on, running a transaction, and closing the region down again.You can run the IVP in a single-tasking or multi-tasking CICS region, but first you must open the project that contains the IVP.

7.2.1 Opening the IVP Project

To open the supplied Mainframe Express project for the IVP:

1. Start Mainframe Express if it is not already running.

2. Click Open Project on the File menu.

3. On the Open dialog box change Files of type to Project Files, then select in order the folders project, demo and cicsivp.

4. Select the file cicsivp.mvp and click Open.

7.2.2 Running the IVP in a Single-Tasking Region

To run the IVP in a single-tasking region, follow the steps below:

1. From the Debug menu click Start Debugging.

2. On the Start Debugging dialog box click the CICS tab.

3. Ensure that the Initial Tran Id entry field is empty and click OK. (By default the entry field should show CESN as the transaction ID.)

   Console messages are displayed in the CICS log View in the Output window of the IDE (this may not be visible - click Output Window on the View menu of the IDE). The messages show the progress of the region start-up. Wait for the message:

   TXSI1600I Server initialization completed successfully

   The 3270 Terminal emulator appears in the Application Output window.

   If the terminal starts correctly, you see the Sign-On screen for the CESN transaction.

4. Type in SYSAD as the user name, press Tab, and type in SYSAD as the password. The password does not display.

   Make sure you enter these in upper case; UCTRAN does not take effect for a transaction unless the PCT entry also specifies upper case.

5. Press Enter. The screen clears and one of the following messages appears:

   TXSE0012I Signon complete at A000, for user SYSAD. Local security is disabled.

   or, if security is enabled:

   TXSE0002I Signon complete at A000, for user SYSAD.

   If this sign-on fails you may have mistyped the password or you may have entered the password or user name in lower case, or the password could have been changed by your administrator. Try re-entering the user name and password. If this does not work , leave the sign-on screen by pressing the 3270 Clear key and entering the transaction ID EXIT, then ask your administrator for help.

6. Press the 3270 Clear key to clear the screen.

7. Enter CFCR ACCTFIL. This runs the CFCR transaction to create the file ACCTFIL, to which you add a record in the next step. (ACCTFIL is defined in the FCT in the supplied resource definition file.)

8. Press the 3270 Clear key to clear the screen.

9. 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 11111 in the ACCOUNT field.

10. Fill in the fields as follows:

    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.

    Press Enter.

11. Display the record you have just entered by typing SMITH into the SURNAME field and pressing Enter.

12. Press the 3270 Clear key to clear the screen.

13. Type EXIT and press Enter. This shuts down the terminal emulator.

14. Close the Application Output window by clicking the close icon in the top right-hand corner.

7.2.3 Running the IVP in a Multi-Tasking Region

To run the IVP in a multi-tasking region, follow the steps below:

1. From the CICS sub-menu of the Tools menu click Start Region.

   Console messages are displayed in the Console tab in the lower pane of the IDE showing the progress of the region start-up. Wait for the message:

   TXSI1600I Server initialization completed successfully

2. From the CICS sub-menu of the Tools menu click Start 3270 Terminal.

   If the terminal starts correctly, you see the Sign-On screen for the CESN transaction.

3. Type in SYSAD as the user name, press Tab, and type in SYSAD as the password. The password does not display.

   Make sure you enter these in upper case; UCTRAN does not take effect for a transaction unless the PCT entry also specifies upper case.

4. Press Enter. The screen clears and one of the following messages appears:

   TXSE0012I Signon complete at A000, for user SYSAD. Local security is disabled.

   or, if security is enabled:

   TXSE0002I Signon complete at A000, for user SYSAD.

   If this sign-on fails you may have mistyped the password or you may have entered the password or user name in lower case, or the password could have been changed by your administrator. Try re-entering the user name and password. If this does not work , leave the sign-on screen by pressing the 3270 Clear key and entering the transaction ID EXIT, then ask your administrator for help.

5. Press the 3270 Clear key to clear the screen.

6. Enter CFCR ACCTFIL. This runs the CFCR transaction to create the file ACCTFIL, to which you add a record in the next step. (ACCTFIL is defined in the FCT in the supplied resource definition file.)

   If you have previously run the IVP in a single-tasking environment, the file ACCTFIL already exists and running the CFCR transaction produces an error message indicating this.

7. Press the 3270 Clear key to clear the screen.

8. 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.

9. Fill in the fields as follows:

   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.

   Press Enter.

10. Display the record you have just entered by typing SMITH into the SURNAME field and pressing Enter.

11. Press the 3270 Clear key to clear the screen.

12. Type EXIT and press Enter. This shuts down the terminal emulator.

13. Click OK on the Application Completed dialog.

14. From the CICS sub-menu of the Tools menu click Stop Region to shut down the region.

Copyright © 2001 Micro Focus International Limited. All rights reserved.
This document and the proprietary marks and names used herein are protected by international law.