GH20-9070-5

VS Personal Computing (VSPC) for OS/VS and DOS/VS: Program Product General Information GH20-9070-5 File No. S370-39

VS Personal Computing (VSPC) for OS/VS and DOS/VS: Program Product General Information Program Numbers 5740-XR5(0S/VS1 VSPC) 5740-XR6(0S/VS2 MVS VSPC) 5746-XR3(DOS/VS VSPC) PageofGH20-907a-5 As Updated 29 Feb 1980 ByTNLGN20-9316

Fourth Edition (March 1978) This edition, as amended by technical newsletter GN20-9316, describes Release 2 of VS Personal Computing(VSPC) for OS/VS. VSPC is a program product that runs under OS/VSl (5740-XR5),0S/VS2 MVS(5740-XR6), and DOS/VS(5746-XR3), and to any subsequent releases until otherwise indicated in new editions or technical newsletters. Technical changes are summarized under "Sununary of Amendments"following the list of figures. Each technical change is marked by a vertical line to the left of the change. These bars will be deleted at any subsequent republication of the page affected. Editorial changes that have no technical significance are not noted. Changes are periodically made to the information herein; before using this publication in connection with the operation of IBM systems, consult the latest IBM System/370 and 4300 Processors Bibliography, GC20-0001,for the editions that are applicable and current. It is possible that this material may contain reference to, or information about,IBM products(machines and programs), progranuning, or services that are not announced in your country. Such references or information must not be construed to mean that IBM intends to announce such IBM products, programming, or services in your country. Publications are not stocked at the address given below; requests for IBM publications should be made to your IBM representative or to the IBM branch office serving your locality. A form for reader's comments is provided at the back of this publication. If the form has been removed, comments may be addressed to IBM Corporation, P. O. Box S0020, Programming Publishing, San Jose, California 9S1S0. All comments and suggestions become the property of IBM. ® Copyright International Business Machines Corporation 197S, 1976,1978 ABOUT THIS BOOK

This book describes VSPC Personal Computing (VSPC) and introduces features available with Release 2. VSPC is a program product that enables personnel—even those without previous computer experience—^to use a computer interactively through terminals. VSPC runs under the following IBM virtual storage operating systems: OS/VSl,OS/VS2 MVS,and DOS/VS. The purpose of this book is to enable managers, system programmers, and other interested persons to evaluate VSPC for use in their organization and to plan for installing and operating VSPC. It explains what VSPC is, how it's used, and what requirements must be met and what tasks must be performed to install, administer, and maintain it.

Organization of the Book This book is organized into the following chapters: VSPC Quickly introduces the features of VSPC—both for OS/VS Release 2 and for the previous releases—and identifies the programs and machines that VSPC is used with. It is intended as an introduction for all readers. VSPC Programmiiig Overview: Briefly describes the facilities available to the VSPC programmer—the terminal user, the application programmer, and administrative personnel. It is intended as introductory information for all readers. Usang VSPC: Describes in more detail what a user can do with VSPC and how he does it. It is intended as an introduction for all readers. VSPC Tasks and Roles: Outlines the kinds of activities that take place when you install and operate VSPC and relates these activities to the people who do them. banning for VSPC: Identifies the objectives in using VSPC and the machine and storage requirements to meet those objectives. Insralling VSPC: Discusses system generation, VSPC library setup, and VSPC startup. Administering and Controlling the Use of VSPC: Discusses VSPC user enrollment, user libraries, security, and VSPC accounting. Maintaining VSPC: Discusses performance optimization, backup and recovery, and other tasks of VSPC library maintenance. Reference Material: Describes the VSPC publications and indicates who needs each one. This book also has a glossary of the technical terms used and an index.

About This Book 3 As Updated 29 Feb 1980 ByTNLGN20-9316 Using the Book This book avoids distinctions in data processing terminology between DOS/VS and OS/VS. For example, the term "data set" is used without any note that "file" would be the proper term for DOS/VS. Browsing through the glossary after reading the first chapter may help you in reading the rest of the book.

Related Publications VSFC publications are described under "Reference Materials." For additional information about programs and terminals that are used with VSPC, you might consult the following books:

Other Program Product Publications VS APL General Information, GH20-9064, which gives an overview of the IBM program product VS APL VS BASIC General Information, GC28-8302, which gives an overview of the IBM program product VS BASIC VSPC FORTRAN General Information, GH20-9061, which ^ves an overview of the IBM program product VSPC FORTRAN Interactive PL/1 for VSPC, G320-5806, which is a notice of availability of the Interactive PL/1 for Virtual Storage Personal Computing (S78S-EAB)in the United States as an Installed User Program with extended support VS TSIO Program Product Specifications, GH20-9114 Network Terminal Option (NTO) General Information Introduction, GC38-0297, which gives an overview of the Network Terminal Option

General Publicati

4 VS Personal Computing(VSPC) for OS/VS and DOS/VS: General Information PageofGH20-9070-5 As Up^ted 29 Feb 1980 ByTNLGN20-9316

OS/VS Publicatioiis OS/VS System Modification Program (SMP), GC28-0673, which describes how to use SMP to apply a change (in this case, VSPC)to an OS/VS system Planning for Enhanced VSAM under OS/VS, GC26-3842, which introduces VSAM and Access Method Services ACF/VTAM System Programmer's Guide, SC38-0258, which gives the system features of ACF/VTAM for OS/VS.

OS/VSl Pubfications OS/VSl Planning and Use Guide, GC24-5090, which provides a detailed introduction to OS/VSl OS/VSl Access Method Services, GC26-3840, which explains how to use Access Method Services OS/VSl VTAM System Programmer's Guide, GC27-6996, which gives detailed information for the installation and maintenance of VTAM

OS/VS2 PubGcations OS/VS2 Access Method Services, GC26-3841, which explains how to use Access Method Services OS/VS2 System Programming Library: VTAM, GC28-0688, which gives detailed information for the installation and maintenance of VTAM

DOS/VSPubficatioiis • Introduction to DOS/VS, GC33-5370, which provides a general summary ofDOS/VS • DOS/VS VSAM Planning Guide, GC33-5404, which introduces VSAM and Access Method Services

• DOS/VS Access Method Services User's Guide, GC33-5382, which explains how to use Access Method Services • DOS/VS VTAM System Programmer's Guide, GC27-6957, which gives detailed information for the installation and maintenance of VTAM • ACF/VTAM System Programmer's Guide for DOS/VS, SC38-0268, which gives detailed information for the installation and maintenance of ACF/VTAM under DOS/VS

Teiminal Pubfications IBM 3704 and 3705 Control Program Generation and Utilities Guide and Reference Manual, GC30-3008, which provides the information necessary to define and generate NOP (network control program) for the IBM 3704 or 3705 Communications Controller An Introduction to the 3270 Information Display System, GA27-2739, which introduces the IBM 3270 Information Display System IBM 3767 Models 1 and 2 Communication Terminal Component Description, GA27-3096, which provides detailed information about the IBM 3767 Communication Terminal

About This Book S IBM 3770 Data Communication System/System Components, GA27-3097, which provides introductory and reference information about the IBM 3770 Data Communication System An Introduction to the IBM 3790 Communication System, GA27-2807, which introduces the IBM 3790 Communication System

6 VS Personal Computing(VSPC) for OS/VS and DOS/VS: General Information CONTENTS

About This Book 3 Organization of the Book 3 Using the Book 4 Related Publications 4 VSPC Publications 4 Other Program Product Publications 4 General Publications 4 OS/VS Publications 5 OS/VSl Publications 5 OS/VS2 Publications 5 DOS/VS Publications 5 Terminal Publications 5 Figures 9 Summary of Amendments 11 VSPC Highlights 13 Release 2 Highlights 13 Terminal Usage Enhancements 13 Improved Application Capabilities 14 Subsystem Management Improvements 14 Features of the Previous Releases 15 Interactive Terminal Usage 15 Easy-to-Use Application Facilities 15 Subsystem Management Features 16 VSPC Programming Overview 19 Interactive Terminal Facilities 19 Enter and Edit Data 19 Use Display Terminals Effectively 20 Full Screen Editing 20 PF Key Support 20 Get Aid in Using Commands 20 Application Development Facilities 21 VSPC Applications 21 Application Development 21 Application Execution 21 External Applications 21 Application Development 21 Application Execution 21 Subsystem Management Features 22 Security and Integrity Measures 22 Supervision and Control Features 23 Accounting Facilities 23 The VSPC Service Program 23 Programming Interfaces for Extending VSPC 24 UsmgVSPC 25 The User Profile 25 The Terminal 25 Making Connection with the Computer 25 Entering Information and Seeing It Displayed 25 The User Library 26

Contents 7 PageofGH20-9070-5 As Updated 29 Feb 1980 ByTNLGN20-9316

The Workspace 27 VSPC Commands for the General User 28 Conducting the Terminal Session 28 Entermg and Editmg Data 29 Managing the Workspace 30 Managing a User Library 30 Submitting Batch Jobs 31 The Session Between User and Computer 32

VSPC Tasks and Roles 37 Planning for VSPC 39 Your VSPC Objectives 39 ' VSPC Requirements 39 IBM Virtual-Storage Operating System 39 IBM System/370 Processing Units 40 Terminals 40 IBM SDLC (Synchronous Data Link Control) Terminals 41 IBM BSC (Bisynchronous Communication) Terminals 41 Start-Stop Terminals 41 Controllers 42 Real Storage 42 Virtual Storage 42 Direct-Access Storage 42 Installing VSPC 43 Generating the Operating System 43 Setting Up the Telecommunications Network 43 ACF/VTAM and ACF/NCP/VS Functions 44 Including VSPC 44 Setting Up the VSPC Library 44 The System Profile 44 Processor Profiles 44 User Profiles 44 Installing Foreground and Auxiliary Processors 45 Converting Users' Data and Programs to the VSPC Library 45 Preparing the VSPC Startup Procedure 45 Job Control Statements 45 VSPC Startup Control Statements 46 Testing the VSPC Installation 46 Administering and ControDing the Use of VSPC 49 Starting Up the VSPC Job 49 Assigning User Libraries 50 Private User Libraries 50 Project User Libraries 50 Public User Libraries 50 Enrolling New Users 51 The VSPC User Profile 51 VSPC Administrator Functions and Commands 52 Interactive Commands 52 VSPC Service Program 52 Enrollment Techniques 52 Encouraging the Use of Passwords to Limit Access 53 Logon Passwords 53 File Passwords 53 Monitoring the Operation of VSPC 54

8 VS Personal Computing(VSPC) for OS/VS and DOS/VS: General Information VSPC Monitor Functions and Commands 54 Controlling the Operation of the VSPC Job 55 VSPC Operator Functions and Commands 55 Analyzing VSPC Accounting Information 56 Using the VSPC Service Program 57 VSPC Service Program Control Statements 57 Notes on the Use of the VSPC Service Program 59 Maintainiiig VSPC 61 Controlling VSPC Use of Computer Resources 61 Evaluating Response Time 61 Setting Limits on Computer Resources to Be Used 62 Reorganizing Space in the VSPC Library 62 Backing Up and Recovering the VSPC Library 63 Providing Adequate Space in the VSPC Library 63 Enrolling a User with the Proper Space Maximum 63 Allocating Additional VSPC Library Space 63 Archiving Files That Are Seldom Used 64 Eliminating Unwanted User Profiles and Files 64 Transferring Data to Another VSPC Library 64 Adding Foreground and Auxiliary Processors to Use with VSPC 65

Reference Material 67 Glossary 69

Index 73

FIGURES Figure 1. Submitting Batch Jobs and Receiving Output 22 Figure 2. Foreground and Auxiliary Processors Communicating by Way of VSPC 24 Figure 3. Example of a User Session with VSPC 33

