system z software demo setup guide

7/22/2019 System z Software Demo Setup Guide

1/16

System z Software

Demo Script Setup Guide

Document Version: 1.2

Version Date:October 27, 2008

2008 Copyright IBM Corporation. All Rights Reserved

This document is intended for IBM internal use only. The contents of the document may be discussed withexisting and/or potential customers. The document itself, however, may not be distributed outside of IBM.


2/16

System z Software Demo Script Setup Guide October 27, 2008

Table of Contents

1. System z Demo System User ID .....................................................................................32. Configure Terminal Emulator Software .........................................................................4

Configure an Emulator Session to Connect to the Demo System.............................................4Customize the Terminal Emulator Session .................................................................................7Log on to the Demo System..........................................................................................................9Configure Other Terminal Emulator Sessions ..........................................................................12Using IBM Session Manager .......................................................................................................13

3. What CICS Regions to Use ...........................................................................................15Revision History ................................................................................................................16

Summary of Changes ..................................................................................................................16Summary of Reviews ...................................................................................................................16

2008 Copyright IBM Corporation Page 2 of 16


3/16


1. System z Demo System User ID

You need a User ID on a System z Demo System before you can access the system to run a demonstration.Use the following process to request a User ID on the System z Demo System (DEMOMVS).

Go to the DEMOcentralRequest user ID page at http://w3.demopkg.ibm.com/LPage/DCACidReq.

Log in with your IBM intranet User ID and password. If you already have a User ID for DEMOmvs, it will appearin the User ID column. If you do not have a User ID for DEMOmvs, click the Requestbutton.

After you submit your request, the help desk will e-mail you the user ID, password, and access instructions.



4/16


2. Configure Terminal Emulator Software

A terminal emulator program is a PC application that provides an interface to a mainframe system that is similarto a 3270 terminal. This document shows how to configure the IBM Personal Communications (PCOMM)terminal emulator. PCOMM should already be installed on your system if you have the IBM Client for e-business

image. If you do not have PCOMM, you can install it from the IBM Standard Software Installer.

Configure an Emulator Session to Connect to the Demo SystemStart IBM Personal Communications by clicking

Start > All Programs > IBM Personal Communications > Start or Configure Sessions.

In the Session Manager window, click the New Sessionbutton.

In the Customize Communication window, click Link Parameters.

http://w3.ibm.com/download/standardsoftware/http://w3.ibm.com/download/standardsoftware/


5/16


Enter the Primary Host Name: demomvs.demopkg.ibm.com. Leave the Port Number default of 23. Click OK.

You can customize the Terminal Emulator Session screen size to display more lines of text on the screen. Thedefault is 24 lines, but it may be helpful to increase this to 32 lines. Click the Session Parametersbutton.

In the Session Parameters window, select Screen Size: 32x80. Click OK. Click OKagain.



6/16


The PCOMM session should connect to DEMOMVS and look like the screen below:

If the Terminal Emulator Session does not connect to DEMOMVS as shown above, you might have a network or

firewall problem preventing you from connecting to the Demo system. Test your network connection by pingingthe Demo system. In a Windows environment, open a "MS-DOS Prompt" window. Start > Run > cmd > OK.You should see successful replies to the ping command if you can connect to the Demo system via the network.

Type: pingdemomvs.demopkg.ibm.com



7/16


Customize the Terminal Emulator SessionYou can customize the Terminal Emulator Session to make it easier to use. One issue that you may encounter isthat the Enter key does not work as you might expect. Pressing the Enter key only sends a new line character tothe Demo system. The Ctrl key on the right is configured by default to send the Enter command to the Demosystem. If you type a command and press the Enter key, nothing happens. You must press the right Ctrlkey tosubmit your command to the Demo system.

You can configure the Enter key to submit your command to the Demo system by customizing the KeyboardSetup. In the PCOMM session, select Edit > Preferences > Keyboard. On the Keyboard Setup screen, clickthe Customizebutton.

Click to select the Enterkey shown as button to change the current base action for the selected key from [newline] to [enter].

Select File > Saveto save your custom keyboard. Then close the Customize Keyboard window.



8/16


In the Keyboard Setup window, select Current Keyboard: User Definedand browse to the custom keyboard fileyou just saved. Click OK.

You can customize the Terminal Emulator Session to display the Demo system name in the title bar. It will behelpful to display the system name if you have multiple sessions configured to different systems.

Select Edit > Preferences > Appearance > Window Setup.

Under Window Title, deselect the first checkbox Long Session-ID, Session A, select the Session Namecheckbox, and fill in a Session Name: DEMOMVS. Click OK.



