User Guide Linux on System z Remote Acces Program.pdf

8/10/2019 User Guide Linux on System z Remote Acces Program.pdf

1/19

User's Guide and Reference

for IBM Linux for System z

Remote Access Programs

June 29, 2010

International Business Machines CorporationInnovation Center, Dallas

Dallas, TXUSA

This document is intended for the sole use of participants in an IBM Innovation Center, Dallas

Remote Development or Early Test Program and is not to be distributed to nonparticipants or usedfor purposes other than intended!

Coyrig!t Internationa" Business Mac!ines Cororation #$%$& A"" rig!ts resered&Coyrig!t Internationa" Business Mac!ines Cororation #$%$& A"" rig!ts resered&


2/19

Preface

This document is intended to assist the user in accessing and using the Linux on System zRemote Development system. It covers all supported versions of Linux on System z.

Comments on this document may be addressed to:

IBM Corporation

"ttn# ETP "dministrationM$% &''()('*

(&+'' Diplomat Drive

Dallas, T -./&*

Numbers to call for assistance: 01-/2 *'/.3./, hold for the agent and as4 to open a Partner5orld Technical %upport PMR

for %ystem 6!

0+''2 */3111', hold for the agent and as4 to open a Partner5orld Technical %upport PMR

for %ystem 6(!

( This number is tollfree 7ithin the 8nited %tates


3/19

Index

( 9vervie7 : remote access environment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! /(!( ;ard7are $ soft7are platform !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! /

(!/ Introduction to the virtual machine concept !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! /

(!& %ystem availability !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! /

(!* Maintenance 7indo7 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! /(!. Remote access system bac4up !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! &

/ Technical support !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! *& ;o7 to access the IBM Innovation Center %ystem 6 server !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! *

* IP) the )inu< on %ystem 6 guest system !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! 1

. ;o7 to Reconnect the Control 8ser ID !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! 1

3 ;o7 to Terminate the )inu< on %ystem 6 %ystem !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! ('

- ;o7 To IP) )inu< on %ystem 6 using )9=9>B? !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! ((

+;o7 to "ccess the )inu< Console "fter an IP) !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! (/1 ;o7 to Terminate the )inu< on %ystem 6 %ystem if IP)ed using )9=9>B? !!!!!!!!!!!!!!!!!!!!!!!!!!!!!! (&

(' "ccounting information !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! (&

('!( 9btaining program account information !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! (&(( "ppendi< "# Terms and definitions !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! (.

(/ >otices !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! (3

(& Trademar4s !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! (-

(


4/19

1 Overview remote access environment

The remote access environment is provided by the IBM Innovation Center, Dallas organizationin conjunction with various IBM development laboratories. Linux on System z is an operatingsystem from IBM which runs on System zserver hardware.

1.1 Hardware / software platform

The remote access program is implemented on an IBM System z server which is accessible toSolution Developers participating in the remote access program via the INTERNET. The

System z server runs the IBM z/VM(Virtual Machine) operating system which supports

multiple guest systems, each capable of supporting multiple users in a unique environment.

Each remote access participant is provided with a dedicated guest system, which appears to

the user as a System z server running a native Linux on System z operating system.

1.2 Introduction to the virtual machine concept

Virtual Machine(VM) is a software facility that allows one physical processor complex to beconfigured with multiple "virtual" processors or machines. Each virtual machine, 4no7n as a

guest, runs independently of every other virtual machine, and can run any System z operatingsystem (z/OS, z/VSE, z/VM, Linux, CMS, etc.) and software. Please refer to the IBM

Redbook Introduction to the New Mainframe: z/VM Basics SG247316 http://

www.redbooks.ibm.com/redbooks/pdfs/sg247316.pdf

1.3 System availability

The remote access program host systems are generally available 24 hours per day, 7 days per

week except for scheduled maintenance windows. Technical and administrative support isavailable from 07:00 to 19:00 US Central time Monday through Friday only.

1. !aintenance window

The IBM Innovation Center, Dallas has implemented the following policy regarding

maintenance windows:

Every Sunday between the hours of 09:30 and 15:30 US Central time theEvery Sunday between the hours of 09:30 and 15:30 US Central time the IBM Innovation

Center, Dallas may choose to make any of the processors unavailable. This time will be usedmay choose to make any of the processors unavailable. This time will be used

to perform system IPL's and to implement new or updated releases of software. Allto perform system IPL's and to implement new or updated releases of software. All Solution

Developers requiring an orderly guests requiring an orderly guest Linux on System z systemsystem shutdownshutdown should performshould perform

the shutdown prior to that time and should not plan to resume operation until after 15:30 USthe shutdown prior to that time and should not plan to resume operation until after 15:30 US

Central time on Sunday.Central time on Sunday.

/
http://www.redbooks.ibm.com/redbooks/pdfs/sg247316.pdfhttp://www.redbooks.ibm.com/redbooks/pdfs/sg247316.pdfhttp://www.redbooks.ibm.com/redbooks/pdfs/sg247316.pdfhttp://www.redbooks.ibm.com/redbooks/pdfs/sg247316.pdf


5/19

A maintenance window will not be required every Sunday, therefore Solution Developers may

choose to work during this time but only at their own risk. Notices will be posted whenever

possible (via host system broadcast messages) but all activity during this window is subject toimmediate interruption.

Solution Developers with special requirements for this time period should contact the

IBM Innovation Center, Dallas as early as possible.

1." #emote access system bac$up

The z/VM disks that contain the remote access system are backed up to tape every week and

are available for 3 months. The intent of these backups is to enable us to recover from aDASD failure. The backup and restore process operates only at the z/VM disk level, therefore

the restoration of individual files from these backups is difficult and time-consuming and notgenerally available.

To obtain details of the backups for the remote access system, or to change the frequency of

the backups, please contact the IBM Innovation Center, Dallas.

&


6/19

2 %echnical support

Technical %upport is provided via email! ;ours of attended operation are '-#'' to (1#'' 8%Central time Monday through @riday e


7/19

Second, a word about TN3270 Emulators...

Consult the T>&/-' emulator documentation to determine the appropriate 4ey

seAuences reAuired for the E>TER, P"/, @(/ and C)E"R 4eys!

The T>&/-' emulator must be %%) capable!

T!$"e 2 % T'(2)0 *mu"!tos

NOTE: IBM Corporation has taken steps to enhance the security of the internet connections to

the IBM Innovation Center, Dallas remote access systems, by blocking various ports from"INBOUND" traffic. Information about the blocked ports can be found on the IBM Innovation

Center, Dallas website at URL:

http://dtsc.dfw.ibm.com/MVSDS/'HTTPD2.DSN01.PUBLIC.HTML(BLKPORTS)'

To access the System z server, an Internet connection must first be established. Once that is

established, perform the following steps:

Step 1. Direct an SSL enabled TN3270 connection to the IBM Innovation Center, Dallas

Secure Portal at IP address 198.81.193.6, port23.

=o to the IBM Innovation Center, Dallas public 7ebsite to do7nload the Certificate for

%%) and vie7 instructions for setting up an %%) enabled T>&/-' connection 0Theinstructions that follo7 are for the IBM Personal Communications &/-' Emulator

soft7are! ?ou 7ill need to consult your &/-' emulator documentation for the steps that

are reAuired to do7nload and use the security certificate for the IBM Innovation Center,Dallas %ecure Portal at IP address (1+!+(!(1&!32#

http://dtsc.dfw.ibm.com/

%elect the Certificate for %%) T>&/-' lin4 at the bottom of the page!

Step 2. Once the connection is set up, the Remote Access Portal screen (below) will beOnce the connection is set up, the Remote Access Portal screen (below) will be

shown. Choose the system identified in the delivery email by entering in the system nameshown. Choose the system identified in the delivery email by entering in the system name

and pressingand pressing ENTERENTER..

.
http://dtsc.dfw.ibm.com/MVSDS/'HTTPD2.DSN01.PUBLIC.HTML(BLKPORTShttp://dtsc.dfw.ibm.com/http://dtsc.dfw.ibm.com/MVSDS/'HTTPD2.DSN01.PUBLIC.HTML(BLKPORTShttp://dtsc.dfw.ibm.com/


8/19

@igure ( %%) connection screen shot

%tep &! The ne


9/19

Step 4. On the command line of the LOGO screen, logon by typing in a z/VM Personal user ID

and password and pressing ENTER.

The pass7ord 7ill be e


10/19

@igure & %ystem messages, C)E"R to continue

Step 6. Successful logon has occurred when the screen displays the CMS ready prompt and

the z/VM status indicator in lower right-hand corner shows Running SVSCxxx. You are

now ready to initialize the Linux on System z guest as described in IPL the Linux on Systemz guest systemon page 1! %ince a 6$M Personal user ID has been chosen to initiali6e the 6$

M guest, this 6$M Personal user ID becomes the M Control userid!

@igure * CM% Ready prompt

+


11/19

I)* the *inu+ on System ( ,uest system

(! "ccess the %ystem 6 server over the Internet through the IBM Innovation Center, Dallas%ecure Portal using an %%) enabled T>&/-' emulator! %ee ;o7 to access the IBM

Innovation Center %ystem 6 server on page * for detailed instructions!

/! )ogon a 6$M Personal user ID 7hich 7ill be used to control the guest )inu< on %ystem6 system! The user ID is no7 referred to as the 6$M control user ID!

&! Initiali6e the guest )inu< on %ystem 6 system 7ith the command S+0!Oguest systemID:

SVXLOG ETPGLyy

*! "fter successfully activating and IP)ing your guest system ID, type in the follo7ing

command on your M command line#

#CP DISCand press Enter.

You will see a message similar to:

DISCONNECT AT 11:22:57 CDT WEDNESDAY 10/08/97

.! Press Enter to return to the IBM Innovation Center, Dallas logo screen!

3! ?ou can no7 log onto (ootfor your )inu< on %ystem 6 system by directing your %%;Client to the IP address assigned to your )inu< system! Refer to the system delivery

emails to obtain the assigned IP address and the pass7ord for root! If the assigned IP

address reAuires the use of Client P>, please refer to the system delivery email for

instructions for do7nloading the Cisco P> Client soft7are and using it to log into the

P>

" How to #econnect the 'ontrol -ser I

To reconnect the 6$M control user ID again to log off the )inu< on %ystem 6 system, you must

follo7 these steps#

(! "ccess the %ystem 6 server over the Internet through the IBM Innovation Center, Dallas

%ecure Portal using an %%) enabled T>&/-' emulator! %ee ;o7 to access the IBM

Innovation Center %ystem 6 server on page * for detailed instructions!/! @rom the IBM Innovation Center, Dallas logo screen, enter the 6$M control user ID and

the associated pass7ord and press Enter!

&! 9nce logged bac4 on, notice that displayed in the lo7er right hand corner of your screen

is CP RE"D! Type B and press Enter! ?ou may have to clear your screen after7ards by

pressing the Clear or P"/ 4ey to complete the reconnect process!

1


12/19


13/19

0 How %o I)* *inu+ on System ( usin,*OO&

(! "ccess the %ystem 6 server over the Internet through the IBM Innovation Center, Dallas

%ecure Portal using an %%) enabled T>&/-' emulator! %ee ;o7 to access the IBM

Innovation Center %ystem 6 server on page * for detailed instructions!

/! The )inu< on %ystem 6 =uest system user ID does not have a pass7ord and thus can not be

logged on to directly! ;o7ever, you can )9=9> to the =uest system ID B? a 6$M

Personal user ID, if you have a 6$M Personal user ID assigned!

&! Tab to the C9MM">D line and type ) ETP=)yy B? ETPD


14/19

.! ?ou may see system Glog messagesG at this point 7ith information of general interest 7hich

is broadcast to all users on the system! If the M status indicator 0in the lo7er righthand

corner of the screen2 sho7s ;olding or More!!!, press the Clear or P"/ 4ey(to continue!

5hen the M status indicator sho7s Running, CM% is operating!

@igure - E, please refer to the system delivery email for instructions for

do7nloading the Cisco P> Client soft7are and using it to log into the P> !

+! Issue the HCP DI%C command from the M command line to disconnect 7hen finished

vie7ing the )inu< console! The )inu< system 7ill remain fully operational!

4 How to 5ccess the *inu+ 'onsole 5fter anI)*

8se the )9=9>B? command to access the guest system user IDFs console as you did 7hen IP)ing thesystem! %ee ;o7 To IP) )inu< on %ystem 6 using )9=9>B? on page ((! If you receive the

message ,9P!A;


15/19

6 How to %erminate the *inu+ on System (System if I)*ed usin, *OO&

(! Shutdownthe )inu< on %ystem 6 system from (ootby directing your %%; Client to the IP

address assigned to your guest )inu< system!

/! 8se the )9=9>B? command to access the guest system user IDFs console as you did 7hen

IP)ing the system! %ee ;o7 To IP) )inu< on %ystem 6 using )9=9>B? on page ((!

&! 9n the command line, type %9P !OO>>and press Enter! ?ou 7ill receive a message

from the guest system user ID similar to#

ETP=)yy# )9=9@@ "T (.#(/#*( C%T T8E%D"? (($'3$'-

17 5ccountin, informationMany of the IBM Innovation Center, Dallas Remote Access Program fees include a specified

amount of CPU work units in the base fee and any extra work units used for a month are charged

at a specified per work unit rate. The number of work units included in the base fee and the

additional per work unit rate are documented in the Program Chargessection of the Exhibit

included in the program enrollment package. The session report (SESSREPT) command isprovided for you to monitor the work unit usage of your guest system. Accounting records are

stored for each guest system that has had usage during the twelve hour period ending at 07:00

and at 19:00 US Central time each day.

17.1 Obtainin, pro,ram account information

Work unit accounting information may be obtained for the guest Linux on System z system,

for a specified date range by issuing a CP command from a z/VM Personal user ID.

The command is:

MSG SVUTIL SESSREPT ETPGLyy FDATE LDATE

where FDATEis the first date in the range and LDATEis the last date in the range.

(&


16/19

An explanation of the syntax is provided in the SESSREPT help text which is retrieved withthe command:

MSG SVUTIL HELP SESSREPT

SVUTIL: SVUTIL SESSREPT COMMAND SYNTAX:

SVUTIL:

SVUTIL: "MSG SVUTIL SESSREPT UUUUUUUU FDATE LDATE"

SVUTIL:

SVUTIL: WHERE UUUUUUUU = USERID FOR SESSION REPORT

SVUTIL: FDATE = FIRST DATE TO BE REPORTED (MM/DD/YY)

SVUTIL: LDATE = LAST DATE TO BE REPORTED (MM/DD/YY)

SVUTIL:

SVUTIL: ALL PARAMETERS ARE REQUIRED. DATES MUST BE BETWEEN 1989

AND THE CURRENT DATE. ONE OR TWO DIGITS OK FOR MONTH AND DAY.

After a short time, the SVUTIL service machine will send a detailed usage report to the z/VMReader of the z/VM Personal user ID that sent the command.

When the report is returned, a message will be displayed on the z/VM Personal user ID CMSscreen with an identifying file number. To view the contents of the file, enter the command:

PEEKfile_number (FOR *

Alternatively, access the file using the z/VM ReadList command:

RL

@rom the list of reader files, cursor to the line of the file to vie7 and press >??0Pee42!

5hile pee4ing the file, it may be easier to vie7 after entering the command + ? @ on the

command line! 8se @- and @+ to scroll the file for7ard and bac47ard! 8se @& to Auit

loo4ing at the file!

(*


17/19

11 5ppendi+ 58 %erms and definitions

Te(m Definition

uest system "n operating system running in a virtual machine managed by the 6$M Control program!

9ont(ol -D The term 6$M control user IDis used to reference the specific B/+# Pe(son)l use( -Dused to initiali6e the guest )inu< on %ystem 6 system and currently holds the ability toperform functions for the system!

9P Control Program! The component of 6$M that manages the resources of a single physicalprocessor comple< such that multiple computing systems appear to e%9)E device, a user may toggle bac4 and forth bet7een CP and a guest system bypressing the P"( 0Program "ttention (2 4ey!(

+i(tu)l#)chine

" functional eAuivalent of either a %ystem$&-' computing system, a %ystem$&-'"0E


18/19

12 otices

This information 7as developed for products and services offered in the 8!%!"!

IBM may not offer the products, services, or features discussed in this document in other

countries! Consult your local IBM representative for information on the products andservices currently available in your area! "ny reference to an IBM product, program, or

service is not intended to state or imply that only that IBM product, program, or service may

be used! "ny functionally eAuivalent product, program, or service that does not infringe anyIBM intellectual property right may be used instead! ;o7ever, it is the users responsibilityto evaluate and verify the operation of any nonIBM product, program, or service!

IBM may have patents or pending patent applications covering subect matter described in

this document! The furnishing of this document does not give you any license to these

patents! ?ou can send license inAuiries, in 7riting, to#

IBM Director of Licensing, IBM Corporation, North Castle Drie, !rmon", N# $%&%'($)*&+-!

The followin* p)()*()ph does not )pply to the nited Cin*dom o( )ny othe( count(y

whe(e such p(ovisions )(e inconsistent with loc)l l)w:I>TER>"TI9>") B8%I>E%%

M"C;I>E% C9RP9R"TI9> PR9IDE% T;I% P8B)IC"TI9> G"% I%G 5IT;98T5"RR">T? 9@ ">? JI>D, EIT;ER EPRE%% 9R IMP)IED, I>C)8DI>=, B8T

>9T )IMITED T9, T;E IMP)IED 5"RR">TIE% 9@ >9>I>@RI>=EME>T,

MERC;">T"BI)IT? 9R @IT>E%% @9R " P"RTIC8)"R P8RP9%E! %ome states do

not allo7 disclaimer of e


19/19

Documents

User Guide Linux on System z Remote Acces Program.pdf