CA-Roscoe

®

Getting Started Guide
6.0

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 1-1 2-1 2-2 2-4 2-9 3-1 3-2 3-3 3-4 3-5 4-1 4-2 4-3 4-4 4-6 5-1 5-2 5-3 5-4

Chapter 1. Introducing CA-Roscoe

Chapter 2. Signing On and Entering Data 2.1 Signing On to CA-Roscoe . . . . . . . . 2.2 Entering Data . . . . . . . . . . . . . . . 2.3 Review/Summary . . . . . . . . . . . . . Chapter 3. Saving Data and Signing Off 3.1 Introducing the CA-Roscoe Library . . 3.2 Saving Data . . . . . . . . . . . . . . . 3.3 Signing Off . . . . . . . . . . . . . . . 3.4 Review/Summary . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Chapter 4. Retrieving and Displaying Data . . . . . . . . . . . . . 4.1 Displaying Data 4.2 Displaying Data to Modify . . . . . . . 4.3 Detaching and Reattaching Data . . . . 4.4 Review/Summary . . . . . . . . . . . . . Chapter 5. Scrolling Through Data 5.1 Using PF Keys to Scroll . . . . . 5.2 Using Commands to Scroll . . . 5.3 Review/Summary . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Chapter 6. Modifying Data . . . . . . . . . 6.1 Using Multiple Commands . . . . . . . . 6.2 Correcting and Changing Commands . . . 6.3 Moving Data Within the AWS . . . . . . 6.4 Copying Data Within the AWS . . . . . . 6.5 Deleting Data From the AWS . . . . . . . 6.6 Renumbering the AWS . . . . . . . . . . 6.7 Locating Specific Words Within the AWS 6.8 Changing Words Within the AWS . . . . 6.9 Review/Summary . . . . . . . . . . . . . . Chapter 7. Updating Data . . 7.1 Updating a Library Member

6-1 6-2 6-3 6-5 6-8 6-10 6-12 6-13 6-18 6-20 7-1 7-2

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Contents iii

. . . .0 Getting Started Guide . . . . . . .2 Determining the Print Status 8. . . . . .2 Receiving Messages . . . . . . . . . . . . . . . . . . . . . . 7-3 7-6 7-8 7-9 7-10 8-1 8-2 8-3 8-4 9-1 9-2 9-3 9-4 10-1 10-2 10-3 10-4 10-5 10-6 10-7 11-1 11-2 11-4 11-5 Chapter 8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4 7. . . Chapter 9. . . . . . . . . .6 Review/Summary . . . . . . . . . . . . . . . . . . .5 Executing TSO Commands . . . . . . . . . . . . . . . . . . . . . . Printing Data . . . . . .2 Performing Data Management Tasks 10. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9. . . 10. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 Submitting and Viewing Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Review/Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3 Review/Summary . . . . . . . . . . Renaming a Member . . . . . . . . . . . . . . . . . . .3 Learning About RPF . . . . . . . . . . .4 Executing Application Under ETSO 10. . . . . . . . Chapter 10. 8. . . . . . . . . . . . . Chapter 11. . . . .1 Online HELP Facility . . . . . . . . . . . . . . . . . . . 11. . . . . . . 9. . . . . . . . .2 Online Training . . . . . . . . . . . . . . . . . . . . . . 8.6 Obtaining Library Member Information Changing Member Attributes . . . .3 7. . . 11. . . . . iv CA-Roscoe 6. . . . . . . . . . . . 10. . . . . . . . . . . Deleting a Member . . . . . . . . . . . . . . . . . . . . . . . . . .3 Documentation . . . . . . . .2 7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 Identifying What to Print . . . . . .3 Review/Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Other Things You Can Do 10. . . . . . . .7. . . . . . . . . . . . . . . . . . . . . . . .1 Sending Messages . Learning More About CA-Roscoe 11. . . . . . . . . . . . . . . . . . . . . . . . . .5 7. . . . . . . . . . . . . Communicating With Others 9. . . . . . . . . . . . .

0 of CA-Roscoe. About This Guide v . Note: The facilities described in this manual apply to Release 6.About This Guide The Getting Started guide provides an introduction to CA-Roscoe for non-programmers.

0 Getting Started Guide . detach that data and then reattach it. Describes how to use primary and line commands to change data. Describes how to update data saved in the CA-Roscoe library with changes made to data in the AWS. 8 9 10 11 vi CA-Roscoe 6. Describes how to print data. Describes how to send messages to other users. Describes how to display data saved in the CA-Roscoe library. Describes how to obtain additional information about CA-Roscoe.Organization CHAPTER 1 2 3 4 5 6 7 DESCRIPTION Introduces CA-Roscoe and describes how to use this manual. Introduces areas of CA-Roscoe that are described in detail in other manuals. Describes how to use PF keys and commands to scroll the displayed data. Also describes how to obtain library member information and how to maintain library members. Describes how to sign on to CA-Roscoe and enter data. Describes how to save data in the CA-Roscoe library and then sign off CA-Roscoe.

Summary of Revisions for this Edition Updated the CA-Roscoe Sign-on Screen. “Signing On to CA-Roscoe” on page 2-2 for more information.1. See 2. About This Guide vii .

0 Getting Started Guide . see the 'Summary Of Amendments' in the CA-Roscoe Command Reference Guide.Summary of Revisions ■ This manual has been updated to reflect enhancements to CA-Roscoe 6. CA-Roscoe User Guide.0. For details about these enhancements. viii CA-Roscoe 6. and the CA-Roscoe RPF Language Guide. ■ Editorial and minor technical changes have been made throughout this manual.

expressions and variables. functions. Introduces CA-Roscoe to non-programmers. Getting Started Guide Reference Summary Reference Summary (for RPF) Release Guide RPF Language Guide User Guide About This Guide ix . Describes how: 1) the Application Programming Interface (API) can be used by applications executing under ETSO to take advantage of CA-Roscoe facilities. Provides a summary of the enhancements included in this release. Provides task-oriented descriptions of how to use CA-Roscoe. Summarizes all Roscoe Programming Facility (RPF) commands. They are divided into a User Series and a System Series. maintain and execute panel-driven RPF applications.CA-Roscoe Publications The following publications are supplied with CA-Roscoe. and 2) the interactive facilities provided by SKETCH can be used to generate and maintain panels used in programs running under CICS or IMS. User Series Name Command Reference Guide Extended Development Tools Guide Contents Describes all CA-Roscoe primary and line commands and Monitor commands. Summarizes all CA-Roscoe primary and line commands and Monitor commands. It also describes the Dialog Management Facility (DMF) which can be used to develop. Describes all components of the RPF language and how to write RPF programs.

and user profile system. Describes implementation of internal and external security to protect your CA-Roscoe system. Security Administration Guide System Commands Guide System Reference Guide x CA-Roscoe 6. Explains all messages that might be received by individuals using CA-Roscoe and/or by the individual responsible for maintaining CA-Roscoe. Describes how sites can make extensions to their CA-Roscoe system.1 Supplement Extended Facilities for System Programmers Guide Installation Guide Messages and Codes Guide Programs and Utilities Guide Contents Presents CA-ACTIVATOR installation procedures. Active Work Space (AWS). Also describes maintenance and reporting programs for the accounting facility. Intended for the individual responsible for maintaining CA-Roscoe.0 Getting Started Guide . It describes CA-Roscoe and its components.System Series Name CA-ACTIVATOR 2. library system. Describes commands used to control and monitor CA-Roscoe and to obtain performance information about that execution. Describes CA-Roscoe execution requirements. This includes creating site-written Monitor routines and customizing security and other online exits. Describes the steps to follow when installing or upgrading CA-Roscoe.

The following manuals relate to CA-Roscoe and are available from Computer Associates. and operating instructions for CA-ACTIVATOR. parameters. Messages and codes for CA90s Services. Installation procedure and installation JCL for CA90s Services. and coding rules. Also describes size requirements and program execution. It presents an introduction to CA-Earl features and capabilities.1 Supplement CA90s Services CA-ACTIVATOR Implementation and User Guide CA-ViewPoint User Guide Contents Operating Instructions for the CA90s Services. CA-Earl User Guide CA-Earl Systems Programmer Guide CA-Earl Examples Guide About This Guide xi . Also explains the CA-Earl Reporting Service. Proceduresa for using CA-ACTIVATOR to install and maintain CA90s Services. Designed for users interested in learning about CA-Earl. Lists the installation options for CA-Earl and instructions for modifying them. Contains sample programs that show a variety of common applications. Installation and upgrade instructions. Title CA-Earl Reference Guide Contents Contains detailed information about CA-Earl statements.Related Publications The following manuals are included in the CA90s Services Documentation set: Title CA90s Services Reference Guide CA90s Services Installation and Maintenance Guide CA90s Services Message Guide CA90s Services CA-ACTIVATOR 2. Contains information and examples for implementing and using ViewPoint.

CA-Roscoe uses CAIRIM for installation services and security.0 Getting Started Guide . xii CA-Roscoe 6. These services are maintained separately from the product and are documented and installed separately as well. Licensing Management Program (LMP) CA-Roscoe now interfaces with CAIRIM services to determine product licensing authorization.CA90s Services CA90s Services are a common set of services that may be used by any MVS Computer Associates product.

