IBM Professional Series User manual

•

Preface
This publication is intended for all users of VM/PC. It
assumes a general knowledge of the VM operating
environment. This publication has two sections:
1. Chapters 1 through 5 contain basic information to help
you start using VM/PC.
2. Chapters 6 through 8 and the Appendixes contain more
specialized and reference information.
"How to Use This Book" on page 1-3 describes the layout of
this book in greater detail.
If you are not familiar with using VM/SP or something
similar, you may want to order the IBM publication Virtual
Machine/ Personal Computer Primer, part number 6024174,
from your IBM Marketing Representative. This Primer is
intended for beginning users. It provides many examples of
basic usage.
VM/PC is based upon VM/SP Release 2. It may be
necessary to reference some VM/SP publications to find
further reference information for VM/PC. Appendix
C, "Comparison of VM/PC and VM/SP" on page C-1
provides information about where to find further information
in the VM/SP library, and gives the Titles and Order
Numbers for the VM/SP books.
When you see text printed in this color it indicates either:
1. This is the first occurrence of a term defined in the
glossary.
2. This is a user entry (for example, a command).
Preface iii

Statement of Service
Program service for VM/PC is IBM Central Service including an IBM
Support Center. This service will be available until discontinued by IBM
upon six (6) months written notice or until
31 December 1985, whichever
comes first.
The IBM Support Center will provide the customer technical coordinator
with telephone assistance in problem diagnosis and resolution. The IBM
Support Center
is the established point of contact between the customer
technical coordinator and IBM Central Service.
IBM Central Service will respond to a defect in the unaltered portion of a
supported release of the licensed program by issuing defect correction
information such as correction documentation, corrected code,
or notice of
availability of corrected code; or a restriction or a bypass. IBM does not
guarantee service results or that the program will be error free
or that all
program defects will be corrected.
No on-site service is included.
The IBM Marketing Representative will register the customer technical
coordinator with the IBM Support Center.
It is expected that the customer
technical coordinator
is familiar with VM/ CMS. The customer technical
coordinator becomes the first level of customer end-user assistance. The
technical coordinator's duties should include:
answer end-user hardware and software questions.
perform problem determination to determine if a problem
is hardware
or software related.
provide the customer interface to the appropriate IBM Support
Centers.
provide corrections received from IBM Central Service through the
IBM Support Center to all licensed
VM/PC users for whom he is
responsible in the customer organization.
manage problems and changes for
VM/PC end-users in the customer's
organization.
Some customers may find it necessary to have more than one technical
coordinator. However, to ensure consistency
of support, the number of
technical coordinators should be kept to a minimum. The IBM Marketing
Representative
is the contact to negotiate additional technical coordinators.
iv VM/PC Users Guide

Contents
Chapter 1. Introduction to VM/PC ... 1-1
What You Need ........................... 1-2
How to Use This Book ...................... 1-3
The VM/PC System ....................... 1-7
Using Local VM/PC Services ................ 1-8
Using Remote VM Services .................. 1-9
Chapter 2. Installing VM/PC ....... 2-1
About This Chapter ...................... 2-1
Before You Begin ......................... 2-2
Copying VM/PC to Backup Diskettes .......... 2-4
Copying VM/PC to Your System .............. 2-5
How Much Disk Space Is Required? .......... 2-14
At Installation Time ..................... 2-14
After Installation ....................... 2-14
What About Existing Files? ................. 2-17
If Something Goes Wrong? ................. 2-19
DOS Facilities Missing .................. 2-19
VM/PC Temporary Files Already Exist ...... 2-19
Insufficient Space on C Disk .............. 2-20
Unable to Read Space Available on C Disk .... 2-21
VM/PC Distribution Diskette Not Used ..... 2-21
Repeating the Installation Process ............ 2-23
Chapter 3. Configuring Your VM/PC
System ........................ 3-1
The Configuration File .................... 3-1
The Configurator Program ................... 3-3
Starting the Configurator Program ........... 3-3
Using the Configurator .................... 3-3
Configurator Screens ................... 3-4
Function Key Usage .................... 3-4
Keyboard Usage ....................... 3-5
The Password Screen ..................... 3-6
Function Menu Screen .................... 3-6
Quitting the Configurator ................ 3-7
Contents v

