roscoe v6.0 - getting started guide

Getting Started Guide 6.0

CA-Roscoe

SP3

This documentation and related computer software program (hereinafter referred to as the “Documentation”) is for the end user’s informational purposes only and is subject to change or withdrawal by Computer Associates International, Inc. (“CA”) at any time.

This documentation may not be copied, transferred, reproduced, disclosed or duplicated, in whole or in part, without the prior written consent of CA. This documentation is proprietary information of CA and protected by the copyright laws of the United States and international treaties.

Notwithstanding the foregoing, licensed users may print a reasonable number of copies of this documentation for their own internal use, provided that all CA copyright notices and legends are affixed to each reproduced copy. Only authorized employees, consultants, or agents of the user who are bound by the confidentiality provisions of the license for the software are permitted to have access to such copies.

This right to print copies is limited to the period during which the license for the product remains in full force and effect. Should the license terminate for any reason, it shall be the user’s responsibility to return to CA the reproduced copies or to certify to CA that same have been destroyed.

To the extent permitted by applicable law, CA provides this documentation “as is” without warranty of any kind, including without limitation, any implied warranties of merchantability, fitness for a particular purpose or noninfringement. In no event will CA be liable to the end user or any third party for any loss or damage, direct or indirect, from the use of this documentation, including without limitation, lost profits, business interruption, goodwill, or lost data, even if CA is expressly advised of such loss or damage.

The use of any product referenced in this documentation and this documentation is governed by the end user’s applicable license agreement.

The manufacturer of this documentation is Computer Associates International, Inc.

Provided with “Restricted Rights” as set forth in 48 C.F.R. Section 12.212, 48 C.F.R. Sections 52.227-19(c)(1) and (2) or DFARS Section 252.227-7013(c)(1)(ii) or applicable successor provisions.

2001 Computer Associates International, Inc.

All trademarks, trade names, service marks, and logos referenced herein belong to their respective companies.

Contents

About This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v

Chapter 1. Introducing CA-Roscoe . . . . . . . . . . . . . . . . . . . . . . . . 1-1

Chapter 2. Signing On and Entering Data . . . . . . . . . . . . . . . . . . . . 2-12.1 Signing On to CA-Roscoe . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-22.2 Entering Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-42.3 Review/Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-9

Chapter 3. Saving Data and Signing Off . . . . . . . . . . . . . . . . . . . . . 3-13.1 Introducing the CA-Roscoe Library . . . . . . . . . . . . . . . . . . . . . . . 3-23.2 Saving Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-33.3 Signing Off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-43.4 Review/Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5

Chapter 4. Retrieving and Displaying Data . . . . . . . . . . . . . . . . . . . 4-14.1 Displaying Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-24.2 Displaying Data to Modify . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-34.3 Detaching and Reattaching Data . . . . . . . . . . . . . . . . . . . . . . . . 4-44.4 Review/Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6

Chapter 5. Scrolling Through Data . . . . . . . . . . . . . . . . . . . . . . . . 5-15.1 Using PF Keys to Scroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-25.2 Using Commands to Scroll . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-35.3 Review/Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-4

Chapter 6. Modifying Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-16.1 Using Multiple Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-26.2 Correcting and Changing Commands . . . . . . . . . . . . . . . . . . . . . . 6-36.3 Moving Data Within the AWS . . . . . . . . . . . . . . . . . . . . . . . . . 6-56.4 Copying Data Within the AWS . . . . . . . . . . . . . . . . . . . . . . . . . 6-86.5 Deleting Data From the AWS . . . . . . . . . . . . . . . . . . . . . . . . . 6-106.6 Renumbering the AWS . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-126.7 Locating Specific Words Within the AWS . . . . . . . . . . . . . . . . . . 6-136.8 Changing Words Within the AWS . . . . . . . . . . . . . . . . . . . . . . 6-186.9 Review/Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-20

Chapter 7. Updating Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-17.1 Updating a Library Member . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2

Contents iii

7.2 Obtaining Library Member Information . . . . . . . . . . . . . . . . . . . . 7-37.3 Changing Member Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . 7-67.4 Renaming a Member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-87.5 Deleting a Member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-97.6 Review/Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-10

Chapter 8. Printing Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-18.1 Identifying What to Print . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-28.2 Determining the Print Status . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-38.3 Review/Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-4

Chapter 9. Communicating With Others . . . . . . . . . . . . . . . . . . . . . 9-19.1 Sending Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-29.2 Receiving Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-39.3 Review/Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-4

Chapter 10. Other Things You Can Do . . . . . . . . . . . . . . . . . . . . 10-110.1 Submitting and Viewing Jobs . . . . . . . . . . . . . . . . . . . . . . . . 10-210.2 Performing Data Management Tasks . . . . . . . . . . . . . . . . . . . . 10-310.3 Learning About RPF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-410.4 Executing Application Under ETSO . . . . . . . . . . . . . . . . . . . . . 10-510.5 Executing TSO Commands . . . . . . . . . . . . . . . . . . . . . . . . . . 10-610.6 Review/Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-7

Chapter 11. Learning More About CA-Roscoe . . . . . . . . . . . . . . . . 11-111.1 Online HELP Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-211.2 Online Training . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-411.3 Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-5

iv CA-Roscoe 6.0 Getting Started Guide

About This Guide

The Getting Started guide provides an introduction to CA-Roscoe fornon-programmers.

Note: The facilities described in this manual apply to Release 6.0 of CA-Roscoe.

About This Guide v

Organization

CHAPTER DESCRIPTION

1 Introduces CA-Roscoe and describes how to use this manual.

2 Describes how to sign on to CA-Roscoe and enter data.

3 Describes how to save data in the CA-Roscoe library and thensign off CA-Roscoe.

4 Describes how to display data saved in the CA-Roscoe library,detach that data and then reattach it.

5 Describes how to use PF keys and commands to scroll thedisplayed data.

6 Describes how to use primary and line commands to changedata.

7 Describes how to update data saved in the CA-Roscoe librarywith changes made to data in the AWS. Also describes how toobtain library member information and how to maintain librarymembers.

8 Describes how to print data.

9 Describes how to send messages to other users.

10 Introduces areas of CA-Roscoe that are described in detail inother manuals.

11 Describes how to obtain additional information aboutCA-Roscoe.

vi CA-Roscoe 6.0 Getting Started Guide

Summary of Revisions for this Edition

Updated the CA-Roscoe Sign-on Screen. See 2.1, “Signing On to CA-Roscoe” onpage 2-2 for more information.

About This Guide vii

Summary of Revisions

■ This manual has been updated to reflect enhancements to CA-Roscoe 6.0.

For details about these enhancements, see the 'Summary Of Amendments' in theCA-Roscoe Command Reference Guide, CA-Roscoe User Guide, and theCA-Roscoe RPF Language Guide.

■ Editorial and minor technical changes have been made throughout this manual.

viii CA-Roscoe 6.0 Getting Started Guide

CA-Roscoe Publications

The following publications are supplied with CA-Roscoe. They are divided into aUser Series and a System Series.

User SeriesName

Contents

Command ReferenceGuide

Describes all CA-Roscoe primary and line commandsand Monitor commands.

Extended DevelopmentTools Guide

Describes how: 1) the Application ProgrammingInterface (API) can be used by applications executingunder ETSO to take advantage of CA-Roscoefacilities, and 2) the interactive facilities provided bySKETCH can be used to generate and maintain panelsused in programs running under CICS or IMS.

Getting Started Guide Introduces CA-Roscoe to non-programmers.

Reference Summary Summarizes all CA-Roscoe primary and linecommands and Monitor commands.

Reference Summary (forRPF)

Summarizes all Roscoe Programming Facility (RPF)commands, functions, expressions and variables.

Release Guide Provides a summary of the enhancements included inthis release.

RPF Language Guide Describes all components of the RPF language andhow to write RPF programs. It also describes theDialog Management Facility (DMF) which can beused to develop, maintain and execute panel-drivenRPF applications.

User Guide Provides task-oriented descriptions of how to useCA-Roscoe.

About This Guide ix

System SeriesName

Contents

CA-ACTIVATOR 2.1Supplement

Presents CA-ACTIVATOR installation procedures.

Extended Facilities forSystem ProgrammersGuide

Describes how sites can make extensions to theirCA-Roscoe system. This includes creating site-writtenMonitor routines and customizing security and otheronline exits.

Installation Guide Describes the steps to follow when installing orupgrading CA-Roscoe.

Messages and CodesGuide

Explains all messages that might be received byindividuals using CA-Roscoe and/or by the individualresponsible for maintaining CA-Roscoe.

Programs and UtilitiesGuide

Describes CA-Roscoe execution requirements. Alsodescribes maintenance and reporting programs for theaccounting facility, Active Work Space (AWS), librarysystem, and user profile system.

Security AdministrationGuide

Describes implementation of internal and externalsecurity to protect your CA-Roscoe system.

System CommandsGuide

Describes commands used to control and monitorCA-Roscoe and to obtain performance informationabout that execution.

System Reference Guide Intended for the individual responsible for maintainingCA-Roscoe. It describes CA-Roscoe and itscomponents.

x CA-Roscoe 6.0 Getting Started Guide

Related Publications

The following manuals are included in the CA90s Services Documentation set:

The following manuals relate to CA-Roscoe and are available from ComputerAssociates.

Title Contents

CA90s Services Reference Guide Operating Instructions for the CA90sServices.

CA90s Services Installation andMaintenance Guide

Installation procedure and installationJCL for CA90s Services.