Name of an OS data set or CA-Librarian master file.mem). pfx. underline lowercase Lowercase alphabetics are shown as: aname charstr Name of an AWS. Identifies command.) Integer or a variable whose value can be converted into an integer. The uppercase letters are the minimum abbreviation. Length of a string or field. operand or keyword values which must be coded exactly as shown. Indicates a variable for which a value must be supplied. Indicates a default value that you need not supply. dsn dsnmem expr i int l mem n About This Guide xiii . If it is shown as /charstr/. operands or parameters from which you must select one. If the member belongs to another user. (RPF only. Any sequence of printable entities specified in character format.Command Notation The command syntax described in this manual uses the following notation conventions: [] {} UPPERCASE Mixed Cases Indicates optional keywords. Increment value used for determining line numbers. the string must be bound by a special character and may include blanks. that user's prefix must be included (for example. (RPF only. context Keyword operand that identifies the type of string specified with the command (qualifying the type of search operation to be performed). Name of a CA-Roscoe library member. operand or keyword abbreviations.) One or more elements and associated operators. Name of a PDS member or CA-Librarian master file module. Lowercase letters are optional. operands or parameters from which you may select one or none. The special character delimiting the string and the special character used as the command delimiter cannot appear within the string itself. Identifies command. Line number. Indicates required keywords.

If only one value is specified.. the destination begins with line v. the operation is limited to p If p and q are omitted. If omitted. If p is an * (indicating line at which pointer positioned). it is assumed to be the starting column (s). If p is a line number. where p is the line at which the operation begins and q is the line at which the operation ends. -p p q Processing option specified with Monitor commands. it is assumed to be the ending column (e). After the last line of an AWS. (This destination/operation is not valid with all commands. Range of lines. the positioning affects the single execution of the command. If omitted. Specific line number in an AWS. q must also be a line number.) Real number or a variable whose value can be converted into a real number. (RPF only.) Before the first line of the AWS. where s is the starting column number of the range and l is the length of the range. Range of columns. If the number exists. the destination is after line v. scope Keyword operand designating the location of the data to be affected by the command. q must be a line count. str xiv CA-Roscoe 6. Replaces the contents of the AWS. which can be represented using any of the following forms: * B or . real s e s l Range of columns. If the line number does not exist.) String or a variable whose value can be converted into a string. the positioning currently in effect is used. (RPF only. the currently attached data is assumed.o Destination of an operation. R T v Line at which the pointer is positioned. If only one value is specified.0 Getting Started Guide . all lines are assumed. position Keyword operand designating the screen position that is to occur when a string match is found. If specified. where s is the number of the column at which the operation begins and e is the number of the column at which the operation ends. If q is omitted.

string Any sequence of entities specified in either character format or its hexadecimal representation. the string must be bound with a special character. About This Guide xv . The special character delimiting the string and the special character used as the command delimiter cannot appear within the string. If shown as /string/. v Numeric value.

0 Getting Started Guide .xvi CA-Roscoe 6.

Based on the material you read.Chapter 1.case and. PRINT and SAVE whatever you have typed. Introducing CA-Roscoe Before describing how to use CA-Roscoe. you will discover that they are easy to use and remember since their names indicate the type of action they perform. you can COPY. we will not be describing: Chapter 1. Introducing CA-Roscoe 1-1 . With them. CA-Roscoe is an extremely powerful online program development and maintenance system. retrieve that member and make changes to the data it contains. DELETE. It consists of three major components: The Terminal This is where you view data and enter commands that tell CA-Roscoe what task(s) you want to perform. Commands are shown in upper. you will be asked to perform certain tasks. While you can actually use multiple AWSs (a minimum of two AWSs are available for your use). While most of the text you will be entering and viewing is less than the width of the terminal screen. The tasks will be presented in the form. As you read through this manual. you will learn how to enter data in the AWS. To assist you in distinguishing text from commands. when appropriate. CA-Roscoe Library This is a permanent storage area in which you can save the text you have been working on in the AWS. we will only discuss how you work with the one that is currently active. Type -> task where 'TYPE' means that you are to perform an action and 'task' identifies the text or CA-Roscoe command that is to be used. let's discuss what CA-Roscoe is. the text is shown in uppercase and lowercase. As you are asked to use different CA-Roscoe commands. While we will be describing many tasks you can perform with CA-Roscoe. save that data as a member in the CA-Roscoe library. the AWS can contain lines that are a maximum of 255 characters in length. include any allowed abbreviations. The AWS (Active Work Space) This is the name of a temporary work area that is made available for your text that you enter and edit.

■ Every type of task that can be performed using CA-Roscoe. If it does. OS data sets.0 Getting Started Guide . Also ask whether or not that sign-on key has a password associated with it. see the Reference Summary. ask someone at your site to explain the various hardware editing keys (particularly the keys to insert and delete data). ask your site management what sign-on key you should use. If you do not. CA-Roscoe library. job output and general session information. the cursor positioning keys. and the PF keys. The chapter "Other Things You Can Do" contains a brief description of the types of tasks that are not described within this manual. ■ A sign-on key. That book provides detailed information about the AWS. If you have not. We will be referring you to that book to find additional information about specific topics.■ Every CA-Roscoe command. you will need to know the password. It is also useful if you have a copy of the CA-Roscoe User Guide. 1-2 CA-Roscoe 6. For a synopsis of all CA-Roscoe commands. For a detailed description of each command. the ENTER key. This manual is written under the assumption that you have: ■ Used a 3270-type terminal before. see the CA-Roscoe Command Reference Guide.

■ What the CA-Roscoe screen looks like. Signing On and Entering Data In this chapter. and ■ How to enter data using both primary commands and line commands. Signing On and Entering Data 2-1 .Chapter 2. we will be describing: ■ How to sign on to CA-Roscoe. Chapter 2.

0 Getting Started Guide .. INC.......4....1 Signing on to CA-Roscoe The following screen illustrates what the CA-Roscoe sign-on screen looks like...+. move the cursor to the field named PASSWORD and type your password.... If it is not displayed at the terminal you are using..+. (The cursor is already positioned there...+.2.49 ||||||| |||| GROUP CODE TERMID A 1IX 17 ||||||| |||| NEW PASSWORD > ||||||| |||| > (Repeat for verification) ||||||| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| |||||||| ||||| ||||| ||| ||| ||||| ||||| ||||||| || |||| || ||||| ||||||||| |||||| || ||||| |||||||||| ||CA-| || |||| || ||||| ||||||||| |||||| || ||||| ||||||||||| ||||| |||| || ||||| ||| |||||| || ||||| |||||||| |||| ||| |||| || ||||||||||| ||| |||||| || ||||| ||||Ver 6...6.+. ask your site management what you need to do to display it.. Your site management will tell you if these fields need to be used. 2-2 CA-Roscoe 6.. We are going to ignore them.3.7 |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| |||| ||||||| |||| ||||||| |||| KEY _ DATE 9/25/ 1 ||||||| |||| PASSWORD TIME 14... The fields GROUP CODE and NEW PASSWORD can be used to provide additional sign-on security...1.....1 Signing On to CA-Roscoe 2.+. if needed) press the ENTER key. The following screen illustrates the next screen that you will see..5.+. |||||| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| Type your sign-on key in the field named KEY.....) If you have a password. CA-Roscoe Sign-on Screen | | | | | | | | | | | | | | | | | | | | | | | | >APPLID(A 4IROS3) > .. || ||| ||| ||| || ||||||||||| ||| |||||| || ||||| ||||Glvl 11 | || ||| ||| ||| ||| || ||||| ||||SP 3| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| |||| COPYRIGHT (C) 1994 COMPUTER ASSOCIATES INTERNATIONAL... After typing your sign-on key (and password...2..35..+.

. This is where you will enter....+..+.xxx in this case.With No Data Attached _ > > . please use the ERASE EOF key to delete xxx..4. The next three lines comprise the System Control Area. Type -> XXX Press the ENTER key... the Command Area consists of the first three lines of the screen.) ■ For now. You can use it to determine the exact position of a character within a 255-character line.. make sure the cursor is in the Command Area and then.. (There is a command that you can use to change the number of lines in the Command Area....+...2...1 Signing On to CA-Roscoe CA-Roscoe Screen . we will ignore the second line beginning with a >. Chapter 2. To illustrate... You can now correct the command.) This is where you will enter all CA-Roscoe primary commands. A site-written message may appear in this space. ■ The third line is called the Scale Line.2... (As a matter of fact... CA-Roscoe uses these lines to provide information....+.. change it or delete it. It reflects the margins currently in effect.. CA-Roscoe displays the message: CMD 4 COMMAND NOT RECOGNIZED and positions the cursor to the 'command' in error . edit and display data. It is used to display messages. By default.5... Signing On and Entering Data 2-3 .6....+..3. The cursor is positioned to the first line of the Command Area...1. ■ The first line (beginning with a >) is the Response Line. The remaining lines of the screen are called the Execution Area.+.

the lower portion of the screen. Your site management has the option of designating whether the information you enter will be kept in the form you typed it (for example. Before going any further. C: Charlie. 2. So. uppercase and lowercase) or will be converted to uppercase only. use the New Line key to position the cursor to the beginning of the next line. Most sites use the default which causes what you type to be converted to uppercase characters. CA-Roscoe supports: ■ Primary Commands. If your site is using the default and you want to prevent this conversion from occurring. You are now ready to enter data. let's talk about CA-Roscoe commands. we're going to enter data using first primary commands and then line commands. Type --> SET MODE XTENDED Press the ENTER key. You can then use the INPUT command to tell CA-Roscoe that you want to enter data. Type -> A: Able. (Everything you enter from this point on will not be converted to uppercase.) The easiest way to understand these command types is to use them.2 Entering Data 2. ■ Line Commands. Type -> INPUT Press the ENTER key. B: Baker.) or I 2-4 CA-Roscoe 6.2. The data consists of a series of one-line definitions. After typing a definition. Press the ENTER key.2. the first three lines of the screen). let's take a look at the screen as illustrated on 2-5 First. These are commands you enter in the Command Area of the screen (for example. CA-Roscoe 'opens' the Execution Area for data entry and moves the cursor to the first line of this Area. make sure that the cursor is in the Command Area of the screen. D: Dog. These are commands that you enter in the Execution Area (for example.2 Entering Data Before you enter any data. look at the definitions you have just typed.0 Getting Started Guide .1 Using Primary Commands To use primary commands.

