B001642e - Getting Started

Advantage CA-Roscoe
 
Interactive Environment
Getting Started
r6
This documentation and any related computer software help programs (hereinafter referred to as the
“Documentation”) is for the end user’s informational purposes only and is subject to change or withdrawal by CA at
any time.
This Documentation may not be copied, transferred, reproduced, disclosed, modified or duplicated, in whole or in
part, without the prior written consent of CA. This Documentation is confidential and 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 the documentation for
their own internal use, and may make one copy of the related software as reasonably required for back-up and
disaster recovery purposes, 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 provisions of the license for
the product are permitted to have access to such copies.
The right to print copies of the documentation and to make a copy of the related software is limited to the period
during which the applicable 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 certify in writing to CA that all copies and partial copies of the
Documentation have been returned to CA or destroyed.
EXCEPT AS OTHERWISE STATED IN THE APPLICABLE LICENSE AGREEMENT, 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 the Documentation is governed by the end user’s applicable license
agreement.
The manufacturer of this Documentation is CA.
Provided with “Restricted Rights.” Use, duplication or disclosure by the United States Government is subject to the
restrictions set forth in FAR Sections 12.212, 52.227-14, and 52.227-19(c)(1) - (2) and DFARS Section 252.227-
7014(b)(3), as applicable, or their successors.
All trademarks, trade names, service marks, and logos referenced herein belong to their respective companies.
Copyright  2005 CA. All rights reserved.

Contents
About This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
Chapter 1. Introducing Advantage CA-Roscoe . . . . . . . . . . . . . . . . 1-1
Chapter 2. Signing On and Entering Data . . . . . . . . . . . . . . . . . . 2-1

2.1 Signing On to Advantage CA-Roscoe . . . . . . . . . . . . . . . . . . . . 2-2
2.2 Entering Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5
2.2.1 Using Primary Commands . . . . . . . . . . . . . . . . . . . . . . . 2-5
2.2.2 Using Line Commands . . . . . . . . . . . . . . . . . . . . . . . . . . 2-8
2.3 Review/Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-11
Chapter 3. Saving Data and Signing Off . . . . . . . . . . . . . . . . . . . 3-1

3.1 Introducing the Advantage CA-Roscoe Library . . . . . . . . . . . . . . 3-2
3.2 Saving Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
3.3 Signing Off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
3.4 Review/Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5
Chapter 4. Retrieving and Displaying Data . . . . . . . . . . . . . . . . . 4-1

4.1 Displaying Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
4.2 Displaying Data to Modify . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3
4.3 Detaching and Reattaching Data . . . . . . . . . . . . . . . . . . . . . . . 4-4
4.4 Review/Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6
Chapter 5. Scrolling Through Data . . . . . . . . . . . . . . . . . . . . . . . 5-1

5.1 Using PF Keys to Scroll . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2
5.2 Using Commands to Scroll . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3
5.3 Review/Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5
Chapter 6. Modifying Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1

6.1 Using Multiple Commands . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2
6.2 Correcting and Changing Commands . . . . . . . . . . . . . . . . . . . 6-3
6.3 Moving Data Within the AWS . . . . . . . . . . . . . . . . . . . . . . . . 6-5
6.3.1 Using a Primary Command . . . . . . . . . . . . . . . . . . . . . . . 6-5
6.4 Copying Data Within the AWS . . . . . . . . . . . . . . . . . . . . . . . 6-8
6.4.1 Using a Primary Command . . . . . . . . . . . . . . . . . . . . . . . 6-8
6.5 Deleting Data From the AWS . . . . . . . . . . . . . . . . . . . . . . . 6-10
6.5.1 Using Primary Commands . . . . . . . . . . . . . . . . . . . . . . 6-10
Contents iii
6.5.2 Using Line Commands . . . . . . . . . . . . . . . . . . . . . . . . . 6-10
6.6 Renumbering the AWS . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-11
6.7 Locating Specific Words Within the AWS . . . . . . . . . . . . . . . . 6-12
6.7.1 Locating All Occurrences . . . . . . . . . . . . . . . . . . . . . . . 6-12
6.7.2 Locating Specific Occurrences . . . . . . . . . . . . . . . . . . . . 6-14
6.8 Changing Words Within the AWS . . . . . . . . . . . . . . . . . . . . 6-17
6.8.1 Using a Primary Command . . . . . . . . . . . . . . . . . . . . . . 6-17
6.8.2 Using Line Commands . . . . . . . . . . . . . . . . . . . . . . . . . 6-17
6.9 Review/Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-19
Chapter 7. Updating Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1

7.1 Updating a Library Member . . . . . . . . . . . . . . . . . . . . . . . . . 7-2
7.2 Obtaining Library Member Information . . . . . . . . . . . . . . . . . . 7-3
7.3 Changing Member Attributes . . . . . . . . . . . . . . . . . . . . . . . . 7-6
7.4 Renaming a Member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-8
7.5 Deleting a Member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-9
7.6 Review/Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-10
Chapter 8. Printing Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-1

8.1 Identifying What to Print . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-2
8.2 Determining the Print Status . . . . . . . . . . . . . . . . . . . . . . . . . 8-3
8.3 Review/Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-4
Chapter 9. Communicating With Others . . . . . . . . . . . . . . . . . . . 9-1

9.1 Sending Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-2
9.2 Receiving Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-3
9.3 Review/Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-4
Chapter 10. Other Things You Can Do . . . . . . . . . . . . . . . . . . . 10-1

10.1 Submitting and Viewing Jobs . . . . . . . . . . . . . . . . . . . . . . . 10-2
10.2 Performing Data Management Tasks . . . . . . . . . . . . . . . . . . 10-3
10.3 Learning About RPF . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-4
10.4 Executing Application Under ETSO . . . . . . . . . . . . . . . . . . . 10-5
10.5 Executing TSO Commands . . . . . . . . . . . . . . . . . . . . . . . . 10-6
10.6 Review/Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-7
Chapter 11. Learning More About Advantage CA-Roscoe . . . . . . . . 11-1

11.1 Online HELP Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-2
11.2 Online Training . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-3
11.3 Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-4
iv Getting Started
About This Guide
The Getting Started guide provides an introduction to Advantage CA-Roscoe

Interactive Environment for non-programmers.
Note: The facilities described in this manual apply to Version 6.0 of
Advantage CA-Roscoe.
About This Guide v

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

Summary of Revisions for this Edition
Updated the Advantage CA-Roscoe Sign-on Screen. See 2.1, “Signing On to
Advantage CA-Roscoe” on page 2-2 for more information.
viii Getting Started

Summary of Revisions
■ This manual has been updated to reflect enhancements to Advantage
CA-Roscoe 6.0.
For details about these enhancements, see the 'Summary Of Amendments'
in the Advantage CA-Roscoe Interactive Environment Command Reference
Guide, Advantage CA-Roscoe Interactive Environment User Guide, and the
Advantage CA-Roscoe Interactive Environment RPF Language Guide.
■ Editorial and minor technical changes have been made throughout this
manual.
About This Guide ix

Advantage CA-Roscoe Publications
The following publications are supplied with Advantage CA-Roscoe Interactive
Environment. They are divided into a User Series and a System Series.
User Series Contents