CA90s Services Message Guide Messages and codes for CA90sServices.

CA90s Services CA-ACTIVATOR 2.1Supplement

Proceduresa for usingCA-ACTIVATOR to install andmaintain CA90s Services.

CA90s Services CA-ACTIVATORImplementation and User Guide

Installation and upgrade instructions,and operating instructions forCA-ACTIVATOR.

CA-ViewPoint User Guide Contains information and examples forimplementing and using ViewPoint.

Title Contents

CA-Earl Reference Guide Contains detailed information aboutCA-Earl statements, parameters, andcoding rules. Also explains theCA-Earl Reporting Service.

CA-Earl User Guide Designed for users interested inlearning about CA-Earl. It presents anintroduction to CA-Earl features andcapabilities.

CA-Earl Systems Programmer Guide Lists the installation options forCA-Earl and instructions for modifyingthem. Also describes sizerequirements and program execution.

CA-Earl Examples Guide Contains sample programs that show avariety of common applications.

About This Guide xi

CA90s Services

CA90s Services are a common set of services that may be used by any MVSComputer Associates product. These services are maintained separately from theproduct and are documented and installed separately as well. CA-Roscoe usesCAIRIM for installation services and security.

Licensing Management Program (LMP)

CA-Roscoe now interfaces with CAIRIM services to determine product licensingauthorization.

xii CA-Roscoe 6.0 Getting Started Guide

Command Notation

The command syntax described in this manual uses the following notation conventions:

Lowercase alphabetics are shown as:

[ ] Indicates optional keywords, operands or parameters from whichyou may select one or none.

{ } Indicates required keywords, operands or parameters from whichyou must select one.

UPPERCASE Identifies command, operand or keyword values which must becoded exactly as shown.

Mixed Cases Identifies command, operand or keyword abbreviations. Theuppercase letters are the minimum abbreviation. Lowercaseletters are optional.

underline Indicates a default value that you need not supply.

lowercase Indicates a variable for which a value must be supplied.

aname Name of an AWS.

charstr Any sequence of printable entities specified in character format.

If it is shown as /charstr/, the string must be bound by a specialcharacter and may include blanks. The special characterdelimiting the string and the special character used as thecommand delimiter cannot appear within the string itself.

context Keyword operand that identifies the type of string specified withthe command (qualifying the type of search operation to beperformed).

dsn Name of an OS data set or CA-Librarian master file.

dsnmem Name of a PDS member or CA-Librarian master file module.

expr (RPF only.) One or more elements and associated operators.

i Increment value used for determining line numbers.

int (RPF only.) Integer or a variable whose value can be convertedinto an integer.

l Length of a string or field.

mem Name of a CA-Roscoe library member. If the member belongsto another user, that user's prefix must be included (for example,pfx.mem).

n Line number.

About This Guide xiii

o Destination of an operation, which can be represented using anyof the following forms:

* Line at which the pointer is positioned.

B or ,, After the last line of an AWS.

R Replaces the contents of the AWS. (Thisdestination/operation is not valid with all commands.)

T Before the first line of the AWS.

v Specific line number in an AWS. If the numberexists, the destination is after line v. If the linenumber does not exist, the destination begins with linev.

-p Processing option specified with Monitor commands.

p q Range of lines, where p is the line at which the operation beginsand q is the line at which the operation ends.

If p is a line number, q must also be a line number. If p is an *(indicating line at which pointer positioned), q must be a linecount.

If q is omitted, the operation is limited to p If p and q areomitted, all lines are assumed.

position Keyword operand designating the screen position that is tooccur when a string match is found. If omitted, the positioningcurrently in effect is used. If specified, the positioning affectsthe single execution of the command.

real (RPF only.) Real number or a variable whose value can beconverted into a real number.

s e Range of columns, where s is the number of the column atwhich the operation begins and e is the number of the columnat which the operation ends.

If only one value is specified, it is assumed to be the endingcolumn (e).

s l Range of columns, where s is the starting column number of therange and l is the length of the range.

If only one value is specified, it is assumed to be the startingcolumn (s).

scope Keyword operand designating the location of the data to beaffected by the command. If omitted, the currently attacheddata is assumed.

str (RPF only.) String or a variable whose value can be convertedinto a string.

xiv CA-Roscoe 6.0 Getting Started Guide

string Any sequence of entities specified in either character format orits hexadecimal representation.

If shown as /string/, the string must be bound with a specialcharacter. The special character delimiting the string and thespecial character used as the command delimiter cannot appearwithin the string.

v Numeric value.

About This Guide xv

xvi CA-Roscoe 6.0 Getting Started Guide

Chapter 1. Introducing CA-Roscoe

Before describing how to use CA-Roscoe, let's discuss what CA-Roscoe is.

CA-Roscoe is an extremely powerful online program development and maintenancesystem. It consists of three major components:

The TerminalThis is where you view data and enter commands that tell CA-Roscoewhat task(s) you want to perform.

The AWS (Active Work Space) This is the name of a temporary work area thatis made available for your text that you enter and edit. While most ofthe text you will be entering and viewing is less than the width of theterminal screen, the AWS can contain lines that are a maximum of 255characters in length.

While you can actually use multiple AWSs (a minimum of two AWSsare available for your use), we will only discuss how you work withthe one that is currently active.

CA-Roscoe LibraryThis is a permanent storage area in which you can save the text youhave been working on in the AWS.

As you read through this manual, you will learn how to enter data in the AWS, savethat data as a member in the CA-Roscoe library, retrieve that member and makechanges to the data it contains. Based on the material you read, you will be asked toperform certain tasks. The tasks will be presented in the form,

Type -> task

where 'TYPE' means that you are to perform an action and 'task' identifies the text orCA-Roscoe command that is to be used. To assist you in distinguishing text fromcommands, the text is shown in uppercase and lowercase. Commands are shown inupper- case and, when appropriate, include any allowed abbreviations.

As you are asked to use different CA-Roscoe commands, you will discover that theyare easy to use and remember since their names indicate the type of action theyperform. With them, you can COPY, DELETE, PRINT and SAVE whatever you havetyped.

While we will be describing many tasks you can perform with CA-Roscoe, we willnot be describing:

Chapter 1. Introducing CA-Roscoe 1-1

■ Every CA-Roscoe command. For a synopsis of all CA-Roscoe commands, see theReference Summary. For a detailed description of each command, see theCA-Roscoe Command Reference Guide.

■ Every type of task that can be performed using CA-Roscoe. The chapter "OtherThings You Can Do" contains a brief description of the types of tasks that are notdescribed within this manual.

This manual is written under the assumption that you have:

■ Used a 3270-type terminal before.

If you have not, ask someone at your site to explain the various hardware editingkeys (particularly the keys to insert and delete data), the cursor positioning keys,the ENTER key, and the PF keys.

■ A sign-on key.

If you do not, ask your site management what sign-on key you should use. Alsoask whether or not that sign-on key has a password associated with it. If it does,you will need to know the password.

It is also useful if you have a copy of the CA-Roscoe User Guide. That book providesdetailed information about the AWS, CA-Roscoe library, OS data sets, job output andgeneral session information. We will be referring you to that book to find additionalinformation about specific topics.

1-2 CA-Roscoe 6.0 Getting Started Guide

Chapter 2. Signing On and Entering Data

In this chapter, we will be describing:

■ How to sign on to CA-Roscoe,■ What the CA-Roscoe screen looks like, and■ How to enter data using both primary commands and line commands.

Chapter 2. Signing On and Entering Data 2-1

2.1 Signing On to CA-Roscoe

2.1 Signing on to CA-Roscoe

The following screen illustrates what the CA-Roscoe sign-on screen looks like. If it isnot displayed at the terminal you are using, ask your site management what you needto do to display it.

CA-Roscoe Sign-on Screen

| �| �

| >APPLID(A�4IROS3)

| >

| ....+....1....+....2....+....3....+....4....+....5....+....6....+....7

| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||

| |||| |||||||

| |||| |||||||

| |||| KEY _ DATE �9/25/�1 |||||||

| |||| PASSWORD TIME 14.35.49 |||||||

| |||| GROUP CODE TERMID A�1IX�17 |||||||

| |||| NEW PASSWORD > |||||||

| |||| > (Repeat for verification) |||||||

| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||

| |||||||| ||||| ||||| ||| ||| ||||| |||||

| ||||||| || |||| || ||||| ||||||||| |||||| || ||||| ||||||||||

| ||CA-| || |||| || ||||| ||||||||| |||||| || ||||| |||||||||||

| ||||| |||| || ||||| ||| |||||| || ||||| ||||||||

| |||| ||| |||| || ||||||||||| ||| |||||| || ||||| ||||Ver 6.�||

| ||| ||| ||| || ||||||||||| ||| |||||| || ||||| ||||Glvl �11�|

| || ||| ||| ||| ||| || ||||| ||||SP�3|

| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||

| |||| COPYRIGHT (C) 1994 COMPUTER ASSOCIATES INTERNATIONAL, INC. ||||||

| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||

| 9| :

Type your sign-on key in the field named KEY. (The cursor is already positionedthere.) If you have a password, move the cursor to the field named PASSWORD andtype your password.

The fields GROUP CODE and NEW PASSWORD can be used to provide additionalsign-on security. We are going to ignore them. Your site management will tell you ifthese fields need to be used.

After typing your sign-on key (and password, if needed) press the ENTER key. Thefollowing screen illustrates the next screen that you will see.