. It tells you: ■ The location and name of the data.......+...+.With AWS Attached > > AWS() SCRL FULL COLS 1 72 A<ROS1> > .4. ============================= T O P ================= 1 A: Able...... it shows the keyword AWS followed by ().. ... 4 D: Dog.....3. your display will scroll forward or backward one line less than a full screen of data... to the top or bottom of the AWS.+....+. Chapter 2. You can change the display margins by: 1.. This means that the information you typed has been placed in the AWS. You can change the scroll value by positioning the cursor to the SCRL field and typing: number HALF MAX CSR To To To To scroll scroll scroll scroll that number of lines.2 Entering Data CA-Roscoe Screen . half the display. 2 B: Baker...1. This line is called the System Information Line.2.. using the SET DISPLAY command. 3 C: Charlie. overtyping the column numbers shown in this field... FULL means that if you press a PF key that is assigned a scrolling function. or 2...2. or based on the position of the cursor. The () means that the information is unnamed.. ========================== B O T T O M ============== Notice the information appearing on the second line containing an >...+. In this example... ■ How the display will be scrolled.5... ■ The number of the currently displayed left and right margins.. Signing On and Entering Data 2-5 ..

If the cursor is not in the Command Area. you will see how these markers are useful as reference points. Notice also that the Execution Area contains lines marking the top and bottom of the data.) The following screen illustrates how your screen should appear. 500). Zebra. move it there and then. 2-6 CA-Roscoe 6. Later. (While it may be different at your site. You can use a PF key to scroll the display back to the beginning (for example.0 Getting Started Guide . If you want to add information after a specific line. By site option. when we talk about scrolling data. there is not much data to scroll. The cursor is placed at the first data entry line (for example. The resulting display starts with line 400. If you want to add information to the end of the AWS. you may be able to create and use additional AWSs. When information is already in the AWS and you type INPUT. The screen 'closes' and the display begins with line 500. F: Fox. Press the ENTER key. CA-Roscoe makes the last line in the AWS the first displayed line. to add data after line 500. 'opens' the Execution Area and positions the cursor to the first line available for data entry. Type -> INPUT Press the ENTER key. Type -> E: Easy. you can again use the INPUT command. PF7 is the key normally assigned the scroll backward function. You are now ready to enter more data. Type -> T: Z: Tango. line 100). Type -> INPUT 5 Press the ENTER key. For example. So let's add more data to the AWS.2. While we will only be using one AWS with the exercises in this manual. or I 5 or I Press the ENTER key. move the cursor to the Command Area and. Right now. you have two AWSs available for your use. you can do so by specifying that line number with the INPUT command.2 Entering Data ■ The name of the AWS that is active. They are named ROSn (where 'n' is a unique identifier).

.. 5 E: Easy..2 Entering Data Notice the sequence numbers to the left of the screen... Position the cursor anywhere within the sequence number field of line 400 and. Sites. ... After Using INPUT COMMAND > > AWS() SCRL FULL COLS 1 72 A<ROS1> > . One way you can do this is with the I and IB line commands.2.+. suppose you want to add a few more lines to the AWS. you can use the primary command SET DISPLAY to enable this facility. line commands are typed in the sequence number field of the Execution Area. have the option of designating whether line commands can be used when you first sign on to CA-Roscoe..1.2 Using Line Commands You can always enter primary commands in the Command Area of the screen. Type -> SET DISPLAY NUMX Press the ENTER key..+. 2 B: Baker.+.. By default. move the cursor anywhere within the Command Area of the screen and.. Signing On and Entering Data 2-7 .5... however.4. if you insert data between existing lines. Type -> I Chapter 2.. You can tell if it is enabled by looking for six periods in the sequence number field to the left of the TOP and BOTTOM markers (as illustrated in the previous screen). the line number increment of 100 is still used.2. When you insert data at the end of the AWS. CA-Roscoe numbers the AWS beginning with 100 and incremented by 100.... 7 ========================== B O T T O M ============== 2..+. Unlike primary commands (such as INPUT) which are typed in the Command Area. 6 F: Fox..... If the periods are not there....... To do so. However.... Now. CA-Roscoe increments the new lines by ones.. 5 1 T: Tango. 5 2 Z: Zebra...+. Most sites do enable this facility. 3 C: Charlie. 4 D: Dog.3.. ============================= T O P ================= 1 A: Able...2. This is done to minimize changes to your existing line numbers.

a blank line is inserted immediately after the line containing the command. I 4 D: Dog.. To insert more than one line..... specify a number with the command...... 5 2 Z: Zebra.+. 5 1 T: Tango..... With the I line command. 3 C: Charlie. S: Sierra. ============================= T O P ================= 1 A: Able. Type -> V: Victor.1. (Notice that IB5 causes five lines to be inserted before line 700.....+.4.. Notice that the unused lines have been deleted from the display...0 Getting Started Guide .2. 5 E: Easy. the unused lines are deleted when you press ENTER. On the inserted lines preceding line 600.2 Entering Data Now move the cursor to the sequence number field of line 600 and..+. 7 ========================== B O T T O M ============== Press the ENTER key. 2-8 CA-Roscoe 6.... On the inserted line following line 400. the blank line is inserted before the line containing the command. Type -> IB5 The following screen shows the I and IB line commands before the ENTER key is pressed. IB56 F: Fox.. .2..+. Type -> X: X-ray..) If you do not type on all of the inserted blank lines... 2 B: Baker......+.. With IB. Using I and IB Line Commands > > AWS() SCRL FULL COLS 1 72 A<ROS1> > ..3.5. Press the ENTER key.

is the only place where data can be entered and edited. Chapter 2. How to use primary and line commands to enter data into the AWS. Table 2-1. In the next chapter. You now know that the data you type in the Execution Area of the CA-Roscoe screen is placed in the AWS when you press the ENTER key. which is a temporary work area. you have learned: ■ ■ ■ ■ How to sign on to CA-Roscoe. The AWS. Summary: Signing On and Entering Data TOPIC AWS Entering Data Screen Format Signing On plus Establishing and Changing Passwords Primary and Line Commands CHAPTER Introducing the AWS Entering Data into the AWS Selecting a Screen Format Signing On and Off CA-Roscoe Commands and Command Components The CA-Roscoe Command Reference Guide contains a detailed description of the commands described in this chapter.3 Review/Summary 2. you will learn how you can save the data you have in the AWS in the CA-Roscoe library. Signing On and Entering Data 2-9 .3 Review/Summary In this chapter.2. Table 2-1 shows the title of the chapter in the CA-Roscoe User Guide where you can get additional information about the topics discussed in this chapter. The format of the CA-Roscoe screen. That CA-Roscoe supports both primary and line commands.

0 Getting Started Guide .2-10 CA-Roscoe 6.

■ Signing off CA-Roscoe. 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.Chapter 3. Chapter 3. Saving Data and Signing Off 3-1 .

CA-Roscoe then acts as your file clerk placing the member in the library.1 Introducing the CA-Roscoe Library Suppose you have been sitting at your desk writing a memo and you now want to file it for future reference. CA-Roscoe knows the prefix associated with your key and uses it whenever you create or reference one of your library members. (Your site management assigns a unique prefix to each CA-Roscoe sign-on key. Just as other people can have folders placed in a file cabinet. When you sign on. CA-Roscoe automatically assigns your 2. The CA-Roscoe library can be compared to that file cabinet.1 Introducing the CA-Roscoe Library 3.or 3-character prefix to whatever member name you specify. When using CA-Roscoe.0 Getting Started Guide .3.) 3-2 CA-Roscoe 6. You might: 1) place the material in a file folder on which you have written a meaningful name and then 2) give the folder to a file clerk who immediately places the folder in a file cabinet. you place your information in a 'member' (comparable to the file folder) to which you assign a name. It is the place where you permanently store the information you have been working on in the AWS. To ensure that your members are kept separate from other users' members. so other users can save members in the CA-Roscoe library.

