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