Name
Command Reference Describes all Advantage CA-Roscoe primary and
Guide line commands and Monitor commands.
Extended Development Describes how: 1) the Application Programming
Tools Guide Interface (API) can be used by applications
executing under ETSO to take advantage of
Advantage CA-Roscoe facilities, and 2) the
interactive facilities provided by SKETCH can be
used to generate and maintain panels used in
programs running under CICS or IMS.
Getting Started Introduces Advantage CA-Roscoe to
non-programmers.
Release Guide Provides a summary of the enhancements included
in this release.
RPF Language Guide Describes all components of the RPF language and
how to write RPF programs. It also describes the
Dialog Management Facility (DMF) which can be
used to develop, maintain and execute panel-driven
RPF applications.
User Guide Provides task-oriented descriptions of how to use
x Getting Started
System Series Contents
Name
Extended Facilities for Describes how sites can make extensions to their
System Programmers Advantage CA-Roscoe system. This includes
Guide creating site-written Monitor routines and
customizing security and other online exits.
Installation Guide Describes the steps to follow when installing or
upgrading Advantage CA-Roscoe.
Messages and Codes Explains all messages that might be received by
Guide individuals using Advantage CA-Roscoe or by the
individual responsible for maintaining Advantage
CA-Roscoe.
Programs and Utilities Describes Advantage CA-Roscoe execution
Guide requirements. Also describes maintenance and
reporting programs for the accounting facility,
Active Work Space (AWS), library system, and user
profile system.
Security Administration Describes implementation of internal and external
Guide security to protect your Advantage CA-Roscoe
system.
System Commands Guide Describes commands used to control and monitor
Advantage CA-Roscoe and to obtain performance
information about that execution.
System Reference Guide Intended for the individual responsible for
maintaining Advantage CA-Roscoe. It describes
Advantage CA-Roscoe and its components.
About This Guide xi

Related Publications
The CA Common Services r11 for z/OS SP6 (formerly known as Unicenter
TNG Framework for OS/390 and CA Common Services for z/OS and OS/390
Services) documentation can be found on http://supportconnect.ca.com.
The following manuals relate to Advantage CA-Roscoe and are on

http://supportconnect.ca.com.
Title Contents
Advantage CA-Earl Reference Guide Contains detailed information about
Advantage CA-Earl statements,
parameters, and coding rules. Also
explains the Advantage CA-Earl
Reporting Service.
Advantage CA-Earl User Guide Designed for users interested in
learning about Advantage CA-Earl. It
presents an introduction to
Advantage CA-Earl features and
capabilities.
Advantage CA-Earl Systems Lists the installation options for
Programmer Guide Advantage CA-Earl and instructions
for modifying them. Also describes
size requirements and program
execution.
Advantage CA-Earl Examples Guide Contains sample programs that show
a variety of common applications.
xii Getting Started

CA Common Services for z/OS
CA Common Services for z/OS are a common set of services that may be used
by any MVS Computer Associates product. These services are maintained
separately from the product and are documented and installed separately as
well. Advantage CA-Roscoe uses CAIRIM for installation services and security.
Licensing Management Program (LMP)
Advantage CA-Roscoe now interfaces with CAIRIM services to determine

product licensing authorization.
Command Notation
The command syntax described in this manual uses the following notation
conventions:
[] Indicates optional keywords, operands or parameters from

which you may select one or none.
{} Indicates required keywords, operands or parameters from
which you must select one.
UPPERCASE Identifies command, operand or keyword values which
must be coded exactly as shown.
Mixed Cases Identifies command, operand or keyword abbreviations. The
uppercase letters are the minimum abbreviation. Lowercase
letters are optional.
underline Indicates a default value that you need not supply.
lowercase Indicates a variable for which a value must be supplied.
Lowercase alphabetics are shown as:
aname Name of an AWS.

charstr Any sequence of printable entities specified in character
format.
If it is shown as /charstr/, the string must be bound by a
special character and may include blanks. The special
character delimiting the string and the special character
used as the command delimiter cannot appear within the
string itself.
context Keyword operand that identifies the type of string specified
with the command (qualifying the type of search operation
to be performed).
About This Guide xiii

dsn Name of an OS data set or AllFusion CA-Librarian master
file.
dsnmem Name of a PDS member or AllFusion CA-Librarian master
file module.
expr (RPF only.) One or more elements and associated operators.
i Increment value used for determining line numbers.
int (RPF only.) Integer or a variable whose value can be
converted into an integer.
l Length of a string or field.
mem Name of a Advantage CA-Roscoe library member. If the
member belongs to another user, that user's prefix must be
included (for example, pfx.mem).
n Line number.
o Destination of an operation, which can be represented using
any of the following forms:
* Line at which the pointer is positioned.
B or ,, After the last line of an AWS.
R Replaces the contents of the AWS. (This
destination/operation is not valid with all
commands.)
T Before the first line of the AWS.
v Specific line number in an AWS. If the number
exists, the destination is after line v. If the line
number does not exist, the destination begins with
line v.
-p Processing option specified with Monitor commands.
p q Range of lines, where p is the line at which the operation
begins and q is the line at which the operation ends.
If p is a line number, q must also be a line number. If p is
an * (indicating line at which pointer positioned), q must be
a line count.
If q is omitted, the operation is limited to p If p and q are
omitted, all lines are assumed.
position Keyword operand designating the screen position that is to
occur when a string match is found. If omitted, the
positioning currently in effect is used. If specified, the
positioning affects the single execution of the command.
real (RPF only.) Real number or a variable whose value can be
converted into a real number.
xiv Getting Started

s e Range of columns, 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 only one value is specified, it is assumed to be the ending
column (e).
s l Range of columns, where s is the starting column number of
the range and l is the length of the range.
If only one value is specified, it is assumed to be the
starting column (s).
scope Keyword operand designating the location of the data to be
affected by the command. If omitted, the currently attached
data is assumed.
str (RPF only.) String or a variable whose value can be
converted into a string.
string Any sequence of entities specified in either character format
or its hexadecimal representation.
If shown as /string/, the string must be bound with a
special character. The special character delimiting the string
and the special character used as the command delimiter
cannot appear within the string.
v Numeric value.
About This Guide xv

xvi Getting Started
Chapter 1. Introducing Advantage CA-Roscoe
Before describing how to use Advantage CA-Roscoe, let's discuss what

Advantage CA-Roscoe is.
Advantage CA-Roscoe is an extremely powerful online program development

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

While we will be describing many tasks you can perform with Advantage
CA-Roscoe, we will not be describing:
■ Every Advantage CA-Roscoe command. For a synopsis of all Advantage
CA-Roscoe commands, see the Reference Summary. For a detailed
description of each command, see the Advantage CA-Roscoe Interactive
Environment Command Reference Guide.
■ Every type of task that can be performed using Advantage CA-Roscoe.
The chapter "Other Things You Can Do" contains a brief description of the
types of tasks that are not described within this manual.
This manual is written under the assumption that you have:

■ Used a 3270-type terminal before.
If you have not, ask someone at your site to explain the various hardware
editing keys (particularly the keys to insert and delete data), the cursor
positioning keys, the ENTER key, and the PF keys.
■ A sign-on key.
If you do not, ask your site management what sign-on key you should use.
Also ask whether or not that sign-on key has a password associated with
it. If it does, you will need to know the password.
It is also useful if you have a copy of the Advantage CA-Roscoe Interactive

Environment User Guide. That book provides detailed information about the
AWS, Advantage CA-Roscoe library, OS data sets, job output and general
session information. We will be referring you to that book to find additional
information about specific topics.
1-2 Getting Started

Chapter 2. Signing On and Entering Data
In this chapter, we will be describing:
■ How to sign on to Advantage CA-Roscoe,

■ What the Advantage CA-Roscoe screen looks like, and
■ How to enter data using both primary commands and line commands.
Chapter 2. Signing On and Entering Data 2-1

2.1 Signing On to Advantage CA-Roscoe

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

Advantage CA-Roscoe Screen - With No Data Attached

_
>
>
....+....1....+....2....+....3....+....4....+....5....+....6.
A site-written message may appear in this space.

The cursor is positioned to the first line of the Command Area. By default, the
Command Area consists of the first three lines of the screen. (There is a
command that you can use to change the number of lines in the Command
Area.) This is where you will enter all Advantage CA-Roscoe primary
commands.
The next three lines comprise the System Control Area. Advantage CA-Roscoe
uses these lines to provide information.
■ The first line (beginning with a >) is the Response Line. It is used to
display messages. To illustrate, make sure the cursor is in the Command
Area and then,
Type -> XXX
Press the ENTER key.
Advantage CA-Roscoe displays the message:
CMD4 COMMAND NOT RECOGNIZED
and positions the cursor to the 'command' in error - xxx in this case. You
can now correct the command, change it or delete it. (As a matter of fact,
please use the ERASE EOF key to delete xxx.)
■ For now, we will ignore the second line beginning with a >.
■ The third line is called the Scale Line. It reflects the margins currently in
effect. You can use it to determine the exact position of a character within
a 255-character line.