.to 8-characters in length and begin with an alphabetic character.. 5 1 T: Tango.. 6 V: Victor.+.. 6 1 S: Sierra.+... 3 C: Charlie...+.. The member name is preceded by your prefix.... 7 ....) The name must be 1.. (This is comparable to writing a name on a file folder before placing the folder in a file cabinet. 4 D: Dog...+.. 4 1 X: X-ray. ============================= T O P ================= 1 A: Able. .. 5 E: Easy..3. 2 B: Baker.2 Saving Data 3.2 Saving Data Now that you have entered information into the AWS.. you have the option of saving it in the CA-Roscoe library.....4.. To save the data in the AWS as the library member named WORDS...1.WORDS) SCRL FULL COLS 1 72 > .3. To do this......) Saving Data or S WORDS _ > > AWS(pfx. (In the following screen your prefix is represented as 'pfx'. 5 2 Z: Zebra. Notice that your library member name now appears in the parentheses following the AWS keyword on the System Information Line. Type -> SAVE WORDS Press the ENTER key....+.. ========================== B O T T O M ============== Chapter 3.5. 6 2 F: Fox..2.. all you need enter is the primary command SAVE and the name you want to assign to the new library member... Saving Data and Signing Off 3-3 .

CA-Roscoe checks the contents of the AWS when you sign off.3. If the AWS contains data. 3-4 CA-Roscoe 6. move the cursor to the Command Area and Type -> OFF But suppose you type the OFF command before you save your data. it is automatically saved in a member (associated with your prefix) named SAVAWSnn (where 'nn' is a unique identifier). you can retrieve this member.3 Signing Off Now that you have saved your data. When you sign back on to CA-Roscoe.0 Getting Started Guide .3 Signing Off 3. you can sign off CA-Roscoe. To do this.

CA-Roscoe will save the contents for you. You also know that if you forget to save the contents of the AWS before you sign off. About the special library member named SAVAWSnn.4 Review/Summary In this chapter.3. Summary: Saving Data and Signing Off TOPIC CA-Roscoe Library Saving Data Signing Off CHAPTER Introducing the Library Facility Saving Data as a Library Member Signing On and Off CA-Roscoe The CA-Roscoe Command Reference Guide contains a detailed description of the commands described in this chapter. How to sign off CA-Roscoe. you have learned: ■ ■ ■ ■ About the CA-Roscoe library. Saving Data and Signing Off 3-5 . Table 3-1.4 Review/Summary 3. How to save data in the AWS as a member on the CA-Roscoe library. You now know how to save data that is in the AWS as a member in the CA-Roscoe library. Table 3-1 shows the title of the chapter and/or section in the CA-Roscoe User Guide where you can get additional information about the topics discussed in this chapter. You know that the name to assign to that member will always be unique because CA-Roscoe associates your prefix with the name. Chapter 3.

3-6 CA-Roscoe 6.0 Getting Started Guide .

please sign back on. ■ Detaching and reattaching a library member and the AWS. ■ Bringing a copy of a library member into the AWS.Chapter 4. you will learn about: ■ Attaching a library member so that you can look at its contents. Retrieving and Displaying Data 4-1 . Chapter 4. If you have signed off CA-Roscoe. Retrieving and Displaying Data In this chapter.

... use PF keys to scroll through the contents.. This means that you are looking at the contents of a member in your library... Attached Library Member or A WORDS _ > > LIB(pfx.+. Type -> ATTACH WORDS Press the ENTER key....1. Try to move the cursor to the Execution Area of the screen.. You cannot modify the contents of the library member You can only modify the contents of the AWS.1 Displaying Data 4.+...+. you can look at its contents.2.... and enter a variety of commands to locate specific occurrences of words within the contents.....5. (As with the keyword AWS.+...... Notice that the System Information Line now begins with the keyword LIB.4.. to change a member..+. Therefore.4.. ================================= T O P ============== 1 A: Able.0 Getting Started Guide . 4-2 CA-Roscoe 6.. LIB is followed by the prefixed name of your library member.WORDS) SCRL FULL COLS 1 72 > <.1 Displaying Data You can use the ATTACH command* to look at the contents of your library member named WORDS..3. The following screen illustrates the first few lines of the resulting display. When a library member is attached. you must first bring a copy of it into the AWS.) Note: The chapter 'Updating Data' describes another way that you can view a library member.. 2 B: Baker...

4. The AWS will remain attached until you detach it. even though you have brought a copy of that member into the AWS.2 Displaying Data to Modify 4. Notice that the System Information Line still shows LIB.WORDS). You must then attach the AWS to see its contents. To view the contents of the AWS. indicating that your library member is attached. you must connect (or attach) the AWS to your terminal. you must first bring a copy of it into the AWS. Retrieving and Displaying Data 4-3 . 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 of your own library members. To do this. Press the ENTER key. or A Chapter 4. CA-Roscoe assumes you are referring a library member that you own. Type -> ATTACH Press the ENTER key. when you reference someone else's library member.2 Displaying Data to Modify To change the contents of a library member. Obviously then. you must include their prefix (for example. FETCH XYZ. If you do not include a prefix. Now the System Information Line shows that the AWS is attached.

Type -> ATTACH Press the ENTER key. Notice that the contents of the AWS is no longer displayed. The library member named WORDS is now attached. It is not displayed because the AWS is not attached. or A or A WORDS or A or DET The double commas have a special meaning to CA-Roscoe. The DETACH command explicitly releases whatever is attached. For example. For example. To use this command. Type -> ATTACH 5 . Press the ENTER key. Another character that has a special meaning to CA-Roscoe is the asterisk (*). Type -> DETACH Press the ENTER key. To reattach the AWS. if you typed ATTACH 500). The resulting display begins with the first line of the AWS.4.. only the line numbered 500 would be displayed. If you omitted them (for example.0 Getting Started Guide . you can begin the display with a specific line by including that line number with the command. they represent the last line in the AWS or the library member. To reattach the AWS. Type -> ATTACH WORDS Press the ENTER key. (Notice the keyword LIB on the System Information Line.. You can use it when reattaching data to have the display begin with the line that had been 4-4 CA-Roscoe 6. Using Special CA-Roscoe Reserved Characters When attaching or reattaching the AWS or a library member. the AWS is automatically detached when you attach a library member for display. You can implicitly release attached data by using any other command that causes output to the Execution Area.3 Detaching and Reattaching Data You can detach the AWS or a library member either explicitly or implicitly.3 Detaching and Reattaching Data 4. or A 5 . to attach the AWS and begin the display of its contents with line 500.) The data you brought into the AWS is still there. Type -> ATTACH Press the ENTER key.

the same line that had previously been the first line of the display. Chapter 4. Type -> ATTACH Press the ENTER key. Retrieving and Displaying Data 4-5 ... or A . to reattach the AWS. first detach the AWS.) Now.4. To illustrate how this works. Notice that the display begins with line 500. (You can do this using either the DETACH command or by attaching your library member WORDS. .3 Detaching and Reattaching Data the previously displayed first line.

Table 4-1 shows the title of the chapter and/or section in the CA-Roscoe User Guide where you can get additional information about the topics discussed in this chapter.4. you have learned how to: ■ Attach a library member. you will learn how you can scroll through the data in the AWS. Table 4-1. In the next chapter. 4-6 CA-Roscoe 6. ■ FETCH a copy of a library member into the AWS and the ATTACH the AWS to the terminal. ■ Use special CA-Roscoe reserved characters.4 Review/Summary In this chapter. ■ Detach and reattach a library member and the AWS.4 Review/Summary 4. Summary: Retrieving and Displaying Data TOPIC Attaching the AWS Attaching library members Bringing data into the AWS Reattaching the AWS Using Reserved Characters CHAPTER Attaching an AWS to the Terminal Attaching Library Data at the Terminal Attaching an AWS to the Terminal Attaching an AWS to the Terminal Commands and Command Components The CA-Roscoe Command Reference Guide contains a detailed description of the commands described in this chapter.0 Getting Started Guide .

Scrolling Through Data 5-1 . ■ Primary and line commands to reposition the display of data within the AWS. Chapter 5. Scrolling Through Data This chapter describes how you can use: ■ PF keys to scroll through attached data.Chapter 5.

the contents of the AWS or a library member). you have typed more definitions than can be displayed in a single screen. a list of assignments will be displayed. they will have updated the information provided by PA2.1 Using PF Keys to Scroll 5. Scroll the display to the right.1 Using PF Keys to Scroll If you are using a terminal with a 24-line screen. 5-2 CA-Roscoe 6.0 Getting Started Guide . By default. Your site management has the option of changing any PF or PA key assignment. Scroll the display to the left. towards the top of the screen). If they have done so. Scrolls forward (for example. Table 5-1.5. If you press this key. Table 5-1 shows the default scrolling functions that are assigned to PF keys. PF Keys Used For Scrolling KEY PF7 or PF19 PF8 or PF20 PF9 or PF21 PF10 or PF22 ASSIGNMENT Scroll backward (for example. a list of all PF and PA key assignments is assigned to PA2. You can use PF keys to scroll through whatever data is currently attached (for example. towards the bottom of the screen).

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 Press the ENTER key. The resulting display will begin with line 500. There are a number of line commands you 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 sequence number field of line 200 and, Type -> 3 Press the ENTER key. ■ Positionally. Move the cursor to the sequence number field of line 60 and, Type -> Press the ENTER key. You can also position the display to begin a specified number of lines before or after 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; *-5 would 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 display positions forward one page; -P positions the display backward one page. Try this command. Move the cursor to the sequence number field of line 60 and, Type -> -P Press the ENTER key. Since there is less than a full page, the resulting display scrolls back to the beginning of the AWS. If you specify a number with either of these commands, you will scroll that number 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 Bto scroll to the bottom. In the sequence number field of any line, Type -> T+ or B-

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

Chapter 5. Scrolling Through Data 5-3

5.3 Review/Summary

5.3 Review/Summary
In this chapter, you have learned: ■ How to use the PF keys to scroll through attached data. ■ How to use the POINT command and a variety of line commands to scroll through the contents of the AWS. Table 5-2 shows the title of the chapter and/or section in the CA-Roscoe User Guide where you can get additional information about the topics discussed in this chapter.
Table 5-2. Summary: Scrolling Through Data

TOPIC PF Key Assignments Scrolling

CHAPTER Using/Customizing PF/PA Keys Attaching an AWS to the Terminal

The CA-Roscoe Command Reference Guide contains a detailed description of the commands described in this chapter. In the next chapter, you will learn how you can use primary and line commands to modify the data that is in the AWS.

5-4 CA-Roscoe 6.0 Getting Started Guide

5.3 Review/Summary

Chapter 5. Scrolling Through Data 5-5

5-6 CA-Roscoe 6.0 Getting Started Guide .

Chapter 6. Rearrange and delete the contents of the AWS. It also describes commands that let you: ■ ■ ■ ■ Use multiple commands.Chapter 6. Modifying Data This chapter describes how you can use multiple primary and line commands and correct any invalid or incomplete command. Search for specific words within the AWS. Modifying Data 6-1 . and Change one or more occurrences of those words.

are just two of the commands that you can use to customize your CA-Roscoe session. described in Section 2.0 Getting Started Guide . separated by a command delimiter. When you do. You can execute multiple commands either by typing each command on a separate line in the Command Area. the primary commands SET DISPLAY NUMX and SET MODE XTENDED must be in effect. 6-2 CA-Roscoe 6. change the number of lines in the Command Area. CA-Roscoe records any changes you made to the data in the Execution Area and then executes first the line commands and then the primary commands. Note: These commands. etc. one of the exercises asked you to enter two line commands on different lines of the same screen. It tells CA-Roscoe where one command ends and other begins. Other session-related commands allow you to change the display margins. you can enter one or more primary and line commands on the same screen. as in: SET DISPLAY NUMX SET DISPLAY XTENDED or by typing them on a single line.2. The ampersand (&) is the default command delimiter.1 Using Multiple Commands 6.6.1 Using Multiple Commands If you have signed off. As you may have guessed. set tab positions. Remember that to use line commands and to have your data kept in the form in which you enter it. please sign back on. as in: SET DISPLAY NUMX & SET MODE XTENDED In the chapter on entering data.

.3...+. ============================= T O P ================= 1 2 B: Baker.2 Correcting and Changing Commands If you enter an invalid or incomplete primary command. you can correct the command in error.WORDS) SCRL FULL COLS 1 72 > . CA-Roscoe displays a message on the Response Line and positions the cursor to the command in error..... add or delete any commands that follow the corrected command.. You can even insert commands ahead of the corrected command..2 Correcting and Changing Commands 6.1.6. 4 D: Dog......+.2.. change it or delete it...... ..+. The following screen illustrates what happens if you enter an invalid or incomplete line command.5.4..... The following screen illustrates what happens if you attempt to FETCH and ATTACH a library member without specifying its name....... Modifying Data 6-3 . Chapter 6..+. Changing Invalid or Incorrect Primary Commands FETCH ATTACH > CMD13 INSUFFICIENT NUMBER OF OPERANDS SPECIFIED > AWS(pfx..+.. 3 C: Charlie.. Any commands following the invalid or incomplete command are not executed.. You can change. At this point..

Roscoe displays a message and halts processing.3. the Erase EOF key... or the space bar. 6 2 F: Fox. 6 V: Victor.. You can use the RESET line command to have CA-Roscoe ignore: 1) all of the currently displayed line command (and any pending line commands). 3 C: Charlie. To correct the command in error. or 3) use the RESET line command.6.2..+. 5 2 Z: Zebra.4.. and 2) any changes made to the currently displayed data...+... you can: 1) overtype it with a valid line command.1.5..+.. CA. No changes to the data are applied. . 5 E: Easy.WORDS) SCRL FULL COLS 1 72 > .... no primary commands are executed.. 6-4 CA-Roscoe 6..0 Getting Started Guide . XX 4 <<< ATX 1 INVALID COMMAND >>> 4 1 X: X-ray.. If you should enter an invalid or incomplete line command. 5 1 T: Tango...2 Correcting and Changing Commands Changing Incorrect or Invalid Line Commands > > AWS(pfx....+....+. no line commands are executed.......... 2) blank out the sequence number field using the Delete key.... ============================= T O P ================= 1 2 B: Baker. 6 1 S: Sierra.