2.1 Signing On to CA-Roscoe

CA-Roscoe Screen - With No Data Attached

� �

_

>

>

....+....1....+....2....+....3....+....4....+....5....+....6.

A site-written message may appear in this space.

9 :

The cursor is positioned to the first line of the Command Area. By default, theCommand Area consists of the first three lines of the screen. (There is a commandthat you can use to change the number of lines in the Command Area.) This is whereyou will enter all CA-Roscoe primary commands.

The next three lines comprise the System Control Area. CA-Roscoe uses these linesto provide information.

■ The first line (beginning with a >) is the Response Line. It is used to displaymessages. To illustrate, make sure the cursor is in the Command Area and then,

Type -> XXX

Press the ENTER key.

CA-Roscoe displays the message:

CMD�4 COMMAND NOT RECOGNIZED

and positions the cursor to the 'command' in error - xxx in this case. You cannow correct the command, change it or delete it. (As a matter of fact, please usethe ERASE EOF key to delete xxx.)

■ For now, we will ignore the second line beginning with a >.

■ The third line is called the Scale Line. It reflects the margins currently in effect.You can use it to determine the exact position of a character within a255-character line.

The remaining lines of the screen are called the Execution Area. This is where youwill enter, edit and display data.


2.2 Entering Data

2.2 Entering Data

Before you enter any data, let's talk about CA-Roscoe commands. CA-Roscoesupports:

■ Primary Commands. These are commands you enter in the Command Area of thescreen (for example, the first three lines of the screen).

■ Line Commands. These are commands that you enter in the Execution Area (forexample, the lower portion of the screen.)

The easiest way to understand these command types is to use them. So, we're goingto enter data using first primary commands and then line commands.

2.2.1 Using Primary Commands

To use primary commands, make sure that the cursor is in the Command Area of thescreen. You can then use the INPUT command to tell CA-Roscoe that you want toenter data.

Type -> INPUT or I


CA-Roscoe 'opens' the Execution Area for data entry and moves the cursor to the firstline of this Area. You are now ready to enter data.

The data consists of a series of one-line definitions. After typing a definition, use theNew Line key to position the cursor to the beginning of the next line.

Type -> A: Able. B: Baker.

C: Charlie.

D: Dog.


Before going any further, let's take a look at the screen as illustrated on 2-5

First, look at the definitions you have just typed. Your site management has theoption of designating whether the information you enter will be kept in the form youtyped it (for example, uppercase and lowercase) or will be converted to uppercaseonly. Most sites use the default which causes what you type to be converted touppercase characters. If your site is using the default and you want to prevent thisconversion from occurring,

Type --> SET MODE XTENDED

Press the ENTER key. (Everything you enter from this point on will not be convertedto uppercase.)


2.2 Entering Data

CA-Roscoe Screen - With AWS Attached

� �

>

> AWS() SCRL FULL COLS ��1 ��72 A<ROS1>

> ....+....1....+....2....+....3....+....4....+....5...

...... ============================= T O P =================

��1�� A: Able.

��2�� B: Baker.

��3�� C: Charlie.

��4�� D: Dog.

...... ========================== B O T T O M ==============

9 :

Notice the information appearing on the second line containing an >. This line iscalled the System Information Line. It tells you:

■ The location and name of the data.

In this example, it shows the keyword AWS followed by (). This means that theinformation you typed has been placed in the AWS. The () means that theinformation is unnamed.

■ How the display will be scrolled.

FULL means that if you press a PF key that is assigned a scrolling function, yourdisplay will scroll forward or backward one line less than a full screen of data.You can change the scroll value by positioning the cursor to the SCRL field andtyping:

number To scroll that number of lines,HALF To scroll half the display,MAX To scroll to the top or bottom of the AWS, orCSR To scroll based on the position of the cursor.

■ The number of the currently displayed left and right margins.

You can change the display margins by:

1. overtyping the column numbers shown in this field, or

2. using the SET DISPLAY command.


2.2 Entering Data

■ The name of the AWS that is active.

While we will only be using one AWS with the exercises in this manual, you havetwo AWSs available for your use. They are named ROSn (where 'n' is a uniqueidentifier). By site option, you may be able to create and use additional AWSs.

Notice also that the Execution Area contains lines marking the top and bottom of thedata. Later, when we talk about scrolling data, you will see how these markers areuseful as reference points.

Right now, there is not much data to scroll. So let's add more data to the AWS.

If you want to add information to the end of the AWS, you can again use the INPUTcommand. When information is already in the AWS and you type INPUT, CA-Roscoemakes the last line in the AWS the first displayed line, 'opens' the Execution Area andpositions the cursor to the first line available for data entry.

If the cursor is not in the Command Area, move it there and then,

Type -> INPUT or I


The resulting display starts with line 400. The cursor is placed at the first data entryline (for example, 500). You are now ready to enter more data.

Type -> E: Easy. F: Fox.

IIIIIIIIII


If you want to add information after a specific line, you can do so by specifying thatline number with the INPUT command. For example, to add data after line 500, movethe cursor to the Command Area and,

Type -> INPUT 5�� or I 5��


Type -> T: Tango. Z: Zebra.


The screen 'closes' and the display begins with line 500. You can use a PF key toscroll the display back to the beginning (for example, line 100). (While it may bedifferent at your site, PF7 is the key normally assigned the scroll backward function.)The following screen illustrates how your screen should appear.


2.2 Entering Data

Notice the sequence numbers to the left of the screen. By default, CA-Roscoenumbers the AWS beginning with 100 and incremented by 100. When you insert dataat the end of the AWS, the line number increment of 100 is still used. However, ifyou insert data between existing lines, CA-Roscoe increments the new lines by ones.This is done to minimize changes to your existing line numbers.

After Using INPUT COMMAND

� �

>


> ....+....1....+....2....+....3....+....4....+....5...

...... ============================= T O P =================

��1�� A: Able.



��4�� D: Dog.

��5�� E: Easy.

��5�1 T: Tango.

��5�2 Z: Zebra.

��6�� F: Fox.

��7�� IIIIIIIIII

========================== B O T T O M ==============

9 :

2.2.2 Using Line Commands

You can always enter primary commands in the Command Area of the screen. Sites,however, have the option of designating whether line commands can be used whenyou first sign on to CA-Roscoe. Most sites do enable this facility. You can tell if it isenabled by looking for six periods in the sequence number field to the left of the TOPand BOTTOM markers (as illustrated in the previous screen). If the periods are notthere, you can use the primary command SET DISPLAY to enable this facility. To doso, move the cursor anywhere within the Command Area of the screen and,

Type -> SET DISPLAY NUMX


Now, suppose you want to add a few more lines to the AWS. One way you can dothis is with the I and IB line commands. Unlike primary commands (such as INPUT)which are typed in the Command Area, line commands are typed in the sequencenumber field of the Execution Area.

Position the cursor anywhere within the sequence number field of line 400 and,

Type -> I


2.2 Entering Data

Now move the cursor to the sequence number field of line 600 and,

Type -> IB5

The following screen shows the I and IB line commands before the ENTER key ispressed.

Using I and IB Line Commands

� �

>


> ....+....1....+....2....+....3....+....4....+....5...

...... ============================= T O P =================

��1�� A: Able.



I��4�� D: Dog.

��5�� E: Easy.



IB56�� F: Fox.


========================== B O T T O M ==============

9 :


With the I line command, a blank line is inserted immediately after the line containingthe command. With IB, the blank line is inserted before the line containing thecommand.

To insert more than one line, specify a number with the command. (Notice that IB5causes five lines to be inserted before line 700.) If you do not type on all of theinserted blank lines, the unused lines are deleted when you press ENTER.

On the inserted line following line 400,

Type -> X: X-ray.

On the inserted lines preceding line 600,

Type -> V: Victor. S: Sierra.


Notice that the unused lines have been deleted from the display.


2.3 Review/Summary

2.3 Review/Summary

In this chapter, you have learned:

■ How to sign on to CA-Roscoe.■ The format of the CA-Roscoe screen.■ That CA-Roscoe supports both primary and line commands.■ How to use primary and line commands to enter data into the AWS.

You now know that the data you type in the Execution Area of the CA-Roscoe screenis placed in the AWS when you press the ENTER key. The AWS, which is atemporary work area, is the only place where data can be entered and edited.

Table 2-1 shows the title of the chapter in the CA-Roscoe User Guide where you canget additional information about the topics discussed in this chapter.

The CA-Roscoe Command Reference Guide contains a detailed description of thecommands described in this chapter.

In the next chapter, you will learn how you can save the data you have in the AWS inthe CA-Roscoe library.

Table 2-1. Summary: Signing On and Entering Data

TOPIC CHAPTER

AWS Introducing the AWS

Entering Data Entering Data into the AWS

Screen Format Selecting a Screen Format

Signing On plusEstablishing and ChangingPasswords

Signing On and Off CA-Roscoe

Primary and Line Commands Commands and Command Components


Chapter 3. Saving Data and Signing Off

In this chapter, you will learn about:

■ Saving the information in your AWS as a member in the CA-Roscoe library.

■ Signing off CA-Roscoe.

Chapter 3. Saving Data and Signing Off 3-1

3.1 Introducing the CA-Roscoe Library

3.1 Introducing the CA-Roscoe Library

Suppose you have been sitting at your desk writing a memo and you now want to fileit for future reference. You might: 1) place the material in a file folder on which youhave written a meaningful name and then 2) give the folder to a file clerk whoimmediately places the folder in a file cabinet.