9/16


Save the customized Terminal Emulator Session for future use. Select File > Saveand give the profile a name,such as DEMOMVS.ws. The next time you go to Start or Configure Sessions, there will be an icon forDEMOMVS.

Log on to the Demo SystemNow that you have a User ID and a Terminal Emulator Session configured for the Demo System, you can log on

to the Demo System and begin running a demo.

Type the command for one of the applications available, such as TSO, and click Enteror the right Ctrlkey.



10/16


Enter your User IDand Passwordat the prompts, and press Enteror the right Ctrlkey..

Some messages may display. Press Enteror the right Ctrlkey to proceed.



11/16


The z/OS Primary Option Menudisplays, and you can proceed with the Demo script.



12/16


Configure Other Terminal Emulator Sessions

Other terminal emulator sessions may be useful for connecting to the System z Demo System (DEMOMVS).You can create additional emulator sessions for specific purposes with the settings below.

DemoMFI

This is a definition to start the STATIC VTAM Mainframe Interface connection for routing your tests usingsomething like: TEST(ALL,*,PROMPT,MFI%TRMLU001:*)

Host Name: demomvs.demopkg.ibm.comPort: 2023

DemoTIM

This is a definition to start the Terminal Interface Manager for IBM Debug Tool for routing your tests like:TEST(ALL,,,VTAM%SYS029:)

Host Name: demomvs.demopkg.ibm.com

Port: 2024

DemoSessionManager

This is recommended for general access to DEMOmvs. It uses PORT 9994 and has many predefined sessions

Host Name: demomvs.demopkg.ibm.comPort: 9994



13/16


Using IBM Session Manager

IBM Session Manager provides secure and reliable access to multiple applications from a single 3270 terminalsession. Session Manager acts as an intermediary between the user and the applications. It gives the user asingle secure sign on, and then allows access to all their applications from multiple concurrent virtual sessions. Asingle menu means users are within a few keystrokes of any business application. Users can easily connect to

an application or switch between applications with a single keystroke or simple command.

When you configure an emulator session to Host Name: demomvs.demopkg.ibm.comand Port 9994, you willsee the sign on screen where you enter your User ID and password.

After you sign on, the Session Manager Main Menu shows all the applications that are potentially available.



14/16


Each application has an assigned selection id, usually a session number or PFKEY. This should appear on thesame line as the application. An application can be selected by entering the session number or pressing theassociated PFKEY, if assigned. Your MENU Escape sequence Shiftand Page UpPA3 exits from the currentapplication display and returns to the MENU screen.

On the Main Menu, the prefix area will accept the following commands:

Prefix command S/MGR command Description-------------- ------------- -----------

? display this screen

S (SELECT) start/re-join session

K (KILL) RESET n terminate session n

R (RESET) RESET n terminate session n

E (END) ENDSCRIPT n run ENDSCRIPT and end session

* ENDSCRIPT * run ENDSCRIPTS and end ALL sessions

H (HALTSCRIPT) HALTSCRIPT n kill SCRIPT running on this session

P (HARDCOPY) HARDCOPY n take hardcopy print of this session

If you open up more than one applications through Session Manager, you can transfer between the applicationsusing the Forward and Backward commands. To transfer between open applications without returning to themain menu, use the Forward escape sequence >>in any application to move to the next application. Similarly,use the Backward escape sequence


15/16


3. What CICS Regions to Use

CICSE- This region is specifically maintained for the IBM PD Tools. Any and all demonstrations should be runfrom this region for IBM Debug Tool or simple CICS transactions.

CICSD- This region was created for use with the IBM Fault Analyzer (IDI) transaction. Note that while someother tools may work (IBM Debug Tool for instance), its real use is for IDI!

CICSC- For the foreseeable future, this CICS TS 2.3 Region is available for IBM Debug Tool (DTCN) use. TheCEMT I SYS command should always show DEBUGTOOL(NODEBUG).

CICSA and CICSB are having lots of issues and there are a lot more CICS users doing various things here.



16/16


Revision History

Summary of Changes

Version # Version Date Summary of Changes Author Date Approved

1.0 Sep. 19, 2006 Jim Hildner andKelly OHara

1.1 Oct 30, 2006 Added Other Terminal EmulatorSessions, Using IBM SessionManager, and What CICSRegions to Use

Kelly OHara

1.2 Oct 27, 2008 Updated URL for DEMOmvsUser ID request on page 3

Kelly OHara

Summary of Reviews

Reviewer Version # Date Reviewed


system z software demo setup guide

Documents