you must specify the number of the first and last line in the range. Modifying Data 6-5 . You did not have to use the ATTACH command since the AWS is already attached to your terminal. To move line 502 to the top of the AWS. 6. CA-Roscoe increments the inserted lines by ones. Type -> MOVE 5 2 T Press the ENTER key. Several of them are not. you must always designate: ■ The line or lines of data to be moved. to move the definitions from B to D after the definition of T.3.3 Moving Data Within the AWS Assume that the definitions you have entered so far are supposed to be in alphabetic order.1 Using a Primary Command When you move lines within the AWS. Type -> MOVE 2 Press the ENTER key. You can specify this destination as a line number or the positional expressions T (meaning before the first line of the AWS) or B (meaning after the last line of the AWS). For example.3. and ■ The line at or after which the data is to be inserted. Please bring a fresh copy of the member WORDS into the AWS. CA-Roscoe provides both a primary command and several line commands that you can use to move one or more lines from one location to another within the AWS.6. Notice the line numbers. When data is inserted between existing lines. Type -> FETCH WORDS Press the ENTER key. To move multiple lines within the AWS. or F WORDS Chapter 6.2 Using Line Commands You are now going to use line commands to perform the same tasks you did with the MOVE primary command.3 Moving Data Within the AWS 6. 4 5 1 or M 2 4 5 1 or M 5 2 T 6.

Destination Line Commands COMMAND B A BB TT FUNCTION To insert before the line containing the command. To insert after the line containing the command.3 Moving Data Within the AWS As with the primary command.0 Getting Started Guide .6. Type -> TT Press the ENTER key. use the MM line commands. you must designate which lines are to be moved and the line where they are to be inserted. The move line commands require that you use specific destination line commands. Type -> M Now indicate the destination by moving the cursor to the sequence number field of the next line. position the cursor to the sequence number field of line 501. Table 6-1 lists some of the destination line commands. Place MM in the sequence number field of the first and last line in the range. Table 6-1. To move the line numbered 501 to the top of the AWS. To insert after the last line of the AWS. To move a range of lines. 6-6 CA-Roscoe 6. To insert before the first line of the AWS.