The CA-Roscoe library can be compared to that file cabinet. It is the place where youpermanently store the information you have been working on in the AWS. Whenusing CA-Roscoe, you place your information in a 'member' (comparable to the filefolder) to which you assign a name. CA-Roscoe then acts as your file clerk placingthe member in the library.

Just as other people can have folders placed in a file cabinet, so other users can savemembers in the CA-Roscoe library. To ensure that your members are kept separatefrom other users' members, CA-Roscoe automatically assigns your 2- or 3-characterprefix to whatever member name you specify. (Your site management assigns aunique prefix to each CA-Roscoe sign-on key. When you sign on, CA-Roscoe knowsthe prefix associated with your key and uses it whenever you create or reference oneof your library members.)


3.2 Saving Data

3.2 Saving Data

Now that you have entered information into the AWS, you have the option of saving itin the CA-Roscoe library. To do this, all you need enter is the primary commandSAVE and the name you want to assign to the new library member. (This iscomparable to writing a name on a file folder before placing the folder in a filecabinet.) The name must be 1- to 8-characters in length and begin with an alphabeticcharacter. To save the data in the AWS as the library member named WORDS,

Type -> SAVE WORDS or S WORDS


Notice that your library member name now appears in the parentheses following theAWS keyword on the System Information Line. The member name is preceded byyour prefix. (In the following screen your prefix is represented as 'pfx'.)

Saving Data

� � _

>

> AWS(pfx.WORDS) SCRL FULL COLS ��1 ��72

> ....+....1....+....2....+....3....+....4....+....5...

...... ============================= T O P =================

��1�� A: Able.



��4�� D: Dog.

��4�1 X: X-ray.

��5�� E: Easy.



��6�� V: Victor.

��6�1 S: Sierra.

��6�2 F: Fox.


...... ========================== B O T T O M ==============

9 :


3.3 Signing Off

3.3 Signing Off

Now that you have saved your data, you can sign off CA-Roscoe. To do this, movethe cursor to the Command Area and

Type -> OFF

But suppose you type the OFF command before you save your data.

CA-Roscoe checks the contents of the AWS when you sign off. If the AWS containsdata, it is automatically saved in a member (associated with your prefix) namedSAVAWSnn (where 'nn' is a unique identifier). When you sign back on toCA-Roscoe, you can retrieve this member.


3.4 Review/Summary

3.4 Review/Summary


■ About the CA-Roscoe library.■ How to save data in the AWS as a member on the CA-Roscoe library.■ How to sign off CA-Roscoe.■ About the special library member named SAVAWSnn.

You now know how to save data that is in the AWS as a member in the CA-Roscoelibrary. You know that the name to assign to that member will always be uniquebecause CA-Roscoe associates your prefix with the name. You also know that if youforget to save the contents of the AWS before you sign off, CA-Roscoe will save thecontents for you.

Table 3-1 shows the title of the chapter and/or section in the CA-Roscoe User Guidewhere you can get additional information about the topics discussed in this chapter.


Table 3-1. Summary: Saving Data and Signing Off

TOPIC CHAPTER

CA-Roscoe Library Introducing the Library Facility

Saving Data Saving Data as a Library Member

Signing Off Signing On and Off CA-Roscoe


Chapter 4. Retrieving and Displaying Data

In this chapter, you will learn about:

■ Attaching a library member so that you can look at its contents.■ Bringing a copy of a library member into the AWS.■ Detaching and reattaching a library member and the AWS.

If you have signed off CA-Roscoe, please sign back on.

Chapter 4. Retrieving and Displaying Data 4-1

4.1 Displaying Data

4.1 Displaying Data

You can use the ATTACH command* to look at the contents of your library membernamed WORDS.

Type -> ATTACH WORDS or A WORDS


The following screen illustrates the first few lines of the resulting display.

Attached Library Member

� � _

>

> LIB(pfx.WORDS) SCRL FULL COLS ��1 ��72

> <...+....1....+....2....+....3....+....4....+....5....

================================= T O P ==============

��1�� A: Able.


9 :

Notice that the System Information Line now begins with the keyword LIB. Thismeans that you are looking at the contents of a member in your library. (As with thekeyword AWS, LIB is followed by the prefixed name of your library member.)

Note: The chapter 'Updating Data' describes another way that you can view a librarymember.

Try to move the cursor to the Execution Area of the screen.

When a library member is attached, you can look at its contents, use PF keys to scrollthrough the contents, and enter a variety of commands to locate specific occurrences ofwords within the contents. You cannot modify the contents of the library memberYou can only modify the contents of the AWS. Therefore, to change a member, youmust first bring a copy of it into the AWS.


4.2 Displaying Data to Modify

4.2 Displaying Data to Modify

To change the contents of a library member, you must first bring a copy of it into theAWS. You must then attach the AWS to see its contents.

To bring a copy of your library member named WORDS into the AWS,

Type -> FETCH WORDS or F WORDS

You do not have to include your prefix when you are FETCHing a copy of one ofyour own library members. If you do not include a prefix, CA-Roscoe assumes youare referring a library member that you own. Obviously then, when you referencesomeone else's library member, you must include their prefix (for example, FETCHXYZ.WORDS).


Notice that the System Information Line still shows LIB, indicating that your librarymember is attached, even though you have brought a copy of that member into theAWS. To view the contents of the AWS, you must connect (or attach) the AWS toyour terminal. To do this,

Type -> ATTACH or A


Now the System Information Line shows that the AWS is attached. The AWS willremain attached until you detach it.


4.3 Detaching and Reattaching Data


You can detach the AWS or a library member either explicitly or implicitly.

The DETACH command explicitly releases whatever is attached. To use thiscommand,

Type -> DETACH or DET


Notice that the contents of the AWS is no longer displayed. To reattach the AWS,

Type -> ATTACH or A


You can implicitly release attached data by using any other command that causesoutput to the Execution Area. For example, the AWS is automatically detached whenyou attach a library member for display.

Type -> ATTACH WORDS or A WORDS


The library member named WORDS is now attached. (Notice the keyword LIB on theSystem Information Line.) The data you brought into the AWS is still there. It is notdisplayed because the AWS is not attached. To reattach the AWS,

Type -> ATTACH or A


The resulting display begins with the first line of the AWS.

Using Special CA-Roscoe Reserved Characters

When attaching or reattaching the AWS or a library member, you can begin thedisplay with a specific line by including that line number with the command. Forexample, to attach the AWS and begin the display of its contents with line 500,

Type -> ATTACH 5��,, or A 5��,,

The double commas have a special meaning to CA-Roscoe; they represent the last linein the AWS or the library member. If you omitted them (for example, if you typedATTACH 500), only the line numbered 500 would be displayed.


Another character that has a special meaning to CA-Roscoe is the asterisk (*). Youcan use it when reattaching data to have the display begin with the line that had been



the previously displayed first line. To illustrate how this works, first detach the AWS.(You can do this using either the DETACH command or by attaching your librarymember WORDS.)

Now, to reattach the AWS,

Type -> ATTACH 1,, or A 1,,


Notice that the display begins with line 500, the same line that had previously beenthe first line of the display.


4.4 Review/Summary

4.4 Review/Summary

In this chapter, you have learned how to:

■ Attach a library member.

■ FETCH a copy of a library member into the AWS and the ATTACH the AWS tothe terminal.

■ Detach and reattach a library member and the AWS.

■ Use special CA-Roscoe reserved characters.



In the next chapter, you will learn how you can scroll through the data in the AWS.

Table 4-1. Summary: Retrieving and Displaying Data

TOPIC CHAPTER

Attaching the AWS Attaching an AWS to the Terminal

Attaching library members Attaching Library Data at the Terminal

Bringing data into the AWS Attaching an AWS to the Terminal

Reattaching the AWS Attaching an AWS to the Terminal

Using Reserved Characters Commands and Command Components


Chapter 5. Scrolling Through Data

This chapter describes how you can use:

■ PF keys to scroll through attached data.■ Primary and line commands to reposition the display of data within the AWS.

Chapter 5. Scrolling Through Data 5-1

5.1 Using PF Keys to Scroll

5.1 Using PF Keys to Scroll

If you are using a terminal with a 24-line screen, you have typed more definitions thancan be displayed in a single screen.

You can use PF keys to scroll through whatever data is currently attached (forexample, the contents of the AWS or a library member). Table 5-1 shows the defaultscrolling functions that are assigned to PF keys.

By default, a list of all PF and PA key assignments is assigned to PA2. If you pressthis key, a list of assignments will be displayed.

Your site management has the option of changing any PF or PA key assignment. Ifthey have done so, they will have updated the information provided by PA2.

Table 5-1. PF Keys Used For Scrolling

KEY ASSIGNMENT

PF7 or PF19 Scroll backward (for example, towards the top of thescreen).

PF8 or PF20 Scrolls forward (for example, towards the bottom of thescreen).

PF9 or PF21 Scroll the display to the left.

PF10 or PF22 Scroll the display to the right.


5.2 Using Commands to Scroll

5.2 Using Commands to Scroll

You can use a primary command to reposition the display of data you are viewing.

Type -> POINT LINE 5��


The resulting display will begin with line 500. There are a number of line commandsyou can use to scroll through the contents of the AWS. You can scroll the display:

■ To begin with a specific line number. Try this. Place the cursor in the sequencenumber field of line 200 and,

Type -> 3�


■ Positionally. Move the cursor to the sequence number field of line 60 and,

Type -> 1


You can also position the display to begin a specified number of lines before orafter the positionally referenced line. For example, if you typed *+5 on line 500,the next display would begin with the line that is five lines after line 500; *-5would cause the display to begin with the line that is five lines before line 500.

■ By page (for example, the number of lines in the display). With +P, the displaypositions forward one page; -P positions the display backward one page. Try thiscommand. Move the cursor to the sequence number field of line 60 and,

Type -> -P


Since there is less than a full page, the resulting display scrolls back to thebeginning of the AWS.

If you specify a number with either of these commands, you will scroll thatnumber of pages forward or backward (that is, +P5 scrolls five pages forward).

■ To the top or bottom of the AWS. Use T+ to scroll to the top of the AWS and B-to scroll to the bottom. In the sequence number field of any line,

Type -> T+ or B-


By including a number with the command, you can position the display to beginthat number of lines after the top (for example, T+5) or before the bottom (that is,B-5).


5.3 Review/Summary

5.3 Review/Summary


■ How to use the PF keys to scroll through attached data.

■ How to use the POINT command and a variety of line commands to scrollthrough the contents of the AWS.



In the next chapter, you will learn how you can use primary and line commands tomodify the data that is in the AWS.

Table 5-2. Summary: Scrolling Through Data

TOPIC CHAPTER

PF Key Assignments Using/Customizing PF/PA Keys

Scrolling Attaching an AWS to the Terminal


5.3 Review/Summary


Chapter 6. Modifying Data

This chapter describes how you can use multiple primary and line commands andcorrect any invalid or incomplete command. It also describes commands that let you:

■ Use multiple commands,■ Rearrange and delete the contents of the AWS,■ Search for specific words within the AWS, and■ Change one or more occurrences of those words.

Chapter 6. Modifying Data 6-1

6.1 Using Multiple Commands

6.1 Using Multiple Commands

If you have signed off, please sign back on.

Remember that to use line commands and to have your data kept in the form in whichyou enter it, the primary commands SET DISPLAY NUMX and SET MODEXTENDED must be in effect.

Note: These commands, described in Section 2.2, are just two of the commands thatyou can use to customize your CA-Roscoe session. Other session-relatedcommands allow you to change the display margins, set tab positions, changethe number of lines in the Command Area, etc.

You can execute multiple commands either by typing each command on a separate linein the Command Area, as in:

SET DISPLAY NUMX

SET DISPLAY XTENDED

or by typing them on a single line, separated by a command delimiter. The ampersand(&) is the default command delimiter. It tells CA-Roscoe where one command endsand other begins, as in:

SET DISPLAY NUMX & SET MODE XTENDED

In the chapter on entering data, one of the exercises asked you to enter two linecommands on different lines of the same screen. As you may have guessed, you canenter one or more primary and line commands on the same screen. When you do,CA-Roscoe records any changes you made to the data in the Execution Area and thenexecutes first the line commands and then the primary commands.


6.2 Correcting and Changing Commands


If you enter an invalid or incomplete primary command, CA-Roscoe displays amessage on the Response Line and positions the cursor to the command in error. Anycommands following the invalid or incomplete command are not executed.

The following screen illustrates what happens if you attempt to FETCH and ATTACHa library member without specifying its name.

Changing Invalid or Incorrect Primary Commands

� �FETCH

ATTACH

> CMD13 INSUFFICIENT NUMBER OF OPERANDS SPECIFIED


> ....+....1....+....2....+....3....+....4....+....5...

...... ============================= T O P =================

��1� IIIIIIIIII

��2� B: Baker.

��3� C: Charlie.

��4� D: Dog.

9 :

At this point, you can correct the command in error, change it or delete it. You canchange, add or delete any commands that follow the corrected command. You caneven insert commands ahead of the corrected command.

The following screen illustrates what happens if you enter an invalid or incompleteline command.



Changing Incorrect or Invalid Line Commands

� �

>


> ....+....1....+....2....+....3....+....4....+....5...

...... ============================= T O P =================




XX�4�� <<< ATX�1 INVALID COMMAND >>> ��4�1 X: X-ray.

��5�� E: Easy.





��6�2 F: Fox.

9 :

If you should enter an invalid or incomplete line command, CA- Roscoe displays amessage and halts processing. No changes to the data are applied; no line commandsare executed; no primary commands are executed.

To correct the command in error, you can: 1) overtype it with a valid line command,2) blank out the sequence number field using the Delete key, the Erase EOF key, orthe space bar, or 3) use the RESET line command.

You can use the RESET line command to have CA-Roscoe ignore: 1) all of thecurrently displayed line command (and any pending line commands), and 2) anychanges made to the currently displayed data.


6.3 Moving Data Within the AWS


Assume that the definitions you have entered so far are supposed to be in alphabeticorder. Several of them are not. CA-Roscoe provides both a primary command andseveral line commands that you can use to move one or more lines from one locationto another within the AWS.

6.3.1 Using a Primary Command

When you move lines within the AWS, you must always designate:

■ The line or lines of data to be moved, and

■ The line at or after which the data is to be inserted. You can specify thisdestination as a line number or the positional expressions T (meaning before thefirst line of the AWS) or B (meaning after the last line of the AWS).

To move line 502 to the top of the AWS,

Type -> MOVE 5�2 T or M 5�2 T


To move multiple lines within the AWS, you must specify the number of the first andlast line in the range. For example, to move the definitions from B to D after thedefinition of T,

Type -> MOVE 2�� 4�� 5�1 or M 2�� 4�� 5�1


Notice the line numbers. When data is inserted between existing lines, CA-Roscoeincrements the inserted lines by ones.


You are now going to use line commands to perform the same tasks you did with theMOVE primary command. Please bring a fresh copy of the member WORDS into theAWS.

Type -> FETCH WORDS or F WORDS


You did not have to use the ATTACH command since the AWS is already attached toyour terminal.



As with the primary command, you must designate which lines are to be moved andthe line where they are to be inserted. The move line commands require that you usespecific destination line commands. Table 6-1 lists some of the destination linecommands.

To move the line numbered 501 to the top of the AWS, position the cursor to thesequence number field of line 501.

Type -> M

Now indicate the destination by moving the cursor to the sequence number field of thenext line.

Type -> TT


To move a range of lines, use the MM line commands. Place MM in the sequencenumber field of the first and last line in the range.

Table 6-1. Destination Line Commands

COMMAND FUNCTION

B To insert before the line containing the command.

A To insert after the line containing the command.

BB To insert after the last line of the AWS.

TT To insert before the first line of the AWS.



The following screen illustrates how you could move lines 1 and 100 after line 200.

Moving Multiple Lines

� �

>


> ...1....+....2....+....3....+....4....+....5....+....

...... ============================= T O P =================

MM��1 T: Tango.

MM�1�� A: Able.

A��2�� B: Baker.


��4�� D: Dog.

��4�1 X: X-ray.

��5�� E: Easy.




��6�2 F: Fox.

9 :

Do the move operation illustrated in the previous screen. Move the cursor to thesequence number field of line 1.

Type -> MM

Now move the cursor to line 100.

Type -> MM

Finally, move the cursor to line 200.

Type -> A



6.4 Copying Data Within the AWS


Move operations are referred to as destructive because data is removed from one placewhen it is inserted in another. Copy operations are not destructive since the linesbeing copied are not deleted from their original location.


As when moving data, you must designate what line or lines are to be copied andwhere the line(s) are to be placed. For example, to copy the last line of the AWS tothe top of the AWS,

Type -> COPY 6�2 T or C 6�2 T

Notice that you are again using T to indicate that the destination of this operation isthe top of the AWS. When specifying a destination, you can use a line number or thepositional expressions T (meaning the top of the AWS) or B (meaning the bottom.)


To copy multiple lines, you need to include the number of the first and last line to becopied plus the destination of the operation. For example, to copy lines 300 through500 after line 600,

Type -> COPY 3�� 5�� 6�� or C 3�� 5�� 6��



To copy one line, place the C line command in the sequence number field of the lineto be copied. Then place a destination line command in the sequence number field ofthe appropriate line. (The copy and move line commands use the same destinationline commands.) For example, to place a copy of line 400 after line 200, move thecursor to line 400 and in the sequence number field,

Type -> C

Now move the cursor to the sequence number field of line 200 and,

Type -> A




There are also line commands that allow you to repeat one or more lines afterthemselves. For example, suppose you have a second definition for 'D'. You couldinsert a blank line and then type your new definition. However, if you use the R linecommand, you can repeat the existing line and then modify it as needed. In thesequence number field of line 400,

Type -> R


Now, on line 401, overtype the definition 'Dog' with 'Delta'.



6.5 Deleting Data From the AWS


As the result of your copy operations, you now have duplicate lines in the AWS. Youcan use either primary or line commands to remove these lines.

6.5.1 Using Primary Commands

You can use the DELETE command to remove one or more lines from the AWS. Ifyou specify DELETE with just one line number, only that line will be deleted. Toillustrate, move the cursor to the Command Area,

Type -> DELETE 4�1 or DEL 4�1


If you specify DELETE with two line numbers, the range of lines beginning with thefirst number and ending with the second is deleted. (Note: If you specify DELETEwith no line numbers, the entire contents of the AWS is deleted.)




If you type the D line command in the sequence number field of a line, that line willbe removed from the AWS when the ENTER key is pressed.