Normal Exit from the Configurator ........ 3-7
System Configuration Screen ............... 3-8
Configurator Password Screen ............. 3-10
System Options Screen .................. 3-10
User Selection Screen ................... 3-11
User Function Selection Screen .......... 3-12
Update Environment for User Screen ...... 3-12 I
Minidisk List Screen .................. 3-13
Link List Screen ..................... 3-16
Update Link Screen ................... 3-17
Disk Allocation and Checking .............. 3-18
Limitations ........................... 3-19
Chapter 4. Getting Started .......... 4-1
Invoking VM/PC ....................... 4-1
Keyboard Usage ........................... 4-2
Session Selection .......................... 4-5
Local 3277 Session ...................... 4-6
Remote 3277 Session .................... 4-6
Remote 3101 Session .................... 4-7
Prerequisites ......................... 4-8
Using the Remote 3101 Session ........... 4-8
370 Processor Control ................... 4-11
LogonSequence ......................... 4-12
Screen Format ........................... 4-15
Screen Scroll .......................... 4-15
Status Notices ......................... 4-16
The 25th Line ......................... 4-18
What To Do if Something Goes Wrong ........ 4-21
System Failures ........................ 4-21
Startup Failures ...................... 4-22
Processing Failures ................... 4-23
System Error Conditions ................. 4-23
Error Messages ...................... 4-23
System Unavailable ................... 4-23
Chapter 5. Using VM/PC Commands to
Do Work
...................... 5-1
Using Commands to Do Work .............. 5-1
Creating, Changing and Managing Files ......... 5-2
vi VM/PC Users Guide

Creating Files .......................... 5-2
What Is a File? ....................... 5-2
Creating A File ....................... 5-4
Entering Data ....................... '. 5-7
Capital and Lowercase Letters ............ 5-8
Splitting and Joining Lines ............... 5-9
Setting Tabs ........................ 5-10
Displaying PF Key Settings ............. 5-10
Inserting Words in a Line ............... 5-11
Power Typing ........................ 5-11
Creating an XEDIT Profile ............. 5-12
Changing Files ......................... 5-13
Displaying a File on Your Screen ......... 5-13
Adding Lines ........................ 5-13
Moving through a File ................. 5-14
Deleting Lines ....................... 5-15
Duplicating Lines ..................... 5-17
Copying Lines ....................... 5-17
Moving Lines ........................ 5-19
Cancelling a Prefix Command - RESET
Command ......................... 5-19
LOCATE and CHANGE Commands ...... 5-19
Repeating a Command -The = (equal)
Command
......................... 5-21
Combining Files ...................... 5-21
Cancelling Changes to a File ............ 5-22
Numbering Lines of a File .............. 5-23
Sorting a File ........................ 5-23
Protecting Files ........................ 5-26
SAVE Command ..................... 5-26
SET AUTOSAVE Command ............ 5-27
Managing Files ........................ 5-27
Getting a List of Your Files ..........•.. 5-28
Using the FILELIST Command .......... 5-28
Using the LISTFILE Command .......... 5-35
Printing Files ............................ 5-38
PRINT Command ...................•.. 5-38
Remote Printing ........................ 5-38
Writing EXECs .......................... 5-40
An EXEC to Print a File ..............•.. 5-40
Contents vii