Do the move operation illustrated in the previous screen..+..5.+..1..3 Moving Data Within the AWS The following screen illustrates how you could move lines 1 and 100 after line 200.. Able. Dog..2. Easy... Zebra. Modifying Data 6-7 . Type -> MM Now move the cursor to line 100...3.WORDS) SCRL FULL COLS 1 72 > ..+.. Baker. ..+...... Chapter 6... Charlie.4. Fox..... Moving Multiple Lines > > AWS(pfx. move the cursor to line 200..... Victor...+.. Sierra... Move the cursor to the sequence number field of line 1.6... X-ray. Type -> A Press the ENTER key... ============================= T O P ================= MM MM 1 A 2 3 4 4 5 5 6 6 6 1 T: A: B: C: D: 1 X: E: 2 Z: V: 1 S: 2 F: Tango. Type -> MM Finally.

For example. to copy lines 300 through 500 after line 600. you can use a line number or the positional expressions T (meaning the top of the AWS) or B (meaning the bottom.) For example.4.6. to copy the last line of the AWS to the top of the AWS.2 Using Line Commands To copy one line. Then place a destination line command in the sequence number field of the appropriate line. 5 6 or C 3 5 6 6.1 Using a Primary Command As when moving data. you must designate what line or lines are to be copied and where the line(s) are to be placed. to place a copy of line 400 after line 200. Type -> A Press the ENTER key. (The copy and move line commands use the same destination line commands.) Press the ENTER key.0 Getting Started Guide . move the cursor to line 400 and in the sequence number field. For example. Type -> COPY 3 Press the ENTER key. Type -> C Now move the cursor to the sequence number field of line 200 and.4 Copying Data Within the AWS Move operations are referred to as destructive because data is removed from one place when it is inserted in another. Copy operations are not destructive since the lines being copied are not deleted from their original location.4 Copying Data Within the AWS 6. When specifying a destination. 6-8 CA-Roscoe 6. 6.4. you need to include the number of the first and last line to be copied plus the destination of the operation. place the C line command in the sequence number field of the line to be copied. To copy multiple lines. 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 is the top of the AWS.

if you use the R line command. Chapter 6. In the sequence number field of line 400. You could insert a blank line and then type your new definition.6. However.4 Copying Data Within the AWS There are also line commands that allow you to repeat one or more lines after themselves. you can repeat the existing line and then modify it as needed. Press the ENTER key. For example. on line 401. Now. Modifying Data 6-9 . suppose you have a second definition for 'D'. overtype the definition 'Dog' with 'Delta'. Type -> R Press the ENTER key.

1 Using Primary Commands You can use the DELETE command to remove one or more lines from the AWS. If you specify DELETE with just one line number.5 Deleting Data From the AWS As the result of your copy operations. 6.6.5 Deleting Data From the AWS 6. the entire contents of the AWS is deleted. you now have duplicate lines in the AWS. If you specify DELETE with two line numbers.0 Getting Started Guide . Type -> DELETE 4 1 Press the ENTER key.) or DEL 4 1 6-10 CA-Roscoe 6.5. the range of lines beginning with the first number and ending with the second is deleted. move the cursor to the Command Area. (Note: If you specify DELETE with no line numbers. only that line will be deleted. You can use either primary or line commands to remove these lines. To illustrate.

2 Using Line Commands If you type the D line command in the sequence number field of a line. Type -> DD Press the ENTER key.5. To illustrate. all of the lines encompassed by the two line commands will be deleted when you press the ENTER key. that line will be removed from the AWS when the ENTER key is pressed. Type -> DD Now move the cursor to the sequence number field of line 602.5 Deleting Data From the AWS 6. Lines 601 through 602 have been deleted.6. Chapter 6. Modifying Data 6-11 . If you type a DD line command in the sequence number field of one line and then another DD line command in the sequence number field of a different line. move the cursor to the sequence number field of line 601.

To renumber the contents of the AWS.6 Renumbering the AWS 6.0 Getting Started Guide . entering RENUMBER with no operands causes the AWS to be renumbered by 100. moving. move the cursor to the Command Area.6. to have the lines in the AWS number by tens. Type -> RENUMBER Press the ENTER key. 1 or R 1 1 or R 6-12 CA-Roscoe 6. For example.6 Renumbering the AWS Notice what has happened to the line numbers while you have been inserting. You can renumber using a different starting value and increment. They are no longer numbered sequentially by 100. You can renumber the AWS at any time during your terminal session. copying and deleting lines. Type -> RENUMBER 1 Press the ENTER key. As you know.

We're using the term 'string' instead of 'word' because you can look for one or more words..+... 6...+.+.2..7. 1 S: Sierra..... to use the INCL primary command to display all of the lines that contain the string 'ra'.6..+. Type -> INCL ra Press the ENTER key.... In fact.. move the cursor to the Command Area.... When using the INCL or EXCL line command.5. the command is typed in the sequence number field of the first line to be searched.... ======================= INCL/EXCL DISPLAY ============== 5 X: X-ray... Chapter 6..3...4..7 Locating Specific Words Within the AWS 6.+.... Notice that the cursor is positioned to the first occurrence of the string. For example.. 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 > AWS(pfx... even those including spaces. 8 Z: Zebra.. the character string is typed in the data portion of the same line. Then.7 Locating Specific Words Within the AWS There are a number of commands you can use to locate and display one or more occurrences of a string of characters within the AWS. you can look for any arrangement of characters.1.+.WORDS) SCRL FULL COLS 1 72 > .1 Locating All Occurrences You can use the INCL or EXCL primary or line commands to display all lines including or excluding a specific character string. Modifying Data 6-13 ..... .

In our examples. 5 X: X-ray. we use the slash (/) to delimit character strings....0 Getting Started Guide .3. you need to tell CA-Roscoe where your string starts and stops.....WORDS) SCRL FULL COLS 1 72 > .. 9 V: Victor.7 Locating Specific Words Within the AWS Use a PF key assigned a scroll function or the ATTACH command to position the display to begin with the first line in the AWS..+. You will see that with EXCL every line that does not contain the string is displayed..1. Type -> /ra/ When you type a string in the data portion of a line. Also.5.. 6 E: Easy. 6-14 CA-Roscoe 6....+. ============================= T O P ================= EXCL /ra/ 2 B: Baker.. (After you execute this command.....2.. the data that you overtyped is redisplayed. 4 D: Dog... Type -> EXCL Now move the cursor to the data portion of the same line. 3 C: Charlie.+. 11 F: Fox.6. notice that the format of the resulting display is the same as that produced by the INCL primary command. 1 S: Sierra. Press the ENTER key.. 8 Z: Zebra..) The following screen illustrates how this line command and its string operand should be entered: Using the EXCL Line Command > > AWS(pfx... Move the cursor to the sequence number field of line 10.. ... called a string 'delimiter'. 7 T: Tango.4....+.... You do this by bounding the string with a special character...+.

Type -> /er/ The following screen illustrates the placement of the line command and its string. line 50).7 Locating Specific Words Within the AWS Actually. Type -> FIRST to Press the ENTER key. Please position the display to begin with the first line in the AWS.7. LAST. For example. NEXT and PREV primary and line commands to locate and display specific occurrences of a character string. Modifying Data 6-15 . let's use a line command to find the last occurrence of a string. let's use a primary command to locate the first occurrence of the string 'ra'. you did not have to enter the string 'ra' since you used that string with the INCL primary command. Chapter 6.6. In the sequence number field. Once you have specified a string.2 Locating Specific Occurrences You can use the FIRST. Type -> LAST Now move the cursor to the data portion of the same line. Move the cursor to the Command Area. 6. Then move the cursor to the first line in the Execution Area. it is remembered and used with every subsequent INCL and EXCL primary or line command that does not include a string. LAST. NEXT and PREV primary and line command that does not include a string. Now. It is also used with every FIRST. The resulting display begins with the first line containing 'ra' (for example.

.. Press the ENTER key.... Once you have specified a string.+.. . the line containing the string is presented as the first displayed line.+.. FIRST. 5 X: X-ray....0 Getting Started Guide . As their names imply. 6-16 CA-Roscoe 6. NEXT and PREV primary and line commands that do not include a string.. 3 C: Charlie.+. 8 Z: Zebra.. you need not retype the string each time you use the command..4.. it is remembered and used in subsequent EXCL... 11 F: Fox....7 Locating Specific Words Within the AWS Using the LAST Line Command > > AWS(pfx. Type -> PREV Press the ENTER key. The resulting display begins with line 100. INCL.6. 4 D: Dog..2.. move the cursor to the Command Area. In every instance. 7 T: Tango... If you are looking for multiple occurrences of the same string. you can use the NEXT and PREV primary and line commands to find the next occurrence of a string or the previous occurrence of a string..+...5... 6 E: Easy.WORDS) SCRL FULL COLS 1 72 > . LAST. ============================= T O P ================= LAST /er/ 2 B: Baker.. 1 S: Sierra.... The previous occurrence of the string 'Female' now begins the display.+... 9 V: Victor..3.. For example. the line containing the last occurrence of 'er' in the AWS.1..

CA-Roscoe needs to know where the string starts and stops. the string contains a space or matches an operand of the command. Since you're typing the string in the data portion of the Execution Area. When you are using a line command. Usually. as in: FIRST to If. as in: FIRST /F: Fox/ Chapter 6.7 Locating Specific Words Within the AWS One last note about locating a string. you must delimit the string. Modifying Data 6-17 . you must delimit the string. you do not have to delimit the string you specify with a primary command. however.6.

you must specify a search string that is followed by a replacement string. and ■ ET to change strings on lines between the first line of the AWS through the line containing the command. Type -> EB and then position the cursor to the data portion of the same line. For example. ■ EE (on the first and last line of a range) to change a string on a range of lines. As with the primary command. move the cursor to the Command Area. you can move the cursor to that word and over-type it with the correct spelling. E.6.0 Getting Started Guide . You can include operands with this command to limit its scope of operation to specific columns and/or a specific range of lines. it could get cumbersome if you decide that you want to change multiple occurrences of the same word or a group of words.2 Using Line Commands You can use the line commands.1 Using a Primary Command You can use the EDIT command to replace one string of characters with another.8.8 Changing Words Within the AWS There may be occasions when you will want to modify the words that are in the AWS. You will see that every occurrence of the string 'er' in the AWS has been changed to the string 'xx'. EE. to change every occurrence of a string from the line on which the command is entered through the end of the AWS.8. ■ EB to change a string on lines between the line containing the command and the end of the AWS. EB and ET to change one character string to another.8 Changing Words Within the AWS 6. While this is a simple procedure. move the cursor to the first displayed line. For example. Use: ■ E with an optional numeric value to change strings on specific lines. Type -> EDIT /er/xx/ Press the ENTER key. if you discover that you have misspelled a word. CA-Roscoe provides a number of commands that allow you to replace one or more words. 6. Type -> /xx/er/ 6-18 CA-Roscoe 6. or E /er/xx/ 6. Therefore.

..+.....+..+..6... Chapter 6. ============================= T O P ================= EB /xx/er/ 2 B: Baker...WORDS) SCRL FULL COLS 1 72 > ....4.+.. 4 D: Dog..... Using the EB Line Command > > AWS(pfx...1.. Press the ENTER key...2.. 5 X: X-ray. 3 C: Charlie...... Modifying Data 6-19 .8 Changing Words Within the AWS The following screen illustrates the placement of this command and its strings..5.... ..+..3.

■ Locate all or specific strings of characters within the AWS.0 Getting Started Guide . Table 6-2. rename and even delete the member.9 Review/Summary 6. 6-20 CA-Roscoe 6. delete and renumber lines within the AWS. change the attributes of the member.9 Review/Summary In this chapter. In the next chapter. ■ Replace one character string with another within the AWS. Summary: Modifying Data TOPIC Using Multiple Commands and Correcting Commands Session Options Changing Words Copying Lines Deleting Lines Locating Words Moving Lines Repeating Lines CHAPTER Commands and Command Components Displaying/Changing Session Status Information Changing Character Strings Within the AWS Copying Data Within the AWS Deleting Data Within the AWS Locating a Character String Within the AWS Moving Data Within the AWS Copying Data Within the AWS The CA-Roscoe Command Reference Guide contains a detailed description of the commands described in this chapter. Table 6-2 shows the title of the chapter and/or section in the CA-Roscoe User Guide where you can get additional information about the topics discussed in this chapter. you have learned how to use multiple commands and correct any that may have been entered incorrectly.6. You have also learned how to use primary and line commands to: ■ Move. you will learn how you can update the contents of a library member. copy.

Updating Data This chapter describes how you can: ■ Update the contents of an existing library member.Chapter 7. ■ Use primary command or the Library Facility to: – – – – Obtain library member information. Chapter 7. Delete a library member. Change the attributes of a library member. Change the name of a library member. Updating Data 7-1 .

the contents of that member will be updated. or U or U WORDS 7-2 CA-Roscoe 6. the asterisk has a special meaning to CA-Roscoe.7. As has already been noted. Since WORDS is the name of the last member you FETCHed. SAVEd or UPDATEd with the contents of the AWS. you probably want to modify your library member to reflect those changes.1 Updating a Library Member 7. Type -> UPDATE WORDS or Type -> UPDATE Press the ENTER key. it tells CA-Roscoe to update the last member that you FETCHed. UPDATE causes the contents of a library member to be replaced by all or part of the contents of the AWS.1 Updating a Library Member Now that you have made changes to the definitions in the AWS.0 Getting Started Guide . In this example. to update your member. Thus. The command that performs this task is UPDATE.

.RES.2 Obtaining Library Member Information You know the CA-Roscoe library contains your member WORDS....2 Obtaining Library Member Information 7..+..COPY MEMBERS I If this is the first time you are using the Library Facility..+.6....2..NOD) YES .DELETE MEMBERS .+.. To do this: Type -> LIBRARY Press the ENTER key....+.3.. CA-Roscoe will display the name of that member and ask you to confirm that you want the member deleted. The following screen illustrates the next display you will see.RENAME MEMBERS ..ATTACH LIBRARY D ........INFO MEMBERS P R X ... the menu will contain your CA-Roscoe prefix. you can use the Library Facility to display a list of your library members..+.4. Library Facility Menu > > LIB() SCRL FULL COLS 1 79 ... but what other library members are saved under your prefix? At any time during your session..+.. sign-on key and formal key.5..PRINT MEMBER .TERMINATE LIB . Chapter 7...7..1.EXE. The YES with CONFIRM DELETE means that if you try to delete one of your library members. Updating Data 7-3 .. LIBRARY FACILITY FUNCTION PREFIX MEMBER SIGNON KEY FORMAL KEY SEARCH CONFIRM DELETE A C ==> ==> ==> ==> ==> ==> ==> your prefix your signon key your formal key (SHR.

.4.0 Getting Started Guide . ==================================== T O P =================== SIGNON KEY MEM EXCL BLOCKS M-LINES LINES your-key 3 23 2 34 MEMBER STATUS DESCRIPTION LINES ATR SEQNO XYZ.+.+.. Type -> A (in FUNCTION field) Press the ENTER key.. For example.WORDS NROS1 datetime 1 SHR NOSEQ 1 SHR 73. therefore.. Number of library members included in the Selection List. 7-4 CA-Roscoe 6....+.. Eventually.. We are going to use the code A.... divided into alternate displays. Type -> SELECT ALT Press the ENTER key. you will return to the original display.+. to attach a list of your library members..1. Every time you do this. They show: SIGNON KEY MEM Your sign-on key. the next sequential display is presented.. The first two lines in the list remain constant as you scroll through the Selection List..7..+. You can change the display to view different information.. you can use a Selection List to perform specific actions.JUNK XYZ....3. however...2 Obtaining Library Member Information The codes at the bottom of the previous screen indicate the types of actions you can perform.2.. in addition to displaying information... you can display the contents of that member.8 23 SHR 73.6. The information is..5..+. if you type a library member name in the field MEMBER and an A in the FUNCTION field... Make sure that no library member name appears in the MEMBER field and then.. The following screen illustrates the type of information that is contained in the resulting member Selection List...SAVAWS 1 XYZ...8 The amount of information provided by this Selection List exceeds the width of 80-column screens... (As you will see later..) Library Selection List Description > > LIB() SCRL FULL COLS 1 72 LINE 1 .

Updating Data 7-5 . Member's access attribute. shown as XYZ in the previous screen.) Description of the member. The default (shown as 073. Numbers indicating where sequence numbers are to be positioned when the member is printed.l No sequence numbers are to be included when you print this member. The remaining fields identify the individual members comprising the List and include: MEMBER Name of the library member. Maximum number of lines you may save in the library or N/A if you have no limit. Prevents anyone from looking at or executing your member. prevents anyone from looking at your member. CREATED UPDATED ACCESS Chapter 7.2 Obtaining Library Member Information EXCL BLOCKS M-LINES LINES Number of library members that site management caused to be excluded from the display.7. Number of library blocks used by the members included in the List. (Use with RPF programs. Number of lines the member contains. (The name begins with your two or three character CA-Roscoe prefix.) Allows anyone to execute your member. DESCRIPTION LINES ATR SEQNO Member's sequence number attribute. Date the member was last accessed. if available. shown as: SHR RES EXE Allows anyone to look at or execute your member. shown as: NOSEQ col.8) causes sequence numbers to begin in column 73 and be eight digits long. Date the member was created. Number of lines contained within all of the members included in the display. This is the default. Date the member was last updated.