The remaining lines of the screen are called the Execution Area. This is where
you will enter, edit and display data.
2-4 Getting Started

2.2 Entering Data
2.2 Entering Data

Before you enter any data, let's talk about Advantage CA-Roscoe commands.
Advantage CA-Roscoe supports:
■ Primary Commands. These are commands you enter in the Command
Area of the screen (for example, the first three lines of the screen).
■ Line Commands. These are commands that you enter in the Execution
Area (for example, the lower portion of the screen.)
The easiest way to understand these command types is to use them. So, we're
going to enter data using first primary commands and then line commands.
2.2.1 Using Primary Commands

To use primary commands, make sure that the cursor is in the Command Area
of the screen. You can then use the INPUT command to tell Advantage
CA-Roscoe that you want to enter data.
Type -> INPUT or I
Advantage CA-Roscoe 'opens' the Execution Area for data entry and moves
the cursor to the first line of this Area. You are now ready to enter data.
The data consists of a series of one-line definitions. After typing a definition,

use the New Line key to position the cursor to the beginning of the next line.
Type -> A: Able.
B: Baker.
C: Charlie.
D: Dog.
Before going any further, let's take a look at the screen as illustrated on 2-6
First, look at the definitions you have just typed. Your site management has
the option of designating whether the information you enter will be kept in the
form you typed it (for example, uppercase and lowercase) or will be converted
to uppercase only. Most sites use the default which causes what you type to be
converted to uppercase characters. If your site is using the default and you
want to prevent this conversion from occurring,
Type --> SET MODE XTENDED
Press the ENTER key. (Everything you enter from this point on will not be
converted to uppercase.)

2.2 Entering Data
Advantage CA-Roscoe Screen - With AWS Attached

>
> AWS() SCRL FULL COLS 1 72 A<ROS1>
> ....+....1....+....2....+....3....+....4....+....5...
...... ============================= T O P =================
1 A: Able.
2 B: Baker.
3 C: Charlie.
4 D: Dog.
...... ========================== B O T T O M ==============

Notice the information appearing on the second line containing an >. This line
is called the System Information Line. It tells you:
■ The location and name of the data.
In this example, it shows the keyword AWS followed by (). This means
that the information you typed has been placed in the AWS. The () means
that the information is unnamed.
■ How the display will be scrolled.
FULL means that if you press a PF key that is assigned a scrolling
function, your display will scroll forward or backward one line less than a
full screen of data. You can change the scroll value by positioning the
cursor to the SCRL field and typing:
number To scroll that number of lines,
HALF To scroll half the display,
MAX To scroll to the top or bottom of the AWS, or
CSR To scroll based on the position of the cursor.
■ The number of the currently displayed left and right margins.
You can change the display margins by:
1. overtyping the column numbers shown in this field, or
2. using the SET DISPLAY command.
2-6 Getting Started

2.2 Entering Data
■ The name of the AWS that is active.

While we will only be using one AWS with the exercises in this manual,
you have two AWSs available for your use. They are named ROSn (where
'n' is a unique identifier). By site option, you may be able to create and use
additional AWSs.
Notice also that the Execution Area contains lines marking the top and bottom
of the data. Later, when we talk about scrolling data, you will see how these
markers are useful as reference points.
Right now, there is not much data to scroll. So let's add more data to the AWS.
If you want to add information to the end of the AWS, you can again use the
INPUT command. When information is already in the AWS and you type
INPUT, Advantage CA-Roscoe makes the last line in the AWS the first
displayed line, 'opens' the Execution Area and positions the cursor to the first
line available for data entry.
If the cursor is not in the Command Area, move it there and then,
Type -> INPUT or I
The resulting display starts with line 400. The cursor is placed at the first data
entry line (for example, 500). You are now ready to enter more data.
Type -> E: Easy.
F: Fox.

If you want to add information after a specific line, you can do so by

specifying that line number with the INPUT command. For example, to add
data after line 500, move the cursor to the Command Area and,
Type -> INPUT 5 or I 5

Type -> T: Tango.
Z: Zebra.
The screen 'closes' and the display begins with line 500. You can use a PF key
to scroll the display back to the beginning (for example, line 100). (While it
may be different at your site, PF7 is the key normally assigned the scroll
backward function.) The following screen illustrates how your screen should
appear.

2.2 Entering Data
Notice the sequence numbers to the left of the screen. By default, Advantage
CA-Roscoe numbers the AWS beginning with 100 and incremented by 100.
When you insert data at the end of the AWS, the line number increment of 100
is still used. However, if you insert data between existing lines, Advantage
CA-Roscoe increments the new lines by ones. This is done to minimize
changes to your existing line numbers.
After Using INPUT COMMAND

>
> ....+....1....+....2....+....3....+....4....+....5...
...... ============================= T O P =================
1 A: Able.
2 B: Baker.
3 C: Charlie.
4 D: Dog.
5 E: Easy.
51 T: Tango.
52 Z: Zebra.
6 F: Fox.
7
========================== B O T T O M ==============

2.2.2 Using Line Commands

You can always enter primary commands in the Command Area of the screen.
Sites, however, have the option of designating whether line commands can be
used when you first sign on to Advantage CA-Roscoe. Most sites do enable
this facility. 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). If the periods are not there, you can use the
primary command SET DISPLAY to enable this facility. To do so, move the
cursor anywhere within the Command Area of the screen and,
Type -> SET DISPLAY NUMX
Now, suppose you want to add a few more lines to the AWS. One way you
can do this is with the I and IB line commands. Unlike primary commands
(such as INPUT) which are typed in the Command Area, line commands are
typed in the sequence number field of the Execution Area.
Position the cursor anywhere within the sequence number field of line 400
and,
2-8 Getting Started

2.2 Entering Data
Type -> I
Now move the cursor to the sequence number field of line 600 and,
Type -> IB5
The following screen shows the I and IB line commands before the ENTER key
is pressed.
Using I and IB Line Commands

>
> ....+....1....+....2....+....3....+....4....+....5...
...... ============================= T O P =================
1 A: Able.
2 B: Baker.
3 C: Charlie.
I4 D: Dog.
5 E: Easy.
51 T: Tango.
52 Z: Zebra.
IB56 F: Fox.
7
========================== B O T T O M ==============

With the I line command, a blank line is inserted immediately after the line
containing the command. With IB, the blank line is inserted before the line
containing the command.
To insert more than one line, specify a number with the command. (Notice
that IB5 causes five lines to be inserted before line 700.) If you do not type on
all of the inserted blank lines, the unused lines are deleted when you press
ENTER.
On the inserted line following line 400,

Type -> X: X-ray.
On the inserted lines preceding line 600,

Type -> V: Victor.
S: Sierra.

2.2 Entering Data
Notice that the unused lines have been deleted from the display.
2-10 Getting Started

2.3 Review/Summary
2.3 Review/Summary
In this chapter, you have learned:
■ How to sign on to Advantage CA-Roscoe.

■ The format of the Advantage CA-Roscoe screen.
■ That Advantage CA-Roscoe supports both primary and line commands.
■ How to use primary and line commands to enter data into the AWS.
You now know that the data you type in the Execution Area of the Advantage
CA-Roscoe screen is placed in the AWS when you press the ENTER key. The
AWS, which is a temporary work area, is the only place where data can be
entered and edited.
Table 2-1 shows the title of the chapter in the Advantage CA-Roscoe Interactive
Environment User Guide where you can get additional information about the
topics discussed in this chapter.
Table 2-1. Summary: Signing On and Entering Data
TOPIC CHAPTER
AWS Introducing the AWS
Entering Data Entering Data into the AWS
Screen Format Selecting a Screen Format
Signing On plus Signing On and Off Advantage
Establishing and Changing CA-Roscoe
Passwords
Primary and Line Commands Commands and Command
Components
The Advantage CA-Roscoe Interactive Environment Command Reference Guide