Contents 9 PageofGH20-907(X-5 As Updated 29 Feb 1980 ByTNLGN2a-9316

SUMMARY OF AMENDMENTS

This section describes amendments to this edition of VSPC General Information.

February, 1980

ACF/VTAM New Programming Features A description of functions available for VSPC used with ACF/VTAM and ACF/NCP/VS appears in the "Installing VSPC" chapter.

March, 1978

VSPC Release 2 New Programming Features A description of the new programming features for VSPC Release 2 appears in the "VSPC Highlights" chapter.

August, 1976

VSPC AID New Programming Feature A description of AID appears in the "VSPC Programming Overview' chapter.

Full Screen Management(FSM) New Programming Feature A description of FSM appears in the "Using VSPC" chapter.

Relative-Record Data Sets New Programming Feature The ability of VSPC foreground processors to handle relative-record data sets is noted in the "VSPC Programming Overview" chapter.

Storage Requirements Specification Changes In the "Planning for VSPC" chapter, program storage requirements have been updated.

Summary of Amendments 11 PageofGH20-9070-5 As Updated 29 Feb 1980 By TNL GN20-9316

OS/VSl VSPC The following changes have been made for the release of OS/VSl VSPC: • Added a new chapter, called "Reference Material," which ^ves the title, order number, description, and intended audience of each VSPC publication; added these and other related publication titles and order numbers to the preface. Corrected the order number of VSPC FORTRAN General Information and the title of the NCP generation manual. • Corrected errors in VSPC requirements for operating systems, CPUs, and terminals: - NCP (network control program) is required only for remote terminals. (NCP is not required for local terminals.) - Added CPU Model 115-2,for DOS/VS VSPC. - Noted that special feature #2001,for CPU Models 135 and 145, is required only for DOS/VS VSPC.

- Added IBM 3767 Model 3 to the list of terminals that VSPC can be used with. - Corrected the type of interrupt required for IBM start-stop terminals (receive, not attention). Added information about VSPC requirements for real storage and virtual storage. Clarified that "OS/VS2" refers to OS/VS2 MVS. Added to the chapter "Installing VSPC" a section on using SMP (system modification program) to include VSPC in an OS/VS operating system. Clarified that foreground processors are of two types: interpreters and compilers. Clarified the use of the IBM 3270 Information Display System: it can be used to display previous screen pages and to print a screen page at a remote printer. Pointed out that workspace contents can be automatically saved at logoff in a file called CONTINUE. Corrected reference to LIBRARY command: changed it to QUERY command. Corrected description of DOS/VS VSPC startup procedure: it can be cataloged in the procedure library, as well as entered as a card deck.

12 VS Personal Computing(VSPC) for OS/VS and DOS/VS: General Information VSPCfflGHLIGHTS

VS Personal Computing (VSPC) is an IBM program product designed especially for fast conversational processing using simple, easy-to-learn commands. Yet, VSPC offers a wide range of system services through any one of the three IBM VS operating systems. You can tailor your VSPC subsystem to your processing needs by using any or all of the following related IBM programs: • VS APL—Program Number 5748-APl • VS BASIC—^Program Number 5748-XXl . VSPC FORTRAN—Program Number 5748-F02 • VSPC PL/I—^Program Number 5785-EAB • VS TSIO—Program Number 5740-XR9 For additional information on any of these programs, see the appropriate product documentation. VSPC for OS/VS is being enhanced with Release 2. Highlights for each release are described in the following sections.

OS/VS Release 2 Highlights Terminal, application, and subsystem management improvements are included in VSPC Release 2 for OS/VS only.

Terminal Usage Enhancements Full Screen Editii^: 3270 display terminal users can now edit multiple data and text lines displayed on the screen. The terminal edit facilities—INS MODE,DEL, etc.—can be used, along with VSPC local commands that act only upon the line at which they're entered. A global command area at the bottom of the screen is also provided. Program Function Key Setting: Through the new PFKEY command, the display terminal user can specify the interpretation of the PF keys. New Editing Commands: Give added capabilities for editing and line entry. The user can now copy one or more lines into another part of the workspace, join or split lines in the workspace, and, through one command, set defaults for other commands. Improved Editing Commands: Give added usefulness and added function. The user can choose whether or not INPUT lines will overlay existing lines. In the CHANGE command, global changes must be explicitly requested. In addition, a current line pointer is provided as a convenient reference point for the user. General Usability Improvements: Command entry is simplified (parentheses in commands can be omitted). A single line-number operand in the LIST command displays only a single line. Editable files of any content attribute can be specified with the FILE command. The terminal user can hold a screen display for as long as needed, and then page the screen display forward when desired.

VSPC Highlights 13 Improved Application Capabilities VSAM Alternate Index Support: Gives enhanced data processing capabilities. Record processing of external VSAM files with primary or alternate indexes is provided. Shared File Updating: Updates of shared common files can be made by more than one user, now that ownership of such files can be transferred from one user to another via the ACQUIRE and RELEASE commands. Foreground Interface Enhancements: Make additional processing capabilities available for foreground processors, such as: immediate commands, in-core command lists, and user-controlled password prompting. Improved Command List Support: Command lists can now be nested; that is, if one command list runs another, control is returned to the first command list after the subordinate command list completes processing.

Subsystem Management Improvements A number of subsystem management improvements are also included in VSPC Release 2, including: • Additional Display Terminal Support: For a greater range of terminal choices: The 3276 Control Unit/Display Station and the 3278 Display Station in 1920 character mode, with the associated 3287 and 3289 Printers are supported. 3270 devices can be connected by local attachment through the 3791 Controller in DSC (data set compatibility) mode. For remote attachment, the 3704/3705 Communications Controller is required. • Flexible Accounting Options: Accounting information can be displayed in terms of composite accounting units rather than as separate VSPC counts. Startup options allow the choice of the counts to be included in the composite accounting unit, and the relative weight each count should have. The composite units are then included in all SMF records and in messages displayed to terminal users. • Service Program Enhancements: Full backup of files is no longer necessary—instead, for a partial backup only files updated since a previous backup are copied. Shared files can be exported and copied by a non-owning user. Alphabetic characters in the line-number field of an imported file are now allowed. Files and users can now be deleted from the VSPC output library. • General Usability Improvements: Terminal and system problem messages are much improved; jobname syntax is abbreviated; a sample logon interpreter is provided which an organization can use unchanged or can modify as needed. Extensions to SMF records are provided.

14 VS Personal Computing(VSFC) for OS/VS and DOS/VS: Genera! Information Features of the Previous Releases Features continued from the previous releases of VSPC are:

Interactive Terminal Usage VSPC interacts conversationally with the terminal user through a comprehensive set of simple, easily-learned commands:

• Terminal Control Commands: Allow the user to control terminal and session characteristics. • Data Entry and Editing Commands: Let the user enter, edit, and display programs and data. i • Library Control Commands: Allow the user to store files in his own library or in shared common libraries; to retrieve, read, and update such files; and to delete them from the library when they're no longer needed. The user can also obtain a listing of library contents. • Processing Commands: Let the user compile source programs, store source or object programs in the library, and execute source or object programs or command lists. • Remote Job Entpr Commands: Let the user process batch jobs outside the VSPC workspace and retrieve output from such jobs—either at the terminal or at some designated destination. • Aid Commands: Coach the terminal user through the VSPC commands themselves; thus, the terminal user can enter commands correctly without remembering the exact syntax.

Easy-to-Use Application Facilities Application development through VSPC is quick and efficient. It's achieved through the following features: • Data Availability: The VSPC online library structure makes a wide range of direct access data easily available to each terminal user; yet the data is always under complete control through the private/project/public library structure that controls the data available to each user or set of users. In addition, external VSAM data sets are also available to the terminal user. • Interfaces for Processors: VSPC has programming interfaces for the addition of customer-written foreground and auxiliary processors to run with VSPC. For example, the VS TSIO foreground processor gives the user convenient access to OS/VS data sets. • Interactive Programming Language Support: VSPC is specially designed to be used with interactive programming languages. The IBM programs VS APL, VS BASIC, VSPC FORTRAN,and VSPC PL/I can be used as foreground processors with VSPC. They enable users to run applications developed by others or to develop and run their own applications. • Command List Processing: A list of commands can be entered as a data file. The list can then be executed upon demand. This is useful for performing a series of often-executed commands whenever they're needed. • Efficient Data Protection: The internal design of VSPC protects each ^1 user's data from loss and from unauthorized access. VSPC options for ^ 1 additional security include logon and file passwords.

VSPC Highlights 15 Subsystem Management Features VSPC is easy to install, maintain, and administer. It's specifically designed to give reliable and responsive performance, while providing the following features: • Flexible Subsystem Sharing: Because VSPC uses VTAM,the same terminals valid for VSPC can also be used for other VTAM applications, such as CICS,IMS, and TSO. In addition, ACF/VTAM provides networking functions. • Coherent Upward Migration: VSPC is available under all three IBM VS operating systems; thus, upward migration presents very few problems. • Detailed Accounting Facilities: VSPC accounting routines give information for each user's session on each of the following resource factors: connect time, CPU time, total direct-access storage space, number of VSAM accesses, and number of VTAM requests. Global records are also kept—VSPC startup and termination, operator startup modifications, VSPC user logons and logoffs, and a log of attempts at unauthorized usage. • Simple Operation and Maintenance: VSPC has supervisory commands and a batch service program (the VSPC Service Program) for administering and controlling the use of VSPC,for converting data, for optimizing performance, and for maintaining the VSPC library. • Efficient Operating System Facilities: VSPC exploits the facilities of each of the VS operating systems, OS/VSl, OS/VS2 MVS,and DOS/VS: For MVS, VSPC is designed to take full advantage of the MP/AP (multiprocessor/attached processor) features, and of Systems Extension 1 (a selectable unit). Shared real storage for minimal impact on other jobs running in the computer VTAM (virtual telecommunications access method) for transferring data between VSPC and local terminals or between VSPC and remote terminals with NCP (network control program) by way of an IBM Communications Controller VSAM (virtual storage access method) for transferring data between VSPC and direct-access storage Job entry subsystems (JES for OS/VS1, JES2 or JESS for OS/VS2 MVS, POWER/VS for DOS/VS)for submitting batch jobs and receiving output at the terminal • Many Machine Choices: VSPC can be used with a wide variety of machines: - System/370 Processing Units: Models 115 and up. (The smaller models, with DOS/VS, are suitable only for operation with a small number of terminals.)

- Communications Controllers: 3704 or 3705 Communications Controller with NCP (network control program) is required for remote devices.

16 VS Personal Computing(VSPC) for OS/VS and DOS/VS: General Information - 3272/3274 Communications Controllers are supported for local attachment. - 3791 Controller is supported for local attachment or for remote attachment through a 3704/3705 Communications Controller.

- Terminals: IBM 3270, 2741, 3770, 3767, 1050, and CPT-TWX (Models 33 and 35). For remote terminals, an IBM 3704 or 3705 Communications Controller with NCP is required. - All direct-access storage devices that can be used with VSAM. Required features of the processing units and terminals are identified in the chapter "Planning for VSPC."

VSPC Highlights 17 VSPC PROGRAMlVflNG OVERVffiW

VS Personal Computing (VSPC) allows a user—with or without data processing experience—to operate a terminal to do personal computing; that is, use a computer to: • Develop applications—either interactively or through the batch system • Execute applications once they've been developed • Share applications and/or data with other users Organizations such as medical institutions, banks, manufacturers, petrochemical makers, and public utilities have used VSPC to develop and execute applications in the areas of: Engineering and scientific problem solving

Simulation Modeling Financial planning Economic analysis Data analysis

Data collection

Data base access All these personal computing activities can be concurrently handled through VSPC. To use VSPC effectively, the terminal user needs little training; that's because VSPC, through its interactive terminal facilities, makes access to the computer simple and easy for the casual or intermittent programmer. In addition, VSPC can speed up the application development process, and—through its subsystem management features—^improve access to the system.

Interactive Terminal Facilities With VSPC,each user interacts directly with the computer to solve problems. Through a terminal, the user and the computer converse with one another in a simple language that uses English words. At the terminal, a user can enter and edit data, use display terminals effectively, and get aid in using commands.

Enter and Edit Data Each user has a workspace in the computer's virtual storage for entering and editing data and text (including source programs and interpreter functions) and^ j a_ libraryiM fori? storinginjT his work.wnrV Once the data is entered, the user can edit it through the various editing commands: he can replace lines or parts of lines, rearrange lines, erase lines,

VSPC Programming Overview 19 locate the occurrence of a specific character string in a line. When the data has been edited to the user's satisfaction, he can save his work in a file and clear the workspace for further work. In addition, he can: • Display a list of his library files at his terminal • Display the files • Let othe^ users display them at their terminals

Use Display Terminals Effectively With a 3270 Display Terminal, the user can take advantage of the terminal capabilities through full screen editing and PF key support.

Full Screen Editing

Normally, in VSPC, data entry is restricted to the last three lines on the display screen and editing is accomplished through the use of VSPC commands. However, the VIEW command allows the user to move the display cursor anywhere on the screen, and through the terminal editing capabilities (INS MODE,DEL, ERASE EOF,etc.), edit any of the data displayed on the first 20 lines of the screen. Thus, editing is quicker, more convenient, more flexible.

PF Key Support Through the PFKEY command, the user can define the interpretation of one or more PF keys: • To enter a character-string as data. The user can optionally modify the string before it is transmitted into virtual storage. • To recall the last input line for correction or reentry • To request a printed copy of the current screen on a predefined 3270 printer To page backward or forward a selected number of pages

Get Aid in Using Commands If VSPC AID is included at startup, the user can request to be prompted in entering a VSPC command. AID replies with a series of simple questions that prompt the user to define exactly what the command is to do. As the user answers these questions, VSPC builds the command to the desired specifications. At the end of the prompting sequence, VSPC AID displays the completed command. The user can then either have the command executed or have the command canceled. When the user does not understand a VSPC message, he can request an explanation by typing and VSPC AID supplies an explanation of the message.

20 VS Personal Computing(VSPC) for OS/VS and DOS/VS: General Information Application Development Facilities Using VSPC, the user can develop and execute applications that run within VSPC and applications that run in the batch system.

VSPC Applications When VSPC is used with a foreground processor—such as VS APL, VS BASIC, VSPC FORTRAN, VSPC PL/I, or a user-written processor—terminal users can develop and execute application programs interactively.

Application Development Under the control of a compiler, users can use VSPC editing functions to write application programs and compile and execute them through VSPC facilities. Under control of an interpreter, users can write and execute interpreter functions. Under control of an interpreter or a user-written foreground processor, users can take advantage of the Full Screen Management facilities to manipulate the functions of a 3270 display device and to perform their own screen formatting.

Application Execution Users can follow a previously-written procedure to interactively execute an object program, compile and execute a source program, or execute interpreter functions. A user can interactively process VSPC library files and exchange data with other programs and interpreter functions. Through an interpreter function or program, a user can process VSAM data sets external to the VSPC library. Key sequenced and entry sequenced data sets can be processed through alternate indexes.

External Applications With the inclusion of a job entry subsystem, authorized users can develop and execute applications that run outside the VSPC environment.

Application Development Users can use VSPC editing functions to enter job control statements, source statements, and data—and submit them for batch processing (see Figure 1). A user can interactively request the output of a batch job to be displayed at his terminal or to be routed to a printer or punch or to a remote destination.

Application Execution Users can submit batch jobs that have been saved in the VSPC library—^the saved entries could be, for example, a COBOL object program together with the JCL necessary for its execution.

VSPC Programming Overview 21 Job Entry VSPC Subsystem

Input User's '1^ Terminal

Batch Job Output V User's Workspace Output

JCL Printer or Punch Data V Source Input Statements

Figure 1. Submitting Batch Jobs and Receiving Output

Subsystem Management Features Through its set of subsystem management features, VSPC provides the means for administering, controlling, and maintaining VSPC.

Security and Integrity Measures VSPC provides password-protection for users and their files. The passwords themselves are protected by techniques that enable users to enter them without their being printed legibly. The limits of a user's access to VSPC and its facilities are defined when the user is enrolled. These options are additional to the security and data-integrity measures included in VSPC's internal design: • The contents of a user's workspace are automatically saved if he is disconnected from the computer. • A user's library files and workspace are never left in a partiaUy-updated state. • Fetch (in OS/VS systems) and store protection, problem program state, and SVC (supervisor call) screening are used to ensure that users' programs don't violate system integrity. In this way, a user's computer storage is protected from modification by programs running in another user's storage.

22 VS Personal Computing(VSPC) for OS/VS and DOS/VS: General Information Supervision and Control Features Personnel authorized to administer and control the operation of VSPC are provided supervisory commands for interactively performing many of their tasks: • Modifying startup options for the operation of VSPC • Receiving log messages and displaying information about the operation of VSPC • Enrolling users and defining their VSPC capabilities Control statements in the VSPC startup procedure are used to define options for the operation of VSPC,such as its use of computer resources and the availability of the remote job entry facility to users.

Accounting Facilities Accounting records in the OS/VS SMF (system management facilities) format are used, even for DOS/VS (which doesn't include SMF), to record events and usage of computer and operating system resources. Using the VSPC accounting facilities, an organization can collect data on system usage, direct access storage usage, and so forth, which can then be used for fine tuning the system, system accounting, and other tasks. The separate counts that VSPC makes can be combined and weighted into a composite accounting unit that has direct meaning for the organization using it. VSPC usage can be collected by foreground processor, or by application.

The VSPC Service Program The VSPC Service Program, which runs as a batch job, is used for enrolling VSPC users, for producing accounting information, for converting data to and from VSPC format, for copying and printing files in the VSPC library, and for backing up and recovering the VSPC library. Incremental library backups can now be used; for a partial backup, only those files that have been updated since the last full backup are copied. To restore the library, the user then copies the last partial backup, followed by the last full backup. A user who is not the owner of a shared file can export or copy such a file.

The PURGE control statement can be used to remove a file or a user (including the user's files) from the output VSPC library.

VSPC Programming Overview 23 Programming Interfaces for Extending VSPC As Figure 2 shows, VSPC provides interfaces (sets of macros and control blocks) for writing: • Foreground processors, which run interactively under VSPC's control and are either: — Interpreters, which process all user commands directly, or - Compilers, which get control from VSPC only through certain commands (such as the commands to compile or run a program). • Auxiliary processors, which run as one or more separate batch jobs that communicate with each other and with foreground processors by way of VSPC.

Foreground Foreground Processor Processor A A

Foreground Interface Interactive >. VSPC V V Job

VSPC A A

Background Interface

V V

Auxiliary Auxiliary Batch Processor Processor Jobs

Figure 2. Foreground and Auxiliary Processors Communicating by Way of VSPC

24 VS Personal Computing(VSPC) for OS/VS and DOS/VS: General Information USING VSPC

What sorts of things can a user do with VSPC? And how easily can he do them? Before answering those questions by examining a hypothetical VSPC session at a terminal, let's consider: • The user profile, and what it's for

• Terminals, and how to use them • The user library, and its contents • The workspace, and how to use it • The VSPC commands, and what they do

The User Profile

Each VSPC user has a profile, created when he is enrolled, which identifies him to VSPC. Its contents include: • The user's ID—a user number (and optional logon password) that he specifies when he logs on to VSPC • An indication of the kind of library assigned to the user and its maximum size • An indication of the user's default workspace attribute and the workspace's maximum size • An indication of whether the user is allowed to submit jobs interactively for batch processing

The Terminal The method of making connection with the computer and displaying information depends on the terminal to be used.

Making Connection with the Computer A terminal communicates with the computer either through a permanent (leased) line or through a dial-up (switched) telephone line. The terminal user turns the power on and sets the required switches. With a leased line, he can now log on to VSPC; with a switched line, he dials a prescribed telephone number, and he can then log on to VSPC.

Entering Information and Seeing It Displayed With each terminal, the terminal user enters information by typing at a keyboard very much like that of a typewriter. The way the terminal displays the entered information and the computer responds varies with the terminal: • With a keyboard printer, entered information and computer responses are typed or printed on a roll of paper fed through it. • With an IBM 3270 Information Display System, entered information and computer responses are displayed on a screen. The user's commands to the computer and the computer's responses appear, one above the other, in the

Using VSPC 25 order they are given. VSPC provides for the display of the running dialog in the upper part of the screen and the entry of data at the bottom. The user can also take advantage of the full screen editing capabilities to display the current workspace on the screen and to edit it—^using local commands that change only one line; and the terminal editing facilities, such as INS MODE,DEL, etc. PF keys can be defined to enter a character-string as data, to recall the last input, to request a printed copy of the current screen, or to page backward or forward a selected number of pages.

With the 3270, the user can: - Display previous screen pages - Print a screen page at a remote printer attached to the 3270 Through the Full Screen Management(FSM) facility, foreground processors can manipulate the functions of the 3270 and perform their own screen formatting.

Hie User library Each VSPC user is assigned to manage a user library within the VSPC library. The library can be: • A private library, to store his own files (collections of information) • A project library, for a group of VSPC users with common project interests • A public library, for all VSPC users The kinds of files that a user can have in a user library are: • Data — of whatever kind the user desires, such as text for a report or memo,job control statements for remote job entry, or data records in direct or sequential organization • VSPC command lists — they are treated as data and stored for future execution • Source programs — computer program statements as written by the user: they are treated as data and can be stored for future compilation and execution or submitted along with JCL for batch processing • Object programs — as produced by a compiler under VSPC • Interpreter workspaces

26 VS Personal Computing(VSPC) for OS/VS and DQS/VS: General Information The Workspace Each VSPC user has one workspace in the computer's virtual storage. When he logs on to VSPC for a session, the workspace is made available to him, with the attribute defined in his profile. The workspace content attribute indicates what the workspace will contain:

• Data to be worked on under VSPC's control

• A VSPC command list • Foreground-processor data, such as: - Source statements for a compiler - An interpreter workspace When the workspace has the attribute of a foreground processor that directly processes all of a user's commands (such as an interpreter), the user is under its control as soon as he logs on. A user can change the workspace attribute:

• With the ENTER command • By loading or executing a file with a different workspace attribute • By ending his session with a foreground processor under whose control he has been working During the session, he uses the workspace to: Retrieve and modify files (data, text, job control language, VSPC command lists, source programs, interpreter workspaces) from his library

Create new files Compile and execute his source programs Execute his object programs and interpreter functions

Execute VSPC command lists Submit batch jobs Retrieve output from batch jobs He works on one file (that is, program, interpreter workspace, command list, job output, or set of data) at a time. As he completes one, he can save or store it in his library, then load another to work on or clear his workspace to create a new one.

Using VSPC 27 VSPC Commands for the General User The general commands, available to anyone using VSPC (but not used in working with an interpreter-type foreground processor), are for: Conducting a session at the terminal Entering and editing data Managing the workspace Managing a user library Submitting batch jobs (which requires authorization) Getting help in using VSPC commands While a person is using VSPC to work under the control of an interpreter-type foreground processor, he doesn't use these commands—he communicates with the foreground processor according to its own procedure. He can end his session with that foreground processor and work under the ; direct control of VSPC or another foreground processor. Supervisory commands, available only to VSPC supervisory personnel, are discussed in the last two chapters. The following sections describe the general commands.

Conducting the Terminal Session The commands for conducting a session enable a user to: Log on and off VSPC: A VSPC user logs on with the VSPC logon command and logs off with the OFF command. At the end of a session, a special /"""N library file named CONTINUE can be used to save the workspace contents until the next session, if the user requests it or the session ends abnormally. Change His Logon Password: A user changes his logon password with the PASSWORD command. He uses the new password the next time he logs on to VSPC. Adjust Terminal Formatting: The LINESIZE command sets the number of print or display positions at the terminal. The TABSET command sets the tab positions in a line. The TRANSLATE command specifies a table to be used for substituting graphic characters or indicates whether lowercase alphabetic characters are to be changed to uppercase. Send and Receive Messages: A user gives the SEND command to send a message to another user or to the system operator or the VSPC operator; he gives the MESSAGE command to indicate whether he wants to receive messages. Correct or Delete a Line Just Entered: The method of correcting or deleting a line varies with the type of terminal being used. Correction generally calls for backspacing to a position preceding the error, signaling to have VSPC delete the information that was backspaced over, and reentering the information. Deletion generally calls for signaling that the whole line is to be deleted. Use the IBM 3270 Information Display System Features: The 3270 has its own set of terminal entry conventions associated with the format of the display screen, which was described above under "Entering Information and Seeing It Displayed." To enter full screen editing mode, the user gives the

28 VS Personal Computing(VSPC) for OS/VS and DOS/VS: General Information VIEW command. To enter a local command—that is, a command affecting only the line at which it is entered—the user types the command over the line number; local commands are available to change the current line pointer, to add lines, to delete lines, and to repeat lines. To preset the PF keys, the user gives the PFKEY command. To print the display-screen information at a printer attached to the 3270, a user gives the HARDCOPY command. Use CPT-TWX Terminal Features: With a CPT-TWX terminal, the VSPC user gives the KEY,TAPE, and PUNCH commands to indicate whether he is entering information at the keyboard or at the paper tape reader and whether he wants to receive information at the paper tape punch. With paper tape entry, the paper tape reader stops automatically after reading a line and is started again by VSPC to read the next line.

Use the IBM 3767/3770 Terminal Features: In SDLC mode, when the user issues a TABSET command, the terminal tabs are automatically set as specified in the command.

Entering and Editing Data A user enters data and edits it in his workspace. Data includes source program statements and text, as well as, for example, numerical information to be processed by a program. The data entry and editing commands enable a user to:

Set the Current Line Pointer: VSPC maintains a current line pointer for the user's convenience; the current line pointer can be set explicitly through the LOCATE command, or it can be set implicitly through the following commands: DELETE, EXTRACT,INPUT, LOAD,RENUMBER, or through source line entry. Enter and Number Lines of Data: Lines are numbered—a user either types a line's number as he enters it or uses the INPUT command to cause VSPC to number each line automatically. The RENUMBER command enables the user to change line numbers. Delete Lines: A user can delete a line by typing its number with no data for the line. He can also delete one or more lines with the DELETE command. With the EXTRACT command, the user can delete all but a specified range of lines from the workspace. Rearrange Lines: The MOVE command moves one or more lines to a specified location. The COPY command reproduces an existing line or range of lines at another location in the workspace. The JOIN command connects two consecutive workspace lines into one; the SPLIT command separates one workspace line into two. Merge a File with His Workspace Contents: A user gives the MERGE command to either: • Add a file from a user library to a specified position in the workspace, or • Merge a file from a user library by line number with the lines in the workspace (when a line number in the merged file matches a line number in the workspace, the line in the merged file replaces the line in the workspace) Find or Replace a String of Characters: A user gives the FIND command to r^. search all or a specified range of lines in his workspace to find out which lines contain a particular string of characters. He gives the CHANGE command to

Using VSPC 29 replace a string of characters (or delete it) wherever it occurs in all or in a specified range of lines. Display His Workspace Contents: The LIST command enables a user to see all or a specified range of lines in his workspace. He can have them displayed with or without line numbers. Specify Logical Terminal Characters: Any character can be specified as a logical tab, new line, or backspace character. Such a logical terminal character can then be used in place of the control character.

Managing the Workspace The workspace management commands enable a user to: Reset His Workspace Attribute: When a user logs on to VSPC, his workspace has the content attribute indicated in his profile—for example, the attribute for data. When the workspace has the attribute of a foreground processor that directly processes all of a user's commands (an interpreter), the user is under its control as soon as he logs on. He can use the ENTER command to reset the attribute—for example, to the attribute for a VSPC command list. Save His Workspace Contents in a User Library: The SAVE command saves data or a source program in a user library. The user can use the NAME command to name his workspace contents, or he can specify a name in the SAVE command. Load a Library File into His Workspace: The LOAD command replaces the workspace contents, if any, with a specified file from a user library. The workspace content attribute is reset to the content attribute of that file. Compile a Source Program: The STORE command compiles a source program and saves its object program in a user library. The user specifies the name of the object program file in the STORE command. Execute a Program or VSPC Command List: The RUN command causes the execution of a source program, an object program, or a VSPC command list. It loads the program or command list, if necessary; it compiles a source program; then it executes the program or command list. A foreground processor can be predefined to run when a user logs on. Command lists can be invoked by a foreground processor. A command list can run another command list; when the subsidiary command list completes processing, control is returned to the invoking command list. Erase His Workspace Contents: To prepare for entering new work, the user gives the CLEAR command to erase his workspace contents. When he uses the LOAD command to bring a file into his workspace or the ENTER command to work under the control of a foreground processor, erasure of the previous contents is automatic.

Managing a User Library The library management commands enable a user to: List the Names of Files in a User Library: A user gives the QUERY LIBRARY command to display, from the directory of a'user library, the names of all or of a specified subset of the files in that library or gives the QUERY FILE command to display the detailed status of a particular file.

30 VS Personal Computing(VSPC) for OS/VS and DOS/VS: General Information Create a Directory Entry for a File: A user can define a file in a user library before he creates the data to be stored in it. This file could, for example, serve to receive the output from a running program. The FILE command creates a directory entry or modifies the information in an existing directory entry. Delete a File from a User Library: A user gives the PURGE command to delete any file from the user library he manages or to delete his own files from his project library or a public library. Control a File's Accessibility: A file owner can restrict or extend access to a file. The PROTECT command gives a file a password, changes or removes a password, or makes a file unreadable or unchangeable for certain kinds of processing. The SHARE command permits users who aren't normally • allowed to read a file to read it—^however, if the file is protected by a password, they must supply it.

Submitting Batch Jobs For a user whose profile indicates he is allowed to submit jobs for batch processing, the job entry commands enable him to: Submit a Job: A user can have job control language and other job-related statements in his workspace or in files in a user library. He uses the SUBMIT command to send the JCL and statements to the job entry subsystem for processing. He can use the NUMBER command to specify that line numbers are to be used to assign sequence numbers to the statements when the job is submitted. Inquire about a Job: A user gives the STATUS command to find out whether one or all of his jobs have been processed yet. Cancel a Job: A user gives the CANCEL command to prevent a job from being processed (if it hasn't already been). Manage Job Output: A user gives: • The LOAD command to place job output in his workspace, where it can be edited and displayed like other data • The ROUTE command to send output to a centrally located printer or card punch or to a remote work station for printing or punching • The SCRATCH command to erase output

i^v

Using VSPC 31 The Session Between User and Computer The table in Figure 3 portrays a possible sequence of actions by a person using VSPC. It shows what sorts of things the user can do and how easily he can do them. It assumes that a language compiler has been added as a foreground processor to VSPC—it doesn't show processing under the control of an interpreter-type foreground processor. The first column gives the user's objective. The second column gives his action at the terminal. The third column gives significant responses at the terminal or at the computer. The table exemplifies almost all of the VSPC commands that a user can use. VSPC responds to all of these commands, but the table doesn't indicate all of the possible responses. For example, the table indicates password prompting v for logging on to VSPC, but not for gaining access to a file in a library. All of the commands indicated in bold type in the middle column can be abbreviated to as few as three characters (some can be abbreviated to as few as one character). For clarity, they aren't abbreviated in the table.

32 VS Personal Computing(VSPC) for OS/VS and DOS/VS: General Information Objective Terminal Entry Terminal/Computer Response

Log on to VSPC. The user types vspc id= and his user number. (At his terminal) VSPC prompts him for his logon password, if he has one.

(At the computer) a workspace becomes available.

Prevent messages from Types message block. (At the computer) no messages are sent to his other users or the terminal. VSPC operator from interrupting his work.

Receive messages. Types message open. (At his terminal) the last message, if any, broadcast by the VSPC operator is displayed, and new messages are displayed.

Send a message to Types send, his message, and the other user's (At the computer) the message is available for the another VSPC user. number. other user. (At the other user's terminal) the message is displayed as he indicates.

Learn the names of the Types query library. (At his terminal) the name of each file is displayed. files in his library.

Delete an unwanted Types purge and the name of the file. (At the computer) the file is removed from his file. library.

Assign a password to a Types protect, the name of the file, and the (At the computer) the password is associated with file. password. the file.

Make a file available to Types share and the name of the file. (At the computer) the file is made accessible to certain other problem whoever supplies the password, if any. solvers.

Submit job(s) for batch Types submit(when the workspace contains (At the computer) VSPC verifies that he is processing. the JCL and data for the job(s)). ..or types authorized to submit jobs, and the job(s) arc submit and the name(s) of the file(s) that scheduled to be processed. contain the JCL and data. (At his terminal) the name of each job is displayed.

Inquire whether a job Types status and the name of the job. (At his terminal) the status of the job is displayed. has been processed.

Acquire output from a Types load output and the name of the job. (At the computer) the output is placed in his job. workspace.

Types list. (At the terminal) the output is displayed.

Types save and a name for the output. (At the computer) the contents of the workspace are stored in his library.

Figure 3 (Part 1 of 3). Example of a User Session with VSPC

Using VSPC 33 Objective Terminal Entry Terminal/Computer Response

Run a program or a Types run (if the workspace contains the (At the computer) if the file is: VSPC command list program or command list). ..or types run and An object program, it is executed. interactively. the name of the file that contains the program or list. A source program, it is compiled, and the resulting object program is executed.

A VSPC command list, the commands are processed. (At the terminal) messages and other output from the program or VSPC command list are displayed—the user and the computer interact.

Gain access to a file in Types load and the name of the file, (At the computer) the file is placed in his workspace. his library.

See what the workspace Types list, (At his terminal) the workspace contents are contents look like. displayed.

Add lines to the Types input, then types each line. (At the computer) each line is added to the contents. workspace.

Types mei^e and the name of another file in The new file is placed at the specified position in the the library. workspace (or it is, optionally, merged by line number into the workspace).

Edit the workspace Types move and line numbers. (At the computer, in his workspace) the indicated contents. line(s) are moved to the indicated position.

Types a line number without any data. The indicated line is deleted.

Types delete and line number(s). The indicated line(s) are deleted.

Types find and a string of characters. (At the terminal) the line number(and optionally the text) of each line that contains the string of characters are displayed.

Types change, line number(s), old string of (At the computer, in the workspace) the old string of characters, and new string of characters. characters is replaced by the new string of characters in the indicated line(s). (At the terminal) the line number (and optionally the text) of each changed line and the total number of changed lines are displayed.

Renumber the lines in Types renumber, (At the computer) the lines in his workspace are the workspace. renumbered. (At the terminal) the number of lines renumbered is displayed.

Figure 3 (Part 2 of 3). Example of a User Session with VSPC

34 VS Personal Computing(VSPC) for OS/VS and DOS/VS: General Information Objective Terminal Entry Terminal/Computer Response

Put the workspace Types save. (At the computer) the updated workspace contents contents back in his replace the original file in the library (or they are library. optionally stored as a new file).

If the workspace Types store and a name for the object (At the computer) the source program in the contains a source program. workspace is compiled, and the resulting object program, compile it program is stored in the library. and place the object program in his lilirary. . .

...or run it Types run. (At the computer) the source program in the immediately. workspace is compiled, and the resulting object program is executed. (At the terminal) the user and'the program interact.

Receive an explanation Types ?. (At the terminal) an explanation of the immediately of an error message preceding message is displayed by VSPC AID. sent by VSPC.

Erase the contents of Types clear. (At the computer) the contents of the workspace are his workspace for erased. entering new data.

Name the new Types name and the new name. (At the computer) the name is associated with the collection of data. workspace and becomes the name of the collection of data about to be created by the user.

Log off VSPC, Types off continue. (At the computer) the system resources held by this automatically saving user are reclaimed, and his workspace contents are his workspace contents saved in his library under the name CONTINUE. until he logs on again. (At the terminal) VSPC displays the length of time the user was logged on and the amount of time he used the CPU (the computers central processing unit).

Figure 3 (Part 3 of 3). Example of a User Session with VSPC

Using VSPC 35 VSPC TASKS AND ROLES

This chapter presents an overview of VSPC installation and operation. It identifies for each activity the roles to be filled and the personnel to fill them. Planning: Reading this book, understanding what VSPC is all about, formulating your objectives (such as number of terminals and what foreground processors to be used), and preparing for the installation. Installing VSPC: System generation, including VSPC in the system, setting up the VSPC library and putting existing data and programs into it, preparing a VSPC startup deck or procedure, and testing the installation. ; Administering VSPC: Enrolling users, introducing them to working at a , answering their questions, and responding to their requests. Controlling VSPC's Use: Controlling access to VSPC, to its library, and to its job entry facilities and monitoring the use and operation of VSPC. Maintaining VSPC: Optimizing performance, periodically making a backup copy of the VSPC library, and providing adequate library space. Extending VSPC: Planning for and adding foreground and auxiliary processors for use with VSPC. Capacity Planning: The ongoing task of gathering and analyzing the information needed to make informed preparations for future VSPC needs. These activities naturally suggest corresponding roles: planner, installer, administrator, operator, monitor, maintainer, extender. The roles of administrator, operator, and monitor have special meaning with VSPC, because supervisory VSPC commands are provided for: • Chief administrators, who can enroll other VSPC users, including other administrators

• Account administrators, who can enroll other VSPC users, but not other administrators • A VSPC operator, who shares with the system operator the authority to terminate VSPC and also has other powers relative to the use and operation of VSPC • A VSPC monitor, who receives log messages that indicate significant events in the use and operation of VSPC One person can fill all four or any combination of these roles. The persons among whom all of the roles are divided include: Managers: They represent the company's interests and have the authority to shape its general direction. They act as planners and make the business decisions for all of the activities. System Programmers: They knpw how to make full use of the computer and the operating system and how to use a system programming language and job control language and utility programs. They make the technical decisions and can assume all of the roles: they act as planners, installers, maintainers, extenders, capacity planners, chief administrators, VSPC operator, and VSPC monitor.

VSPC Tasks.and Roles 37 Application Personnel: They understand the company's objectives for the users of VSPC. They are probably users themselves; they probably don't know much more about computers or programming than other users. But they are responsible for the use of VSPC—and they have more authority than other users. They act as planners and account administrators and, with additional training or assistance from a system programmer, might also act as chief administrators, VSPC operator, and VSPC monitor. The way the necessary roles are filled depends on your organization's needs. Within your organization, for example, there might be one or two chief administrators to administer VSPC centrally and several account administrators—one for each department or project. Alternatively, both chief administrators and account administrators might be located centrally. Because planning includes understanding all of the other activities and preparing for them, the rest of this book deals with the activities of planning, installing, administering, controlling, and maintaining VSPC.

38 VS Personal Computing(VSPC) for OS/VS and DOS/VS: General Information PLANNING FOR VSPC

To meet your basic VSPC objectives (such as the maximum number of users that can be logged on at one time, average workspace size, and use of foreground processors), you have to meet certain basic system requirements (such as the appropriate processing unit, operating system, and amount of real storage). This chapter identifies such objectives and requirements and indicates some of the relationships between them.

Your VSPC Objectives The answers to the following questions determine the requirements you will have to meet to install VSPC. The way the answers determine requirements is explained after we ask the questions. Do you want to install VSPC just to try it out with one or two terminals, or to use it with a larger number of terminals? How many persons will be using VSPC at the same time? What kinds of terminals do you want to use? What response time do you want? How much of your total system resources (such as real storage and CPU processing time) can you set aside for VSPC? Are persons in your company already using programming languages that they would want to be able to use with VSPC? How large a workspace and how much VSPC library space will they need? Do they have data and source programs or interpreter workspaces that they will need to have converted for use with VSPC? Will they need to use VSPC for remote job entry? What information will you need for capacity planning?

VSPC Requirements To install VSPC, you have to meet certain minimum requirements:

IBM Virtual-Storage Operating System VSPC can be used only with one of the IBM virtual-storage operating systems: OS/VSl, OS/VS2 MVS, and DOS/VS. OS/VS2 MVS requires a Release 3.7 base with the following selectable units: VTAM2, JES2 Enhancement (or JESS Release 2), Supervisor Performance No. 1, and Supervisor Performance No. 2. The operating system must be installed with VTAM (virtual telecommunications access method) for transferring data between VSPC and local terminals or between VSPC and remote terminals with NCP (network control program) by way of the IBM 3704 or 3705 Communications Controller. Planning for the installation of VTAM and NCP is discussed in the next chapter.

Planning for VSPC 39 The operating system must be installed with VSAM (virtual storage access method) for transferring data between VSPC and direct-access storage.

IBM System/370 Processing Units VSPC will operate on any IBM System/370 processing unit that will execute its host operating system; for certain models, special features are needed. If a model is not listed below, no special features are needed. The special features and the models needing them are listed below. For the Model 115 (3115-2 only), this required special feature: • Floating point (#3910) For the Model 125, this required special feature: • Floating point (#3910) Note: VSPC operating on the Models 115-2 and 125 (DOS/VS) is suitable only with a small number of terminals. In most cases, performance is not expected to be suitable for production. For the Model 135, these required special features: • Conditional swapping (#1051) • Clock comparator and CPU timer (#2001)(Required only for DOS/VS.) • Floating point (#3900) For the Model 145, these required special features: • Advanced control program support (#1001) or conditional swapping (#1051) • Clock comparator and CPU timer (#2001)(Required only for DOS/VS.) • Floating point (#3910) Note: For the Models 135 and 145, the clock comparator and CPU timer (#2001), though not required for OS/VSl, is recommended, for greater accuracy in: • Setting the limit on CPU time to be used by VSPC for foreground processing • VSPC's balancing CPU time among foreground processors • Accounting

Terminals

According to the requirements of VTAM, VSPC can be used with the following terminals, with the restrictions and required features indicated. For remote terminals, an IBM 3704 or 3705 Communications Controller, with NCP (network control program), is required.

40 VS Personal Computing(VSPC) for OS/VS and DOS/VS: General Information PageofGH20-907a-S As Updated 29 Feb 1980 ByTNLGN20-9316

IBM SDLC(Synchnmous Data Unk Control) Terminals IBM 3270 Information Display System: This is a family of display devices that includes advanced display terminals with added user convenience features. Only the 1920-character screen mode is supported. Terminals can be remotely connected through a leased line, or locally connected with these restrictions:

• ASCn transmission codes and character sets can't be used with the 3272 Model 2 Lx)cal Cluster Control Unit.

• 3287 form feed character and SCS forms control features are not supported. IBM 3770 Data Communication System: This terminal system can be used with switched lines or a leased line, with this restriction: • Interactive mode only IBM 3767 Communication Terminal, Models 1, 2, and 3: This terminal can be used with switched lines or a leased line in either SDLC mode or start-stop mode (as a 2741—^Models 1 and 2 only), with this restriction: • Interrupt capability required for the modem (special feature #3719, 5505, or 5506)

IBM BSC (Bisynchronous C

• 3287 form feed character and SCS forms control features are not supported.

Start-Stop Terminals IBM 2741 Communication Terminal: This terminal can be used with switched lines or a leased line, with this requirement: • Receive interrupt (special feature #4708) IBM 1050 Data Communication System: This terminal system can be used with switched lines or a leased line, with this requirement: • Receive interrupt (special feature #6100) IBM 3101 Display Terminal: This terminal system can be used only with switched lines. CFT-TWX(Models 33 and 35—^KSR and ASR): This terminal can be used only with switched lines, as follows: • Reader Control Arrangement feature is required for the paper tape reader with ASR models • Break is interpreted as attention • Break during output is interpreted as cancel

Planning for VSPC 41 Page of GH20-9070-5 As Updated 29 Feb 1980 ByTNLGN20.9316 ControDers IBM 3704/3705 Commimicatioiis Controller: with NCP (network control program).

IBM 3271 Control Unit

IBM 3272 Control Unit

IBM 3274 ControUer IBM 3275 Display Station IBM 3276 Controller/Display IBM 3791 Controller: in DSC (data stream compatibility) mode. Requires feature code 9169. IBM 8100 System

Real Storage VSPC uses the paging facilities of the operating system to run in significantly less real storage than the amount of virtual storage required. The real-storage requirement for VSPC depends on the number and type of terminals used, the amount of terminal activity, the function selected, the desired response time, and the amount of batch and other telecommunication processing by the system. These factors are so complex that no precise statement of the requirement can be made to cover all of the factors. The primary factor is the desired terminal response time, which is affected by the amount of input/output activity required for paging. Excessive paging can also require an excessive amount of processing unit time. If you observe poor response time or excessive paging, the system probably needs additional real storage. VSPC Installation Reference Material gives detailed guidelines.

Virtual Stance VSPC uses virtual storage for: • VSPC and foreground-processor modules

• Control blocks and buffers • VSPC startup options • User workspaces VSPC Installation Reference Material gives the detailed guidelines you will need to calculate the size of the VSPC partition when you install VSPC.

Direct-Access Storage Direct-access storage is needed by VSPC for: • A paging data set for program components, control blocks, and workspaces • The program components of VSPC • The VSPC library—^which includes VSPC AID text • Optional, but recommended, accounting information, which can be collected for later processing

VSPC Installation Reference Material gives detailed guidelines.

42 VS Personal Computing(VSPC) for OS/VS and DOS/VS: General Information INSTALLING VSPC

VSPC installation consists of these steps: Generate the operating system with VSAM and VTAM

Include VSPC Set up the VSPC library Installing foreground and auxiliary processors, if any If necessary, convert users' data and programs to be included in the VSPC library Prepare the VSPC startup deck or procedure Test the VSPC installation, using each option you've selected t This chapter explains how to take each step.

Generating the Operating System To prepare to include VSPC in your operating system, you: • Indicate during the system generation that VSAM (virtual storage access method) and VTAM (virtual telecommunications access method) are to be included (OS/VS2 MVS will already include VSAM in any case). • Set up a telecommunications network with VTAM and with NCP (network control program) for remote terminals. If you already have a telecommunications network, you must modify it for VSPC.

Setting Up the Telecommunications Network If you don't already have a telecommunications network, setting it up will be your major work in system generation. Generating VTAM is an additional step in the generation of the operating system. Generating NCP for remote terminals is similar to, but separate from, generating the operating system. NCP is not a part of the operating system—^the operating system is loaded into and runs in the CPU; NCP is loaded into and runs in the IBM 3704 or 3705 Communications Controller. When the operator loads the operating system into the CPU and starts up VTAM,VTAM loads NCP into the communications controller and establishes communication with it. When the operator next starts up VSPC, » VSPC establishes communication with VTAM. VTAM and NCP are described in VTAM Concepts and Planning and IBM 3704 and 3705 Control Program Generation and Utilities Guide and Reference Manual. VSPC Installation Reference Material contains examples of VTAM and NCP generation for VSPC.

Installing VSPC 43 Page of GH20-907Q-5 As Updated 29 Feb 1980 By TNL GN20-9316

ACF/VTAMandACF/NCP/VS Functions When ACF/VTAM and ACF/NCP/VS are installed, additional functions _ can be used with VSPC. VSPC can communicate with a user-written ACF/VTAM application program as if it were a 3767 Communication Terminal. ACF/NCP/VS supports the 3767 in start-stop mode with the multiple terminal access(MTA) facility. The Multisystem Networking Facility Feature of ACF/VTAM supports cross-system communications. With proper network definition, supported terminals (except start-stop) anywhere in the network can communicate with any VSPC in the network. With ACF/VTAM Release 2 or later and ACF/NCP/VS Release 2 or later, VSPC Release 2 for OS/VSl and OS/VS2 MVS supports start-stop terminals through the Network Terminal Option(NTO) program product. The IBM 1050 terminal and 3704 controller are not supported in this environment. t When NTO is installed, start-stop terminals can participate in the Multisystem Networking Facility Feature.

Including VSPC For OS/VS, you must use SMP (system modification program) to install VSPC in your operating system. The required JCLIN input for SMP is included on the VSPC distribution tape, which contains VSPC modules and macros and a job to unload the distribution tape to the appropriate libraries. VSPC Installation Reference Material describes the installation procedure. SMP is described in OS/VS System Modification Program (SMP).

Setting Up the VSPC Ubrary Before VSPC can be started up, the VSPC library must be created and certain profiles must be defined in it. To create the VSPC library and define profiles, you:

• Use Access Method Services DEFINE commands to define the three VSAM data sets that comprise the VSPC library. Access Method Services is a service program for creating and maintaining VSAM data sets. Before the VSPC library can be defined, a VSAM catalog must have been defined. • Use VSPC Service Program DEFINE control statements to define a system profile, profiles of processors that will be used ^th VSPC, and at least the profile of a chief administrator. (Other user profiles can either be defined now or defined after VSPC is operational, with the interactive DEFINE command.) The VSPC Service Program is used for batch processing of the VSPC library, independently of the online VSPC job. It is discussed in more detail in the following two chapters.

The System Profile Defining the system profile is the first operation on the VSPC library after its data sets have been defined. The system profile contains: • The password that authorizes VSPC to use VTAM (this password is specified in the APPL macro in the system generation of VTAM) • A library number that VSPC will provide for foreground processors to refer to VSAM data sets external to the VSPC library

44 VS Personal Computing(VSPC) for OS/VS and DOS/VS: General Information Page of GH20-9070-5 Added 29 Feb 1980 ByTNLGN20-9316

Processor Profiles Each foreground or auxiliary processor that will be used with VSPC must have a processor profile. A processor profile contains the name of the processor and other descriptive information.

User Profiles Defining a profile for at least one chief administrator identifies him to VSPC. His profile enables him to log on to VSPC and use the VSPC supervisory commands(as well as the general VSPC commands). After VSPC is operational, the chief administrator can use the interactive VSPC DEFINE command to enroll other administrators and general users to use VSPC. The next chapter describes enrollment and the roles of the VSPC administrators, the VSPC operator, and the VSPC monitor.

Installing VSPC <44.1 Installing Foreground and Auxiliary Processors Processing programs can be installed with VSPC (either during the VSPC installation or after VSPC is operational). Foreground processors run interactively under the control of VSPC; auxiliary processors run as one or more separate batch jobs that communicate by way of VSPC with each other or with foreground processors. To install a processor, you must define a processor profile for it in the VSPC library and link-edit it into the appropriate operating system library.

Converting Users' Data and Programs to the VSPC Library If the users already have computer data, source programs, or interpreter workspaces to be used interactively with VSPC, they must be converted to VSPC library files. The VSPC Service Program is used to import external data sets into the VSPC library, either during the VSPC installation or after VSPC is operational. Conversion is discussed in "Using the VSPC Service Program" in the chapter "Administering and Controlling the Use of VSPC."

Preparing the VSPC Startup Procedure VSPC runs as a job of the operating system. The system operator starts the VSPC job after he has started the VTAM job. The VSPC job is described by a set of JCL (job control language) statements and a set of VSPC startup control statements. The startup varies from DOS/VS to OS/VS and from OS/VSl to OS/VS2 MVS, according to each operating system's standard. In DOS/VS, the procedure can be cataloged in the procedure library or entered as a card deck in the input stream. In OS/VSl, the procedure must be cataloged in SYSl.PROCLIB. In OS/VS2 MVS,two procedures are required (both of which must be cataloged in SYSl.PROCLIB); • One for a main address space, which contains VSPC control routines and control blocks • Another for one or more secondary address spaces, which contain other VSPC routines, control blocks, and user workspaces Each time the operating system is loaded, the VSPC job must be started to make VSPC available to its users. The JCL and VSPC startup control statements can be modified without regenerating the operating system.

Job Control Statements The job control statements used to describe the VSPC job are: • A JOB statement (except when the procedure is cataloged)

• An EXEC statement that invokes VSPC • Three statements describing the three VSAM data sets that make up the VSPC library

Installing VSPC 45 • Statements that describe sequential data sets to be used for journal messages, accounting records, and diagnostic information • Statements that describe any VSAM data sets external to the VSPC library to be processed interactively by VSPC users • A statement that introduces the set of VSPC startup control statements

VSPC Startup Control Statements The startup control statements, which define options within the VSPC job, do the following: • Identify the system console, the VSPC operator, and the VSPC monitor of the online VSPC log • Indicate whether any log messages are to be saved in a journal, whether accounting records are to be created, and whether diagnostic trace information is to be kept • Define the format of the VSPC logon message and date displayed tojisers • Identify VSPC facilities to be used (remote job entry, shared storage, number of display screen pages saved, interactive access to VSAM data sets external to the VSPC library) • Set the levels of computer resources: - Maximum percentage of CPU time that VSPC should use for foreground processing - Maximum amount of real storage that VSPC should use for workspaces for foreground processing - Maximum number of VSPC users and auxiliary processors that can be logged on at one time Some of the options specified in the VSPC startup control statements can be modified while VSPC is running. The VSPC operator can modify the logon message; he can make remote job entry unavailable to VSPC users, or he can restore its use to them; he can reset the levels of computer resources to be used. The VSPC monitor can control what online information he receives. The roles of the VSPC operator and the VSPC monitor are discussed in the next chapter.

Testing the VSPC Installation Before users begin to use VSPC for their work, have your system operator load the operating system, start up VTAM,and then start up VSPC for a test run. ♦ Whenever VSPC is started up, it initializes itself and establishes communication with VTAM. Check out the system operator's VSPC startup itself and the VSPC initialization. If these are satisfactory, you will have your chief administrator, VSPC operator, and VSPC monitor log on and use VSPC commands, both the supervisory commands (described in the following chapters) and the general VSPC commands.

46 VS Personal Computing(VSPC) for OS/VS and DOS/VS: General Information After you have satisfied yourself that you have installed VSPC adequately to start it up and use its functions, you can enroll your users and let them begin to use VSPC,so that, under real conditions, you can: • Monitor and evaluate VSPC's functional behavior and performance • Monitor and evaluate your administrative and maintenance procedures

Installing VSPC 47 ADMINISTERING AND CONTROLLING THE USE OF VSPC

The tasks in administering and controlling the use of VSPC include: Starting up the VSPC job for each period of interactive processing Assigning libraries to new users according to a plan for all of the users Enrolling new users by defining a profile for each of them that specifies his freedoms and limitations Encouraging the use of passwords to limit access to VSPC and to VSPC library files that can be shared Monitoring the operation of VSPC through VSPC log messages Controlling the operation of the VSPC job (such as the availabihty of the remote job entry facility) Analyzing VSPC accounting information for billing and statistical purposes The tools for accomplishing some of these tasks include: The VSPC startup procedure Sets of VSPC supervisory commands for interactive work The VSPC Service Program for batch work These tools are discussed here, along with the tasks they are designed for. The VSPC Service Program is further discussed in "Using the VSPC Service Program" at the end of the chapter. starting Up the VSPC Job The system operator starts up the VSPC job by introducing the startup procedure to the operating system (two procedures for OS/VS2 MVS). The startup procedure, which was described in the chapter "Installing VSPC," contains job control language and startup control statements that might have to be changed to achieve your operational goals or to satisfy the needs of the users. For example, the procedure must contain a job control statement to define each external VSAM data set to be processed through VSPC. The VSPC operator can change some of the startup options interactively after the VSPC job has been started up, as described in "Controlling the Operation of the VSPC Job."

Administering and Controlling the Use of VSPC 49 Assigning User Libraries When a VSPC user is enrolled, he is assigned to manage a user library of one of three kinds: private, project, or public. The kind of user library he should be assigned depends on the kind of work he will be doing.

Private User Libraries A private library is normally assigned to a user whose files are for the most part of no interest to others. The user can still use a project library and public libraries for work that is of immediate interest to others. All the files in a private library belong to the library's manager—he alone can create, modify, and delete them. No other VSPC user can retrieve a file from the private library, unless the library manager specifies that the file can be shared.

Project User Libraries A project library is normally assigned to a group of users who have an immediate interest in a common set of files. One member of the group is the manager of the project library and has overall responsibility for it. Each of the other members of the group is the manager of his own user library. All the files in a project library are accessible to the library's manager and to all other VSPC users whose profiles designate them users of that project library: all of them can retrieve any file from it. As for the creation, modification, and deletion of files in a project library, the manager's profile indicates whether: • Either the manager owns (creates) all the files in that project library and he alone can modify and delete them • Or the manager and all other designated users can own (create) files in that project library, and: - The manager can delete any file in it and modify any file he owns - Each other user can modify and delete any file he owns No VSPC user other than those designated as users of a project library can retrieve a file from that project library, unless the file owner specifies that the file can be shared.

Public User Libraries A public library is for files of potential interest to the whole community of VSPC users. For example, a notice or memorandum could be put in a public library, and the VSPC operator could send or include in the logon text a message that directed users to retrieve the notice or memorandum. One VSPC user is the manager of each public library and has overall responsibility for it. All the files in a public library are accessible to the library's manager and to all other VSPC users; all of them can retrieve any file from it.

50 VS Personal Computing(VSPC) for OS/VS and DOS/VS: General Information As for the creation, modification, and deletion of files in a public library, the manager's profile indicates whether: • Either the manager owns (creates) all the files in that public library and he alone can modify and delete them • Or the manager and all other VSPC users can own (create) files in that public library and: - The manager can delete any file in it and modify any file he owns - Each other user can modify and delete any file he owns

Enrolling New Users To log on to VSPC, a person must be enrolled by a VSPC administrator—that is, he must be identified by a profile in the VSPC library. His profile contains a unique VSPC user number, which identifies not only the user, but also the user library he manages.

The VSPC User Profile A user's profile defines the VSPC resources and facilities available to him. To enroll a VSPC user, you specify: • A unique VSPC user number to identify the user and the library he manages • An optional logon password to protect the user's logon (he can change it for subsequent logons) • The kind of library the user manages and, if it is a project or a public library, an indication of whether he alone can own files in it • The maximum amount of direct-access storage the library can use • An optional project library number • A default workspace content attribute that is associated with the user's workspace when he logs on to VSPC and indicates what kind of information the workspace will contain (if the attribute indicates a foreground processor that directly processes all of a user's commands, the user is under its control after he logs on) • The maximum sizes (for various uses) of the user's workspace • Optional limit on the amount of CPU time that can be used for one interaction (the processing between one terminal input and the next) • Optional authorization to use virtual storage for sharing data with other

users • Optional authorization to submit jobs for batch processing • Optional authorization to use the VSPC administrator commands and the corresponding control statements of the VSPC Service Program

Administering and Controlling the Use of VSPC 51 VSPC Administrator Functions and Commands Any VSPC administrator can enroll VSPC users; only a chief administrator can enroll other administrators or alter another administrator's profile. There are two ways for an administrator to create a profile, alter it, and get information from it: • Interactively, with interactive commands • By batch job, with the VSPC Service Program

Interactive Commands

Three commands enable a VSPC administrator to:

Create a User Profile (DEFINE): The DEFINE command is used to enroll a VSPC user. Modify a User Profile (ALTER): The ALTER command is used to modify a user profile. It can be used (with the LOCK operand) to prevent any other user (but not himself) from logging on to VSPC. Display Information from a User Profile (QUERY): The QUERY command is used to display at the terminal either a user profile (except for the logon password) or accounting information about: • The amount of time a user has been logged on • The amount of CPU time, virtual storage, and direct-access storage he has used

• The number of accesses VTAM and VSAM have made for him

VSPC Service Program A VSPC administrator can use the VSPC Service Program to achieve results equivalent to those of the VSPC administrator commands. It is described in "Using the VSPC Service Program" at the end of this chapter.

Enrollment Techniques As stated in the chapter "Installing VSPC," the first enrollments are necessarily done offline by way of the VSPC Service Program—otherwise there'd be nobody authorized to log on to VSPC to do anything, including enrolling others to log on to VSPC. But after VSPC is operational, new users can be enrolled online at any time through the interactive DEFINE command. VSPC recognizes user numbers, not individuals as people. Thus, one person can be enrolled more than once, with different user numbers. For example, a person might be enrolled with one user number as the manager of a private library; he might be enrolled with another user number as the manager of a project or public library. A user profile must be defined to create a public or project library. However, unless the profile indicates that the library manager alone can own files in it, no user need log on with the user number defined by the profile—the library would be managed indirectly, through the creation and deletion of files by other users. A couple of the control statements of the VSPC Service Program permit you to process a range of user profiles or user libraries by specifying the user number at the beginning and the user number at the end of the range. For

52 VS Personal Computing(VSPC) for OS/VS and DOS/VS: General Information this reason, you should evaluate whether your organization should assign VSPC user numbers in groups. For example, you could assign user numbers of the form nnnnnOO to project libraries and assign user numbers in the range nnnnnOl through nnnnn99 to users on the project or in the department identified by nnnnn. You could also reserve a range of user numbers (such as numbers below 1000) for public libraries. Within this range, subsets of user numbers could be reserved for various applications (mathematics, statistics, etc.). You should establish criteria for deciding whether a given public library is to be controlled by its manager or can receive contributions from the whole user population.

Encouraging the Use of Passwords to Limit Access There are two kinds of passwords: • Logon passwords, which protect access to VSPC • File passwords, which protect access to VSPC library files that can be shared You should encourage, if not require, users to use logon passwords.

Logon Passwords A logon password protects a person's user number—only someone who knows the password can log on with the user number. A logon password can be specified by the VSPC administrator who enrolls a user. It can be respecified or removed altogether by that user. If a user has a logon password that he keeps secret and changes often, he prevents others from logging on to VSPC as himself. If a user has no logon password, then anybody who knows his VSPC user number and has access to a terminal can log on to VSPC as though he were that user. For example, the library number of a public or project library, which is the user number of that library's manager, will necessarily be known to other legitimate users. Thus, the library manager would have to have a logon password to prevent these other users from using his user number to log on to VSPC. To alert the VSPC monitor that an unauthorized person might be trying to log on to VSPC, VSPC can issue a message whenever anyone gives an incorrect logon password.

File Passwords A file password restricts file access to otherwise authorized users who can supply the password. The file owner specifies his own file password. Specifying a file password enables the file owner (the user who created it) to prevent other users from gaining access to it, even though they might otherwise be able to. For example, a file in a project or public library is normally accessible to other users, and a file in a private library becomes accessible to other users when the owner specifies that the file can be shared. If such a file has a password, the file owner can limit access to those users he has told the password.

Administering and Controlling the Use of VSPC 53 To alert the VSPC monitor that an unauthorized person might be trying to gain access to a VSPC file, VSPC can issue a message whenever anyone gives an incorrect file password. The file owner can further protect the file by marking it as unreadable or unchangeable for certain classes of processing.

Monitoring the Operation of VSPC One VSPC user can be designated the VSPC monitor through one of the VSPC startup control statements. Nothing in his profile relates to his being the VSPC monitor—he may or may not be a VSPC administrator.

VSPC Monitor Functions and Commands The VSPC monitor controls what kind of log messages are sent to his terminal (online logging). The log of messages can include: • Urgent messages about errors or changes in the operation of VSPC or about possible security violations • Session messages that indicate a user's logging on to or logging off VSPC • External messages about the use of facilities related to VSPC,such as remote job entry

Two commands enable the VSPC monitor to: Receive Log Messages(MONITOR): He can indicate what kinds of messages are to be displayed at his terminal. Stop Receiving Log Messages(PMONITOR): He can indicate what messages are no longer to be displayed at his terminal. Online logging enables the VSPC monitor to learn about problems or potential problems immediately. For him to take the appropriate action he needs either to be able to communicate with the VSPC operator readily, to be the VSPC operator himself, or to be able to assume the role of the VSPC operator temporarily. The messages that the VSPC monitor can receive at his terminal can be collected in a journal data set as well (offline logging). The journal is indicated in one of the VSPC startup control statements.

54 VS Personal Computing(VSPC) for OS/VS and DOS/VS: General Information Controlling the Operation of the VSPC Joh One VSPC user can be designated the VSPC operator through one of the VSPC startup control statements. Nothing in his profile relates to his being the VSPC operator—he may or may not be a VSPC administrator. And he may or may not be the VSPC monitor.

VSPC Operator Functions and Commands Six commands enable the VSPC operator to: Inquire about VSPC Computer Usage (DISPLAY): He can inquire about the identity or number of users logged on to VSPC and about the usage levels of the CPU, real storage, and the VSPC library: • He can interrogate the current state of the VSPC library. • He can produce a detailed list of all logged-on users. Modify Performance (SET): He can reset the levels of computer resources to constrain VSPC usage: • Maximum percentage of CPU time that VSPC should use for foreground processing • Maximum amount of real storage that VSPC should use for workspaces for foreground processing • Maximum number of VSPC users and auxiliary processors that can be logged on at one time Performance optimization is discussed in detail at the beginning of the next chapter. Send Messages(SEND): He can change the logon message and send messages to the system operator or to all or selected VSPC users. Control Remote Job Entry (JENTRY): He can prevent all authorized users from submitting batch jobs or permit them to resume submitting jobs.

Terminate a VSPC User's Session (CANCEL): He can terminate a VSPC user's session. He might do this for a number of reasons, among which could be his belief that the user is trying to gain unauthorized access to a VSPC file. Terminate the VSPC Job (HALT): The VSPC operator, as well as the system operator, can terminate the VSPC job. The VSPC operator stops it by logging on and issuing the HALT command; the system operator stops it in the way prescribed for stopping any job in his operating system.

Administering and Controlling the Use of VSPC 55 Analyzing VSPC Accounting Information VSPC accounting records are optionally written to an accounting data set—you request them in one of the VSPC startup control statements, and you can control which types of accounting records are to be written. They are written in a format compatible with SMF (system management facilities), a control program option of OS/VSl and OS/VS2. In these operating systems, the records can be written directly to the SMF data set or to an alternative data set. In DOS/VS, the records are written to an alternative data set. They record each of the following events; • VSPC job startup • VSPC job termination • Modification of VSPC startup options by the VSPC operator • Logon of a VSPC user • Logoff of a VSPC user (or other termination of his session) • Possible attempt to gain unauthorized access to VSPC or to the VSPC library The records that describe a user session (logon and logoff) indicate: • Elapsed time of the session

• CPU time used for the session • Amount of direct-access storage occupied by the user's files in his library and in other user libraries • Number of accesses during the session to the VSPC library and other direct-access data sets • Number of requests during the session to VTAM for telecommunication and (for IBM 3270 users) number of hardcopy pages printed • Amount of virtual storage, in relation to time, used for the workspace during the session Session information is written not only in accounting records, but also in the user's profile. The profile accumulates the information from one session to the next. A VSPC administrator can use the VSPC Service Program ACCOUNT control statement to create accounting records that contain the accumulated information. You can, optionally, combine the counts for any of the user session records as an accounting unit. The count for each accounting unit can be weighted for easy correlation with system charges, according to your organization's needs. Careful utilization of accounting information can be of assistance in your capacity planning for future VSPC needs. Experience shows that tracking actual figures on CPU utilization, storage utilization, and terminal accesses—all available through the VSPC accounting records—can be important in capacity planning for future expansion. You can develop accounting programs to process VSPC accounting records to evaluate system usage and security.

56 VS Personal Computing(VSPC) for OS/VS and DOS/VS: General Information Using the VSPC Service Program Most tasks of VSPC administration and operation can be done interactively, as discussed in the preceding sections. Some tasks either can't be done interactively or are more conveniently done by batch processing, with the VSPC Service Program: Enrollment of Many New Users at One Time: A new user can always be enrolled interactively through the DEFINE command, but VSPC Service Program DEFINE control statements can also be used. Production of Accounting Records: The only way to create accounting records that contain information accumulated in users' profiles is to use the VSPC Service Program ACCOUNT control statement. The administrator QUERY command displays accounting information, but doesn't create accounting records. Printing Large Files: Any VSPC library file that can be loaded into a user's * workspace can be printed at a terminal, but it might be more convenient to use the VSPC Service Program EXPORT control statement to print a large file at a high-speed printer. Transferring Files from One User to Another: Any file that can be loaded into a user's workspace can be transferred to another user's library interactively, but it might be more convenient to transfer a large number of files with the VSPC Service Program COPY control statement. A file that can't be loaded into a user's workspace must be transferred by way of COPY or by way of EXPORT and IMPORT. Converting Data to or from the VSPC Library: A data set external to the VSPC library can be converted to a file in the VSPC library through the LOAD command for retrieving batch job output and the SAVE command, but the VSPC Service Program IMPORT control statement provides more comprehensive format conversion and can handle larger files. A VSPC library file can be converted to an external data set through the SUBMIT command for remote job entry, but the SUBMIT command produces only card-image output. The VSPC Service Program EXPORT control statement can produce fixed- or variable-length output records. Object programs and interpreter workspaces can be transferred by IMPORT and EXPORT, but not by LOAD and SAVE or by SUBMIT. The VSPC Service Program is also used for other tasks, such as defining the VSPC system profile and processor profiles for the installation of VSPC. It is also used for tasks of VSPC maintenance, which are discussed in the next chapter.

VSPC Service Program Control Statements The VSPC Service Program is executed as a batch job, using job control language and VSPC control statements that define the operations to be performed: AUTH: Through the AUTH control statement, a user gives his user number and logon password to demonstrate his authority to use the VSPC Service Program: Any VSPC user can use the COPY,EXPORT, and IMPORT control statements for his own files or for shared files.

Administering and Controlling the Use of VSPC 57 • An account administrator can also use the DEFINE and ALTER control statements (for tasks equivalent to those he can perform with the interactive commands) and the ACCOUNT control statement. • Only a chief administrator can use all the operands of every control statement without restriction (except that he can't alter his own administrator status or lock himself out from logging on to VSPC). DEFINE: The DEFINE control statement is used to create a system, processor, or user profile in the VSPC library. For creating a user profile, it is equivalent to the interactive DEFINE command. ALTER: The ALTER control statement is used to modify a system, processor, or user profile in the VSPC library. For modifying a user profile, it is equivalent to the interactive ALTER command. ACCOUNT: The ACCOUNT control statement is used to produce accounting records from the session totals in user profiles. These records are identical to those optionally produced to document logons and logoffs . (described above in "Analyzing VSPC Accounting Information"), except that they can contain data accumulated over many sessions. The ACCOUNT control statement can also reset the totals to 0(except for direct-access space usage).

COPY: The COPY control statement is used to: • Transfer files from one user library to another • Copy files and profiles into a sequential data set for reorganization, backup, and archiving, which are described in the next chapter • Copy files and profiles from a sequential data set (in the format produced by the COPY control statement) into the VSPC library

EXPORT: The EXPORT control statement is used to convert a VSPC library file to a data set external to the VSPC library and to print a file.

IMPORT: The IMPORT control statement is used to convert an external data set to a VSPC library file. The data set to be converted can contain: • Up to 8,388,608 data records (maximum of 40S8 data bytes each), in sequential or direct organization • A source program (with up to 100,000 lines) • An object program or interpreter workspace in the format produced by the EXPORT control statement

■a Any sequential or direct data set with fixed- or variable-length records can be converted to a VSPC sequential file. A sequential or direct data set with fixed-length records can be converted to a VSPC direct file—a direct data set with variable-length records can be converted only to a VSPC sequential file. Fixed-length records to be converted to a VSPC sequential file can contain sequence numbers up to eight digits long at the beginning or end for generating VSPC line numbers (which are five digits long). Variable-length records to be converted can contain sequence numbers up to eight digits long only at the beginning for generating VSPC line numbers. PURGE: The PURGE control statement allows a system administrator to remove a file or a user (including the user's files and his profile) from the VSPC library.

58 VS Personal Computing (VSPC) for OS/VS and DOS/VS: General Information LIST: The LIST control statement generates a listing of file names and attributes, of user profiles, or of Foreground Processor or Auxiliary Processor profiles.

Notes on the Use of the VSPC Service Program The VSPC Service Program cannot alter or add to the VSPC library's contents while the interactive VSPC job is running. Only those operations that don't affect the contents of the library can be done then. Other operations can be done during the regular times that the VSPC job is not running. You can submit VSPC Service Program jobs interactively, but a job that affects the contents of the VSPC library must be held by the system operator or by job control statement until the VSPC job has been terminated. Although general VSPC users may be given the authority to use the VSPC Service Program COPY, EXPORT,and IMPORT control statements, and most of them might be willing or want to learn how to use them, it might be inconvenient for them to learn job control language to use the VSPC Service Program. You can devise a procedure for them to have a chief administrator run it for them. In any case, there should be little need for general users to run the VSPC Service Program.

Administering and Controlling the Use of VSPC 59 MAINTAINING VSPC

The tasks in maintaining VSPC are: • Controlling VSPC use of computer resources and balancing VSPC response time with throughput of batch jobs and other telecommunication jobs • Backing up and recovering the VSPC library in case it is damaged and becomes unreadable • Providing adequate space in the VSPC library for users' current files • Transferring VSPC files and profiles to another VSPC library if the need arises • Optionally adding foreground and auxiliary processors to run with VSPC The tools for accomplishing these tasks include: • Certain VSPC startup control statements • Certain VSPC operator and VSPC monitor commands • The VSPC Service Program for managing the VSPC library • Access Method Services for maintaining VSAM data sets These tools are discussed along with the tasks they are used to accomplish.

Controlling VSPC Use of Computer Resources There are several factors that you can adjust to control VSPC's use of resources in relation to other work being done by the computer: • The maximum number of VSPC users and auxiliary processors that can be logged on at one time • The maximum percentage of CPU time that VSPC should use for foreground processing • The length of the period over which the maximum percentage of CPU time is calculated • The maximum amount of real storage that VSPC should use for workspaces for foreground processing • The extent to which space in the VSPC library has become fragmented through the interaction of users acquiring and freeing space Before adjusting these factors, you should monitor performance and decide whether adjustment is necessary.

Evaluating Rehouse Time You can evaluate VSPC response time by receiving feedback from users or by making your own observations at the terminal while you use VSPC. The DISPLAY command enables the VSPC operator to see how many users are logged on, who they are, and what percentage of CPU time and what amount of real storage are being used for a current period of time, in relation to the maxima allowed VSPC.

Maintaining VSPC 61 With the informati6n gathered, you can optimize resource usage by resetting the limits on VSPC's use of CPU time and real storage.

Setting Limits on Computer Resources to Be Used You specify in VSPC startup control statements the maximum number of users that can be logged on at one time and the maximum amount of computer resources that VSPC should use. The percentage of CPU time and the amount of real storage are limited by your need to do other work with your computer while VSPC is running. The requirements of VSPC for computer resources have to be balanced with the requirements for other jobs. The allowed CPU time and real storage are specifiable for processing with 1/lOth or fewer of the maximum number of users and for processing with 9/lOths or more; between 1/lOth and 9/lOths, the time and storage levels vary proportionally. Thus, for any given number of users, you can specify how much of the computer resources VSPC can use. (Levels aren't set for * small tasks, such as line entry, because they control themselves statistically.) VSPC calculates the maximum percentage of CPU time to be used over the period you specify. The length of the period should be shorter when you have other telecommunication jobs besides VSPC; longer when all other processing is batch. While the VSPC job is running, the VSPC operator can use the SET command to interactively reset the number of users, the percentage of CPU time, the period over which the percentage is calculated, and the amount of real storage. Increasing the percentage of CPU time or the amount of real storage that can be used could decrease VSPC response time, but could also decrease the throughput of other jobs. Increasing the number of users that can be logged on to VSPC makes VSPC available to more users, and, if more users actually log on to VSPC,could increase VSPC response time. Under some circumstances, the number or mix of users could degrade VSPC performance or other throughput. If this occurs, the VSPC operator can use the CANCEL command to terminate the sessions of some of the users. The VSPC operator might experiment with different levels of allowed CPU time and real storage. In each experiment, he can monitor VSPC's performance and compare it with the throughput of other jobs in the computer. After optimum levels of computer resources have been found, the startup control statements can be changed to reflect them.

Reorganizing Space in the VSPC Library As users randomly delete their files from the VSPC library and acquire additional space for other files, each file may no longer occupy contiguous control intervals in direct-access storage—that is, its space becomes fragmented. No space is lost—VSPC can reuse all space that has been freed—but library access can take more time. To minimize the effect of fragmented space on performance, a chief administrator can use the VSPC Service Program COPY control statement to copy the entire VSPC library to a tape or other sequential data set, then to reconstruct the VSPC library from the copy. Copying into an empty VSPC library results in each user's files occupying contiguous control intervals.

62 VS Personal Computing(VSPC) for OS/VS and DOS/VS: General Information How often to reorganize depends on library usage. The procedure must be carried out when the VSPC job isn't running, because the VSPC library is modified by reorganization. When VSPC is terminated, it writes messages that indicate whether the VSPC library should be reorganized.

Backing Up and Recovering the VSPC Library If data in the VSPC library becomes unreadable, for whatever reason, you need a backup copy with which to replace the unreadable data. The backup copy should be as recent as you can practically make it. For example, if you start up the VSPC job every day, you could make a backup copy of the current library contents at the end of each day's processing. Then, if any part of the library becomes unreadable, you can restore that part, or the whole library, with a copy that is less than one day old. Or, you could make a copy of a critical file immediately after updating it, during the operation of the VSPC job. A VSPC chief administrator uses the VSPC Service Program COPY control statement to copy the VSPC library to a tape or other sequential data set for backup and to restore all or part of the VSPC library from the backup copy. Restoration must be carried out when the VSPC job isn't running, because it modifies the VSPC library. In a backup operation, it isn't necessary to copy all the files in the VSPC library; you can, instead, perform a partial backup, in which only the files updated since the last full backup are copied. When file restoration is needed, you copy the last partial backup, followed by the last full backup. VSAM Access Method Services can also be used for complete backup and recovery of the VSPC library; however, it doesn't reorganize space in the VSPC library as the VSPC Service Program does and cannot recover individual files.

Providing Adequate Space in the VSPC Library To ensure that each VSPC user has adequate space in the VSPC library for his current work:

Enrolling a User with the Proper Space Maximum Each user should be allowed the amount of user library space he needs to save his current files. The maximum amount is indicated in each user's profile—if the maximum is too little, it can be increased with the ALTER command or VSPC Service Program ALTER control statement.

Allocating Additional VSPC Library Space The VSPC library should have adequate total space to meet the current needs of all VSPC users. However much library space the users' profiles indicate they can use, they can use no more space than is actually available. As additional space is needed, it can be allocated with Access Method Services and made available to VSPC users by the VSPC Service Program ALTER control statement, with the SYSTEM operand.

Maintaining VSPC 63 Archiving Files That Are Seldom Used Each user should have any file that he doesn't expect to use for a long time copied to a sequential archive data set and removed from the VSPC library; he can notify a chief administrator to restore the file to the library the day before he needs it again. Seldom-used files can be archived with the VSPC Service Program COPY control statement. The original file remains in the VSPC library; it can be deleted interactively with the PURGE command. To avoid unnecessary copy operations, you can back up the VSPC library and archive files at the same time. The backup/archive data set can also be used to reorganize VSPC library space.

Eliminating Unwanted User Profiles and Files Any user that stops using VSPC should have his profile and files removed from the VSPC library. Like archiving, removing the profile and the files of a former VSPC user from the VSPC library frees library space for current use. Before you remove the files, you can archive or copy to another user's library any of the files you want to keep. To remove a former VSPC user's profile and files, you first use the ALTER command or the VSPC Service Program ALTER control statement to indicate in the profile that no one is allowed to log on to VSPC with this user's number. Then you use the COPY control statement to copy the rest of the VSPC library without the unwanted profile and files. To avoid an unnecessary copy operation, you can remove former users' profiles and files at the same time you reorganize VSPC library space.

Transferring Data to Another VSPC Library You can use the VSPC Service Program to move profiles and files from one VSPC library to another. The other VSPC library might belong to another VSPC installation within your organization or some other organization. When you use the COPY control statement to copy files, the profile of the owner of the files is also copied. Thus, the owner is automatically enrolled in the other library, if he isn't already. Alternatively, the profile and files can be given a new user number.

64 VS Personal Computing(VSPC) for OS/VS and DOS/VS: General Information Adding Foreground and Auxiliary Processors to Use with ^ VSPC Once VSPC has been installed, with or without foreground or auxiliary processors, you might want to add other processors or develop your own. VSPC provides one communication interface for foreground processors and another for auxiliary processors. Each interface consists of a set of macros and control blocks that enable a processor to use the services of VSPC and to communicate with other processors through VSPC. VSPC: Writing Processors explains how to write foreground and auxiliary processors. A processor of either kind must have a profile defined in the VSPC library through the VSPC Service Program. The program modules that comprise a processor must be included in the appropriate operating system library.

Maintaining VSPC 65 Page of GH2a-9070-5 As Updated 29 Feb 1980 ByTNLGN20-9316

REFERENCE MATERIAL

This chapter describes the other VSPC publications and indicates who should have a copy of each. DOS VSPC users should refer to publications listed under "DOS/VS VSPC Publications." The preface lists other publications related to VSPC.

VS Personal Computing(VSPC) Installation Reference Material

Order Number: SH20-9072 ' Description: Tells how to install, maintain, operate, and administer VSPC. Discusses setting up a telecommunications network and gives an example of a source NCP (network control program) and examples of VTAM library • members. Gives storage estimates. Describes the VSPC Service Program and the VSPC supervisory commands. Gives explanations of offline VSPC messages and VSPC Service Program messages and explains how to produce < computer listing of the explanations of online VSPC messages. Audience: System programmers who install and maintain VSPC. Supervisory personnel who control the operation and administer the use of VSPC. General users who use the VSPC Service Program.

VS Personal Computing(VSPC) General User's Guide and Command Language

Order Number: SH20-9071 Description: Explains how to use VSPC. Describes the VSPC general commands. Explains how to produce a computer listing of the explanations of online VSPC messages. Audience: All VSPC users (including supervisory personnel).

VS Personal Computing(VSPC) Terminals

Order Number: SH20-9073 Description: Describes the terminals that VSPC can be used with and explains their use. Audience: All VSPC users (including supervisory personnel).

, VS Personal Computing(VSPC): Writing Processors

Order Number: SH20-9074 Description: Describes the interfaces by which auxiliary processors and foreground processors communicate with VSPC and explains how to use those interfaces to write processors. Audience: System programmers who design and implement processors for use with VSPC.

Reference Material 67 Page of GH20-9070-5 As Updated 29 Feb 1980 ByTNLGN20-9316 OS/VS2 MVS ViS Personal Computing(VSPC) Diagnostic Aids

Order Number: LY20-8073 Description: Systematically defines program failures using keywords, which are then used to search the Software Support Facility data base for similarly defined program failures. Audience: IBM support personnel and system programmers who diagnose VSPC program failures.

VS Personal Computing(VSPC) Logic Summary

Order Number: LY20-8072 Description: Describes system architecture, lo^c flow, and modules to support the diagnostic information provided by the OS/VS MVS VS Personal Computing(VSPC) Diagnostic Aids. Audience: IBM support personnel and system programmers who diagnose problems not previously defined in the Software Support Facility data base.

DOS/VS VSPC Publications The following are DOS/VS VSPC Release 1 publications: • VS Personal Computing (VSPC) Installation Reference Material, ST40-9072 VS Personal Computing (VSPC) General User's Guide and Command Language, ST40-9071 VS Personal Computing (VSPC) Terminals, ST40-9073 VS Personal Computing (VSPC): Writing Processors, ST40-9074 VS BASIC for VSPC: Terminal User's Guide, ST40-9060

VSPC FORTRAN Terminal User's Guide, ST40-9062 VS APL for VSPC: Terminal User's Guide, ST40-9066 DOS/VS VS Personal Computing (VSPC) Program Logic, LY20-8039 DOS/VS Virtual Storage Personal Computing (VSPC) Program Product Specifications, Program Number 5746-XR3, GH20-9109 DOS/VS VSPC Cross-Reference Data Areas, LYBO-8048

68 VS Personal Computing(VSPC) for OS/VS and DOS/VS: General Information GLOSSARY

The following terms are defined as they are used in this book. content attribute: See workspace content attribute. If you don't find the term you are looking for, refer to the control statement: A statement used to specify the operation index or to the IBM Data Processing Glossary, GC20-1699. of a job. VSPC Service Program control statements specify Access Method Services: A computer program used to create the operation of the VSPC Service Program; VSPC startup and maintain VSAM catalogs and VSAM data sets. control statements specify the operation of the VSPC job. account administrator: A VSPC administrator with limited current tine pointer: A line number within an editable authority to use the VSPC Service Program and the workspace that is maintained within VSPC and that points to supervisory commands for enrolling new VSPC users and what is considered the user's current position in the processing their profiles. workspace. The current line pointer is explicitly or implicitly set by commands which change the workspace, and may be accoiuiting records: Records in SMF format that contain symbolically referred to in VSPC commands. information about various VSPC events for the purpose of accounting. directory: A set of records in the VSPC library, each one of which identifies and describes a file in a user library. Each accounting unit: An installation-defined measure of VSPC user library has its own directory. system usage which is used for user accounting. enroltment: The creation of a user profile that authorizes a AID: See VSPC AID. person to be a VSPC user. APL: A Programming Language. A problem-solving extemal data set: A data set separate from the VSPC library programming language designed for use at terminals. It data sets. enables businessmen, engineers, scientists, and others who might not be professional programmers to create programs file: A related collection of information (data, text, job and do mathematical and logical calculations in a concise and control language, VSPC command list, source program, efficient manner. object program, or interpreter workspace)stored in a user library. archive: To move a seldom-used file from the VSPC library to a sequential data set in order to free library space for current foreground Interface: A set of macros and control blocks that files. enable a foreground processor to use the services of VSPC on behalf of a VSPC user. These services include the ability to auxiliary processor: A computer program that runs as a batch communicate with other VSPC users and other processors. job separate from the VSPC job and communicates with other processors by way of VSPC. foreground processor: A computer program that runs interactively under the control of VSPC,such as a compiler background interface: A set of macros and control blocks that or an interpreter. enable an auxiliary processor to communicate with other processors by way of VSPC. FORTRAN: FORmula TRANslating system. A programming language used by persons in business, science, engineering, BASIC: An algebra-like programming language used for and other fields to write computer programs to solve problem solving by businessmen, engineers, scientists, and arithmetic problems and for other applications. others who might not be professional programmers. full screen editing: Modifying one or more lines on a screen batch job: A job that is processed without interaction between with the local facilities of the terminal prior to transmission the computer and the person who submitted the job. A job to the host, and then copying the changes back into the that executes the VSPC Service Program is batch; the VSPC workspace. job is interactive. general VSPC commands: VSPC commands that can be used batch processing: The processing of batch jobs under the by any VSPC user. control of the operating system, as opposed to the interactive processing of individual terminal actions under the control of Interactive processing: Computer processing in which each VSPC. action by a person at a terminal elicits a response from the computer at the terminal. chief administrator: A VSPC administrator with unlimited authority to use the VSPC Service Program and the Interpreter: A foreground processor that translates and supervisory commands for enrolling new VSPC users and executes each source statement before it translates and processing their profiles. executes the next one. command: An imperative statement used interactively, at a interpreter function: A sequence of operations that are defined terminal, to tell VSPC to perform a specific action. General under the control of an interpreter and may be saved for commands can be used by any VSPC user; supervisory future use. commands can be used only by a VSPC administrator, the Interpreter workspace: A workspace that contains information VSPC operator, or the VSPC monitor. produced by working under the control of an interpreter. command list: A sequence of VSPC commands that can be Also a file that contains such information. saved for future execution as a group. JES: Job entry subsystem, either JES with OS/VSl or JES2 compiler: A foreground processor that converts a source or JES3 with 0S/VS2 MVS. It is used for remote job entry. program into an object program and, optionally, controls or provides services for the execution of the object program.

Glossary 69 journal: A sequential data set used to write log messages program product: A licensed program that performs a offline. function for the user and usually interacts with a system library: A collection of related files. A user library contains control program or some other IBM-provided control the files of a particular VSPC user or set of VSPC users; the program. VSPC library contains all user libraries. programming language: A language used to create computer library manager: The VSPC user to whom a user library was programs. assigned at enrollment. project library: A user library whose files can be read without library number: The user number of the manager of a user special authority by a designated group of VSPC users. Either library. the manager of that user library alone or all of the designated users can own files in it. local command: In view mode, a command that is entered over a line number in the workspace display area, and that prompt: A request from VSPC for certain information, such acts upon that line only. as a password missing from a command. log messages: VSPC messages sent to the VSPC monitor public library; A user library whose files can be read by all (online log) or to the journal (offline log). VSPC users. Either the manager of that user library alone or all VSPC users can own files in it. logoff: A VSPC user s action of terminating a session with real storage: In System/370 virtual-storage operating systems, VSPC. the computer storage from which the central processing unit logon: A VSPC user's action of beginning a session with can directly obtain instructions and data, and to which it can VSPC. directly return re .ults. MVS: Multiple virtual storage. Refers to release 2 and remote job entry: The submission at a terminal of a batch subsequent releases of 0S/VS2. computer job. NCR: Network control program. The program that controls SDLC: Synchronous data link control. Used to refer to IBM the operation of the IBM 3704 or 3705 Communications terminals that use a high-speed synchronous data Controller. It enables VTAM to transfer data between remote communication technique. terminals and VSPC. session: The activity that occurs at a terminal between logon object program: An executable computer program resulting and logoff. from the compilation of a source program. shared storage: Virtual storage used by VSPC for data offline: As used in this book, pertaining to operations that exchange among users and auxiliary processors. aren't done interactively. SMF: System management facilities. A control program online: As used in this book, pertaining to operations that are option of OS/VSl and 0S/VS2 that provides the means for done interactively. gathering and recording information that can be used to password: A string of characters that limits access to VSPC evaluate system usage and security. (logon password) or to a VSPC file (file password). SMP: System modification program. A service aid program POWER/VS: The job entry subsystem of DOS/VS. It is used that enables users to put IBM or user modifications into an for remote job entry. OS or OS/VS operating system. private library: A user library whose files can belong only to source program: A sequence of computer program statements the manager of that user library. written in a programming language and requiring compilation to be executable by a computer. processing unit: A unit of a computer that includes circuits controlling the interpretation and execution of instructions. start-stop: Used to refer to terminals that use a low-speed serial asynchronous data communication technique. Synonymous with central processing unit(CPU), central processor, and main frame. supervisory VSPC commands: VSPC commands that can be processor: A computer program that runs either interactively used only by a VSPC administrator, the VSPC operator, or under the control of VSPC {foreground processor) or as a the VSPC monitor. separate batch job that communicates with other programs system operator: The person who operates the console for by way of VSPC {auxiliary processor). interactive communication with the operating system and who starts up the VSPC job. processor profile: A collection of information in the VSPC library that identifies and describes either a foreground system profile: A collection of information in the VSPC processor or an auxiliary processor. library that defines certain VSPC parameters. profile: A collection of information in the VSPC library that terminal: A device used for local or remote communication identifies a VSPC user (urer profile), a processor {processor with a computer. profile), or certain VSPC parameters {system profile). user IE>rary: A library in the VSPC library in which a VSPC program function key: A key on the keyboard of a display user or users store their files. A user library is private, project, device that passes a signal to a program to call for a particular or public. A user library is established for every user profile program action. that is created. user Bbrary directory: A directory of the contents of a user library. Every user library has its own directory in the VSPC library.

70 VS Personal Computing(VSPC) for OS/VS and DOS/VS: General Information user number: The number that identifies a user to VSPC. user profile: A collection of information in the VSPC library that identifies a VSPC user and defines the VSPC resources and facilities available to him. VIEW mode: A state in which a display terminal is being used for full screen editing. virtual storage: Addressable space that appears to the user as real storage and from which instructions and data are mapped into real storage. The size of virtual storage is limited by the addressing scheme of the computer and by the amount of direct-access storage available, rather than by the size of real storage. VSAM: Virtual storage access method. The set of programs the operating system uses to transfer data between VSPC and direct-access storage. VSPC administrator: A VSPC user authorized by an indicator in his user profile to use the supervisory commands for enrolling new VSPC users and processing their user profiles. He also has special authority to use the VSPC Service Program. He is either a chief administrator or an account administrator. VSPC AID: A program contained in VSPC that, on request, prompts a user to specify a VSPC command correctly or provides an explanation of a VSPC message. VSPC command list: A series of VSPC commands that can be saved for future execution as a group. VSPC job: The computer job that makes VSPC available for interactive use. VSPC library: A set of three VSAM data sets that contain profiles and user libraries and their directories. VSPC monitor: A VSPC user authorized by a VSPC startup control statement to use the supervisory commands for monitoring the operation of VSPC. VSPC operator: A VSPC user authorized by a VSPC startup control statement to use the supervisory commands for controlling the operation of VSPC. VSPC Service Program: A computer program used to manage the VSPC library. It is run as a batch job separate from the VSPC job. VSPC startup: The process of initiating the operation of the interactive VSPC job. VSPC user: A person who has a user profile in the VSPC library.

VTAM: Virtual telecommunications access method. The set of programs the operating system uses to transfer data ' between terminals and VSPC. workspace: The virtual storage in which a VSPC user does his terminal work (such as entering data or source program statements and compiling and executing programs). workspace content attribute: A descriptor of the kind of information contained in a workspace. It is associated with the workspace contents when they are saved as a file in a user library. A user profile contains a default content attribute that is assigned to that user s workspace when he logs on to VSPC. Certain attributes indicate that a workspace is used under the control of a foreground processor.

Glossary 71 Page of GH20-9070-5 As Updated 29 Feb 1980 ByTNLGN20-9316 INDEX

For additional OS/VS information authorization controlling the operation of the VSPC about any subject listed in this index, to access library file 31,53 job 55 refer to the publications that are listed to log on to VSPC 53 converting data 45,57 under the same subject in OS/VSl to use VSPC facilities 51 COPY command duplicates lines 29 Master Index, GC24-5104, or 0S/VS2 to use VSPC Service Program 57 COPY control statement(VSPC Master Index, GC28-0693. auxiliary processors Service Program) 58,57 adding to VSPC 65 correcting an input line 19,20 definition 69,24 CPT-TWX terminal 41,17 developing your own 65 CPUs(central processing units), abbreviation of VSPC conunands 32 illustration 24 System/370 40,16 Access Method Services, VSAM installing 45 required special features 40 backing up and recovering the profile 44 current line pointer 29 VSPC library 63 auxiliary-storage requirements 42 definition 69 defining the VSPClibrary 44 extending the VSPC library 63 B D account administrators 37,S2 ACCOUNT control statement(VSPC backing up the VSPC library 63 data conversion 45,57 Service Program) 58,57 backspace, setting logical character data entry and editing 19,29 accounting improvements. Release for 30 data sets, external to the VSPC library 2 14 BASIC, VS converting 45,58 accounting information 56 definition 69 VSAM, processing displaying interactively 52 foreground processor of interactively 30,15 formatting records in SMF VSPC 13,15 data stream compatibility(DSC) and format 56 installing 45 3791 controller 42 accounting records(SMF batch job data transfer between libraries 64 format) 23,56 illustration 22,24 DEFINE direct-access storage submitting 31 Access Method Services requirement 42 VSPC Service Program 57 command 44 formatting from user profile 58 administrator command 44,52 accounting units, composite 23,56 VSPC Service Program control definition 69 statement 44,57 ACF/NCP/VS function 44 CANCEL conunand defining ACF/VTAM general 31 processor profile 44 function 44 VSPC operator 55,62 system profile 44 network support 16 capacity planning 37,39 user library 52,58 administering and controlling the use accounting information and 56 user profile 52,58 of VSPC 49 catalog, VSAM 44 the VSPC library 44 administrators, VSPC 37,52 CHANGE command (general) 29 DELETE command (general) 29 functions and conunands 52 example 34 example 34 maintaining the VSPC library 62 Release 2 capabilities 13 sets current line pointer 29 AID Cree VSPC AID) chief administrators 37,52 deleting file 31,58 allocating space for the VSPC maintaining the VSPC library 62 deleting input line 29 library 44,63 CICS and VSPC 16 deleting user profile 58 ALTER CLEAR command (general) 30 direct-access storage devices 17 administrator command 52,63 command list, VSPC 15,30 direct-access storage requirements 42 VSPC Service Program control foreground processor directory, user-library statement 58,63 invocation 30 creating an entry 31 altering nested 30,14 in VSPC library 44 user profile 52 commands listing 30 VSPC startup procedure 49 (see also control statements) DISPLAY command(VSPC analyzing VSPC accounting general 28 operator) 55,61 information 56 supervisory 52,55 display screen(IBM 3270 Information amendments,summary of 11 communication interface for Display System) 20,25 AP (attached processor)feature, processors 24,65 printing display-screen MVS 16 communication network 39,16,44 information 29 APL, VS compiler (foreground display terminal support. Release 2 14 definition 69 processor) 21,15 DSC (data stream compatibility) and foreground processor of composite accounting units 23,56 3791 controller 42 VSPC 13,15 conducting a terminal session 28,19 installing 45 CONTINUE library file 28,35 archiving files 64 control statements attached processor(AP) feature, (see also JCL and commands) MVS 16 VSPC Service Program 57 AUTH control statement(VSPC VSPC startup 46 Service Program) 57

Index 73 E logon 30 illustration 22 profile 44 interactive control 55 editing, full screen 23,28 working under the control of 27,21 startup option 46 Release 2 feature 13 FORTRAN,VSPC user authorization 51 VIEW command begins 20 definition 69 job entry subsystems 21 education of personnel foreground processor of (see also remote job entry) administrators 38 VSPC 13,15 JOIN command joins lines 29 general users 19 installing 45 journal (offline log) 46,54 eliminating files and profiles 64 full screen editing 23,28 enrollment S1,S2 definition 69 K by way of COPY 58 Release 2 feature 13 ENTER command (general) 30 VIEW command begins 20 KEY command (general) 29 entering information and seeing it Full Screen Management(FSM) 26 key-sequenced data set, VSAM processing interactively 21 displayed 25 function, interpreter 24 entry, remote job 15,31 detailed description 31 general description 15 general commands 28 library (see user library and VSPC illustration 33 graphic character substitution 30 library) interactive control 21 limiting job entry subsystems 15 access to library file 53,31 H startup option 46 access to VSPC 53 user authorization 51 HALT command(VSPC operator) 55 user's authority 50 entry-sequenced data set, VSAM HARDCOPY command (general) 29 VSPCs use of system processing interactively 21 resources 46,55 executing I line correction 29 interpreter function 21,27 line deletion 29 object program 21,27 IMPORT control statement(VSPC line duplication, COPY command 29 source program 21,27 Service Program) 58,57 line entry sets current line pointer 29 VSPC command list 15,27 importing data 57,45 line joining and splitting 29 VSPC job (interactive) 45,49 IMS and VSPC 16 LINESIZE command (general) 28 VSPC Service Program (batch) 57 incremental backup, service LIST command (general) 30,13 EXPORT control statement(VSPC program 23 Release 2 capabilities 13 Service Program) 58,57 INPUT command (general) 29 LIST service program control extending the VSPC library 63 sets current line pointer 29 statement 59 external data sets installing processors with VSPC 44 LOAD command (general) 30 converting 45,57 installing VSPC 43 illustration 33,34 VSAM, processing interactively 21 interface for processors 65,24 importing data 57 EXTRACT command deletes lines 29 interpreter (foreground sets current line pointer 29 processor) 65,24 local command,full screen interpreter function 21,27 editing 29,23 interpreter workspace FILE command (general) 31 definition 70 file in a user library 26 LOCATE command sets current line file copying by nonowner 23 import 58,57 pointer 29 file export by nonowner 23 worked on in user workspace 27 log messages 54 file, library logical terminal characters, setting 30 archiving 64 logon command, VSPC (general) 28 contents 26 example 33 copying 58,57 JCL(job control language) logon password 53 deleting 58,31 (see abo remote job entry) changing 28 editing 29,19 VSPC Service Program 57 prompting 33 printing 19,58 VSPC startup procedure 45 user profile 51 transferring to another JENTRY command(VSPC logon processor 30 library 58,57 operator) 55 file password 53,22 JES (job entry subsystem), FIND command (general) 29 definition 70 M foreground interface enhancements. JES2 16 main storage (see real storage) Release 2 14 JESS 16 maintaining VSPC 61 foreground processors job, batch managing adding to VSPC 65 illustration 22 terminal session 28 definition 69,24 submitting 31 user library 30,50 developing your own 65 VSPC Service Program 57,23 workspace 30 illustration 24 job, VSPC (interactive) 45,49 MERGE command (general) 29,34 installing 45 controlling 54 MESSAGE command (general) 28,33 interactive programming job control language languages 15,13 (see abo remote job entry) invocation of command lists 30 VSPC Service Program 57 VSPC startup procedure 45 job entry, remote 31,22

74 VS Personal Computing(VSPC) for OS/VS and DOS/VS: General Information messages PFKEY command sets program R general 28,33 function keys 29 log 54 PL/I, VSPC 13 real storage requirements 42 online explanation (VSPC planning objectives 39 recovering the VSPC library 63 AID) 15,20,35 PMONITOR command(VSPC reference material 67,4 reorganize VSPC library 63 monitor) 54 relative-record data sets in VSAM 21 MONITOR command(VSPC POWER/VS (job entry Release 2 highlights 13 monitor) 54 subsystem) 16,70 remote job entry 31,21 monitor, VSPC 54 private library 50 illustration 22,33 commands 54 (see also user library) interactive control 55 monitoring processing unit, definition 70 job entry subsystems 21 log messages 54 processor profiles 44 startup option 46 performance 61,56 processor, auxiliary user authorization 51 MOVE command (general) 29,34 adding to VSPC 65 remote terminals require NCP 40 MP (multiprocessor) features, definition 69,24 RENUMBER command MVS 16 developing your own 65 (general) 29,34 multiprocessor(MP) features, illustration 24 sets current line pointer 29 MVS 16 installing 45 reorganizing the VSPC library 62 profile 44 combining with other N processor, foreground operations 64 adding to VSPC 65,15 requirements to install VSPC NAME command (general) 30,35 definition 69,24 direct-access storage 42 NCP(network control developing your own 65 operating system 39 program) 39,43,16 illustration 24 processing unit 40 nested command list 30 installing 45 real storage 42 network, telecommunications 39,43 interactive programming terminal 40 new line, setting logical character languages 15,13 virtual storage 42 for 30 profile 44 VSAM 40 NUMBER conunand (general) 31 working under the control of 28 VTAM 39 numbers, sequence profile ROUTE command (general) 31 imported data 58 processor 44 RUN command (general) 30,34,35 job entry 31 system 44 user 44,51 o program (see processor, source program, object program) SAVE command (general) 30,57 object program 26 program conversion 45 illustration 33,35 definition 70 program function (PF)key 13 SCRATCH command (general) 31 execute 21,30 screen, display 20,13 import 57 definition 70 setting 26,20 SDLC (synchronous data link control) store in user library 30,35,26 program products, IBM 15,13 definition 70 submit for batch processing 31 project library 50,51 terminals 41 objectives for VSPC 39 security OFF command (general) 28,35 (see also user library) PROTECT command (general) 31,33 design of VSPC 22 offline log 54,46 protection (security) file passwords 53,31 online log 54 design of VSPC 22,15 logon passwords 53,51 operator file passwords 53,22 SEND command system 49,55 general 28,33 VSPC 55,37,49 logon passwords 53,45,28 public library 50,51 VSPC operator 55 optimizing performance 61,55,56 (see also user library) sequence numbers publications 67,4 imported data 58 PUNCH command (general) 29 job entry 31 paging data set, direct-access storage PURGE command (general) 31,33 service program (see VSPC Service requirement 42 PURGE service program control Program and Access Method partial backups, service program 23 statement 23,58 Services) password 53 service program enhancements. file 53,22 Release 2 14 logon 53,45,28 session, terminal PASSWORD command (general) 28 QUERY command conducting 28 performance administrator 52,57 illustration 33 interactive adjustment 62 general 30,33 SET command(VSPC monitoring 54,61 operator) 55,62 reorganizing the VSPC library 62 SHARE command (general) 31,33 startup options 46 shared file updating. Release 2 14 personal computing, description 19 sharing personnel 37 data for processing 21 library files 31

Index 75 PageofGH20-9070-5 As Up^ted 29 Feb 1980 By TNL GN20-9316

SMF(system management training personnel Release 2 13 facilities) 56 administration 38 application capabilities 14 SMP(system modification general users 19 subsystem management program) 44 transferring data between libraries 64 improvements 14 source program 21 TRANSLATE conunand (general) 28 terminal usage compile 30,35,21 TSIO,VS 13,15 enhancements 13 edit 29 TSO and VSPC 16 VSPC job (interactive) 45,49 execute 30,35,21 controlling 55 import 58 u VSPC library save in user library 30,33 {see also user library) submit for batch processing 31,33 usability improvements, Release 2 13 allocating additional space 63 user library SPLIT command separates lines 29 backing up 63 access 50,53 start-stop creating 44 assigning 50 definition 40 direct-access storage contents 26 terminals 70 requirements 42 starting up the VSPC job 49 files 26 recovering 63 in VSPC library 26 startup procedure, VSPC 45 reorganizing 62 managing 30,50 STATUS command (general) 31,33 VSAM data sets 44 queries one or all jobs 31 user profile and 51 VSPC logon command user profile 44,52 storage devices, direct-access 17 (general) 28,33 altering 52 storage requirements 42 VSPC monitor 37 defining 51,52 STORE command (general) 30,35 commands 54 formatting accounting information SUBMIT command (general) 31 VSPC operator 37 from 56 exporting data 57 commands 55 in VSPC library 44 illustration 33 VSPC PL/I 13,15 subsystem management user workspace VSPC Service Program 57 content attribute 25 features 14,16 restriction 59 defined in user profile 51 summary of amendments 11 setting up the VSPC library 44 managing 30,33 supervisory commands use by general users 59 (see also VSPC Service Program uses of 27 VSPC startup procedure 45,49 uses of VSPC 25 and VSPC startup procedure) VTAM (virtual telecommunications VSPC administrator commands 52 administrative access method) 16,39 commands 52,54,55 VSPC monitor commands 54 telecommunications network 43 general commands 28 VSPC operator commands 55 terminals and 40 SYSGEN 43 VSPC Service Program 57 system generation 43 w system management facilities (SMF) 56 workspace, interpreter VIEW command begins full screen system modification program file in a user library 27 editing 29 (SMP) 44 import and export 57 VIEW mode, definition 71 system operator 49,55 worked on in user workspace 27 virtual-storage requirements 42 system profile, VSPC 44 workspace, user VSAPL 69,13,15 Systems Extension I, MVS feature 16 content attribute 27 VS BASIC 69,13,15 defined in user profile 51 VSTSIO 13,15 managing 30,34 VSAM (virtual storage access saving automatically at method) 16,40 tabs, setting logical 30 logoff 28,35 alternate index support. Release TABSET command (general) 28 uses of 27 Release 2 capabilities 29 2 21,14 data sets processed TAPE command (general) 28 Numeric telecommunications network 39,43,16 interactively 21 Teletype terminal(CPT-TWX) VSAM Access Method Services 44,63 33, CPT-TWX Model 41 requirements 41 VSAM catalog 44 35, CPT-TWX Model 41 use of 28 VSPC administrators 37,51,57 115-2, System/370 CPU Model 40 terminal usage features 13,15 functions and commands 52 125, System/370 CPU Model 40 terminals 40 maintaining the VSPC library 62 135, System/370 CPU Model 40 BSC (bisynchronous service program and 57 145, System/370 CPU Model 40 communication) 40 VSPC AID 15,20,35 1050 Data Conununication System, conducting session 28,32 VSPC FORTRAN 69,13,15 IBM 41 how to use them 25 VSPC highlights 13 2741 Communication Terminal, remote, require NCP 40 previous releases 15 IBM 41 requirements and restrictions 40 application facilities 15 IBM 3767 used as a 2741 41 SDLC(synchronous data link interactive terminal usage 15 3101 Display Terminal 41 control) 41 subsystem management start-stop 41 features 16 testing the VSPC installation 46

76 VS Personal Computing(VSPC) for OS/VS and DOS/VS: General Information 3270 Information Display System, IBM BSC mode 41 full screen editing 20,26 Full Screen Management (FSM) 26 information entry and display 25 printing display-screen information 29 program function keys 20,26,29 SDLC mode 41 3271 Controller, IBM 42 3272 Model 2 Local Cluster Control Unit 41,42,17 3274 Controller, IBM 42,17 3275 Controller/Display, IBM 42 3276 Controller/Display, IBM 42,14 3278 Display Station, IBM 14 3287/3289 Printers, IBM 14,41 3704 Communications Controller, IBM 40,42,16 3705 Communications Controller, IBM 40,42,16 3767 Communication Terminal, IBM 41 3770 Data Communication System, IBM 41 3791 Controller, IBM 42,17

Index 77 Technical Newsletter This Newsletter No. GN20-9316

Date 29 Feb 1980

Base Publication No. GH20-9070-5

File No. S370-39

Prerequisite Newsletters None

2S/ll/io - W.

VS Personal Computing(VSPC) for OS/VS and DOS/VS: General Information

© Copyright IBM Corp. 1975, 1976, 1977 This technical newsletter, a part of Release 2 of VSPC,Program Numbers 5740-XR5(OS/VSl VSPC),5740-XR6 (OS/VS2 MVS VSPC),and 5746-XR3(DOS/VS VSPC), provides replacement pages for the subject publication. These replacement pages remain in effect for any subsequent releases unless specifically altered. Pages to be inserted and removed are:

cover, edition notice 3-12 41_44.1(44.1 added) 67,68 73-76 Each technical change is marked by a vertical bar to the left of the change. Summary of Amendments

Changes included in this newsletter are summarized under "Summary of Amendments" following the list of figures. Note: Please file this cover letter at the back of the publication to provide a record of changes.

IBM Corporation, P.O. Box 50020, Programming Publishing, San Jose, California 95150

Printed in U.S.A. Reader's VS Personal Computing (VSPC) Comment for OS/VS and DOS/VS: General Information Form GH20-9070-5

This manual is part of a library that serves as a reference source for systems analysts, programmers, and operators of IBM systems. This form may be used to communicate your views about this publication. They will be sent to the author's department for whatever review and action, if any, is deemed appropriate. Comments may be written in your own language; use of English is not required. IBM shall have the nonexclusive right, in its discretion, to use and distribute all submitted information, in any form, for any and all purposes, without obligation of any kind to the submitter. Your interest is appreciated. Note: Copies of IBM publications are not stocked at the location to which this form is addressed. Please direct any requests for copies of publications, or for assistance in using your IBM system, to your IBM representative or to the IBM branch office serving your locality.

E 1 tc o d M ■5 £ ® « O) CD C « o V- S£ ^ s E T> T3 C ® 1 1C =o) 2 ™ (O •£ j: o 5 o

EQ)I .. ^ CA ^ C O C) k. CA a o

m ^ 3 £ c a 03 0) u M <» ^ 0) 0) a S » o w a.

Fold on two lines, tape, and mail. No postage necessary if mailed in the U.S.A. (Elsewhere, any IBM representative will be happy to forward your comments.) Thank you for your cooperation. GH20-9070-5

Reader's Comment Form

Fold and Tape

< CO NO POSTAGE ■O NECESSARY o IF MAILED IN THE o UNITED STATES CO < CO cu 3 a BUSINESS REPLY MAIL O o FIRST CLASS PERMIT NO.40 ARMONK, N.Y. CO < CO

Postage will be paid by: Q CO 3 CD IBM Corporation P.O. Box 50020 Programming Publishing San Jose, California 95150

Fold and Tape 3 c cn >

O X ro o CO o "sj o tji

International Business Machines Corporation Data Processing Division 1133 Westchester Avenue, White Plains, N.Y. 10604

IBM World Trade Americas/Far East Corporation Town of Mount Pleasant, Route 9, North Tarrytown, N.Y., U.S.A. 10591

IBM World Trade Europe/Middle East/Africa Corporation 360 Hamilton Avenue, White Plains, N.Y., U.S.A. 10601 GH20-9070-5

International Business Machines Corporation Data Processing Division 1133 Westchester Avenue, White Plains, N.Y. 10604

IBM World Trade Americas/Far East Corporation Town of Mount Pleasant, Route 9, North Tarrytown, N.Y., U.S.A. 10591

IBM World Trade Europe/Middle East/Africa Corporation 360 Hamilton Avenue, White Plains, N.Y., U.S.A. 10601