your member WORDS does not have a description. Also.. to add a description to your member... the access and sequence number attributes are the defaults assigned by CA-Roscoe..+..0 Getting Started Guide .....3. Type -> ALTER WORDS /DEFINITIONS/ Press the ENTER key.+..SAVAWS 1 pfx.8 You can also use this Selection List to change the description and/or attributes of a member.. If you only want to change a member's description and/or attributes..7... For example. You can add or change the information when you update the member (using the UPDATE command)..+. Library Selection List Description > > LIB() SCRL FULL COLS 1 72 LINE 1 .4.3 Changing Member Attributes As illustrated in the following screen.+....3 Changing Member Attributes 7.....WORDS NROS1 datetime DEFINITIONS 1 SHR NOSEQ 1 SHR 73..6... 7-6 CA-Roscoe 6...+.1.8 23 SHR 73... you can use the ALTER command..5...2. ==================================== T O P =================== SIGNON KEY MEM EXCL BLOCKS M-LINES LINES SMITH 3 23 2 34 MEMBER STATUS DESCRIPTION LINES ATR SEQNO pfx. REFRESH updates the Selection List to include your description of WORDS.JUNK pfx. Type -> REFRESH As illustrated in the following screen. You can specify a description and attributes when you initially save the data (using the SAVE command).+.... To verify that the description has been added to the member...