contains a detailed description of the commands described in this chapter.
In the next chapter, you will learn how you can save the data you have in the
AWS in the Advantage CA-Roscoe library.

Chapter 3. Saving Data and Signing Off
In this chapter, you will learn about:

■ Saving the information in your AWS as a member in the Advantage
CA-Roscoe library.
■ Signing off Advantage CA-Roscoe.
Chapter 3. Saving Data and Signing Off 3-1

3.1 Introducing the Advantage CA-Roscoe Library
3.1 Introducing the Advantage CA-Roscoe Library

Suppose you have been sitting at your desk writing a memo and you now
want to file it for future reference. 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.
The Advantage CA-Roscoe library can be compared to that file cabinet. It is

the place where you permanently store the information you have been
working on in the AWS. When using Advantage CA-Roscoe, you place your
information in a 'member' (comparable to the file folder) to which you assign a
name. Advantage CA-Roscoe then acts as your file clerk placing the member in
the library.
Just as other people can have folders placed in a file cabinet, so other users can
save members in the Advantage CA-Roscoe library. To ensure that your
members are kept separate from other users' members, Advantage CA-Roscoe
automatically assigns your 2- or 3-character prefix to whatever member name
you specify. (Your site management assigns a unique prefix to each Advantage
CA-Roscoe sign-on key. When you sign on, Advantage CA-Roscoe knows the
prefix associated with your key and uses it whenever you create or reference
one of your library members.)
3-2 Getting Started

3.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 Advantage CA-Roscoe library. To do this, all you need enter is
the primary command SAVE and the name you want to assign to the new
library member. (This is comparable to writing a name on a file folder before
placing the folder in a file cabinet.) The name must be 1- to 8-characters in
length and begin with an alphabetic character. To save the data in the AWS as
the library member named WORDS,
Type -> SAVE WORDS or S WORDS
Notice that your library member name now appears in the parentheses
following the AWS keyword on the System Information Line. The member
name is preceded by your prefix. (In the following screen your prefix is
represented as 'pfx'.)
Saving Data
_

>
> AWS(pfx.WORDS) SCRL FULL COLS 1 72
> ....+....1....+....2....+....3....+....4....+....5...
...... ============================= T O P =================
1 A: Able.
2 B: Baker.
3 C: Charlie.
4 D: Dog.
41 X: X-ray.
5 E: Easy.
51 T: Tango.
52 Z: Zebra.
6 V: Victor.
61 S: Sierra.
62 F: Fox.
7
...... ========================== B O T T O M ==============


3.3 Signing Off
3.3 Signing Off

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

3.4 Review/Summary
3.4 Review/Summary
■ About the Advantage CA-Roscoe library.

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


3-6 Getting Started
Chapter 4. Retrieving and Displaying Data
In this chapter, you will learn about:

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

4.1 Displaying Data
4.1 Displaying Data

You can use the ATTACH command* to look at the contents of your library
member named WORDS.
Type -> ATTACH WORDS or A WORDS
The following screen illustrates the first few lines of the resulting display.
Attached Library Member
_

>
> LIB(pfx.WORDS) SCRL FULL COLS 1 72
> <...+....1....+....2....+....3....+....4....+....5....
================================= T O P ==============
1 A: Able.
2 B: Baker.

Notice that the System Information Line now begins with the keyword LIB.
This means that you are looking at the contents of a member in your library.
(As with the keyword AWS, LIB is followed by the prefixed name of your
library member.)
Note: The chapter 'Updating Data' describes another way that you can view a
library member.
Try to move the cursor to the Execution Area of the screen.
When a library member is attached, you can look at its contents, use PF keys
to scroll through the contents, and enter a variety of commands to locate
specific occurrences of words within the contents. You cannot modify the
contents of the library member You can only modify the contents of the AWS.
Therefore, to change a member, you must first bring a copy of it into the AWS.
4-2 Getting Started

4.2 Displaying Data to Modify
4.2 Displaying Data to Modify

To change the contents of a library member, you must first bring a copy of it
into the AWS. You must then attach the AWS to see its contents.
To bring a copy of your library member named WORDS into the AWS,
Type -> FETCH WORDS or F WORDS
You do not have to include your prefix when you are FETCHing a copy of one
of your own library members. If you do not include a prefix, Advantage
CA-Roscoe assumes you are referring a library member that you own.
Obviously then, when you reference someone else's library member, you must
include their prefix (for example, FETCH XYZ.WORDS).
Notice that the System Information Line still shows LIB, indicating that your
library member is attached, even though you have brought a copy of that
member into the AWS. To view the contents of the AWS, you must connect (or
attach) the AWS to your terminal. To do this,
Type -> ATTACH or A
Now the System Information Line shows that the AWS is attached. The AWS
will remain attached until you detach it.

4.3 Detaching and Reattaching Data

You can detach the AWS or a library member either explicitly or implicitly.
The DETACH command explicitly releases whatever is attached. To use this

command,
Type -> DETACH or DET
Notice that the contents of the AWS is no longer displayed. To reattach the
AWS,
Type -> ATTACH or A
You can implicitly release attached data by using any other command that
causes output to the Execution Area. For example, the AWS is automatically
detached when you attach a library member for display.
Type -> ATTACH WORDS or A WORDS
The library member named WORDS is now attached. (Notice the keyword LIB
on the System Information Line.) The data you brought into the AWS is still
there. It is not displayed because the AWS is not attached. To reattach the
AWS,
Type -> ATTACH or A
The resulting display begins with the first line of the AWS.
Using Special Advantage CA-Roscoe Reserved Characters
When attaching or reattaching the AWS or a library member, you can begin
the display with a specific line by including that line number with the
command. For example, to attach the AWS and begin the display of its
contents with line 500,
Type -> ATTACH 5,, or A 5,,
The double commas have a special meaning to Advantage CA-Roscoe; they

represent the last line in the AWS or the library member. If you omitted them
(for example, if you typed ATTACH 500), only the line numbered 500 would
be displayed.
4-4 Getting Started

Another character that has a special meaning to Advantage CA-Roscoe is the

asterisk (*). You can use it when reattaching data to have the display begin
with the line that had been the previously displayed first line. To illustrate
how this works, first detach the AWS. (You can do this using either the
DETACH command or by attaching your library member WORDS.)
Now, to reattach the AWS,

Type -> ATTACH ,, or A ,,
Notice that the display begins with line 500, the same line that had previously
been the first line of the display.

4.4 Review/Summary
4.4 Review/Summary
In this chapter, you have learned how to:
■ Attach a library member.
■ FETCH a copy of a library member into the AWS and the ATTACH the
AWS to the terminal.
■ Detach and reattach a library member and the AWS.
■ Use special Advantage CA-Roscoe reserved characters.
Table 4-1. Summary: Retrieving and Displaying Data
TOPIC CHAPTER
Attaching the AWS Attaching an AWS to the Terminal
Attaching library members Attaching Library Data at the
Terminal
Bringing data into the AWS Attaching an AWS to the Terminal
Reattaching the AWS Attaching an AWS to the Terminal
Using Reserved Characters Commands and Command
Components

In the next chapter, you will learn how you can scroll through the data in the
AWS.
4-6 Getting Started

Chapter 5. Scrolling Through Data
This chapter describes how you can use:
■ PF keys to scroll through attached data.

■ Primary and line commands to reposition the display of data within the
AWS.
Chapter 5. Scrolling Through Data 5-1

5.1 Using PF Keys to Scroll
5.1 Using PF Keys to Scroll

If you are using a terminal with a 24-line screen, you have typed more
definitions than can be displayed in a single screen.
You can use PF keys to scroll through whatever data is currently attached (for
example, the contents of the AWS or a library member). Table 5-1 shows the
default scrolling functions that are assigned to PF keys.
Table 5-1. PF Keys Used For Scrolling
KEY ASSIGNMENT
PF7 or PF19 Scroll backward (for example, towards the top of the
screen).
PF8 or PF20 Scrolls forward (for example, towards the bottom of the
screen).
PF9 or PF21 Scroll the display to the left.
PF10 or PF22 Scroll the display to the right.
By default, a list of all PF and PA key assignments is assigned to PA2. If you