Setting Up Your System to Meet Your Needs ... 5-44
Finding Out Basic Information ............. 5-44
How Much Disk Space Have I Used? ........ 5-44
How Does CMS Choose Programs and Files? . 5-45
Modifying the ACCESS List .............. 5-45
An Easy Way to Set Up a Concurrent Session . 5-47
Establishing Automatic LINKs and ACCESSes. 5-48
Sharing Data and Programs with Other Users .. 5-48
A Sample PROFILE EXEC ............... 5-50
PF Keys Make Work Simpler ............. 5-50
Reviewing What You Have Done ........... 5-51
Scrolling Screen Contents .............. 5-51
Retrieving Commands
................. 5-52
Using Synonyms in Your Work ............. 5-53
Controlling Your Display ................. 5-54
Highlighting Your Input ................ 5-54
Scrolling a Half Screen ...........•.... 5-54
Displaying Long Lines ................. 5-54
Transferring Personal Computer DOS and VM/PC
Files .............................•.... 5-55
Copying a Text File from Personal Computer
DOS to VM/PC (IMPORT) ............. 5-55
Copying a Text File from VM/PC to Personal
Computer
DOS (EXPORT) .........•.... 5-56
Copying a Program from Personal Computer
DOS to VM/PC (IMPORT) ........•.... 5-57
Copying a Program from VM/PC to Personal
Computer
DOS (EXPORT) .............. 5-57
Chapter 6. Remote Services ......... 6-1
Remote Upload/Download ................ 6-1
VM/PC Remote Services Program .......... 6-3
Installing VMPCSERV ................. 6-3
What To Do if Something Goes Wrong ..... 6-6
VMPCSERV Program ............•..... 6-8
Remote Minidisks ....................... 6-9
Remote Files .......................... 6-12
File Upload/Download ............•.... 6-13
Remote Spooling ....................... 6-14
What to Do if Something Goes Wrong ....... 6-15
viii VM/PC Users Guide

How VMPCSERV Works ................ 6-16
Collecting Names of Files Downloaded to
VM/PC ........................... 6-18
Chapter 7. VM/PC Commands ...... 7-1
Entering Commands .....•................ 7-1
The Command Name
................... 7-1
The Command Operands
................ 7-1
The Command Options
................. 7-2
Comments
in CMS Command Lines ........ 7-2
Notational Conventions ................... 7-2
CP Commands ............................ 7-7
Format
of CP Commands .................. 7-7
Summary of CP Commands ................ 7-7
CP Commands and Options ............... 7-10
* ................................. 7-10
#CP ............................... 7-10
ATTN ............................. 7-11
BEGIN
............................ 7-12
CHANGE .......................... 7-12
CLOSE ............................ 7-14
CP ................................ 7-16
DEFINE ........................... 7-16
DETACH .......................... 7-18
DISPLAY .......................... 7-19
DUMP ............................ 7-23
EXTERNAL ........................ 7-26
IPL ............................... 7-26
LINK ............................. 7-27
LOGOFF .......................... 7-30
ORDER ........................... 7-30
PURGE ............................ 7-31
QUERY ........................... 7-32
REQUEST ......................... 7-37
SET ............................... 7-38
SPOOL ............................ 7-41
STORE ............................ 7-44
TAG .............................. 7-46
TERMINAL ........................ 7-48
TRACE ............................ 7-51
Contents ix

CMS Commands ......................... 7-56
Character Set Usage .................... 7-56
CMS Command Search Order ............. 7-56
Summary of CMS Commands ............. 7-59
CMS Commands and Options ............. 7-61
ACCESS ........................... 7-62
CMDCALL ......................... 7 -66
COMPARE ...........•............. 7-66
CONW AIT ......................... 7-66
COPYFILE ......................... 7-67
CP ................................ 7-67
DEBUG ........................... 7-68
DEFAULTS ........................ 7-69
DESBUF ........................... 7-71
DROPBUF ......................... 7-71
ERASE ............................ 7-72
ESTATE/ESTATEW ................. 7-72
EXEC ............................. 7-74
EXECIO ........................... 7-74
EXPORT .......................... 7-76
FILEDEF
.......................... 7-78
FILELIST .......................... 7-78
FINIS ............................. 7-79
FORMAT .......................... 7-80
GENDIRT ......................... 7-84
GENMOD ......................... 7-84
GLOBAL .......................... 7-89
GLOBALV ......................... 7-90
IDENTIFY ......................... 7-93
IMPORT .......................... 7-94
INCLUDE .......................... 7-97
LISTFILE .......................... 7-98
LOAD .............................. 7-99
LOADMOD ........................ 7-99
MACLIB .......................... 7-100
MAKEBUF ........................ 7-101
MODMAP ........................ 7-102 I
NUCXDROP ...................... 7-102
NUCXLOAD ...................... 7-102
NUCXMAP ....................... 7-104
x VMjPC Users Guide