If you type a DD line command in the sequence number field of one line and thenanother DD line command in the sequence number field of a different line, all of thelines encompassed by the two line commands will be deleted when you press theENTER key.

To illustrate, move the cursor to the sequence number field of line 601,

Type -> DD

Now move the cursor to the sequence number field of line 602,

Type -> DD


Lines 601 through 602 have been deleted.


6.6 Renumbering the AWS

6.6 Renumbering the AWS

Notice what has happened to the line numbers while you have been inserting, moving,copying and deleting lines. They are no longer numbered sequentially by 100. Torenumber the contents of the AWS, move the cursor to the Command Area,

Type -> RENUMBER or R


You can renumber the AWS at any time during your terminal session. As you know,entering RENUMBER with no operands causes the AWS to be renumbered by 100.You can renumber using a different starting value and increment. For example, tohave the lines in the AWS number by tens,

Type -> RENUMBER 1� 1� or R 1� 1�



6.7 Locating Specific Words Within the AWS


There are a number of commands you can use to locate and display one or moreoccurrences of a string of characters within the AWS. We're using the term 'string'instead of 'word' because you can look for one or more words. In fact, you can lookfor any arrangement of characters, even those including spaces.

6.7.1 Locating All Occurrences

You can use the INCL or EXCL primary or line commands to display all linesincluding or excluding a specific character string. For example, to use the INCLprimary command to display all of the lines that contain the string 'ra', move the cursorto the Command Area,

Type -> INCL ra


The following screen illustrates what the resulting display will look like:

Display Produced by INCL Primary Command

� �

> AWS�7: LINES 1� THRU BOTTOM SEARCH WITH 3 MATCHES


> ....+....1....+....2....+....3....+....4....+....5....+.

...... ======================= INCL/EXCL DISPLAY ==============

��5� X: X-ray.

��8� Z: Zebra.

��1�� S: Sierra.

9 :

Notice that the cursor is positioned to the first occurrence of the string.

When using the INCL or EXCL line command, the command is typed in the sequencenumber field of the first line to be searched. Then, the character string is typed in thedata portion of the same line.



Use a PF key assigned a scroll function or the ATTACH command to position thedisplay to begin with the first line in the AWS. Move the cursor to the sequencenumber field of line 10.

Type -> EXCL

Now move the cursor to the data portion of the same line.

Type -> /ra/

When you type a string in the data portion of a line, you need to tell CA-Roscoewhere your string starts and stops. You do this by bounding the string with a specialcharacter, called a string 'delimiter'. In our examples, we use the slash (/) to delimitcharacter strings. (After you execute this command, the data that you overtyped isredisplayed.)

The following screen illustrates how this line command and its string operand shouldbe entered:

Using the EXCL Line Command

� �

>


> ....+....1....+....2....+....3....+....4....+....5...

...... ============================= T O P =================

EXCL /ra/IIIIII



��4� D: Dog.

��5� X: X-ray.

��6� E: Easy.

��7� T: Tango.


��9� V: Victor.


��11� F: Fox.

9 :


You will see that with EXCL every line that does not contain the string is displayed.Also, notice that the format of the resulting display is the same as that produced by theINCL primary command.



Actually, you did not have to enter the string 'ra' since you used that string with theINCL primary command. Once you have specified a string, it is remembered and usedwith every subsequent INCL and EXCL primary or line command that does notinclude a string. It is also used with every FIRST, LAST, NEXT and PREV primaryand line command that does not include a string.

6.7.2 Locating Specific Occurrences

You can use the FIRST, LAST, NEXT and PREV primary and line commands tolocate and display specific occurrences of a character string. For example, let's use aprimary command to locate the first occurrence of the string 'ra'. Move the cursor tothe Command Area.

Type -> FIRST to


The resulting display begins with the first line containing 'ra' (for example, line 50).

Now, let's use a line command to find the last occurrence of a string.

Please position the display to begin with the first line in the AWS. Then move thecursor to the first line in the Execution Area. In the sequence number field,

Type -> LAST

Now move the cursor to the data portion of the same line.

Type -> /er/

The following screen illustrates the placement of the line command and its string.



Using the LAST Line Command

� �

>


> ....+....1....+....2....+....3....+....4....+....5...

...... ============================= T O P =================

LAST /er/II



��4� D: Dog.

��5� X: X-ray.

��6� E: Easy.

��7� T: Tango.


��9� V: Victor.


��11� F: Fox.

9 :


The resulting display begins with line 100, the line containing the last occurrence of'er' in the AWS.

As their names imply, you can use the NEXT and PREV primary and line commandsto find the next occurrence of a string or the previous occurrence of a string. In everyinstance, the line containing the string is presented as the first displayed line.

If you are looking for multiple occurrences of the same string, you need not retype thestring each time you use the command. For example, move the cursor to theCommand Area.

Type -> PREV


The previous occurrence of the string 'Female' now begins the display. Once you havespecified a string, it is remembered and used in subsequent EXCL, FIRST, INCL,LAST, NEXT and PREV primary and line commands that do not include a string.



One last note about locating a string.

When you are using a line command, you must delimit the string. Since you're typingthe string in the data portion of the Execution Area, CA-Roscoe needs to know wherethe string starts and stops.

Usually, you do not have to delimit the string you specify with a primary command, asin:

FIRST to

If, however, the string contains a space or matches an operand of the command, youmust delimit the string, as in:

FIRST /F: Fox/


6.8 Changing Words Within the AWS


There may be occasions when you will want to modify the words that are in the AWS.For example, if you discover that you have misspelled a word, you can move thecursor to that word and over-type it with the correct spelling. While this is a simpleprocedure, it could get cumbersome if you decide that you want to change multipleoccurrences of the same word or a group of words. CA-Roscoe provides a number ofcommands that allow you to replace one or more words.


You can use the EDIT command to replace one string of characters with another. Forexample, move the cursor to the Command Area.

Type -> EDIT /er/xx/ or E /er/xx/


You will see that every occurrence of the string 'er' in the AWS has been changed tothe string 'xx'. You can include operands with this command to limit its scope ofoperation to specific columns and/or a specific range of lines.


You can use the line commands, E, EE, EB and ET to change one character string toanother. Use:

■ E with an optional numeric value to change strings on specific lines;

■ EE (on the first and last line of a range) to change a string on a range of lines;

■ EB to change a string on lines between the line containing the command and theend of the AWS; and

■ ET to change strings on lines between the first line of the AWS through the linecontaining the command.

As with the primary command, you must specify a search string that is followed by areplacement string. Therefore, to change every occurrence of a string from the line onwhich the command is entered through the end of the AWS, move the cursor to thefirst displayed line.

Type -> EB

and then position the cursor to the data portion of the same line.

Type -> /xx/er/



The following screen illustrates the placement of this command and its strings.

Using the EB Line Command

� �

>


> ....+....1....+....2....+....3....+....4....+....5...

...... ============================= T O P =================

EB /xx/er/III



��4� D: Dog.

��5� X: X-ray.

9 :



6.9 Review/Summary

6.9 Review/Summary

In this chapter, you have learned how to use multiple commands and correct any thatmay have been entered incorrectly. You have also learned how to use primary andline commands to:

■ Move, copy, delete and renumber lines within the AWS.■ Locate all or specific strings of characters within the AWS.■ Replace one character string with another within the AWS.



In the next chapter, you will learn how you can update the contents of a librarymember, change the attributes of the member, rename and even delete the member.

Table 6-2. Summary: Modifying Data

TOPIC CHAPTER

Using Multiple Commands andCorrecting Commands

Commands and Command Components

Session Options Displaying/Changing Session StatusInformation

Changing Words Changing Character Strings Within theAWS

Copying Lines Copying Data Within the AWS

Deleting Lines Deleting Data Within the AWS

Locating Words Locating a Character String Within theAWS

Moving Lines Moving Data Within the AWS

Repeating Lines Copying Data Within the AWS


Chapter 7. Updating Data

This chapter describes how you can:

■ Update the contents of an existing library member.■ Use primary command or the Library Facility to:

– Obtain library member information.– Change the attributes of a library member.– Change the name of a library member.– Delete a library member.

Chapter 7. Updating Data 7-1

7.1 Updating a Library Member

7.1 Updating a Library Member

Now that you have made changes to the definitions in the AWS, you probably want tomodify your library member to reflect those changes. The command that performs thistask is UPDATE. UPDATE causes the contents of a library member to be replaced byall or part of the contents of the AWS. Thus, to update your member,

Type -> UPDATE WORDS or U WORDS

or

Type -> UPDATE 1 or U 1


As has already been noted, the asterisk has a special meaning to CA-Roscoe. In thisexample, it tells CA-Roscoe to update the last member that you FETCHed, SAVEd orUPDATEd with the contents of the AWS. Since WORDS is the name of the lastmember you FETCHed, the contents of that member will be updated.


7.2 Obtaining Library Member Information


You know the CA-Roscoe library contains your member WORDS, but what otherlibrary members are saved under your prefix?

At any time during your session, you can use the Library Facility to display a list ofyour library members. To do this:

Type -> LIBRARY


The following screen illustrates the next display you will see.

Library Facility Menu

� �

>

> LIB() SCRL FULL COLS ��1 ��79

....+....1....+....2....+....3....+....4....+....5....+....6.

LIBRARY FACILITY

FUNCTION ==>

PREFIX ==> your prefix

MEMBER ==>

SIGNON KEY ==> your signon key

FORMAL KEY ==> your formal key