press this key, a list of assignments will be displayed.
Your site management has the option of changing any PF or PA key

assignment. If they have done so, they will have updated the information
provided by PA2.
5-2 Getting Started

5.2 Using Commands to Scroll

You can use a primary command to reposition the display of data you are
viewing.
Type -> POINT LINE 5
The resulting display will begin with line 500. There are a number of line
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
■ Positionally. Move the cursor to the sequence number field of line 60 and,
Type ->
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
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 B- to scroll to the bottom. In the sequence number field of any line,
Type -> T+ or B-
By including a number with the command, you can position the display to
begin that number of lines after the top (for example, T+5) or before the
bottom (that is, B-5).
5-4 Getting Started

5.3 Review/Summary
5.3 Review/Summary
■ How to use the PF keys to scroll through attached data.
■ How to use the POINT command and a variety of line commands to scroll
through the contents of the AWS.
Table 5-2. Summary: Scrolling Through Data
TOPIC CHAPTER
PF Key Assignments Using/Customizing PF/PA Keys
Scrolling Attaching an AWS to the Terminal

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-6 Getting Started
Chapter 6. Modifying Data
This chapter describes how you can use multiple primary and line commands
and correct any invalid or incomplete command. It also describes commands
that let you:
■ Use multiple commands,

■ Rearrange and delete the contents of the AWS,
■ Search for specific words within the AWS, and
■ Change one or more occurrences of those words.
Chapter 6. Modifying Data 6-1

6.1 Using Multiple Commands
6.1 Using Multiple Commands

If you have signed off, please sign back on.
Remember that to use line commands and to have your data kept in the form
in which you enter it, the primary commands SET DISPLAY NUMX and SET
MODE XTENDED must be in effect.
Note: These commands, described in Section 2.2, are just two of the
commands that you can use to customize your Advantage CA-Roscoe
session. Other session-related commands allow you to change the
display margins, set tab positions, change the number of lines in the
Command Area, etc.
You can execute multiple commands either by typing each command on a

separate line in the Command Area, as in:
SET DISPLAY NUMX
SET DISPLAY XTENDED
or by typing them on a single line, separated by a command delimiter. The

ampersand (&) is the default command delimiter. It tells Advantage
CA-Roscoe where one command ends and other begins, as in:
SET DISPLAY NUMX & SET MODE XTENDED
In the chapter on entering data, one of the exercises asked you to enter two
line commands on different lines of the same screen. As you may have
guessed, you can enter one or more primary and line commands on the same
screen. When you do, Advantage 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.
6-2 Getting Started

6.2 Correcting and Changing Commands

If you enter an invalid or incomplete primary command, Advantage
CA-Roscoe displays a message on the Response Line and positions the cursor
to the command in error. Any commands following the invalid or incomplete
command are not executed.
The following screen illustrates what happens if you attempt to FETCH and
ATTACH a library member without specifying its name.
Changing Invalid or Incorrect Primary Commands
FETCH
ATTACH
> CMD13 INSUFFICIENT NUMBER OF OPERANDS SPECIFIED

> ....+....1....+....2....+....3....+....4....+....5...
...... ============================= T O P =================
1
2 B: Baker.
3 C: Charlie.
4 D: Dog.

At this point, you can correct the command in error, change it or delete it. You
can change, add or delete any commands that follow the corrected command.
You can even insert commands ahead of the corrected command.
The following screen illustrates what happens if you enter an invalid or

incomplete line command.

Changing Incorrect or Invalid Line Commands

>
> ....+....1....+....2....+....3....+....4....+....5...
...... ============================= T O P =================
1
2 B: Baker.
3 C: Charlie.
XX4 <<< ATX1 INVALID COMMAND >>>
41 X: X-ray.
5 E: Easy.
51 T: Tango.
52 Z: Zebra.
6 V: Victor.
61 S: Sierra.
62 F: Fox.

If you should enter an invalid or incomplete line command, Advantage
CA-Roscoe displays a message and halts processing. No changes to the data
are applied; no line commands are executed; no primary commands are
executed.
To correct the command in error, you can: 1) overtype it with a valid line
command, 2) blank out the sequence number field using the Delete key, the
Erase EOF key, or the space bar, or 3) use the RESET line command.
You can use the RESET line command to have Advantage CA-Roscoe ignore:
1) all of the currently displayed line command (and any pending line
commands), and 2) any changes made to the currently displayed data.
6-4 Getting Started

6.3 Moving Data Within the AWS

Assume that the definitions you have entered so far are supposed to be in
alphabetic order. Several of them are not. Advantage 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.3.1 Using a Primary Command

When you move lines within the AWS, you must always designate:
■ The line or lines of data to be moved, and
■ The line at or after which the data is to be inserted. You can specify 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).
To move line 502 to the top of the AWS,

Type -> MOVE 52 T or M 52 T
To move multiple lines within the AWS, you must specify the number of the
first and last line in the range. For example, to move the definitions from B to
D after the definition of T,
Type -> MOVE 2 4 51 or M 2 4 51
Notice the line numbers. When data is inserted between existing lines,
Advantage CA-Roscoe increments the inserted lines by ones.

You are now going to use line commands to perform the same tasks you did
with the MOVE primary command. Please bring a fresh copy of the member
WORDS into the AWS.
Type -> FETCH WORDS or F WORDS
You did not have to use the ATTACH command since the AWS is already
attached to your terminal.

As with the primary command, 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. Table 6-1 lists some
of the destination line commands.
Table 6-1. Destination Line Commands
COMMAND FUNCTION
B To insert before the line containing the command.
A To insert after the line containing the command.
BB To insert after the last line of the AWS.
TT To insert before the first line of the AWS.
To move the line numbered 501 to the top of the AWS, position the cursor to
the sequence number field of line 501.
Type -> M
Now indicate the destination by moving the cursor to the sequence number
field of the next line.
Type -> TT
To move a range of lines, use the MM line commands. Place MM in the

sequence number field of the first and last line in the range.
The following screen illustrates how you could move lines 1 and 100 after line
200.
6-6 Getting Started

Moving Multiple Lines

>
> ...1....+....2....+....3....+....4....+....5....+....
...... ============================= T O P =================
MM1 T: Tango.
MM1 A: Able.
A2 B: Baker.
3 C: Charlie.
4 D: Dog.
41 X: X-ray.
5 E: Easy.
52 Z: Zebra.
6 V: Victor.
61 S: Sierra.
62 F: Fox.

Do the move operation illustrated in the previous screen. Move the cursor to
the sequence number field of line 1.
Type -> MM
Now move the cursor to line 100.

Type -> MM
Finally, move the cursor to line 200.

Type -> A

6.4 Copying Data Within the AWS

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

As when moving data, you must designate what line or lines are to be copied
and where the line(s) are to be placed. For example, to copy the last line of the
AWS to the top of the AWS,
Type -> COPY 62 T or C 62 T
Notice that you are again using T to indicate that the destination of this
operation is the top of the AWS. When specifying a destination, you can use a
line number or the positional expressions T (meaning the top of the AWS) or B
(meaning the bottom.)
To copy multiple lines, you need to include the number of the first and last
line to be copied plus the destination of the operation. For example, to copy
lines 300 through 500 after line 600,
Type -> COPY 3 5 6 or C 3 5 6

To copy one line, place the C line command in the sequence number field of
the line to be copied. Then place a destination line command in the sequence
number field of the appropriate line. (The copy and move line commands use
the same destination line commands.) For example, to place a copy of line 400
after line 200, move the cursor to line 400 and in the sequence number field,
Type -> C
Now move the cursor to the sequence number field of line 200 and,
Type -> A
6-8 Getting Started

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

6.5 Deleting Data From the AWS
6.5 Deleting Data From the AWS

As the result of your copy operations, you now have duplicate lines in the
AWS. You can use either primary or line commands to remove these lines.
6.5.1 Using Primary Commands