PRINT ........................... 7 -104
QUERY ...................•...... 7-105
RELEASE ......................... 7-114
RENAME ......................... 7-114
SENTRIES ........................ 7-114
SET .............................. 7-115
SORT ............................ 7-118
START ., .......................... 7-119
STATE/STATEW .................. 7-119
SYNONYM ....................... 7-119
TXTLIB .......................... 7-126
TYPE .....................•...... 7-126
UPDATE ......................... 7-126
XEDIT ........................... 7-127
Immediate Commands ................ 7-128
Chapter 8. VM/PC Messages ....... 8-1
How To Use This Chapter ................. 8-1
Identifying Issuing Component .............. 8-1
Reading a Sample Message Explanation ....... 8-2
Message Explanations ...................... 8-3
List of All VM/PC CMS Messages ........... 8-26
Appendix A. CP /CMS Interface ..... A-I
Privileged Operation Simulation ............. A-I
Set Storage Key -SSK ................. A-I
Insert Storage Key -ISK ................ A-I
Test I/O - TIO ....................... A-2
Set Clock -SCK ...................... A-2
Diagnose Instruction in
VM/PC .............. A-3
DIAGNOSE Code X'OO' -- Store
Extended-Identification Code ............... A-5
DIAGNOSE Code X'08' -- Virtual Console
Function
............................... A-7
DIAGNOSE Code X'OC' -- Pseudo Timer ..... A-10
DIAGNOSE Code
X'10' -- Release Pages ..... A-II
DIAGNOSE Code X'18' -- Standard DASD I/O A-12
DIAGNOSE Code X'20' -- General I/O ...... A-14
DIAGNOSE Code X'24' -- Device Type and
Features
..........•......•............ A-16
Contents xi

DIAGNOSE Code X'54' -- Control The Function
of the PA2 Key ......................... A-19
DIAGNOSE Code X'58'
-- 3270 Virtual Console
Interface
.............................. A-20
Displaying Data
........................ A-20
Full Screen Mode
...................... A-22
Full Screen Interactions
................ A-24
DIAGNOSE Code X'5C'
-- Error Message Editing A-27
DIAGNOSE Code X'60' -Determining the Virtual
Machine Storage Size
.................... A-28
DIAGNOSE Code
X'64' -Finding, Loading, and
Purging a Named Segment
................. A-29
Appendix B. The 370 Processor Control
Session
........................ B-1
370 Processor Control- Screen Format ...... B-1
F2 Key -
Start/Stop ..................... B-3
Processor Status Field .................... B-3
Fl Key -Instruction Step ................. B-4
Editing 370 Registers ..................... B-4
F3 Key -Edit (GPR/FPR/ CR) ............. B-5
Storage Edit ........................... B-5
F7 and F8 Keys -Page Forward and Backward . B-6
F6 Key -EBCDIC (On/Off) .............. B-6
F5 Key -Edit (Real/Virtual) ............... B- 7
F4 Key -Edit
PAT/Edit Main .............. B-7
Address Compare Stop Function ............ B- 7
ALT
F6 Keys -Program Reset ............. B-8
ALT F7 Keys -Clear Reset ................ B-8
ALT F8 Keys -External Interrupt ........... B-8
Appendix C. Comparison of VM/PC
and VM/SP ..•................. C-l
Relationship of VM/PC and VM/SP ........ C-l
Moving Application Programs from VM/SP to
VM/PC .......•...................... C-6
VM/SP Commands Not Supported in VM/PC ... C-7
Finding Further Information in VM/SP Library ... C-8
Order Numbers for VM/SPRelease 2 Books .... C-9
xii VM/PC Users Guide

Appendix D. Operating Hints ...... D-l
Backing up Minidisks ..................... D-1
Minidisks on Diskettes
.................... D-1
Transporting
CMS Files ................... D-1
EXPORT/IMPORT Method ............ D-1
Minidisk Method
...................... D- 2
File Access Performance
.................. D- 2
Using DOS Features ....................... D-3
FORMAT Command Performance .......... D-3
Remote Minidisks ....................... D-4
Spool Files ............................... D-4
Appendix E. ASCII to EBCDIC
Conversion
..................... E-l
Appendix F. Distribution Diskette
Contents
....................... F-l
Glossary X-I
Index ......................... X-5
Contents xiii