SEARCH ==> (SHR,RES,EXE,NOD)

CONFIRM DELETE ==> YES

A - ATTACH LIBRARY D - DELETE MEMBERS P - PRINT MEMBER

C - COPY MEMBERS I - INFO MEMBERS R - RENAME MEMBERS

X - TERMINATE LIB

9 :

If this is the first time you are using the Library Facility, the menu will contain yourCA-Roscoe prefix, sign-on key and formal key.

The YES with CONFIRM DELETE means that if you try to delete one of your librarymembers, CA-Roscoe will display the name of that member and ask you to confirmthat you want the member deleted.



The codes at the bottom of the previous screen indicate the types of actions you canperform. For example, if you type a library member name in the field MEMBER andan A in the FUNCTION field, you can display the contents of that member. We aregoing to use the code A, however, to attach a list of your library members. Make surethat no library member name appears in the MEMBER field and then,

Type -> A (in FUNCTION field)


The following screen illustrates the type of information that is contained in theresulting member Selection List. (As you will see later, in addition to displayinginformation, you can use a Selection List to perform specific actions.)

Library Selection List Description

� �

>

> LIB() SCRL FULL COLS ��1 ��72 LINE ��1

....+....1....+....2....+....3....+....4....+....5....+....6..

==================================== T O P ===================

SIGNON KEY MEM EXCL BLOCKS M-LINES LINES

your-key 3 � 23 2�� 34

MEMBER STATUS DESCRIPTION LINES ATR SEQNO

XYZ.JUNK 1 SHR NOSEQ

XYZ.SAVAWS�1 NROS1 datetime 1� SHR �73,8

XYZ.WORDS 23 SHR �73,8

9 :

The amount of information provided by this Selection List exceeds the width of80-column screens. The information is, therefore, divided into alternate displays. Youcan change the display to view different information.

Type -> SELECT ALT


Every time you do this, the next sequential display is presented. Eventually, you willreturn to the original display. The first two lines in the list remain constant as youscroll through the Selection List. They show:

SIGNON KEY Your sign-on key.

MEM Number of library members included in the Selection List.



EXCL Number of library members that site management caused to beexcluded from the display.

BLOCKS Number of library blocks used by the members included in the List.

M-LINES Maximum number of lines you may save in the library or N/A ifyou have no limit.

LINES Number of lines contained within all of the members included in thedisplay.

The remaining fields identify the individual members comprising the List and include:

MEMBER Name of the library member. (The name begins with yourtwo or three character CA-Roscoe prefix, shown as XYZ inthe previous screen.)

DESCRIPTION Description of the member, if available.

LINES Number of lines the member contains.

ATR Member's access attribute, shown as:

SHR Allows anyone to look at or execute your member.This is the default.

RES Prevents anyone from looking at or executing yourmember.

EXE (Use with RPF programs.) Allows anyone toexecute your member; prevents anyone fromlooking at your member.

SEQNO Member's sequence number attribute, shown as:

NOSEQ No sequence numbers are to be includedwhen you print this member.

col,l Numbers indicating where sequencenumbers are to be positioned when themember is printed. The default (shown as073,8) causes sequence numbers to begin incolumn 73 and be eight digits long.

CREATED Date the member was created.

UPDATED Date the member was last updated.

ACCESS Date the member was last accessed.


7.3 Changing Member Attributes


As illustrated in the following screen, your member WORDS does not have adescription. Also, the access and sequence number attributes are the defaults assignedby CA-Roscoe. You can specify a description and attributes when you initially savethe data (using the SAVE command). You can add or change the information whenyou update the member (using the UPDATE command).

If you only want to change a member's description and/or attributes, you can use theALTER command. For example, to add a description to your member,

Type -> ALTER WORDS /DEFINITIONS/

Press the ENTER key. To verify that the description has been added to the member,

Type -> REFRESH

As illustrated in the following screen, REFRESH updates the Selection List to includeyour description of WORDS.

Library Selection List Description

� �

>


....+....1....+....2....+....3....+....4....+....5....+....6..

==================================== T O P ===================


SMITH 3 � 23 2�� 34


pfx.JUNK 1 SHR NOSEQ

pfx.SAVAWS�1 NROS1 datetime 1� SHR �73,8

pfx.WORDS DEFINITIONS 23 SHR �73,8

9 :

You can also use this Selection List to change the description and/or attributes of amember.



The following screen illustrates how you can change the sequence number attribute ofthat member. First type AT (for alter attribute) before the member WORDS. (Itsshown as the first shaded area.) Then, tab to the sequence number field and overtype073,8 with NOSEQ.

Changing Member Attributes

� �

>


....+....1....+....2....+....3....+....4....+....5....+....6..

==================================== T O P ===================


SMITH 3 � 23 2�� 34




AT pfx.WORDS DEFINITIONS 23 SHR noseq

9 :


To verify that the sequence number has been changed,

Type -> REFRESH

The resulting display shows that the sequence number attribute has been changed.


7.4 Renaming a Member

7.4 Renaming a Member

Suppose you decide that the name WORDS is not an appropriate name for your librarymember. You can use the RENAME command to change the member's name. (Youcan also change the member's description and attributes at the same time.) To changethe member's name,

Type -> RENAME WORDS name

Replace 'name' with any name you want. (Remember that library members namesmust be 1- to 8-characters in length and start with an alphabetic character.)


To verify that you library member has been successfully renamed,

Type -> REFRESH

Notice that there is no entry for the member named WORDS. There is an entry forthe member with the name that you assigned.

You can also use the list to rename a member. In the example shown in the followingscreen, the member named WORDS is renamed SAMPLE. In this case, an R (forrename) is typed before the member name. (In the first shaded area.) Then the newmember name is typed in the STATUS field. (The second shaded area.)

Renaming a Member

� �

>


....+....1....+....2....+....3....+....4....+....5....+....6..

==================================== T O P ===================


SMITH 3 � 23 2�� 34




R pfx.WORDS SAMPLE 23 SHR �73,8

If you try this form of renaming, use the REFRESH command again to verify thatyour member was successfully renamed.


7.5 Deleting a Member

7.5 Deleting a Member

Suppose you decide that you no longer need a library member. You can use theDELETE command or the Selection List to remove that member from your library.

The list shown in the following screen includes a member named JUNK. To removethis member using the command,

Type -> DELETE JUNK or DEL JUNK

To remove this member using the Selection List, type a D (for Delete) before theappropriate member name.

Deleting a Member

� �

>


....+....1....+....2....+....3....+....4....+....5....+....6..

==================================== T O P ===================


SMITH 3 � 23 2�� 34


D pfx.JUNK 1 SHR NOSEQ


pfx.WORDS 23 SHR �73,8

9 :

When you attempt to delete a member, you may be asked to confirm that the memberis to be deleted. With the DELETE command, you must enter DELETE a secondtime. With the D code, you must enter YES or Y.


7.6 Review/Summary

7.6 Review/Summary


■ Update the contents of a library member.■ Display information about your library members.■ Change library member attributes.■ Rename a library member.■ Delete a library member.



In the next chapter, you will learn how you can print the contents of the AWS and/ora library member.

Table 7-1. Summary: Updating Data

TOPIC CHAPTER

Changing Member Attributes Performing Library Management Tasks

Deleting a Member Performing Library Management Tasks

Displaying Member Information Performing Library Management Tasks

Renaming a Member Performing Library Management Tasks

Updating a Member Saving Data as a Library Member


7.6 Review/Summary


Chapter 8. Printing Data

Sites have the option of enabling a facility that you can use to print all or part of theAWS and/or one or more library members at a 328x-type printer or a system printer.This chapter assumes that your site is allowing you to use this facility.

Chapter 8. Printing Data 8-1

8.1 Identifying What to Print

8.1 Identifying What to Print

To print the contents of the AWS,

Type -> PRINT or P

To print the contents of a library member, include the name of the member with thePRINT command.

Type -> PRINT WORDS or P WORDS

In addition, you can:

■ Assign a name or 'tag' to your print request. If you use a tag, it must be: 1- to8-characters, begin with an alphabetic character, bound by apostrophes, and placedimmediately after the PRINT command. The following illustrates how you mightassign the tag SAMPLE to your print request:

Print 'sample' words

■ Print multiple copies of a request. For example, to print three copies of your printrequest, you might enter:

Print 'sample' words copy 3

A confirmation message is displayed on the Response Line when the PRINT commandis executed. The message includes the tag (if you specified one), the print requestnumber assigned by CA-Roscoe and the location at which your request is scheduled toprint.


8.2 Determining the Print Status

8.2 Determining the Print Status

After your request is scheduled for printing, you can obtain information about it.

Type -> PRINT STATUS or P STATUS


This command creates a library member for you that contains information about youroutstanding print requests. By default, this member is attached to the terminal fordisplay. The member contains a variety of information that:

■ Identifies each request. This includes your prefix, the request number assigned byCA-Roscoe and the tag name, if you specified one.

■ The current status of the request.

■ The number of records to be printed and how many remain to be printed.

■ The name of the location where the request is to be printed.


8.3 Review/Summary

8.3 Review/Summary


■ Print a copy of the contents of the AWS.■ Print the contents of a library member.■ Print multiple copies of a print request.■ Obtain the status of your outstanding print requests.

If you would like additional information about printing the contents of the AWS or alibrary member, see the chapter 'Printing Data' in the CA-Roscoe User Guide.


In the next chapter, you will learn how you can send and receive messages throughCA-Roscoe.