You can use the DELETE command to remove one or more lines from the
AWS. If you specify DELETE with just one line number, only that line will be
deleted. To illustrate, move the cursor to the Command Area,
Type -> DELETE 41 or DEL 41
If you specify DELETE with two line numbers, the range of lines beginning
with the first number and ending with the second is deleted. (Note: If you
specify DELETE with no line numbers, the entire contents of the AWS is
deleted.)

If you type the D line command in the sequence number field of a line, that
line will be removed from the AWS when the ENTER key is pressed.
If you type a DD line command in the sequence number field of one line and
then another DD line command in the sequence number field of a different
line, all of the lines encompassed by the two line commands will be deleted
when you press the ENTER key.
To illustrate, move the cursor to the sequence number field of line 601,
Type -> DD
Now move the cursor to the sequence number field of line 602,
Type -> DD
Lines 601 through 602 have been deleted.

6.6 Renumbering the AWS
6.6 Renumbering the AWS

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

6.7 Locating Specific Words Within the AWS

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

You can use the INCL or EXCL primary or line commands to display all lines
including or excluding a specific character string. For example, to use the
INCL primary command to display all of the lines that contain the string 'ra',
move the cursor to the Command Area,
Type -> INCL ra
The following screen illustrates what the resulting display will look like:
Display Produced by INCL Primary Command

> AWS7: LINES 1 THRU BOTTOM SEARCH WITH 3 MATCHES
> ....+....1....+....2....+....3....+....4....+....5....+.
...... ======================= INCL/EXCL DISPLAY ==============
5 X: X-ray.
8 Z: Zebra.
1 S: Sierra.

Notice that the cursor is positioned to the first occurrence of the string.
When using the INCL or EXCL line command, the command is typed in the
sequence number field of the first line to be searched. Then, the character
string is typed in the data portion of the same line.

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. Move the cursor to the
sequence number field of line 10.
Type -> EXCL
Now move the cursor to the data portion of the same line.
Type -> /ra/
When you type a string in the data portion of a line, you need to tell
Advantage CA-Roscoe where your string starts and stops. You do this by
bounding the string with a special character, called a string 'delimiter'. In our
examples, we use the slash (/) to delimit character strings. (After you execute
this command, the data that you overtyped is redisplayed.)
The following screen illustrates how this line command and its string operand
should be entered:
Using the EXCL Line Command

>
> ....+....1....+....2....+....3....+....4....+....5...
...... ============================= T O P =================
EXCL /ra/
2 B: Baker.
3 C: Charlie.
4 D: Dog.
5 X: X-ray.
6 E: Easy.
7 T: Tango.
8 Z: Zebra.
9 V: Victor.
1 S: Sierra.
11 F: Fox.

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

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

You can use the FIRST, LAST, NEXT and PREV primary and line commands
to locate and display specific occurrences of a character string. For example,
let's use a primary command to locate the first occurrence of the string 'ra'.
Move the cursor to the Command Area.
Type -> FIRST to
The resulting display begins with the first line containing 'ra' (for example, line
50).
Now, let's use a line command to find the last occurrence of a string.
Please position the display to begin with the first line in the AWS. Then move
the cursor to the first line in the Execution Area. In the sequence number field,
Type -> LAST
Now move the cursor to the data portion of the same line.
Type -> /er/
The following screen illustrates the placement of the line command and its
string.

Using the LAST Line Command

>
> ....+....1....+....2....+....3....+....4....+....5...
...... ============================= T O P =================
LAST /er/
2 B: Baker.
3 C: Charlie.
4 D: Dog.
5 X: X-ray.
6 E: Easy.
7 T: Tango.
8 Z: Zebra.
9 V: Victor.
1 S: Sierra.
11 F: Fox.

The resulting display begins with line 100, the line containing the last
occurrence of 'er' in the AWS.
As their names imply, you can use the NEXT and PREV primary and line
commands to find the next occurrence of a string or the previous occurrence of
a string. In every instance, the line containing the string is presented as the
first displayed line.
If you are looking for multiple occurrences of the same string, you need not
retype the string each time you use the command. For example, move the
cursor to the Command Area.
Type -> PREV
The previous occurrence of the string 'Female' now begins the display. Once
you have specified a string, it is remembered and used in subsequent EXCL,
FIRST, INCL, LAST, NEXT and PREV primary and line commands that do not
include a string.

One last note about locating a string.
When you are using a line command, you must delimit the string. Since
you're typing the string in the data portion of the Execution Area, Advantage
CA-Roscoe needs to know where the string starts and stops.
Usually, you do not have to delimit the string you specify with a primary
command, as in:
FIRST to
If, however, the string contains a space or matches an operand of the

command, you must delimit the string, as in:
FIRST /F: Fox/

6.8 Changing Words Within the AWS

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

You can use the EDIT command to replace one string of characters with
another. For example, move the cursor to the Command Area.
Type -> EDIT /er/xx/ or E /er/xx/
You will see that every occurrence of the string 'er' in the AWS has been
changed to the string 'xx'. You can include operands with this command to
limit its scope of operation to specific columns and/or a specific range of lines.

You can use the line commands, E, EE, EB and ET to change one character
string to another. Use:
■ E with an optional numeric value to change strings on specific lines;
■ EE (on the first and last line of a range) to change a string on a range of
lines;
■ EB to change a string on lines between the line containing the command
and the end of the AWS; and
■ ET to change strings on lines between the first line of the AWS through the
line containing the command.
As with the primary command, you must specify a search string that is
followed by a replacement string. Therefore, to change every occurrence of a
string from the line on which the command is entered through the end of the
AWS, move the cursor to the first displayed line.
Type -> EB
and then position the cursor to the data portion of the same line.
Type -> /xx/er/

The following screen illustrates the placement of this command and its strings.
Using the EB Line Command

>
> ....+....1....+....2....+....3....+....4....+....5...
...... ============================= T O P =================
EB /xx/er/
2 B: Baker.
3 C: Charlie.
4 D: Dog.
5 X: X-ray.


6.9 Review/Summary
6.9 Review/Summary
In this chapter, you have learned how to use multiple commands and correct
any that may have been entered incorrectly. You have also learned how to use
primary and line commands to:
■ Move, copy, delete and renumber lines within the AWS.

■ Locate all or specific strings of characters within the AWS.
■ Replace one character string with another within the AWS.
Table 6-2. Summary: Modifying Data
TOPIC CHAPTER
Using Multiple Commands and Commands and Command
Correcting Commands Components
Session Options Displaying/Changing Session Status
Information
Changing Words Changing Character Strings Within
the AWS
Copying Lines Copying Data Within the AWS
Deleting Lines Deleting Data Within the AWS
Locating Words Locating a Character String Within
the AWS
Moving Lines Moving Data Within the AWS
Repeating Lines Copying Data Within the AWS

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

Chapter 7. Updating Data
This chapter describes how you can:
■ Update the contents of an existing library member.

■ Use primary command or the Library Facility to:
– Obtain library member information.
– Change the attributes of a library member.
– Change the name of a library member.
– Delete a library member.
Chapter 7. Updating Data 7-1

7.1 Updating a Library Member
7.1 Updating a Library Member

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

7.2 Obtaining Library Member Information

You know the Advantage CA-Roscoe library contains your member WORDS,
but what other library members are saved under your prefix?
At any time during your session, you can use the Library Facility to display a
list of your library members. To do this:
Type -> LIBRARY
The following screen illustrates the next display you will see.
Library Facility Menu

>
> LIB() SCRL FULL COLS 1 79
....+....1....+....2....+....3....+....4....+....5....+....6.
LIBRARY FACILITY
FUNCTION ==>
PREFIX ==> your prefix

MEMBER ==>
SIGNON KEY ==> your signon key
FORMAL KEY ==> your formal key
SEARCH ==> (SHR,RES,EXE,NOD)
CONFIRM DELETE ==> YES
A - ATTACH LIBRARY D - DELETE MEMBERS P - PRINT MEMBER