xiv VMjPC Users Guide

Chapter 1. Introduction to VM/PC
VM/PC is an IBM licensed program product which runs on
the IBM Personal Computer XT /370. VM/PC runs as an
IBM Personal Computer Disk Operating System application
and presents you with an interactive system which has the
characteristics of a
VM/SP Release 2 system. These
characteristics include command entry, command format,
messages, screen formats, data file naming conventions, key
functions, and application interfaces.
VM/PC allows you:
To set up your system quickly via a series of easy to use
panels which guide you through the installation and
configuration process.
To establish a local 370 environment in your IBM
Personal Computer
XT/370.
To manage a single virtual memory space of up to 4
million characters.
• To select the type of connection (3277 or 3101) to a
remote computer that meets your processing needs.
To maintain concurrent local and remote sessions over
the 3277-2 Coaxial Connection or
EIA RS232-C
communication facilities (hereafter referred to as
RS232).
To transfer data and programs between your remote VM
computer and your IBM Personal Computer XT/370.
To execute many 370 CMS applications in your IBM
Personal Computer
XT /370 without modification.
To transfer your
VM/PC data files between the
VM/PC format and IBM Personal Computer Disk
Operating System 2.00,
or equivalent, format (hereafter
referred to as DOS).
Chapter 1. Introduction to VM/PC 1-1

What You Need
The minimum requirements of VM/PC are:
IBM Personal Computer
XT/370
The IBM Personal Computer Disk Operating System
version 2.00 (6024061) reference manual and diskettes
(or equivalent)
An IBM Monochrome Display or any other monitor
designed to display 25 lines of 80 columns each
• One diskette drive
One fixed disk.
VM/PC also supports the following:
• An IBM Matrix Printer or any compatible printer
• A second fixed disk drive, if more fixed disk storage is
required
• A second diskette drive, if more diskette storage is
required
An IBM Asynchronous Communication Adapter and the
IBM 3101 Emulation Program (6024042), if
asynchronous communications
is desired
• An IBM 3277-2 Device Emulation Adapter, if 3277-2
Coaxial Connection communications is desired.
1-2 VM/PC Users Guide

How to Use This Book
We have assumed that you have a general knowledge of the
VM operating environment. Take the time to read this
manual to gain a more detailed understanding of the
VM/PC
system and its relationship to the remote VM system and to
the
IBM Personal Computer XT /370 on which it resides.
Note: If you are a beginner at system usage, you may want
to start by reading the Virtual Machine/Personal Computer
Primer, part number 6024174. You may order this
publication through your
IBM Marketing Representative.
All users should read these parts
of this book (detailed
descriptions of these parts follow):
Introduction
Configuring
Getting Started
Using Commands to Do Work
Commands (for reference)
• Messages (for reference)
• Glossary (for meanings of terms and acronyms)
• Index (to help find information).
All users who have to do the specific tasks named should
read these parts:
Installing
Remote Services (if installing Remote Server Program -
VMPCSERV).
Users with the specific needs named should read these parts:
Remote Services (those needing more information
on
Remote/Local sessions)
• CP /CMS Interface (those interested in Internal
Processing)
370 Processor Control Session (those maintaining the
Control Program)
• Comparison of VM/SP and VM/PC (those familiar
with
VM/SP)
Operating Hints (those interested in System Operation)
Chapter 1. Introduction to VM/PC 1-3

