User's Guide and Reference

for IBM Linux for System z

Remote Access Programs
June 29, 2010
International Business Machines Corporation
Innovation Center, Dallas
Dallas, TX
USA
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 used
for purposes other than intended!

Coyrig!t Internationa" Business Mac!ines Cororation #$%$& A"" rig!ts reser'ed& Coyrig!t Internationa" Business Mac!ines Cororation #$%$& A"" rig!ts reser'ed&
Preface
This document is intended to assist the user in accessing and using the Linux on System z
Remote Development system. It covers all supported versions of Linux on System z.
Comments on this document may be addressed to:
IBM Corporation
"ttn# ETP "dministration
M$% &''()('*
(&+'' 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
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 !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! (-
(
1 Overview remote access environment
The remote access environment is provided by the IBM Innovation Center, Dallas organization
in conjunction with various IBM development laboratories. Linux on System z is an operating
system from IBM which runs on System z server hardware.
1.1 Hardware / software platform
The remote access program is implemented on an IBM System z server which is accessible to
Solution 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 be
configured 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 operating
system (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 is
available 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 the Every 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 used may 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. All to perform system IPL's and to implement new or updated releases of software. All Solution
Developers requiring an orderly guest s requiring an orderly guest Linux on System z system system shutdown shutdown should perform should perform
the shutdown prior to that time and should not plan to resume operation until after 15:30 US the 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.
/
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 to
immediate 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 a
DASD 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 not
generally 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.
&
2 %echnical support
Technical %upport is provided via email! ;ours of attended operation are '-#'' to (1#'' 8%
Central time Monday through @riday e<cept IBM 8%" holidays! Emails received after hours, on
7ee4ends, or on holidays 7ill be processed the ne<t business day! If you reAuire technical
support, please follo7 the instructions sho7n at 8R) http://dtsc.dfw.ibm.com/contact.html!
3 How to access the I&! Innovation 'enter
System ( server
Before utilizing the guest Linux on System z system, Solution Developers must first follow the
steps below to access the IBM System z server (e.g., SVSCDR2) and initialize (IPL) the guest
Linux on System z system. Access to the IBM System z server requires access to the Internet.
The method, line speed, and choice of Internet Service Provider are determined by the Solution
Developer.
First, a word about user IDs...
There are several different user IDs described in this document#
Guest system ID 6$BM ID 7hich e<ecutes )inu< on %ystem 6! This ID is the guest
Linux on System z system.
z/VM Peson!" use ID 6$BM user ID used as an individual identifier for security
verification 7hen accessing the )inu< on %ystem 6 virtual machine 0via the DI")
command2!
z/VM #onto" use ID The term z/VM #onto" use ID is used to reference the
specific 6$BM Personal user ID used to initiali6e the guest )inu< on %ystem 6 system
and currently holds the ability to perform functions for the guest )inu< on %ystem 6
system!
In this guide, 7e refer to the guest )inu< on %ystem 6 system ID as ETP=)yy and the 6$BM
Personal user ID as ETPD<<<
"ll %olution Developers have been provided a guest )inu< on %ystem 6 system ID 7hich is the
guest )inu< on %ystem 6 system!
If not previously supplied 7ith pass7ords for the 6$BM Personal user IDs, contact the IBM
Innovation Center, Dallas and reAuest to have the 6$BM Personal user IDs RE%8MED and an
initial pass7ord set!
T!$"e 1 % &se IDs
*
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, port 23.
=o to the IBM Innovation Center, Dallas public 7ebsite to do7nload the Certificate for
%%) and vie7 instructions for setting up an %%) enabled T>&/-' connection 0The
instructions 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 be Once 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 name shown. Choose the system identified in the delivery email by entering in the system name
and pressing and pressing ENTER ENTER. .
.
@igure ( %%) connection screen shot
%tep &! The ne<t screen displayed 7ill be the IBM Innovation Center, Dallas system )9=9
screen, indicating that the IBM Innovation Center, Dallas %ystem 6 server has been reached!
@igure / )9=9 screen e<ample
3
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<pired on first use of the 6$BM Personal user ID or anytime after
the IBM Innovation Center, Dallas has reset the pass7ord! The system 7ill prompt you
to change the pass7ord 0as sho7n belo72!
LOGON ETPDxxx
RPIMGR042I PASSWORD EXPIRED
To change your pa!or" # en$er% nnn&nnn !here nnn ' ne!
pa!or" or( en$er LOGO)) $o cance*
Enter a ne7 pass7ord in the format of new_password/new_password and press ENTER.
The text you type will not be visible to help assure the privacy of the 6$BM Personal user
ID pass7ord!
PASSWORD R!"S. The PASSWORD #ST:
Be eight characters in length
9nly contain alphabetic, numeric and national characters i!e!, $ % and &
Contain at least one alphabetic and one nonalphabetic character
;ave the first and last characters be nonnumeric
Contain no more than three identical consecutive characters in any position from the
previous pass7ord
Contain no more than t7o identical consecutive characters
>ot contain the userid as part of the pass7ord
>ot be reused until after at least eight iterations
Step 5. %ystem Clog messagesD 7ith information of general interest, are broadcast to all users on %ystem Clog messagesD 7ith information of general interest, are broadcast to all users on
the system! the system! 'e su(e to (eview the 'e su(e to (eview the b(o)dc)st mess)*es b(o)dc)st mess)*es fo( impo(t)nt notices (e*)(din* fo( impo(t)nt notices (e*)(din*
scheduled out)*es scheduled out)*es. . 5hen the 6$BM status indicator in the lo7er righthand corner of the 5hen the 6$BM status indicator in the lo7er righthand corner of the
screen sho7s screen sho7s +# Re)d +# Re)d, press the , press the ENTER ENTER 4ey to continue! If the 6$BM status indicator in the 4ey to continue! If the 6$BM status indicator in the
lo7er righthand corner of the screen sho7s lo7er righthand corner of the screen sho7s ,O!D-./ ,O!D-./ or or #OR" #OR"... ..., press the , press the CLEAR CLEAR or or
PA2 PA2 4ey to continue 4ey to continue
(
! !
( The ENTER, CLEAR, and PA2 4eys are part of the IBM &/-' terminal architecture! Refer to the T>&/-'
emulatorEs documentation for information on these 4eys!
-
@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 System
z guest system on page 1! %ince a 6$BM Personal user ID has been chosen to initiali6e the 6$
BM guest, this 6$BM Personal user ID becomes the BM Control userid!
@igure * CM% Ready prompt
+
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 C ;o7 to access the IBM
Innovation Center %ystem 6 serverC on page * for detailed instructions!
/! )ogon a 6$BM Personal user ID 7hich 7ill be used to control the guest )inu< on %ystem
6 system! The user ID is no7 referred to as the 6$BM control user ID!
&! Initiali6e the guest )inu< on %ystem 6 system 7ith the command S+0!O/ guest system
ID:
SVXLOG ETPGLyy
*! "fter successfully activating and IP)ing your guest system ID, type in the follo7ing
command on your BM command line#
#CP DISC and 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 (oot for 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 BP>, please refer to the system delivery email for
instructions for do7nloading the Cisco BP> Client soft7are and using it to log into the
BP>
" How to #econnect the 'ontrol -ser I.
To reconnect the 6$BM 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 C ;o7 to access the IBM
Innovation Center %ystem 6 serverC on page * for detailed instructions!
/! @rom the IBM Innovation Center, Dallas logo screen, enter the 6$BM 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
/ How to %erminate the *inu+ on System (
System
(! Shutdown your )inu< on %ystem 6 system from (oot by directing your %%; Client to the IP
address assigned to your guest )inu< system!
/! Reconnect the 6$BM control user ID using the instructions found in C;o7 to Reconnect the
Control 8ser IDD on page 1!
&! @rom the 6$BM control user ID, type S".D Guest system ID234567688 and press
Enter! ?ou 7ill receive a message from the =uest system ID similar to#
ETP=)yy# )9=9@@ "T (.#(/#*( C%T T8E%D"? (($'3$'-
Now you are ready to logoff the z/VM control user ID.
Type LOGOFF and press Enter
@igure . )ogging off 6$BM control user ID!
('
0 How %o I)* *inu+ on System ( usin,
*O1O2&3
(! "ccess the %ystem 6 server over the Internet through the IBM Innovation Center, Dallas
%ecure Portal using an %%) enabled T>&/-' emulator! %ee C ;o7 to access the IBM
Innovation Center %ystem 6 serverC 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$BM
Personal user ID, if you have a 6$BM Personal user ID assigned!
&! Tab to the C9MM">D line and type C) ETP=)yy B? ETPD<<<F on the logo screen and
press Enter, replacing ETP=)yy 7ith your =uest system ID and replacing ETPD<<< 7ith
your 6$BM Personal user ID!
@igure 3 E<ample of )9=9>B?
*! The pass7ord 7ill be e<pired on first use of the 6$BM Personal user ID or anytime after the
IBM Innovation Center, Dallas has reset the pass7ord! The system 7ill prompt you to
change the pass7ord 0as sho7n belo72!
LOGON ETPDxxx
RPIMGR042I PASSWORD EXPIRED
To change your pa!or" # en$er% nnn&nnn !here nnn ' ne!
pa!or" or( en$er LOGO)) $o cance*
Enter a ne7 pass7ord in the format of new_password/new_password and press ENTER. The
text you type will not be visible to help assure the privacy of the 6$BM Personal user ID
pass7ord!
((
.! ?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 BM status indicator 0in the lo7er righthand
corner of the screen2 sho7s ;olding or More!!!, press the Clear or P"/ 4ey
(
to continue!
5hen the BM status indicator sho7s Running, CM% is operating!
@igure - E<ample of )ogon Messages
3! The )inu< on %ystem 6 system 7ill begin the IP) process! If the 6$BM status indicator
sho7s E;oldingE or EMoreE, press the C)E"R or P"/ 4ey to continue!
-! ?ou can no7 log onto root for 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 BP>, please refer to the system delivery email for instructions for
do7nloading the Cisco BP> Client soft7are and using it to log into the BP> !
+! Issue the HCP DI%C command from the BM 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 an
I)*
8se the )9=9>B? command to access the guest system user IDFs console as you did 7hen IP)ing the
system! %ee C;o7 To IP) )inu< on %ystem 6 using )9=9>B? D on page ((! If you receive the
message ,9P!/A:;<" Al(e)dy lo**ed on= follo7 these steps#
1. Type LOGOFF and press ENTER to return to the logo screen.
2. From the logo screen, tab to the COMMAND line, type From the logo screen, tab to the COMMAND line, type L ETPGLyy BY ETPDxxx HERE L ETPGLyy BY ETPDxxx HERE
and press ENTER. See and press ENTER. See Figure 6 Example of LOGONBY on page on page 11..
1The C)E"R and P"/ 4eys are part of the IBM &/-' terminal architecture!
(/
6 How to %erminate the *inu+ on System (
System if I)*ed usin, *O1O2&3
(! Shutdown the )inu< on %ystem 6 system from (oot by 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 C;o7 To IP) )inu< on %ystem 6 using )9=9>B? D on page ((!
&! 9n the command line, type %9P !O/O>> 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, information
Many 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 Charges section of the Exhibit
included in the program enrollment package. The session report (SESSREPT) command is
provided 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 FDATE is the first date in the range and LDATE is the last date in the range.
(&
An explanation of the syntax is provided in the SESSREPT help text which is retrieved with
the 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/VM
Reader 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 CMS
screen with an identifying file number. To view the contents of the file, enter the command:
PEEK file_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 Epee4Eing the file, it may be easier to vie7 after entering the command + ? @A on the
command line! 8se @- and @+ to scroll the file for7ard and bac47ard! 8se @& to Auit
loo4ing at the file!
(*
11 5ppendi+ 58 %erms and definitions
Te(m
Definition
/uest system "n operating system running in a virtual machine managed by the 6$BM Control program!
9ont(ol -D The term 6$BM control user ID is used to reference the specific B/+# Pe(son)l use( -D
used to initiali6e the guest )inu< on %ystem 6 system and currently holds the ability to
perform functions for the system!
9P Control Program! The component of 6$BM that manages the resources of a single physical
processor comple< such that multiple computing systems appear to e<ist! @rom the
C9>%9)E device, a user may toggle bac4 and forth bet7een CP and a guest system by
pressing the P"( 0Program "ttention (2 4ey!
(
+i(tu)l
#)chine
" functional eAuivalent of either a %ystem$&-' computing system, a %ystem$&-',"
0E<tended "rchitecture2 computing system, a %ystem$&-'E%" 0Enterprise %ystems
"rchitecture2, or a %ystem$&1' computing system! Each virtual machine is controlled by
an operating system!
B/+# Birtual Machine! " soft7are facility 7hich enables multiple users to share the resources
of a single physical processor comple< such that each user appears to have the eAuivalent
of a dedicated processor!
T!$"e 1 % System Tems
The following are CP and CMS Status Indicators - these indicators may at times appear in the
lower right hand corner of the display.
Te(m Definition
9P R"AD Means that CP issued a read reAuest to the display and is 7aiting for something to be
entered before it continues processing!
+# R"AD %imilar to CP RE"D but issued from CM% 0Conversational Monitor %ystem, a component
of 6$BM2!
R..-./ Means that CP or CM% either is ready for the ne<t CP or CM% command or is processing a
previously entered command!
#OR"... Means that the output display area is full and that CM% or CP has more lines to display!
The data currently on the screen 7ill be displayed for one minute! To get to the ne<t
screen, press C)E"R or P"/! To 4eep the current information on the screen, press the
E>TER 4ey! The ;9)DI>= indicator then appears in the status area! If you do not
respond to the M9RE!!! indicator 7ithin ( minute, the ne<t screen 7ill automatically be
displayed 0your display device 7ill beep (' seconds prior to display of the ne<t screen2!
,O!D-./ Means that the E>TER 4ey 7as pressed in response to a M9RE!!! status indicator, or that
the display screen contains priority messages from CP! To get to the ne<t screen, press
C)E"R or P"/!
.OT
A99"PT"D
Means that previous input has not yet been processed! Recommended response is to 7ait
for the >9T "CCEPTED to clear, bac4space to the left margin, erase the command, and
reenter it!
T!$"e T!$"e 2 % #P !n+ #MS st!tus in+i,!tos % #P !n+ #MS st!tus in+i,!tos
( The P"(, P"/, and C)E"R 4eys are part of the IBM &/-' terminal architecture, and may be emulated by a different 4ey or
combination of 4eys depending on the actual terminal or personal computer emulation pac4age being used!
(.
12 2otices
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 and
services 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 any
IBM intellectual property right may be used instead! ;o7ever, it is the userEs responsibility
to evaluate and verify the operation of any nonIBM product, program, or service!
IBM may have patents or pending patent applications covering subIect 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> PR9BIDE% T;I% P8B)IC"TI9> G"% I%G 5IT;98T
5"RR">T? 9@ ">? JI>D, EIT;ER E,PRE%% 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<press or implied 7arranties in certain transactions, therefore, this
statement may not apply to you!
This information could include technical inaccuracies or typographical errors. Changes are
periodically made to the information herein; these changes will be incorporated in new
editions of the publication. IBM may make improvements and/or changes in the product(s)
and/or the program(s) described in this publication at any time without notice.
(3
13 %rademar$s
The follo7ing terms are trademar4s or registered trademar4s of International Business
Machines Corporation in the 8nited %tates, other countries, or both! If these and other IBM
trademar4ed terms are mar4ed on their first occurrence in this information 7ith a trademar4
symbol 0K or L2, these symbols indicate 8!%! registered or common la7 trademar4s o7ned
by IBM at the time this information 7as published! %uch trademar4s may also be registered
or common la7 trademar4s in other countries! " current list of IBM trademar4s is available
on the 5eb at CCopyright and trademar4 informationD at 777!ibm!com$legal$
copytrade!shtml
IBM

REXX
System z

VTAM

z/VM

Microsoft, 5indo7s, 5indo7s >T, and the 5indo7s logo are trademar4s of Microsoft
Corporation in the 8nited %tates, other countries, or both!
8>I, is a registered trademar4 of The 9pen =roup in the 8nited %tates and other countries!
9ther company, product, or service names may be trademar4s or service mar4s of others!
(-