C - COPY MEMBERS I - INFO MEMBERS R - RENAME MEMBERS
X - TERMINATE LIB

If this is the first time you are using the Library Facility, the menu will contain
your Advantage CA-Roscoe prefix, sign-on key and formal key.
The YES with CONFIRM DELETE means that if you try to delete one of your
library members, Advantage CA-Roscoe will display the name of that member
and ask you to confirm that you want the member deleted.

The codes at the bottom of the previous screen indicate the types of actions
you can perform. For example, if you type a library member name in the field
MEMBER and an A in the FUNCTION field, you can display the contents of
that member. We are going to use the code A, however, to attach a list of your
library members. Make sure that no library member name appears in the
MEMBER field and then,
Type -> A (in FUNCTION field)
The following screen illustrates the type of information that is contained in the
resulting member Selection List. (As you will see later, in addition to
displaying information, you can use a Selection List to perform specific
actions.)
Library Selection List Description

>
> LIB() SCRL FULL COLS 1 72 LINE 1
....+....1....+....2....+....3....+....4....+....5....+....6..
==================================== T O P ===================
SIGNON KEY MEM EXCL BLOCKS M-LINES LINES
your-key 3 23 2 34
MEMBER STATUS DESCRIPTION LINES ATR SEQNO
XYZ.JUNK 1 SHR NOSEQ

XYZ.SAVAWS1 NROS1 datetime 1 SHR 73,8
XYZ.WORDS 23 SHR 73,8

The amount of information provided by this Selection List exceeds the width
of 80-column screens. The information is, therefore, divided into alternate
displays. You can change the display to view different information.
Type -> SELECT ALT
Every time you do this, the next sequential display is presented. Eventually,
you will return to the original display. The first two lines in the list remain
constant as you scroll through the Selection List. They show:
SIGNON KEY Your sign-on key.
7-4 Getting Started

MEM Number of library members included in the Selection List.

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

7.3 Changing Member Attributes

As illustrated in the following screen, your member WORDS does not have a
description. Also, the access and sequence number attributes are the defaults
assigned by Advantage CA-Roscoe. You can specify a description and
attributes when you initially save the data (using the SAVE command). You
can add or change the information when you update the member (using the
UPDATE command).
If you only want to change a member's description and/or attributes, you can
use the ALTER command. For example, to add a description to your member,
Type -> ALTER WORDS /DEFINITIONS/
Press the ENTER key. To verify that the description has been added to the
member,
Type -> REFRESH
As illustrated in the following screen, REFRESH updates the Selection List to

include your description of WORDS.
Library Selection List Description

>
....+....1....+....2....+....3....+....4....+....5....+....6..
==================================== T O P ===================
SMITH 3 23 2 34
pfx.JUNK 1 SHR NOSEQ

pfx.SAVAWS1 NROS1 datetime 1 SHR 73,8
pfx.WORDS DEFINITIONS 23 SHR 73,8

You can also use this Selection List to change the description and/or attributes
of a member.
7-6 Getting Started

The following screen illustrates how you can change the sequence number
attribute of that member. First type AT (for alter attribute) before the member
WORDS. (Its shown as the first shaded area.) Then, tab to the sequence
number field and overtype 073,8 with NOSEQ.
Changing Member Attributes

>
....+....1....+....2....+....3....+....4....+....5....+....6..
==================================== T O P ===================
SMITH 3 23 2 34

AT pfx.WORDS DEFINITIONS 23 SHR noseq

To verify that the sequence number has been changed,

Type -> REFRESH
The resulting display shows that the sequence number attribute has been
changed.

7.4 Renaming a Member
7.4 Renaming a Member

Suppose you decide that the name WORDS is not an appropriate name for
your library member. You can use the RENAME command to change the
member's name. (You can also change the member's description and attributes
at the same time.) To change the member's name,
Type -> RENAME WORDS name
Replace 'name' with any name you want. (Remember that library members
names must be 1- to 8-characters in length and start with an alphabetic
character.)
To verify that you library member has been successfully renamed,

Type -> REFRESH
Notice that there is no entry for the member named WORDS. There is an entry
for the member with the name that you assigned.
You can also use the list to rename a member. In the example shown in the
following screen, the member named WORDS is renamed SAMPLE. In this
case, an R (for rename) is typed before the member name. (In the first shaded
area.) Then the new member name is typed in the STATUS field. (The second
shaded area.)
Renaming a Member

>
....+....1....+....2....+....3....+....4....+....5....+....6..
==================================== T O P ===================
SMITH 3 23 2 34

R pfx.WORDS SAMPLE 23 SHR 73,8
If you try this form of renaming, use the REFRESH command again to verify
that your member was successfully renamed.
7-8 Getting Started

7.5 Deleting a Member
7.5 Deleting a Member

Suppose you decide that you no longer need a library member. You can use
the DELETE command or the Selection List to remove that member from your
library.
The list shown in the following screen includes a member named JUNK. To
remove this member using the command,
Type -> DELETE JUNK or DEL JUNK
To remove this member using the Selection List, type a D (for Delete) before
the appropriate member name.
Deleting a Member

>
....+....1....+....2....+....3....+....4....+....5....+....6..
==================================== T O P ===================
SMITH 3 23 2 34
D pfx.JUNK 1 SHR NOSEQ

pfx.WORDS 23 SHR 73,8

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

7.6 Review/Summary
7.6 Review/Summary
■ Update the contents of a library member.

■ Display information about your library members.
■ Change library member attributes.
■ Rename a library member.
■ Delete a library member.
Table 7-1. Summary: Updating Data
TOPIC CHAPTER
Changing Member Attributes Performing Library Management
Tasks
Deleting a Member Performing Library Management
Tasks
Displaying Member Information Performing Library Management
Tasks
Renaming a Member Performing Library Management
Tasks
Updating a Member Saving Data as a Library Member

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

Chapter 8. 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. This chapter assumes that your site is allowing you to use this
facility.
Chapter 8. Printing Data 8-1

8.1 Identifying What to Print
8.1 Identifying What to Print

To print the contents of the AWS,
Type -> PRINT or P
To print the contents of a library member, include the name of the member
with the PRINT command.
Type -> PRINT WORDS or P WORDS
In addition, you can:

■ Assign a name or 'tag' to your print request. If you use a tag, it must be: 1-
to 8-characters, begin with an alphabetic character, bound by apostrophes,
and placed immediately after the PRINT command. The following
illustrates how you might assign the tag SAMPLE to your print request:
Print 'sample' words
■ Print multiple copies of a request. For example, to print three copies of
your print request, you might enter:
Print 'sample' words copy 3
A confirmation message is displayed on the Response Line when the PRINT

command is executed. The message includes the tag (if you specified one), the
print request number assigned by Advantage CA-Roscoe and the location at
which your request is scheduled to print.
8-2 Getting Started

8.2 Determining the Print Status
8.2 Determining the Print Status

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

8.3 Review/Summary
8.3 Review/Summary
■ Print a copy of the contents of the AWS.

■ Print the contents of a library member.
■ Print multiple copies of a print request.
■ Obtain the status of your outstanding print requests.
If you would like additional information about printing the contents of the
AWS or a library member, see the chapter 'Printing Data' in the Advantage
CA-Roscoe Interactive Environment User Guide.

In the next chapter, you will learn how you can send and receive messages
through Advantage CA-Roscoe.
8-4 Getting Started

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

9.1 Sending Messages
9.1 Sending Messages