JUNK pfx.. First type AT (for alter attribute) before the member WORDS..1.. To verify that the sequence number has been changed.7..4.3 Changing Member Attributes The following screen illustrates how you can change the sequence number attribute of that member.8 23 SHR noseq Press the ENTER key.+..... Updating Data 7-7 .+.. Type -> REFRESH The resulting display shows that the sequence number attribute has been changed..) Then..6.WORDS NROS1 datetime DEFINITIONS 1 SHR NOSEQ 1 SHR 73.......+..+....SAVAWS 1 AT pfx.2...5.. ==================================== T O P =================== SIGNON KEY MEM EXCL BLOCKS M-LINES LINES SMITH 3 23 2 34 MEMBER STATUS DESCRIPTION LINES ATR SEQNO pfx..+..... (Its shown as the first shaded area.+.8 with NOSEQ...... Changing Member Attributes > > LIB() SCRL FULL COLS 1 72 LINE 1 . tab to the sequence number field and overtype 073. Chapter 7.3....

(The second shaded area..+.. Type -> RENAME WORDS name Replace 'name' with any name you want. There is an entry for the member with the name that you assigned...4 Renaming a Member 7.6. Type -> REFRESH Notice that there is no entry for the member named WORDS. 7-8 CA-Roscoe 6. the member named WORDS is renamed SAMPLE. In this case.to 8-characters in length and start with an alphabetic character..4.5..) Renaming a Member > > LIB() SCRL FULL COLS 1 72 LINE 1 ....WORDS SAMPLE NROS1 datetime 1 SHR NOSEQ 1 SHR 73.. To verify that you library member has been successfully renamed... ==================================== T O P =================== SIGNON KEY MEM EXCL BLOCKS M-LINES LINES SMITH 3 23 2 34 MEMBER STATUS DESCRIPTION LINES ATR SEQNO pfx.4 Renaming a Member Suppose you decide that the name WORDS is not an appropriate name for your library member..) To change the member's name.+........ (Remember that library members names must be 1....8 R If you try this form of renaming..) Press the ENTER key.2.+. You can also use the list to rename a member... (You can also change the member's description and attributes at the same time.SAVAWS 1 pfx. (In the first shaded area..+. You can use the RENAME command to change the member's name..+. an R (for rename) is typed before the member name.. In the example shown in the following screen.JUNK pfx.....7. use the REFRESH command again to verify that your member was successfully renamed.3..8 23 SHR 73.0 Getting Started Guide .) Then the new member name is typed in the STATUS field...1..+.

..WORDS NROS1 datetime 1 SHR NOSEQ 1 SHR 73. With the D code. Deleting a Member > > LIB() SCRL FULL COLS 1 72 LINE 1 ..+..+. you may be asked to confirm that the member is to be deleted.5.. The list shown in the following screen includes a member named JUNK.+..SAVAWS 1 pfx...+...4...7. you must enter DELETE a second time....3. Updating Data 7-9 . With the DELETE command.. you must enter YES or Y.+...5 Deleting a Member 7..+.8 When you attempt to delete a member. Chapter 7.1.. To remove this member using the command.8 23 SHR 73. Type -> DELETE JUNK or DEL JUNK To remove this member using the Selection List......JUNK pfx..2. You can use the DELETE command or the Selection List to remove that member from your library......6... ==================================== T O P =================== SIGNON KEY MEM EXCL BLOCKS M-LINES LINES SMITH 3 23 2 34 MEMBER STATUS DESCRIPTION LINES ATR SEQNO D pfx..... type a D (for Delete) before the appropriate member name.5 Deleting a Member Suppose you decide that you no longer need a library member.

7. you will learn how you can print the contents of the AWS and/or a library member. In the next chapter. you have learned how to: ■ ■ ■ ■ ■ Update the contents of a library member.6 Review/Summary 7. Rename a library member.6 Review/Summary In this chapter. Change library member attributes.0 Getting Started Guide . Delete a library member. Table 7-1. Display information about your library members. Summary: Updating Data TOPIC Changing Member Attributes Deleting a Member Displaying Member Information Renaming a Member Updating a Member CHAPTER Performing Library Management Tasks Performing Library Management Tasks Performing Library Management Tasks Performing Library Management Tasks Saving Data as a Library Member The CA-Roscoe Command Reference Guide contains a detailed description of the commands described in this chapter. Table 7-1 shows the title of the chapter and/or section in the CA-Roscoe User Guide where you can get additional information about the topics discussed in this chapter. 7-10 CA-Roscoe 6.

7.6 Review/Summary Chapter 7. Updating Data 7-11 .

0 Getting Started Guide .7-12 CA-Roscoe 6.

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

The following illustrates how you might assign the tag SAMPLE to your print request: Print 'sample' words ■ Print multiple copies of a request.0 Getting Started Guide . If you use a tag. Type -> PRINT WORDS In addition. it must be: 1. The message includes the tag (if you specified one). For example. and placed immediately after the PRINT command. begin with an alphabetic character. the print request number assigned by CA-Roscoe and the location at which your request is scheduled to print. you can: ■ Assign a name or 'tag' to your print request. to print three copies of your print request.8.1 Identifying What to Print To print the contents of the AWS.1 Identifying What to Print 8.to 8-characters. bound by apostrophes. Type -> PRINT or P To print the contents of a library member. you might enter: Print 'sample' words copy 3 A confirmation message is displayed on the Response Line when the PRINT command is executed. or P WORDS 8-2 CA-Roscoe 6. include the name of the member with the PRINT command.

8. This includes your prefix. if you specified one. The member contains a variety of information that: ■ Identifies each request. or P STATUS Chapter 8.2 Determining the Print Status After your request is scheduled for printing. ■ The number of records to be printed and how many remain to be printed. you can obtain information about it. the request number assigned by CA-Roscoe and the tag name. ■ The name of the location where the request is to be printed. this member is attached to the terminal for display. Type -> PRINT STATUS Press the ENTER key.2 Determining the Print Status 8. This command creates a library member for you that contains information about your outstanding print requests. Printing Data 8-3 . ■ The current status of the request. By default.

In the next chapter. you have learned how to: ■ ■ ■ ■ Print a copy of the contents of the AWS.0 Getting Started Guide .3 Review/Summary 8. Obtain the status of your outstanding print requests.8. The CA-Roscoe Command Reference Guide contains a detailed description of the commands described in this chapter.3 Review/Summary In this chapter. 8-4 CA-Roscoe 6. you will learn how you can send and receive messages through CA-Roscoe. Print multiple copies of a print request. If you would like additional information about printing the contents of the AWS or a library member. Print the contents of a library member. see the chapter 'Printing Data' in the CA-Roscoe User Guide.

Printing Data 8-5 .8.3 Review/Summary Chapter 8.

0 Getting Started Guide .8-6 CA-Roscoe 6.

Chapter 9. Communicating With Others 9-1 .Chapter 9. Communicating With Others This chapter describes how to send messages to other users.

the keyword AWS indicates that the message we want to send is in the AWS. Then when you issue the SEND command. as in: send aws key=brown 'report on meeting' In this example.1 Sending Messages You can send messages to other CA-Roscoe users if you know their sign-on key or prefix. The message with this command is optional. Here it is used to identify the information being sent. to send a short message (that is less than 64 characters in length) to the user whose sign-on key is SMITH.1 Sending Messages 9.0 Getting Started Guide . 9-2 CA-Roscoe 6. you would enter: send key=smith 'meeting at 11: in conference room a' To send the same message. identify the location of the message. For example. an apostrophe (') is used in the preceding example). using the user's prefix.9. type the text in either the AWS or a library member. If you want to send a longer message to a CA-Roscoe user. 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.

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 entries contain: 1. For example.9. the day. the month (in hexadecimal). an entry is added to the top of the member ZZZZZMSG in your library. To view the message. represents the month October in hexadecimal). you must ATTACH the member. A created at 9:15 AM on October 15 is saved as ZA150915 (where the second character. Name of the member in your library that contains the message. the hour and the minute the member was created. a member created at 3:25 PM on January 6 is saved as Z1061525. Communicating With Others 9-3 . String Note the user included with the SEND command. ■ Multi-line message The following note is displayed on the Response Line of your terminal: MSG FROM key IN MEMBER Zmddhhmm 'string' where: key Zmddhhmm Sender's sign-on key. the name of the created library member(s) that contains the multi-line message(s). the one-line message and 2. The message text is preceded by the sender's prefix. If you are not signed on or sign off before receiving the message. Chapter 9. A. This unique member name is created by CA-Roscoe and consists of the character Z.2 Receiving Messages 9.

you have learned how to: ■ Send a message to another CA-Roscoe user. 9-4 CA-Roscoe 6.3 Review/Summary 9.3 Review/Summary In this chapter.9. If you would like additional information.0 Getting Started Guide . ■ Receive messages that other CA-Roscoe users send to you. refer to the CA-Roscoe Command Reference Guide. see the chapter 'Sending/Receiving Messages' in the CA-Roscoe User Guide. For a detailed description of the command described in this chapter.

3 Review/Summary Chapter 9.9. Communicating With Others 9-5 .

0 Getting Started Guide .9-6 CA-Roscoe 6.

all of the tasks described in it are also applicable to programmers. Other Things You Can Do 10-1 .Chapter 10. CA-Roscoe's primary purpose is to simplify the tasks performed by programmers. Other Things You Can Do While this manual is intended to be read by non-programmers. This chapter highlights some of these tasks and how CA-Roscoe can be of assistance. In fact. Chapter 10.

It also can check COBOL source code in the AWS or in a specified library member. ■ Copy an attached job output file into the AWS. ■ Detach the job output and. and how many jobs are in each job class.). what initiators have been assigned to each job class. etc. DISPLAY allows you to see what the job is doing (awaiting execution. there are a number of CA-Roscoe commands that you can use to: ■ Position within the job output. awaiting print. you can monitor its progress with the DISPLAY command.1 Submitting and Viewing Jobs Syntax Checking Data The JCL command invokes the job control language syntax checker. The COBOL syntax checker is invoked by the COB command. what its position on the job queue is. By site option. ■ Print an attached job output file. At some MVS sites. 10-2 CA-Roscoe 6. optionally. ■ Reattach job output at the first file in the job or at a specific location within the job.10.1 Submitting and Viewing Jobs 10. ■ Locate and note data within one or more output files. It can be used to check JCL statements in the AWS or a library member. Submitting Data as a Job Stream You can submit the contents of the AWS and/or one or more library members to the operating system at any time during your terminal session. executing. you do not need to use the DISPLAY command to check the status of your jobs. ■ Display and alter file attributes.0 Getting Started Guide . Once a job is attached. noprint or hold status. Checking the Status of Submitted Jobs Once you have submitted a job for execution. you may receive JES2 or JES3 messages at your terminal 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 JOB command. dispose of the files based on its print.

2 Performing Data Management Tasks 10. ■ Write the contents of the AWS and/or one or more library members to a data set. Information about all or selected volumes.be it an OS data set or a CA-Librarian master file. The VTOC (volume table of contents) of a device. ■ Delete a member. module or data set. ICF catalog or OS CVOL. ■ Rename a member. ■ Copy the data set into the AWS where it can be modified and/or saved in the CA-Roscoe library. Chapter 10. Other Things You Can Do 10-3 . A CA-Librarian master file index. The entries in a SAME catalog. ■ Allocate a data set. ■ Print a copy of the data set.10. module or data set.2 Performing Data Management Tasks CA-Roscoe makes it easy for you to: ■ Browse a data set . ■ Display a Selection List that contains: – – – – – A PDS (partitioned data set) directory. ■ Catalog or uncatalog a data set.

10.3 Learning About RPF

10.3 Learning About RPF
RPF (the ROSCOE Programming Facility) is a structured, interactive programming language that can be used to write programs for many different types of applications. In addition to its own commands, statements, and functions, RPF permits all CA-Roscoe commands to be embedded within the program. When these commands are encountered during program execution, they are executed as if the user had entered them from the terminal. Additional information about RPF is available from: ■ The online, interactive training program TRAINING. This program is written using 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 the various components of the language to perform specific tasks. The second segment contains a detailed description of the commands and functions comprising the language.

10-4 CA-Roscoe 6.0 Getting Started Guide

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. If you will be executing applications via ETSO, your site management will tell you what the applications are and how you should execute them.

Chapter 10. Other Things You Can Do 10-5

10.5 Executing TSO Commands

10.5 Executing TSO Commands
TSO commands can be entered from the CA-Roscoe command line and from within RPF programs. This is an extension to ETSO that allows you to easily switch between the use of TSO facilities and native CA-Roscoe facilities. With this command, you can execute CLISTs as well as REXX execs. These procedures 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. To execute CLIST and REXX execs, TSO/E 2.1 or above is required.

10-6 CA-Roscoe 6.0 Getting Started Guide

Performing OS data management tasks. Chapter 10. Executing TSO commands from CA-Roscoe. Other Things You Can Do 10-7 . you have learned about: ■ ■ ■ ■ ■ Submitting and viewing job output.6 Review/Summary In this chapter. ETSO. see the appropriate chapters in the CA-Roscoe User Guide.6 Review/Summary 10. For additional information about any or all of these facilities.10. The RPF programming language.

10.6 Review/Summary 10-8 CA-Roscoe 6.0 Getting Started Guide .

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 .

.+..1 Online HELP Facility The online HELP facility is a quick and easy way to get information about CA-Roscoe commands and facilities.+.... to obtain information about the SAVE command.+... Sample HELP Facility Display or H SAVE _ > > HLP(.. . The following screen illustrates the type of information displayed..1.+.. Name to be assigned to library member being created.3..11. .4.....6 SAVE Function: Places all or part of contents of AWS into library as member....0 Getting Started Guide .HELP. Syntax: SAVE mem < p<q> > < 'string' > < NOSEQ/SEQ <s<l>>/COBOL > < SHARED/EXECONLY/RESTRICTED > mem p q ......2.) SCRL FULL COLS 1 79 >. . Type -> HELP SAVE Press the ENTER key.. For example.. Number of the first and last lines of AWS to be saved..1 Online HELP Facility 11... ....+..5.+.... 11-2 CA-Roscoe 6... ....

or H Chapter 11. forward to the next level. Learning More About CA-Roscoe 11-3 . Note that with the HELP facility. Type -> HELP Press the ENTER key. Use: PF7 or PF19 PF8 or PF20 PF10 or PF22 PF11 or PF23 To To To To scroll scroll scroll scroll back to the beginning of the current level.11. back to the previous level. forward within the current level. the scrolling functions have been assigned to specific PF keys.1 Online HELP Facility To obtain information about the HELP facility itself.

you are presented with a menu of that shows a number of independent learning modules. Type -> HELP TUTORIAL Press the ENTER key.11. or vary the order in which you complete the modules. interactive training aid that simulates an an actual CA-Roscoe session and introduces the most frequently used CA-Roscoe commands and facilities. To find out how to execute the training at your site. or H TUTORIAL 11-4 CA-Roscoe 6.2 Online Training TUTORIAL is an online.2 Online Training 11. You can complete the modules in order. use only certain modules.0 Getting Started Guide . When you execute the TUTORIAL.

and customize the CA-Roscoe system.11. Chapter 11. including creating and updating library members and data sets. The documentation set consists of a User series and a System series. and submitting jobs. The System series contains all information necessary for CA-Roscoe system administrators to install.3 Documentation 11. Learning More About CA-Roscoe 11-5 .3 Documentation The section in the beginning of this manual entitled 'About This Guide' includes a description of all the documentation that is distributed with CA-Roscoe. maintain. The User series contains all documentation required for users to perform online processing.

0 Getting Started Guide .3 Documentation 11-6 CA-Roscoe 6.11.

Sign up to vote on this title
UsefulNot useful