-
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&
-
8/10/2019 User Guide Linux on System z Remote Acces Program.pdf
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
-
8/10/2019 User Guide Linux on System z Remote Acces Program.pdf
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 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! (-
(
-
8/10/2019 User Guide Linux on System z Remote Acces Program.pdf
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 -
8/10/2019 User Guide Linux on System z Remote Acces Program.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.
&
-
8/10/2019 User Guide Linux on System z Remote Acces Program.pdf
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
-
8/10/2019 User Guide Linux on System z Remote Acces Program.pdf
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/10/2019 User Guide Linux on System z Remote Acces Program.pdf
8/19
@igure ( %%) connection screen shot
%tep &! The ne
-
8/10/2019 User Guide Linux on System z Remote Acces Program.pdf
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
-
8/10/2019 User Guide Linux on System z Remote Acces Program.pdf
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
+
-
8/10/2019 User Guide Linux on System z Remote Acces Program.pdf
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
-
8/10/2019 User Guide Linux on System z Remote Acces Program.pdf
12/19
-
8/10/2019 User Guide Linux on System z Remote Acces Program.pdf
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
-
8/10/2019 User Guide Linux on System z Remote Acces Program.pdf
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;
-
8/10/2019 User Guide Linux on System z Remote Acces Program.pdf
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.
(&
-
8/10/2019 User Guide Linux on System z Remote Acces Program.pdf
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!
(*
-
8/10/2019 User Guide Linux on System z Remote Acces Program.pdf
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
-
8/10/2019 User Guide Linux on System z Remote Acces Program.pdf
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
-
8/10/2019 User Guide Linux on System z Remote Acces Program.pdf
19/19