You can send messages to other Advantage CA-Roscoe users if you know their
sign-on key or prefix.
For example, to send a short message (that is less than 64 characters in length)
to the user whose sign-on key is SMITH, you would enter:
send key=smith 'meeting at 11: in conference room a'
To send the same message, using the user's prefix, you would enter:
send pfx=abc 'meeting at 11: in conference room a'
You must delimit the message with a special character not found in the
message itself (for example, an apostrophe (') is used in the preceding
example).
If you want to send a longer message to a Advantage CA-Roscoe user, type

the text in either the AWS or a library member. Then when you issue the
SEND command, identify the location of the message, as in:
send aws key=brown 'report on meeting'
In this example, the keyword AWS indicates that the message we want to send
is in the AWS. The message with this command is optional. Here it is used to
identify the information being sent.
9-2 Getting Started

9.2 Receiving Messages
9.2 Receiving Messages

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

9.3 Review/Summary
9.3 Review/Summary
■ Send a message to another Advantage CA-Roscoe user.

■ Receive messages that other Advantage CA-Roscoe users send to you.
If you would like additional information, see the chapter 'Sending/Receiving

Messages' in the Advantage CA-Roscoe Interactive Environment User Guide.
For a detailed description of the command described in this chapter, refer to

the Advantage CA-Roscoe Interactive Environment Command Reference Guide.
9-4 Getting Started

Chapter 10. Other Things You Can Do
While this manual is intended to be read by non-programmers, all of the tasks

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

10.1 Submitting and Viewing Jobs
10.1 Submitting and Viewing Jobs

Syntax Checking Data
The JCL command invokes the job control language syntax checker. It can be
used to check JCL statements in the AWS or a library member.
The COBOL syntax checker is invoked by the COB command. It also can check
COBOL source code in the AWS or in a specified library member.
Submitting Data as a Job Stream
You can submit the contents of the AWS and/or one or more library members
to the operating system at any time during your terminal session.
Checking the Status of Submitted Jobs
Once you have submitted a job for execution, you can monitor its progress
with the DISPLAY command. DISPLAY allows you to see what the job is
doing (awaiting execution, executing, awaiting print, etc.), what its position on
the job queue is, what initiators have been assigned to each job class, and how
many jobs are in each job class.
At some MVS sites, you do not need to use the DISPLAY command to check
the status of your jobs. By site option, 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.
Once a job is attached, there are a number of Advantage CA-Roscoe

commands that you can use to:
■ Position within the job output.
■ Locate and note data within one or more output files.
■ Display and alter file attributes.
■ Print an attached job output file.
■ Copy an attached job output file into the AWS.
■ Reattach job output at the first file in the job or at a specific location within
the job.
■ Detach the job output and, optionally, dispose of the files based on its
print, noprint or hold status.

10.2 Performing Data Management Tasks
10.2 Performing Data Management Tasks

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

10.3 Learning About RPF
10.3 Learning About RPF

RPF (the ROSCOE Programming Facility) is a structured, interactive
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 Advantage 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 Advantage CA-Roscoe commands To
execute this program, move the cursor to the Command Area of the screen.
Type -> RPF.TRAINING
■ The Advantage CA-Roscoe Interactive Environment 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 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 Advantage 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.

10.5 Executing TSO Commands
10.5 Executing TSO Commands

TSO commands can be entered from the Advantage 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 Advantage
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 Review/Summary
10.6 Review/Summary
In this chapter, you have learned about:
■ Submitting and viewing job output.

■ Performing OS data management tasks.
■ The RPF programming language.
■ ETSO.
■ Executing TSO commands from Advantage CA-Roscoe.
For additional information about any or all of these facilities, see the
appropriate chapters in the Advantage CA-Roscoe Interactive Environment User
Guide.

Chapter 11. Learning More About Advantage
CA-Roscoe
This chapter describes how to obtain additional information about Advantage

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

11.1 Online HELP Facility
11.1 Online HELP Facility

The online HELP facility is a quick and easy way to get information about
Advantage CA-Roscoe commands and facilities. For example, to obtain
information about the SAVE command,
Type -> HELP SAVE or H SAVE
The following screen illustrates the type of information displayed.
Sample HELP Facility Display
_

>
> HLP(...HELP...) SCRL FULL COLS 1 79
>....+....1....+....2....+....3....+....4....+....5....+....6
SAVE
Function: Places all or part of contents of AWS into library

as member.
Syntax: SAVE mem < p<q> > < 'string' >

< NOSEQ/SEQ <s<l>>/COBOL >
< SHARED/EXECONLY/RESTRICTED >
mem Name to be assigned to library member

being created. . . .
p q Number of the first and last lines of

AWS to be saved.
. . .

To obtain information about the HELP facility itself,
Type -> HELP or H
Note that with the HELP facility, the scrolling functions have been assigned to
specific PF keys. Use:
PF7 or PF19 To scroll back to the beginning of the current level.

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

11.2 Online Training
11.2 Online Training

TUTORIAL is an online, interactive training aid that simulates an an actual
Advantage CA-Roscoe session and introduces the most frequently used
Advantage CA-Roscoe commands and facilities. To find out how to execute the
training at your site,
Type -> HELP TUTORIAL or H TUTORIAL
When you execute the TUTORIAL, you are presented with a menu of that
shows a number of independent learning modules. You can complete the
modules in order, use only certain modules, or vary the order in which you
complete the modules.
Chapter 11. Learning More About Advantage CA-Roscoe 11-3

11.3 Documentation
11.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
Advantage CA-Roscoe. The documentation set consists of a User series and a
System series. The User series contains all documentation required for users to
perform online processing, including creating and updating library members
and data sets, and submitting jobs. The System series contains all information
necessary for Advantage CA-Roscoe system administrators to install, maintain,
and customize the Advantage CA-Roscoe system.

B001642e - Getting Started

Cargado por

Información del documento

Título original

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

B001642e - Getting Started

Cargado por

Copyright:

Formatos disponibles

Advantage CA-Roscoe

The manufacturer of this Documentation is CA.

Copyright  2005 CA. All rights reserved.

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

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

Chapter 2. Signing On and Entering Data . . . . . . . . . . . . . . . . . . 2-1

Chapter 3. Saving Data and Signing Off . . . . . . . . . . . . . . . . . . . 3-1

Chapter 4. Retrieving and Displaying Data . . . . . . . . . . . . . . . . . 4-1

Chapter 5. Scrolling Through Data . . . . . . . . . . . . . . . . . . . . . . . 5-1

Chapter 6. Modifying Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1

Chapter 7. Updating Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1

Chapter 8. Printing Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-1

Chapter 9. Communicating With Others . . . . . . . . . . . . . . . . . . . 9-1

Chapter 10. Other Things You Can Do . . . . . . . . . . . . . . . . . . . 10-1

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

The Getting Started guide provides an introduction to Advantage CA-Roscoe

About This Guide v

About This Guide vii

viii Getting Started

About This Guide ix

User Series Contents

About This Guide xi

The following manuals relate to Advantage CA-Roscoe and are on

xii Getting Started

Licensing Management Program (LMP)

Advantage CA-Roscoe now interfaces with CAIRIM services to determine

[] Indicates optional keywords, operands or parameters from

Lowercase alphabetics are shown as:

aname Name of an AWS.

About This Guide xiii

xiv Getting Started

About This Guide xv

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

Advantage CA-Roscoe is an extremely powerful online program development

Chapter 1. Introducing Advantage CA-Roscoe 1-1

This manual is written under the assumption that you have:

It is also useful if you have a copy of the Advantage CA-Roscoe Interactive

1-2 Getting Started

In this chapter, we will be describing:

■ How to sign on to Advantage CA-Roscoe,

Chapter 2. Signing On and Entering Data 2-1

2.1 Signing On to Advantage CA-Roscoe

Advantage CA-Roscoe Sign-on Screen

2-2 Getting Started

Advantage CA-Roscoe Screen - With No Data Attached

A site-written message may appear in this space.

Chapter 2. Signing On and Entering Data 2-3

2-4 Getting Started

2.2 Entering Data

2.2.1 Using Primary Commands

Press the ENTER key.

The data consists of a series of one-line definitions. After typing a definition,

Press the ENTER key.

Chapter 2. Signing On and Entering Data 2-5

Advantage CA-Roscoe Screen - With AWS Attached

2-6 Getting Started

■ The name of the AWS that is active.

Press the ENTER key.

If you want to add information after a specific line, you can do so by

Press the ENTER key.

Chapter 2. Signing On and Entering Data 2-7

After Using INPUT COMMAND

2.2.2 Using Line Commands