8.3 Review/Summary


Chapter 9. Communicating With Others

This chapter describes how to send messages to other users.

Chapter 9. Communicating With Others 9-1

9.1 Sending Messages

9.1 Sending Messages

You can send messages to other CA-Roscoe users if you know their sign-on key orprefix.

For example, to send a short message (that is less than 64 characters in length) to theuser whose sign-on key is SMITH, you would enter:

send key=smith 'meeting at 11:�� in conference room a'

To send the same message, using the user's prefix, you would enter:

send pfx=abc 'meeting at 11:�� in conference room a'

You must delimit the message with a special character not found in the message itself(for example, an apostrophe (') is used in the preceding example).

If you want to send a longer message to a CA-Roscoe user, type the text in either theAWS or a library member. Then when you issue the SEND command, identify thelocation of the message, as in:

send aws key=brown 'report on meeting'

In this example, the keyword AWS indicates that the message we want to send is inthe AWS. The message with this command is optional. Here it is used to identify theinformation being sent.


9.2 Receiving Messages

9.2 Receiving Messages

If you are signed on when someone sends you a message and it is a:

■ Short message

The message is displayed on the Response Line of your terminal. The messagetext is preceded by the sender's prefix.

■ Multi-line message

The following note is displayed on the Response Line of your terminal:

MSG FROM key IN MEMBER Zmddhhmm 'string'

where:

key Sender's sign-on key,

Zmddhhmm Name of the member in your library that contains the message.

This unique member name is created by CA-Roscoe and consistsof the character Z, the month (in hexadecimal), the day, the hourand the minute the member was created. For example, a membercreated at 3:25 PM on January 6 is saved as Z1061525. A createdat 9:15 AM on October 15 is saved as ZA150915 (where thesecond character, A, represents the month October inhexadecimal).

String Note the user included with the SEND command.

If you are not signed on or sign off before receiving the message, an entry is added tothe top of the member ZZZZZMSG in your library. The entries contain:

1. the one-line message and

2. the name of the created library member(s) that contains the multi-line message(s).

To view the message, you must ATTACH the member.


9.3 Review/Summary

9.3 Review/Summary


■ Send a message to another CA-Roscoe user.■ Receive messages that other CA-Roscoe users send to you.

If you would like additional information, see the chapter 'Sending/Receiving Messages'in the CA-Roscoe User Guide.

For a detailed description of the command described in this chapter, refer to theCA-Roscoe Command Reference Guide.


9.3 Review/Summary


Chapter 10. Other Things You Can Do

While this manual is intended to be read by non-programmers, all of the tasksdescribed in it are also applicable to programmers. In fact, CA-Roscoe's primarypurpose is to simplify the tasks performed by programmers. This chapter highlightssome of these tasks and how CA-Roscoe can be of assistance.

Chapter 10. Other Things You Can Do 10-1

10.1 Submitting and Viewing Jobs

10.1 Submitting and Viewing Jobs

Syntax Checking Data

The JCL command invokes the job control language syntax checker. It can be used tocheck JCL statements in the AWS or a library member.

The COBOL syntax checker is invoked by the COB command. It also can checkCOBOL source code in the AWS or in a specified library member.

Submitting Data as a Job Stream

You can submit the contents of the AWS and/or one or more library members to theoperating system at any time during your terminal session.

Checking the Status of Submitted Jobs

Once you have submitted a job for execution, you can monitor its progress with theDISPLAY command. DISPLAY allows you to see what the job is doing (awaitingexecution, executing, awaiting print, etc.), what its position on the job queue is, whatinitiators have been assigned to each job class, and how many jobs are in each jobclass.

At some MVS sites, you do not need to use the DISPLAY command to check thestatus of your jobs. By site option, you may receive JES2 or JES3 messages at yourterminal notifying you when your jobs complete execution.

Viewing Job Output at the Terminal

You can examine the files associated with your job using the ATTACH JOBcommand.

Once a job is attached, there are a number of CA-Roscoe commands that you can useto:

■ Position within the job output.

■ Locate and note data within one or more output files.

■ Display and alter file attributes.

■ Print an attached job output file.

■ Copy an attached job output file into the AWS.

■ Reattach job output at the first file in the job or at a specific location within thejob.

■ Detach the job output and, optionally, dispose of the files based on its print,noprint or hold status.


10.2 Performing Data Management Tasks

10.2 Performing Data Management Tasks

CA-Roscoe makes it easy for you to:

■ Browse a data set - be it an OS data set or a CA-Librarian master file.

■ Copy the data set into the AWS where it can be modified and/or saved in theCA-Roscoe library.

■ Print a copy of the data set.

■ Allocate a data set.

■ Write the contents of the AWS and/or one or more library members to a data set.

■ Rename a member, module or data set.

■ Delete a member, module or data set.

■ Catalog or uncatalog a data set.

■ Display a Selection List that contains:

– A PDS (partitioned data set) directory.– A CA-Librarian master file index.– The entries in a SAME catalog, ICF catalog or OS CVOL.– The VTOC (volume table of contents) of a device.– Information about all or selected volumes.


10.3 Learning About RPF

10.3 Learning About RPF

RPF (the ROSCOE Programming Facility) is a structured, interactive programminglanguage that can be used to write programs for many different types of applications.In addition to its own commands, statements, and functions, RPF permits allCA-Roscoe commands to be embedded within the program. When these commandsare encountered during program execution, they are executed as if the user had enteredthem from the terminal.

Additional information about RPF is available from:

■ The online, interactive training program TRAINING. This program is writtenusing the RPF language and CA-Roscoe commands To execute this program,move the cursor to the Command Area of the screen.

Type -> RPF.TRAINING

■ The CA-Roscoe RPF Language Guide. This manual is divided into two segments.The first segment provides an overview of the language and how you can use thevarious components of the language to perform specific tasks. The secondsegment contains a detailed description of the commands and functions comprisingthe language.


10.4 Executing Application Under ETSO

10.4 Executing Application Under ETSO

ETSO (the Extended Time-Sharing Option) lets you execute interactive applications(such as spreadsheets, statistical packages and report generators) under CA-Roscoe. Ifyou will be executing applications via ETSO, your site management will tell you whatthe applications are and how you should execute them.


10.5 Executing TSO Commands

10.5 Executing TSO Commands

TSO commands can be entered from the CA-Roscoe command line and from withinRPF programs. This is an extension to ETSO that allows you to easily switch betweenthe use of TSO facilities and native CA-Roscoe facilities.

With this command, you can execute CLISTs as well as REXX execs. Theseprocedures will be executable directly from the command line, from within each other(nesting), and from within ISPF dialogs. Both explicit (EXEC) and implicit (%)invocations are supported.

Your site management will tell you if this extension is supported at your site. Toexecute CLIST and REXX execs, TSO/E 2.1 or above is required.


10.6 Review/Summary

10.6 Review/Summary

In this chapter, you have learned about:

■ Submitting and viewing job output.■ Performing OS data management tasks.■ The RPF programming language.

■ ETSO.■ Executing TSO commands from CA-Roscoe.

For additional information about any or all of these facilities, see the appropriatechapters in the CA-Roscoe User Guide.


10.6 Review/Summary


Chapter 11. Learning More About CA-Roscoe

This chapter describes how to obtain additional information about CA-Roscoe.

Chapter 11. Learning More About CA-Roscoe 11-1

11.1 Online HELP Facility


The online HELP facility is a quick and easy way to get information about CA-Roscoecommands and facilities. For example, to obtain information about the SAVEcommand,

Type -> HELP SAVE or H SAVE


The following screen illustrates the type of information displayed.

Sample HELP Facility Display

� � _

>

> HLP(...HELP...) SCRL FULL COLS ��1 ��79

>....+....1....+....2....+....3....+....4....+....5....+....6

SAVE

Function: Places all or part of contents of AWS into library

as member.

Syntax: SAVE mem < p<q> > < 'string' >

< NOSEQ/SEQ <s<l>>/COBOL >

< SHARED/EXECONLY/RESTRICTED >

mem Name to be assigned to library member

being created. . . .

p q Number of the first and last lines of

AWS to be saved.

. . .

9 :



To obtain information about the HELP facility itself,

Type -> HELP or H


Note that with the HELP facility, the scrolling functions have been assigned to specificPF keys. Use:

PF7 or PF19 To scroll back to the beginning of the current level.PF8 or PF20 To scroll forward within the current level.PF10 or PF22 To scroll back to the previous level.PF11 or PF23 To scroll forward to the next level.


11.2 Online Training

11.2 Online Training

TUTORIAL is an online, interactive training aid that simulates an an actualCA-Roscoe session and introduces the most frequently used CA-Roscoe commandsand facilities. To find out how to execute the training at your site,

Type -> HELP TUTORIAL or H TUTORIAL


When you execute the TUTORIAL, you are presented with a menu of that shows anumber of independent learning modules. You can complete the modules in order, useonly certain modules, or vary the order in which you complete the modules.


11.3 Documentation

11.3 Documentation

The section in the beginning of this manual entitled 'About This Guide' includes adescription of all the documentation that is distributed with CA-Roscoe. Thedocumentation set consists of a User series and a System series. The User seriescontains all documentation required for users to perform online processing, includingcreating and updating library members and data sets, and submitting jobs. The Systemseries contains all information necessary for CA-Roscoe system administrators toinstall, maintain, and customize the CA-Roscoe system.


11.3 Documentation


roscoe v6.0 - getting started guide

Documents