Professional Documents
Culture Documents
Roscoe v6.0 - Getting Started Guide
Roscoe v6.0 - Getting Started Guide
SP3
This documentation and related computer software program (hereinafter referred to as the “Documentation”) is for
the end user’s informational purposes only and is subject to change or withdrawal by Computer Associates
International, Inc. (“CA”) at any time.
This documentation may not be copied, transferred, reproduced, disclosed or duplicated, in whole or in part, without
the prior written consent of CA. This documentation is proprietary information of CA and protected by the copyright
laws of the United States and international treaties.
Notwithstanding the foregoing, licensed users may print a reasonable number of copies of this documentation for
their own internal use, provided that all CA copyright notices and legends are affixed to each reproduced copy. Only
authorized employees, consultants, or agents of the user who are bound by the confidentiality provisions of the
license for the software are permitted to have access to such copies.
This right to print copies is limited to the period during which the license for the product remains in full force and
effect. Should the license terminate for any reason, it shall be the user’s responsibility to return to CA the reproduced
copies or to certify to CA that same have been destroyed.
To the extent permitted by applicable law, CA provides this documentation “as is” without warranty of any kind,
including without limitation, any implied warranties of merchantability, fitness for a particular purpose or
noninfringement. In no event will CA be liable to the end user or any third party for any loss or damage, direct or
indirect, from the use of this documentation, including without limitation, lost profits, business interruption,
goodwill, or lost data, even if CA is expressly advised of such loss or damage.
The use of any product referenced in this documentation and this documentation is governed by the end user’s
applicable license agreement.
Provided with “Restricted Rights” as set forth in 48 C.F.R. Section 12.212, 48 C.F.R. Sections 52.227-19(c)(1) and (2) or
DFARS Section 252.227-7013(c)(1)(ii) or applicable successor provisions.
All trademarks, trade names, service marks, and logos referenced herein belong to their respective companies.
Contents
Contents iii
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 DESCRIPTION
1 Introduces CA-Roscoe and describes how to use this manual.
2 Describes how to sign on to CA-Roscoe and enter data.
3 Describes how to save data in the CA-Roscoe library and then
sign off CA-Roscoe.
4 Describes how to display data saved in the CA-Roscoe library,
detach that data and then reattach it.
5 Describes how to use PF keys and commands to scroll the
displayed data.
6 Describes how to use primary and line commands to change
data.
7 Describes how to update data saved in the 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 CA-Roscoe that are described in detail in
other manuals.
11 Describes how to obtain additional information about
CA-Roscoe.
Title Contents
CA90s Services Reference Guide Operating Instructions for the CA90s
Services.
CA90s Services Installation and Installation procedure and installation
Maintenance Guide JCL for CA90s Services.
CA90s Services Message Guide Messages and codes for CA90s
Services.
CA90s Services CA-ACTIVATOR 2.1 Proceduresa for using
Supplement CA-ACTIVATOR to install and
maintain CA90s Services.
CA90s Services CA-ACTIVATOR Installation and upgrade instructions,
Implementation and User Guide and operating instructions for
CA-ACTIVATOR.
CA-ViewPoint User Guide Contains information and examples for
implementing and using ViewPoint.
The following manuals relate to CA-Roscoe and are available from Computer
Associates.
Title Contents
CA-Earl Reference Guide Contains detailed information about
CA-Earl statements, parameters, and
coding rules. Also explains the
CA-Earl Reporting Service.
CA-Earl User Guide Designed for users interested in
learning about CA-Earl. It presents an
introduction to CA-Earl features and
capabilities.
CA-Earl Systems Programmer Guide Lists the installation options for
CA-Earl and instructions for modifying
them. Also describes size
requirements and program execution.
CA-Earl Examples Guide Contains sample programs that show a
variety of common applications.
Before describing how to use CA-Roscoe, let's discuss what CA-Roscoe is.
As you read through this manual, you will learn how to enter data in the AWS, save
that data as a member in the 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
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
upper- case and, when appropriate, include any allowed abbreviations.
As you are asked to use different 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.
While we will be describing many tasks you can perform with CA-Roscoe, we will
not be describing:
It is also useful if you have a copy of the CA-Roscoe User Guide. That book provides
detailed information about the AWS, 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.
|
| >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. ||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 9 :
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.
_
>
>
....+....1....+....2....+....3....+....4....+....5....+....6.
9 :
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 CA-Roscoe primary commands.
The next three lines comprise the System Control Area. 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.
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.
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.
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-5
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.)
>
> AWS() SCRL FULL COLS 1 72 A<ROS1>
> ....+....1....+....2....+....3....+....4....+....5...
...... ============================= T O P =================
1 A: Able.
2 B: Baker.
3 C: Charlie.
4 D: Dog.
...... ========================== B O T T O M ==============
9 :
Notice the information appearing on the second line containing an >. This line 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.
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, 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.
IIIIIIIIII
Press the ENTER key.
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
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.
Notice the sequence numbers to the left of the screen. By default, 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, CA-Roscoe increments the new lines by ones.
This is done to minimize changes to your existing line numbers.
>
> 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.
5 E: Easy.
51 T: Tango.
52 Z: Zebra.
6 F: Fox.
7 IIIIIIIIII
========================== B O T T O M ==============
9 :
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,
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.
>
> 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.
I4 D: Dog.
5 E: Easy.
51 T: Tango.
52 Z: Zebra.
IB56 F: Fox.
7 IIIIIIIIII
========================== B O T T O M ==============
9 :
Press the ENTER key.
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.
Notice that the unused lines have been deleted from the display.
2.3 Review/Summary
In this chapter, you have learned:
You now know that the data you type in the Execution Area of the CA-Roscoe screen
is placed in the AWS when you press the ENTER key. 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 CA-Roscoe User Guide where you can
get additional information about the topics discussed in this chapter.
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 CA-Roscoe
Establishing and Changing
Passwords
Primary and Line Commands Commands and Command Components
In the next chapter, you will learn how you can save the data you have in the AWS in
the CA-Roscoe library.
The 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 CA-Roscoe, you place your information in a 'member' (comparable to the file
folder) to which you assign a name. 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 CA-Roscoe library. To ensure that your members are kept separate
from other users' members, 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 CA-Roscoe sign-on key. When you sign on, CA-Roscoe knows
the prefix associated with your key and uses it whenever you create or reference one
of your library members.)
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 IIIIIIIIII
...... ========================== B O T T O M ==============
9 :
But suppose you type the OFF command before you save your data.
CA-Roscoe checks the contents of the AWS when you sign off. If the AWS 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
CA-Roscoe, you can retrieve this member.
3.4 Review/Summary
In this chapter, you have learned:
You now know how to save data that is in the AWS as a member in the CA-Roscoe
library. You know that the name to assign to that member will always be unique
because 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, CA-Roscoe will save the
contents for you.
Table 3-1 shows the title of the chapter and/or section in the CA-Roscoe User Guide
where you can get additional information about the topics discussed in this chapter.
TOPIC CHAPTER
CA-Roscoe Library Introducing the Library Facility
Saving Data Saving Data as a Library Member
Signing Off Signing On and Off CA-Roscoe
The following screen illustrates the first few lines of the resulting display.
_
>
> LIB(pfx.WORDS) SCRL FULL COLS 1 72
> <...+....1....+....2....+....3....+....4....+....5....
================================= T O P ==============
1 A: Able.
2 B: Baker.
9 :
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.
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.
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, 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.
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.
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 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.
Another character that has a special meaning to 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.)
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
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 CA-Roscoe reserved characters.
Table 4-1 shows the title of the chapter and/or section in the CA-Roscoe User Guide
where you can get additional information about the topics discussed in this chapter.
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.
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.
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.
The resulting display will begin with line 500. There are a number of line commands
you can use to scroll through the contents of the AWS. You can scroll the display:
■ To begin with a specific line number. Try this. Place the cursor in the sequence
number field of line 200 and,
Type -> 3
Press the ENTER key.
■ Positionally. Move the cursor to the sequence number field of line 60 and,
Type -> 1
Press the ENTER key.
You can also position the display to begin a specified number of lines before or
after the positionally referenced line. For example, if you typed *+5 on line 500,
the next display would begin with the line that is five lines after line 500; *-5
would cause the display to begin with the line that is five lines before line 500.
■ By page (for example, the number of lines in the display). With +P, the display
positions forward one page; -P positions the display backward one page. Try this
command. Move the cursor to the sequence number field of line 60 and,
Type -> -P
Press the ENTER key.
Since there is less than a full page, the resulting display scrolls back to the
beginning of the AWS.
If you specify a number with either of these commands, you will scroll that
number of pages forward or backward (that is, +P5 scrolls five pages forward).
■ To the top or bottom of the AWS. Use T+ to scroll to the top of the AWS and B-
to scroll to the bottom. In the sequence number field of any line,
Type -> T+ or B-
Press the ENTER key.
By including a number with the command, you can position the display to begin
that number of lines after the top (for example, T+5) or before the bottom (that is,
B-5).
5.3 Review/Summary
In this chapter, you have learned:
■ How to use the PF keys to scroll through attached data.
■ How to use the POINT command and a variety of line commands to scroll
through the contents of the AWS.
Table 5-2 shows the title of the chapter and/or section in the CA-Roscoe User Guide
where you can get additional information about the topics discussed in this chapter.
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.
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:
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 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
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,
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.
The following screen illustrates what happens if you attempt to FETCH and ATTACH
a library member without specifying its name.
FETCH
ATTACH
9 :
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.
>
> AWS(pfx.WORDS) SCRL FULL COLS 1 72
> ....+....1....+....2....+....3....+....4....+....5...
...... ============================= T O P =================
1 IIIIIIIIII
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.
9 :
If you should enter an invalid or incomplete line command, 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 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.
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, CA-Roscoe
increments the inserted lines by ones.
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.
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.
>
> AWS(pfx.WORDS) SCRL FULL COLS 1 72
> ...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.
9 :
Do the move operation illustrated in the previous screen. Move the cursor to the
sequence number field of line 1.
Type -> MM
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
Now move the cursor to the sequence number field of line 200 and,
Type -> A
There are also line commands that allow you to repeat one or more lines 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
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 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
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
The following screen illustrates what the resulting display will look like:
> AWS7: LINES 1 THRU BOTTOM SEARCH WITH 3 MATCHES
> AWS(pfx.WORDS) SCRL FULL COLS 1 72
> ....+....1....+....2....+....3....+....4....+....5....+.
...... ======================= INCL/EXCL DISPLAY ==============
5 X: X-ray.
8 Z: Zebra.
1 S: Sierra.
9 :
Notice that the cursor is positioned to the first occurrence of the string.
When using the INCL or EXCL line command, the command is typed in the 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 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:
>
> AWS(pfx.WORDS) SCRL FULL COLS 1 72
> ....+....1....+....2....+....3....+....4....+....5...
...... ============================= T O P =================
EXCL /ra/IIIIII
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.
9 :
Press the ENTER key.
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.
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.
>
> AWS(pfx.WORDS) SCRL FULL COLS 1 72
> ....+....1....+....2....+....3....+....4....+....5...
...... ============================= T O P =================
LAST /er/II
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.
9 :
Press the ENTER key.
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.
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, 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/
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.
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.
>
> AWS(pfx.WORDS) SCRL FULL COLS 1 72
> ....+....1....+....2....+....3....+....4....+....5...
...... ============================= T O P =================
EB /xx/er/III
2 B: Baker.
3 C: Charlie.
4 D: Dog.
5 X: X-ray.
9 :
Press the ENTER key.
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:
Table 6-2 shows the title of the chapter and/or section in the CA-Roscoe User Guide
where you can get additional information about the topics discussed in this chapter.
TOPIC CHAPTER
Using Multiple Commands and Commands and Command Components
Correcting Commands
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.
or
Type -> UPDATE 1 or U 1
As has already been noted, the asterisk has a special meaning to CA-Roscoe. In this
example, it tells 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.
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.
>
> LIB() SCRL FULL COLS 1 79
....+....1....+....2....+....3....+....4....+....5....+....6.
LIBRARY FACILITY
FUNCTION ==>
9 :
If this is the first time you are using the Library Facility, the menu will contain your
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, 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.)
>
> 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
9 :
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.
MEM Number of library members included in the Selection List.
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 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.
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,
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.
>
> 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
SMITH 3 23 2 34
MEMBER STATUS DESCRIPTION LINES ATR SEQNO
9 :
You can also use this Selection List to change the description and/or attributes of a
member.
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.
>
> 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
SMITH 3 23 2 34
MEMBER STATUS DESCRIPTION LINES ATR SEQNO
9 :
Press the ENTER key.
The resulting display shows that the sequence number attribute has been changed.
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.)
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
>
> 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
SMITH 3 23 2 34
MEMBER STATUS DESCRIPTION LINES ATR SEQNO
If you try this form of renaming, use the REFRESH command again to verify that
your member was successfully renamed.
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
>
> 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
SMITH 3 23 2 34
MEMBER STATUS DESCRIPTION LINES ATR SEQNO
9 :
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
In this chapter, you have learned how to:
Table 7-1 shows the title of the chapter and/or section in the CA-Roscoe User Guide
where you can get additional information about the topics discussed in this chapter.
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.
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.
To print the contents of a library member, include the name of the member with the
PRINT command.
Type -> PRINT WORDS or P WORDS
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 CA-Roscoe and the location at which your request is scheduled to
print.
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
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.
8.3 Review/Summary
In this chapter, you have learned how to:
If you would like additional information about printing the contents of the AWS or a
library member, see the chapter 'Printing Data' in the CA-Roscoe User Guide.
In the next chapter, you will learn how you can send and receive messages through
CA-Roscoe.
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 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.
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.
9.3 Review/Summary
In this chapter, you have learned how to:
If you would like additional information, see the chapter 'Sending/Receiving Messages'
in the CA-Roscoe User Guide.
For a detailed description of the command described in this chapter, refer to the
CA-Roscoe Command Reference Guide.
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.
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.
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.
You can examine the files associated with your job using the ATTACH JOB
command.
Once a job is attached, there are a number of 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.
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
In this chapter, you have learned about:
For additional information about any or all of these facilities, see the appropriate
chapters in the CA-Roscoe User Guide.
_
>
> HLP(...HELP...) SCRL FULL COLS 1 79
>....+....1....+....2....+....3....+....4....+....5....+....6
SAVE
. . .
9 :
Note that with the HELP facility, the scrolling functions have been assigned to specific
PF keys. Use:
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.
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 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 CA-Roscoe system administrators to
install, maintain, and customize the CA-Roscoe system.