• ASCII to EBCDIC Conversion (those interested in data
representation)
• Distribution Diskette Contents. (those interested in file
names)
The
VM / PC User's Guide has the following parts:
1. Introduction -This is an overview of the VM/PC
system. It tells what you need, what you get, and how
the pieces interact. All users should read this chapter.
2. Installing Your System -This is a step-by-step procedure
to follow when bringing up your
VM/PC system. All
users who must install
VM/PC should read this section.
If VM/PC has already been installed on your Personal
Computer, you need
not read this chapter.
3. Configuring Your System -This tells why you might, and
how you would, configure your system.
It includes a
step-by-step example of a basic configuration process.
All users should read
at least the introduction to this
chapter.
4. Getting Started -This tells what to do to begin using
VM/PC on your Personal Computer. It explains the
Keyboard (and how to use it), the terminal screen (and
how to read it), Session Selection, Logon, and the
History Buffer. All users should read this chapter.
5. Using VM/PC Commands to Do Work -This
documents commonly used
VM/PC commands, grouped
by task. There are descriptions of which commands to
use to do work for you and examples of how you would
use them. All users should read this chapter.
6. Remote Services -Information on
Remote/Local
sessions, Upload/Download, and Local and Remote
Spooling. Anyone who needs to install the Remote
Server program to enable a
Remote/Local session
should read this chapter.
If the Remote Server has
already been installed
at the remote system, you need
not read the installation section. Anyone who wants
further information about using
Remote/Local sessions
should read this chapter.
1-4 VM/PC Users Guide

7. Commands -This chapter has two parts:
a. CP Commands -Contains explanations, formats,
and operand descriptions for
all VM/PC CP
commands.
b. CMS Commands -Contains explanations, formats,
and operand descriptions for all
VM/PC CMS
commands that are different from VM/SP Release 2
commands.
For those that are not different, only the
explanation and format are shown.
All users who want Reference Information about
commands used with
VM/PC should read this chapter.
8. Messages -This chapter contains all VM/PC messages,
and all
VM/PC CP messages with a brief indication of
what recovery action to take. The same information
is
provided for those VM/PC CMS messages an end user
is most likely to encounter. Users are referred to the
VM/SP System Messages book for any further
information. All users who want Information about
messages received from
VM/PC should read this
chapter.
9. Appendix A - CP/CMS Interface. All users who want
information about the internal operations of
VM/PC
should read this appendix.
10. Appendix B - 370 Processor Control. All users who
maintain the Control Program should read this appendix.
11. Appendix C - Comparison of
VM/SP and VM/PC -
This appendix should be read by experienced
VM/SP
users. It lists the functions found in VM/SP but not
found in
VM/PC and explains why they're not there.
12. Appendix D - Operating Hints
13. Appendix E - ASCII to EBCDIC Conversions
14. Appendix F - Distribution Diskette Contents
15 ..Glossary -All users should read this to find the meaning
of terms and acronyms used in this book.
Chapter 1. Introduction to VM/PC 1-5

16. Index -All users should use the index when trying to
find where information
is in this book.
If you want further information about using VM/PC, you
must consult the
VM/SP Release 2 publications. The names
and order numbers for those publications are listed in
"Order
Numbers for VM/SP Release 2 Books" on page C-9. Note
that you must use the special order numbers given there to
order those books to ensure that you get the correct-level
manuals.
1-6 VM/PC Users Guide

The VMjPC System
After you start the VM/PC application, you have the option
of selecting the type of connection that meets your
processing needs. You can:
• Connect to a remote computer as a 3277 or a 3101
terminal. This computer does not have to be located in
your immediate area. This type of connection
is called a
'remote' session, or
Connect to the local computer in the IBM Personal
Computer
XT/370 and run the local VM/PC system.
This type of connection is called a 'local' session,
or
Connect to a remote computer and the local computer at
the same time and maintain 'concurrent' remote and
local sessions.
The concurrent session selection allows you:
To maintain up
to three separate and distinct
sessions, that is, a local
VM/PC session and two
remote sessions with any computer system that
supports 3277 or 3101 data streams, or
To combine the local and remote 3277 sessions into
a single processing environment and allow data
sharing between your IBM Personal Computer
XT /370 and your remote computer. In this case,
only the 3277 communication facilities can
be used.
The remote system must
be an IBM VM/370 Basic
System Extensions Program Release 2 or VM/SP
level system on which the Remote Server Program
has been installed. This installation process
is
described in Chapter 6, "Remote Services" on page
6-1.
The selection of these options
is described in Chapter
4, "Getting Started" on page 4-1.
Chapter 1. Introduction to VM/PC 1- 7