Академический Документы
Профессиональный Документы
Культура Документы
User Guide
6.0
SP3
This documentation and related computer software program (hereinafter referred to as the “Documentation”) is for
the end user’s informational purposes only and is subject to change or withdrawal by Computer Associates
International, Inc. (“CA”) at any time.
This documentation may not be copied, transferred, reproduced, disclosed or duplicated, in whole or in part, without
the prior written consent of CA. This documentation is proprietary information of CA and protected by the copyright
laws of the United States and international treaties.
Notwithstanding the foregoing, licensed users may print a reasonable number of copies of this documentation for
their own internal use, provided that all CA copyright notices and legends are affixed to each reproduced copy. Only
authorized employees, consultants, or agents of the user who are bound by the confidentiality provisions of the
license for the software are permitted to have access to such copies.
This right to print copies is limited to the period during which the license for the product remains in full force and
effect. Should the license terminate for any reason, it shall be the user’s responsibility to return to CA the reproduced
copies or to certify to CA that same have been destroyed.
To the extent permitted by applicable law, CA provides this documentation “as is” without warranty of any kind,
including without limitation, any implied warranties of merchantability, fitness for a particular purpose or
noninfringement. In no event will CA be liable to the end user or any third party for any loss or damage, direct or
indirect, from the use of this documentation, including without limitation, lost profits, business interruption,
goodwill, or lost data, even if CA is expressly advised of such loss or damage.
The use of any product referenced in this documentation and this documentation is governed by the end user’s
applicable license agreement.
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
4.2.1.1 When to Use STATUS DISPLAY . . . . . . . . . . . . . . . . . . 4-3
4.2.1.2 When to Use STATUS AWS . . . . . . . . . . . . . . . . . . . . . 4-3
4.2.2 Using the SET BOUNDS Command . . . . . . . . . . . . . . . . . . . 4-4
4.2.3 Using the BOUNDS Line Command . . . . . . . . . . . . . . . . . . . 4-5
Contents v
12.2 The HELP Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-3
12.3 The Online Tutorial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-6
Chapter 15. AWS: Copying Data Within and Into an AWS . . . . . . . . 15-1
15.1 Copying Data Within the Active AWS . . . . . . . . . . . . . . . . . . . 15-2
15.1.1 Using a Primary Command . . . . . . . . . . . . . . . . . . . . . . . 15-2
15.1.1.1 To copy a single line: . . . . . . . . . . . . . . . . . . . . . . . 15-3
15.1.1.2 To copy a range of lines: . . . . . . . . . . . . . . . . . . . . . 15-3
15.1.1.3 To duplicate the copied lines at the destination: . . . . . . . . . 15-3
15.1.2 Using Line Commands . . . . . . . . . . . . . . . . . . . . . . . . . 15-3
15.1.2.1 Copy Line Commands . . . . . . . . . . . . . . . . . . . . . . . 15-3
15.1.2.2 Using Overlay Destination Line Commands . . . . . . . . . . . 15-6
15.1.2.3 Repeat Line Commands . . . . . . . . . . . . . . . . . . . . . . 15-7
15.2 Copying Data to an AWS . . . . . . . . . . . . . . . . . . . . . . . . . . 15-8
15.2.1 Alternate Form of Screen Copy . . . . . . . . . . . . . . . . . . . . 15-9
15.2.2 Copying All or a Range of Lines . . . . . . . . . . . . . . . . . . . . 15-10
15.2.3 Copying Based on a Character String . . . . . . . . . . . . . . . . . 15-10
15.3 Copying Data Between Screens . . . . . . . . . . . . . . . . . . . . . . . 15-12
15.3.1 Copying All or a Range of Lines . . . . . . . . . . . . . . . . . . . . 15-13
Contents vii
19.5.2 Using Line Commands . . . . . . . . . . . . . . . . . . . . . . . . . 19-17
19.5.2.1 Splitting Lines . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-17
19.5.2.2 Joining Lines . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19-18
Chapter 24. Data Sets: Introducing the Data Set Facility . . . . . . . . . . 24-1
24.1 Attaching the Data Set Facility . . . . . . . . . . . . . . . . . . . . . . . 24-2
24.1.1 Using Wildcard Characters to Create a Catalog or VTOC Selection
List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-8
24.1.2 Using Wildcard Characters to Create a CA-Librarian, PDS or Volume
Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-9
24.2 Using Data Set Facility Function Panels . . . . . . . . . . . . . . . . . . 24-10
24.3 Using Data Set Facility Selection Lists . . . . . . . . . . . . . . . . . . . 24-12
24.3.1 Entering Function Codes . . . . . . . . . . . . . . . . . . . . . . . . 24-13
Chapter 25. Data Sets: Attaching a Data Set Object at the Terminal . . . 25-1
25.1 Attaching a CA-Librarian Selection List . . . . . . . . . . . . . . . . . . 25-2
25.1.1 Using a Primary Command . . . . . . . . . . . . . . . . . . . . . . . 25-2
25.1.2 Using the Data Set Facility . . . . . . . . . . . . . . . . . . . . . . . 25-3
25.1.3 Selection List Description . . . . . . . . . . . . . . . . . . . . . . . . 25-4
25.1.3.1 Selecting Alternate Displays . . . . . . . . . . . . . . . . . . . . 25-4
25.1.3.2 Display Format . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-5
25.1.3.3 Field Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . 25-5
25.2 Attaching a Catalog Selection List . . . . . . . . . . . . . . . . . . . . . . 25-7
25.2.1 Using a Primary Command . . . . . . . . . . . . . . . . . . . . . . . 25-7
25.2.2 Using the Data Set Facility . . . . . . . . . . . . . . . . . . . . . . . 25-8
25.2.3 Selection List Description . . . . . . . . . . . . . . . . . . . . . . . . 25-9
25.2.3.1 Selecting Alternate Displays . . . . . . . . . . . . . . . . . . . . 25-10
25.2.3.2 Display Format . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-10
25.2.3.3 Field Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . 25-11
25.3 Attaching a Generation Data Group Data Set . . . . . . . . . . . . . . . . 25-14
25.4 Attaching a PDS Member/CA-Librarian Module . . . . . . . . . . . . . . 25-15
25.4.1 Using a Primary Command . . . . . . . . . . . . . . . . . . . . . . . 25-15
25.4.2 Using the Data Set Facility Menu . . . . . . . . . . . . . . . . . . . 25-16
25.4.3 Using a Selection List . . . . . . . . . . . . . . . . . . . . . . . . . . 25-17
25.4.4 Attached Data Description . . . . . . . . . . . . . . . . . . . . . . . 25-17
25.5 Attaching a PDS Selection List . . . . . . . . . . . . . . . . . . . . . . . 25-18
25.5.1 Using a Primary Command . . . . . . . . . . . . . . . . . . . . . . . 25-18
25.5.2 Using the Data Set Facility . . . . . . . . . . . . . . . . . . . . . . . 25-19
25.5.3 Selection List Description . . . . . . . . . . . . . . . . . . . . . . . . 25-20
25.5.3.1 Load Library Selection List . . . . . . . . . . . . . . . . . . . . 25-20
25.5.3.2 Selecting Alternate Displays . . . . . . . . . . . . . . . . . . . . 25-21
25.5.3.3 Display Format . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-21
25.5.3.4 Field Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . 25-21
25.5.3.5 Non-Load Selection List . . . . . . . . . . . . . . . . . . . . . . 25-23
25.5.3.6 Selecting Alternate Displays . . . . . . . . . . . . . . . . . . . . 25-24
25.5.3.7 Display Format . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-24
25.5.3.8 Field Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . 25-24
25.6 Attaching a Sequential Data Set . . . . . . . . . . . . . . . . . . . . . . . 25-26
25.6.1 Using a Primary Command . . . . . . . . . . . . . . . . . . . . . . . 25-26
25.6.2 Using the Data Set Facility Menu . . . . . . . . . . . . . . . . . . . 25-26
25.6.3 Using a Selection List . . . . . . . . . . . . . . . . . . . . . . . . . . 25-27
25.6.4 Attached Data Description . . . . . . . . . . . . . . . . . . . . . . . 25-27
25.7 Attaching a Volume Selection List . . . . . . . . . . . . . . . . . . . . . 25-28
25.7.1 Using a Primary Command . . . . . . . . . . . . . . . . . . . . . . . 25-28
25.7.2 Using the Data Set Facility . . . . . . . . . . . . . . . . . . . . . . . 25-29
25.7.3 Selection List Description . . . . . . . . . . . . . . . . . . . . . . . . 25-30
25.7.3.1 Selecting Alternate Displays . . . . . . . . . . . . . . . . . . . . 25-30
25.7.3.2 Display Format . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-31
25.7.3.3 Field Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . 25-31
25.8 Attaching a VTOC Selection List . . . . . . . . . . . . . . . . . . . . . . 25-33
25.8.1 Using a Primary Command . . . . . . . . . . . . . . . . . . . . . . . 25-33
25.8.2 Using the Data Set Facility . . . . . . . . . . . . . . . . . . . . . . . 25-34
Contents ix
25.8.3 Selection List Description . . . . . . . . . . . . . . . . . . . . . . . . 25-35
25.8.3.1 Selecting Alternate Displays . . . . . . . . . . . . . . . . . . . . 25-36
25.8.3.2 Display Format . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-36
25.8.3.3 Field Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . 25-36
25.9 Selecting the Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-38
Contents xi
30.2.1.2 Using the Job Facility . . . . . . . . . . . . . . . . . . . . . . . 30-8
30.2.2 Locating Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30-8
30.2.2.1 Locating Specific Occurrences . . . . . . . . . . . . . . . . . . 30-8
30.2.2.2 Including/Excluding Lists Containing a String . . . . . . . . . . 30-9
30.2.2.3 Customizing the Operation . . . . . . . . . . . . . . . . . . . . 30-10
30.2.2.4 Specifying the Hexadecimal Representation of a String . . . . . 30-11
30.2.2.5 Screen Positioning . . . . . . . . . . . . . . . . . . . . . . . . . 30-11
30.2.3 Positioning the Display . . . . . . . . . . . . . . . . . . . . . . . . . 30-12
30.2.3.1 Positioning Between Multiple Files . . . . . . . . . . . . . . . . 30-12
30.2.3.2 Positioning Within a File . . . . . . . . . . . . . . . . . . . . . 30-13
30.2.3.3 Positioning to Named Lines . . . . . . . . . . . . . . . . . . . . 30-13
30.2.4 Reattaching Job Output . . . . . . . . . . . . . . . . . . . . . . . . . 30-15
30.2.4.1 Using the Job Facility . . . . . . . . . . . . . . . . . . . . . . . 30-16
30.3 Performing Output Management Tasks . . . . . . . . . . . . . . . . . . . 30-17
30.3.1 Altering File Attributes . . . . . . . . . . . . . . . . . . . . . . . . . 30-17
30.3.1.1 Using Primary Commands . . . . . . . . . . . . . . . . . . . . . 30-17
30.3.1.2 Using the Job Facility . . . . . . . . . . . . . . . . . . . . . . . 30-18
30.3.1.3 Using a Job Selection List . . . . . . . . . . . . . . . . . . . . . 30-19
30.3.2 Copying Job Output . . . . . . . . . . . . . . . . . . . . . . . . . . . 30-20
30.3.2.1 Using Primary Commands . . . . . . . . . . . . . . . . . . . . . 30-20
30.3.2.2 Using the Job Facility . . . . . . . . . . . . . . . . . . . . . . . 30-20
30.3.2.3 Using a Job Selection List . . . . . . . . . . . . . . . . . . . . . 30-22
30.3.3 Displaying File Attributes . . . . . . . . . . . . . . . . . . . . . . . . 30-23
30.3.3.1 Using a Primary Command . . . . . . . . . . . . . . . . . . . . 30-23
30.3.3.2 Using the Job Selection List . . . . . . . . . . . . . . . . . . . . 30-25
30.3.4 Printing Job Output . . . . . . . . . . . . . . . . . . . . . . . . . . . 30-26
30.3.4.1 Using Primary Commands . . . . . . . . . . . . . . . . . . . . . 30-26
30.3.4.2 Using the Job Facility . . . . . . . . . . . . . . . . . . . . . . . 30-26
30.3.4.3 Using the Job Selection List . . . . . . . . . . . . . . . . . . . . 30-29
30.3.5 Canceling a Job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30-30
30.3.5.1 Using Primary Commands . . . . . . . . . . . . . . . . . . . . . 30-30
30.3.5.2 Using the Job Facility . . . . . . . . . . . . . . . . . . . . . . . 30-30
30.3.5.3 Using the Job Selection List . . . . . . . . . . . . . . . . . . . . 30-31
Contents xiii
Part VI. Additional Facilities
Appendixes
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . X-1
Contents xv
xvi CA-Roscoe 6.0 User Guide
About This Guide
Chapter Description
1 Introduces CA-Roscoe.
2 Provides general information about CA-Roscoe commands.
3 Describes how to control character recognition.
4 Describes how to define column boundaries.
5 Describes how to define the display format.
6 Describes how to display and change the display and
column boundaries and session attributes. Also describes
how to display site-defined attribute values, the time, and
the date.
7 Describes how to print data at a system or 328x-type printer.
8 Describes the CA-Roscoe screen format, how to split the
screen, change screen sizes and lock the screen.
9 Describes how to send and receive messages.
10 Describes how sign on and off CA-Roscoe.
11 Describes how to use and customize PF and PA key
assignments.
12 Describes how to obtain additional information about
CA-Roscoe.
13 Introduces the AWS and describes how to attach, change,
create, detach, discard, position, and reattach an AWS.
14 Describes how to change data within an AWS by adding or
changing character strings.
15 Describes how to copy data within and into an AWS.
16 Describes how to delete data from an AWS.
17 Describes how to display and change AWS information.
18 Describes how to enter data into an AWS and format that
data.
19 Describes how to format text within the AWS.
20 Describes how to locate all or specific occurrences of data
within an AWS.
21 Describes how to move data within an AWS.
22 Describes how to renumber the contents of an AWS.
23 Describes how to save and update data as a library member.
24 Introduces the Data Set Facility.
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.
The following terminology, symbols, and concepts are used in syntax diagrams.
COMMAND
Where you see a vertical list of parameters as shown in the following example, you
must choose one of the parameters. This indicates that one entry is required and only
one of the displayed parameters is allowed in the statement.
You can choose one of the parameters from the vertical list, such as in the following
examples:
COMMAND PARM1
COMMAND PARM2
COMMAND PARM3
A single optional parameter appears below the horizontal line that marks the main
path. When a required parameter in a syntax diagram has a default value, it indicates
the value for the parameter if the command is not specified. If you specify the
command, you must code the parameter and specify one of the displayed values.
If you specify the command, you must write one of the following:
Optional Parameter
──COMMAND──┬───────────┬──────────────────────────────────────
└─PARAMETER─┘
You can choose (or not) to use the optional parameter, as shown in the following
examples:
COMMAND
COMMAND PARAMETER
If you have a choice of more than one optional parameter, the parameters appear in a
vertical list below the main path.
You can choose any of the parameters from the vertical list, or you can write the
statement without an optional parameter, such as in the following examples:
COMMAND
COMMAND PARM1
COMMAND PARM2
For some statements, you can specify a single parameter more than once. A repeat
symbol (a backward-pointing arrow above the main horizontal line) indicates that you
can specify multiple parameters. The following examples include the repeat symbol.
In the above example, the word “variable” is in lowercase italics, indicating that it is a
value you supply, but it is also on the main path, which means that you are required to
specify at least one entry. The repeat symbol indicates that you can specify a
parameter more than once. Assume that you have three values named VALUEX,
VALUEY, and VALUEZ for the variable. Some of your choices are:
COMMAND VALUEX
COMMAND VALUEX VALUEY
COMMAND VALUEX VALUEX VALUEZ
In the above example, the word “variable” is in lowercase italics, indicating that it is a
value you supply. It is also on the main path, which means that you must specify at
least one entry. The repeat symbol indicates that you can specify more than one
variable and that you must separate the entries with commas. The parentheses indicate
that the group of entries must be enclosed within parentheses. Assume that you have
three values named VALUEA, VALUEB, and VALUEC for the variable. Some of
your choices are:
COMMAND (VALUEC)
COMMAND (VALUEB,VALUEC)
COMMAND (VALUEB,VALUEA)
COMMAND (VALUEA,VALUEB,VALUEC)
The following example shows a list of parameters with the repeat symbol.
COMMAND PARM1
COMMAND PARM1 PARM2 PARM3
COMMAND PARM1 PARM1 PARM3
When a parameter in a syntax diagram is above the line, for example, YES in the
following diagram, its special treatment indicates it is the default value for the
parameter. If you do not include the parameter when you write the statement, the
result is the same as if you had actually specified the parameter with the default value.
COMMAND PARM2
Choices you can make from this syntax diagram therefore include (but are not limited
to) the following:
COMMAND PARM1
COMMAND PARM3
COMMAND PARM3 PARM4
Note: Before you can specify PARM4 or PARM5 in this command, you must specify
PARM3.
A note in a syntax diagram is similar to a footnote except that the note appears at the
bottom of the diagram box.
──COMMAND──┬─────────┬────────────────────────────────────────
(1)
└─PARM1─── ┘
Note:
1 This is a note about the item.
CA-Roscoe is an online program development system that you can use to perform
tasks such as:
■ Entering and editing data,
■ Saving the data in the CA-Roscoe library or an OS data set for later use,
■ Submitting the data as a jobstream for background execution,
■ Viewing the files comprising a job, and
■ Browsing and maintaining OS data sets.
CA-Roscoe can be used at any 3270-type terminal (such as the IBM 3278 or 3290)
and at typewriter devices (such as the IBM 3767 or any device that operates in a
manner similar to a teletype terminal).
The sample screen displays used in this manual assume that you are using a 3270-type
terminal. While the content of the displays is accurate, the width of the displays has
been modified so that they will fit within the margins of this manual.
If you are using a typewriter device, refer to Appendix A for additional information
about using that device with CA-Roscoe.
The following example shows a screen where SET DISPLAY AWS NUMX is in
effect. Here, primary and line commands are used together. When the ENTER key is
pressed, a line for data entry will be inserted after line 3600, and then all occurrences
of PRT will be changed to PART.
7 EDIT /PRT/PART/
8
>
> AWS(PRI.INVLIST) SCRL FULL COLS ====7 ===72
> ...1....+....2....+....3....+....4....+....5....+....
...... ============================= T O P =================
==34== RECORD CONTAINS 133 CHARACTERS
==35== LABEL RECORDS ARE OMITTED
I=36== DATA RECORD IS INVENTORY-REPORT-LINE.
==37== =1 INVENTORY-REPORT-LINE.
==38== =5 CARRIAGE-CONTROL PIC X.
==39== =5 FILLER PIC X(9).
7 8
>
> AWS(PRI.INVLIST) SCRL FULL COLS ====7 ===72
> ...1....+....2....+....3....+....4....+....5....+....
...... ============================= T O P =================
D3 4== RECORD CONTAINS 133 CHARACTERS
==35== LABEL RECORDS ARE OMITTED
==36== DATA RECORD IS INVENTORY-REPORT-LINE.
INCL== /DIVISION/TORY-REPORT-LINE.
==38== =5 CARRIAGE-CONTROL PIC X.
When using a string operand, the line command can be placed anywhere within the
sequence number field.
The first two examples shown below indicate how the deletion of all or part of the
sequence number field following a line command eliminates the concern about cursor
positioning. The remaining examples show how the cursor position can affect
command interpretation.
7 > ...1....+....2....+....3....+....4....+....5....+....
8
...... ============================= T O P =================
===1==
D2_ Cmd is D2; 2 lines deleted
==D3 = _ Cmd is D3; 3 lines deleted
===4==
D5=5== Cmd is D5; 5 lines deleted (cursor after
D5=6== Cmd is D5; 5= lines deleted (cursor one
===7== forward from cmd)
===8D9 _ Cmd is D9; 9 lines deleted
==D9== _ Cmd is D9; 9== lines deleted
==1===
=D11== _ Cmd is D; 1 line deleted
D212== _ Cmd is D2; 1 line deleted
The characters that may be used in CA-Roscoe commands fall into the categories
shown in the following table.
The double comma can be used in a command to represent the last line of the active
AWS, library member, attached data set object or attached job output file. For
example, to display line 500 through the end of the active AWS, you would enter:
ATTACH 5== ,,
To copy lines 800 through the end of the library member INVLIST to the bottom of
the active AWS, you would enter:
COPY INVLIST 8== ,, B
Use the minus sign to reexecute the last executed primary command, Monitor
command or RPF program. For example, if you have just issued the command
DISPLAY ROS+ to see the status of all jobs whose names begin with ROS, enter:
Use the plus sign to redisplay one or more previously executed primary commands,
Monitor commands, or RPF program names. For example, assume the last command
you executed was:
ATTACH DSN ROSCOE.TEST(SOURCE1)
To redisplay this command so that you can modify it, all you need enter is:
+
Optionally, you may include a number with the + to specify which previously executed
command you want displayed. For additional information about using the plus sign,
see the section, 2.5, “Displaying Previously Executed Commands” on page 2-13.
If the syntax of a command shows the operand as either /charstr/ or /string/, it must be
bound by a special character that delimits the operand.
The special character used to delimit the operand and the special character used as the
command delimiter cannot be used within the string.
For consistency, the CA-Roscoe documentation uses the slash (/) as a string delimiter.
Other valid characters include:
| vertical bar
'%' percent sign
¬ logical not - if not used as the default tab character
& ampersand - if not used as the default command delimiter
( left parentheses
) right parentheses
_ underscore
- dash or minus sign
+ plus sign
= equal sign
! exclamation point
¢ cent sign
: colon
' '
semi-colon
" quotation mark
' apostrophe
} right brace
{ left brace
? question mark
< less than sign
> greater than sign
. period
7 8
--<-- DOES THE 'WORD' MATCH A PRIMARY COMMAND OR COMMAND ->--
| NO ABBREVIATION? YES |
| |
|-<-- DOES THE 'WORD' MATCH THE FIRST THREE CHARACTERS -->-|
| NO OF A MONITOR COMMAND NAME? YES |
| |
|-<-- DOES THE 'WORD' MATCH THE NAME OF A MEMBER IN THE -->-|
| NO USER'S LIBRARY? YES |
| |
|-<-- DOES THE 'WORD' MATCH THE NAME OF A MEMBER IN THE -->-|
| NO SITE/USER EXECUTION LIBRARY? YES |
| |
ß ß
DISPLAY EXECUTE
ERROR MESSAGE
U V
Note: If you press a PF/PA key instead of the ENTER key, the PF/PA key is
evaluated before any other action is taken. See Chapter 11,
“Using/Customizing PF/PA Keys” for additional information.
Invalid/Incomplete Commands
Line commands are evaluated before primary commands. Also, all line commands are
evaluated before any is executed. If one or more errors are found, a message is
displayed in the data portion of the affected line(s) and halts processing. No changes
to the data are applied; no line commands are executed; no primary commands are
executed. The following example illustrates the type of message displayed when an
invalid command is encountered.
2. Blank out the sequence number field using the DELETE key, the ERASE EOF
key or the space bar.
When the ENTER key is pressed, the line containing the error is restored, changes
made to the displayed data are recorded and any other line commands are
executed.
3. Use the RESET line command.
RESET causes all outstanding line commands (both valid and invalid) and all
changes made to the currently displayed data to be ignored.
After evaluating and executing any line commands that may have been entered, each
primary command is evaluated before it is executed. If no errors are found, the
commands are executed in the order in which they are encountered.
If an invalid or incomplete command is found, the command containing the error and
any subsequent commands are not executed. As illustrated in the following example a
message is displayed and the cursor is positioned to the beginning of the command in
error. (Valid commands preceding the command in error are executed, and are no
longer displayed.)
You can now correct that command. You can also add, delete or change any command
that is displayed. You can even insert commands ahead of the corrected command.
When you press the ENTER key, the commands are executed.
If a PF/PA key assignment is invalid, the commands comprising the assignment, plus
any others entered in the Command Area, are displayed. For example, if PF1 is
assigned:
SET DISPLAY XXX
that command is displayed when you press PF1. (A message explaining the error is
displayed on the Response Line.)
To continue execution, you can correct the displayed command and press the ENTER
key. (You should correct the PF key assignment as soon as possible.)
Note that if the length of the unexecuted commands exceeds the length of a line in the
Command Area and the Command Area is comprised of:
■ One Line: unexecuted commands that do not fit on that line are truncated.
■ Two or Three Lines: unexecuted commands that do not fit on the first line are
displayed on the second and subsequent lines.
For example, assume that you have just executed the following series of commands:
IMPORT DSN=ROSCOE.TEST(SAMPLE1)
RENUMBER 1= 1=
SAVE WIDGET
EDIT /AAA/BBB/
UPDATE Q
The following example illustrates the display that might be produced if you now
entered the command STATUS COMMAND.
7 _
8
>
>
....+....1....+....2....+....3....+....4....+....5....+....6.
COMMAND BUFFER IS 256 BYTES AND CONTAINS 8 COMMANDS
1 STATUS COMMAND
2 UPDATE Q
3 EDIT /AAA/BBB/
4 SAVE WIDGET
5 RENUMBER 1= 1=
6 IMPORT DSN=ROSCOE.TEST(SAMPLE1)
7 rpf-program-name
8 EXEC pfx.rpf-program-name
U V
The executed commands are stored in a command buffer. (The size of the buffer is
defined by site management.) When the contents of the buffer are displayed, it begins
with the most recently executed command (like STATUS COMMAND), and includes
all of the commands that are currently stored within the buffer area.
This list of commands is useful when, for example, you want to redisplay or reexecute
a previously executed command.
To redisplay:
■ The last executed primary command, Monitor command, or RPF program:
Use the plus sign (+), as in:
You then have the option of modifying or reexecuting the command by entering
the minus sign (-). (See 2.2.1, “Using Reserved Characters” on page 2-5 for
additional information.) For example, if the last executed command was SUBMIT
ABC, you can use the plus sign to redisplay the command, modify it and then
press the ENTER key to submit another job.
■ A series of commands: repeatedly execute the + to scroll back through the
previous commands.
■ A specific command:
Specify a value with the +, where the value is the relative number of the
previously executed command.
If you do not remember the position of the command in a command series, enter
STATUS COMMAND to display a list of the most recently executed commands.
Using the series of commands shown in the previous figure, you can redisplay the
IMPORT command by entering:
+6
Optionally, you can display a maximum of three previously executed commands,
as in:
+6,3
If the terminals at your site support a different language character set, your site
management will have established that language character set as the default.
If your site management has designated that multiple character sets may be used, you
will be told which ones are supported. To change from one character set to another,
you can use either:
■ The SET CHARSET command, or
■ The modifiable displays provided by the STATUS SESSION and STATUS AWS
commands.
By default, non-displayable characters are translated to blanks when data on the same
line is typed or changed. To control this translation, you can set the mode to:
NOPRESERVE Non-displayable characters will be translated to blanks when
other data on the same line is typed. This is the default when
you sign on.
PRESERVE Non-displayable characters will not be translated to blanks when
other data on the same line is typed.
This chapter describes how you can change column boundaries for:
■ The execution of a single command, or
■ The remainder of your terminal session. When you alter the boundaries for your
session, you can use:
– The modifiable displays provided by the STATUS DISPLAY command and
STATUS AWS commands, or
– The SET BOUNDS primary command, or
– The BOUNDS line command, when an AWS is attached.
By default, the operation of primary and line commands that edit, locate or shift data
extends the full width of the line. Thus, if you enter:
FIRST PROCEDURE
the full width of every line is searched until either: 1) the string is found, or 2) the
end of the data or the search limit is reached.
displays the first occurrence of FILLER within columns 20 through 30 of the currently
attached data. After the command is executed, the previously established or default
boundaries are reestablished.
Note: Once a character string has been specified with the commands EXCL, FIRST,
INCL, LAST, NEXT and PREV, the string is remembered until you change it.
For example, if you issued the command:
FIRST FILLER
and you now want to find the next occurrence of the same string within
columns 50 through 70, all you need enter is:
NEXT 5= 7=
Once set, they will remain in effect until you change them or end your session.
The modifiable screen provided by STATUS DISPLAY contains the display formats
used when the active AWS, a data set object, job output file or library member is
attached.
To change a column boundary, position the cursor to the appropriate LEFT BOUNDS
or RIGHT BOUNDS field. Then, overtype the displayed value with the appropriate
column number.
For example, suppose the boundary settings for the active AWS are 10 and 72. To
changes these values to 1 and 80, respectively, type 1 in the LEFT BOUNDS field,
and then position the cursor to the RIGHT BOUNDS field and type 80 there. (When
STATUS DISPLAY is issued, the cursor is automatically placed in the LEFT
BOUNDS field for AWS.) The next time you attach the contents of the active AWS,
your column boundaries will be set to 1 and 80.
When you are working with multiple AWSs, use the STATUS AWS command to
display information about the active, and all existing, AWSs that you are using. In
addition to the current display format information, this modifiable display provides
information about all attributes associated with the AWSs. See Chapter 17, “AWS:
Displaying/Changing AWS Information” for details.
To set or reset the column boundaries for all forms of attached data, use the ALL
keyword with the command, as in:
SET BOUNDS ALL 9= 12= or SET BOUNDS ALL OFF
To illustrate the use of temporary and session boundaries, assume you have attached
an AWS and are currently editing its contents. If you enter the commands:
SET BOUNDS 1= 5= & EDIT /ABC/XYZ/
FILL 1 6 /XXXXXX/ & FIRST AAA
then SET BOUNDS sets the boundaries to columns 10 through 50. EDIT changes
every occurrence of ABC within those columns to XYZ. FILL temporarily overrides
the boundaries so that the string XXXXXX can be placed in columns 1 through 6.
Finally, FIRST uses the session boundaries (columns 10 through 50) to locate the first
occurrence of the string AAA.
The following example shows how you would set the boundaries to columns 9 and 43,
respectively.
7 >
8
> AWS(PRI.INVLIST) SCRL FULL COLS ====7 ===72
> ...1....+....2....+....3....+....4....+....5....+
...... ============================= T O P =============
BOUNDS ID<NTIFICATION DIVISION. >
7 >
8
> AWS(PRI.INVLIST) SCRL FULL COLS ====7 ===72
> ..<1....+....2....+....3....+....4..>.+....5....+
...... ============================= T O P =============
===1== IDENTIFICATION DIVISION.
===2== PROGRAM-ID. INVLIST.
===3== ENVIRONMENT DIVISION.
The Scale Line in the previous example reflects the designated column boundary
locations (the < and > are displayed in the appropriate positions on the Scale Line).
When the display is invoked by SET DISPLAY NUMX, the Scale Line always reflects
the column boundaries, whether they are set by the SET BOUNDS primary command
or the BOUNDS line command.
When using the SET DISPLAY command, you can include one or more changes with
the command. For example, you could enter:
SET DISPLAY 1= 5= (to change display margins)
SET DISPLAY NUMX (to change sequence number display)
SET DISPLAY CHAR (to change data format display)
or
SET DISPLAY 1= 5= NUMX CHAR
Subsequent sections describe how to change each specific display format component.
The resulting display begins with the right margin and continues until the left margin
or the maximum width of the screen is filled.
When you specify a new margin setting, leading zeros are not required; if they are
omitted, eliminate the old value so that the field contains only your new margin
setting.
These margins apply only to what is currently attached and remain in effect until the
attachment is changed. For example, if an AWS is currently attached and you press
the PF key to which SCROLL RIGHT is assigned, the new display margins will:
■ Remain in effect while the current AWS contents is displayed.
■ Revert to the previous setting when you:
– Delete or replace the contents of this AWS. The margins revert to the
previously established margins.
– Attach a data set object, job or library member. The margins revert to the: 1)
previous setting if you are reattaching, or 2) default setting if the designated
data was not previously attached.
Note: Operands of the search-related commands (such as FIRST or INCL), allow you
to designate the screen positioning that is to occur when a match is found.
Depending on the positioning requested through the command, your display
margins may change when one of these commands is executed.
Display margins can be changed using the modifiable screen provided by the STATUS
DISPLAY or STATUS AWS command.
The modifiable screen provided by STATUS DISPLAY contains the display formats
used when the active AWS, a data set object, job output file or library member is
attached.
To change a display margin, position the cursor to the appropriate SET DISPLAY
LEFT or SET DISPLAY RIGHT field. Then, overtype the displayed value with the
appropriate column number.
For example, assume the display margins for the active AWS are 10 and 50. To
change these values to 1 and 72, respectively, type 1 in the SET DISPLAY LEFT field
and type 1; then position the cursor to the SET DISPLAY RIGHT field and type 72.
When you reattach the active AWS, your display margins will be set to 1 and 72.
When you are working with multiple AWSs, use the STATUS AWS command display
information about the active, and all existing, AWSs that you are using. In addition to
the current display format information, this modifiable display provides information
about all attributes associated with the AWSs. See Chapter 17, “AWS:
Displaying/Changing AWS Information” for details.
All of the preceding examples affect the data that is currently displayed. To set display
margins for data that is not currently displayed, include the keyword ALL or any
combination of the keywords AWS, DSN, JOB or LIB. For example, to set all display
margins to 50 through 80, you would enter:
SET DISPLAY ALL 5= 8=
the display margins in effect when you attach the active AWS or a library member
will be set to columns 7 through 72; while the display margins for job output and data
set objects will remain set at columns 50 through 80.
In all cases, specify the keywords NUM, NUMX, NONUM and NUM2, with:
NUM Each line begins with a six digit protected sequence number field
that is followed by data.
NUMX Each line begins with a six digit unprotected sequence number field
that is followed by data. NUMX must be in effect if you want to
use line commands to edit the contents of the active AWS.
NONUM Each line contains only data; no sequence numbers are displayed.
NUM2 Two lines are displayed for each data line. The first line contains
the six digit protected sequence number field; the second line
contains only data.
Notes:
■ If you include the FLIP operand when you assign SET DISPLAY to a PF key,
you can bounce the display between sequence number display settings. For
example, if you assign PF2 the value:
LET PF2 = 'SET DISPLAY FLIP NONUM NUMX'
The display format will change every time you press PF2.
■ You can use ALL or any combination of the keywords AWS, DSN, JOB and LIB
to qualify the scope of the SET DISPLAY command. For example, to enable the
use of line commands when editing the active AWS and to prohibit the display of
sequence numbers with all other forms of attached data, you would enter:
SET DISPLAY AWS NUMX DSN JOB LIB NONUM
Since the display margins and data display operands are not included with these
commands, those that are currently in effect will remain unchanged.
You can change the data display format to have the data displayed in both its character
format and its hexadecimal representation by:
■ Changing the modifiable STATUS DISPLAY or STATUS AWS screen by
overtyping the appropriate field with either CHAR or HEX.
■ Specifying the HEX or CHAR operand with the SET DISPLAY command.
The following example illustrates the display before issuing the SET DISPLAY HEX
command.
Character Display
The following example illustrates the display that results after issuing the command
SET DISPLAY HEX. (SET DISPLAY CHAR returns the data to character format.)
7 >
8
> AWS() SCRL FULL COLS ====1 ===72
> <...+....1....+....2....+....3....+....4....+....5.
...... ============================= T O P ===============
===1== HOWARD THOMAS W
4CDECDC4444444ECDDCE4444E4!
=866194=======386412====6=1
---------------------------------------------------
===2== SMITHSOM SALLY S
4EDCECEDD44444ECDDE44444E4!
=24938265=====21338=====2=2
---------------------------------------------------
===3== WALTERS JOHN
4ECDECDE444444DDCD44444444!
=6133592======1685======!=1
---------------------------------------------------
The highlighted areas in the previous example indicate the hexadecimal representation
of the data shown in the upper screen. Notice that columns 27 and 29 contain data
that is not displayable or modifiable in its character format.
When data are displayed in HEX format, the resulting data are:
■ Modifiable when displaying the contents of the active AWS. You can modify:
– Printable characters on the character line. (Non-printable characters are
shown as blanks, which are not modifiable.)
To ensure your changes are properly applied, no character translation occurs
when SET DISPLAY HEX is in effect. This means that even if you have
specified SET MODE BASIC, lowercase characters will not be translated to
uppercase characters.
– Hexadecimal representation on the two vertical hexadecimal lines. These
lines are always modifiable.
Since there can be no confusion about the hexadecimal representation of a
character, lowercase characters are translated to uppercase when SET MODE
BASIC is in effect.
■ Not modifiable when a library member, job output file or data set object is
displayed.
Notes:
■ If you include the FLIP operand when you assign SET DISPLAY to a PF key,
you can bounce the display between its character and hexadecimal formats. For
example, if you assign PF1 the value:
LET PF1 = 'SET DISPLAY FLIP CHAR'
The display format will change every time you press PF1.
■ As with the other forms of SET DISPLAY, you can use the ALL, AWS, DSN,
JOB and LIB keywords to qualify the scope of the command. These operands are
useful when you want to designate the data display format for data that is not
currently attached.
At any time during your session, you can display information about the attributes that
are currently in effect. For example, to display the current column search boundaries
and display margins, you would enter:
STATUS DISPLAY
You can change most of the session attributes using either modifiable displays or
primary commands. (The section, 6.5, “Synopsis of Session Attributes” on page 6-15
contains a list of the primary commands, associated STATUS displays and a brief
description of the attributes affected.)
Changing these attributes allows you to customize your session to meet your own
unique needs. If you find that you always want certain attributes to be in effect, you
can include the appropriate primary commands in a sign-on program. (A sign-on
program is executed every time you sign on to CA-Roscoe or split the screen. See
Chapter 10, “Signing On and Off CA-Roscoe” for additional information.)
Note: For information about displaying and changing AWS attributes, see
Chapter 17, “AWS: Displaying/Changing AWS Information.”
7 >
8
> AWS() SCRL FULL COLS ====1 ===79 A<name>
>....+....1....+....2....+....3....+....4....+....5....+....6
ROSCOE BOUNDS/DISPLAY STATUS
SET CURRENT
BOUNDS DISPLAY DISPLAY
LEFT RIGHT LEFT RIGHT LEFT RIGHT
AWS: 1 8= 1 72 1 72 NUMX CHAR CJUST
LIB: 1 8= 1 72 1 72 NUM CHAR CJUST
JOB: 1 255 1 72 1 72 NUM CHAR CJUST
DSN: 1 32767 1 72 1 72 NUM CHAR CJUST
U V
Note: STATUS DISPLAY provides information about the active AWS. When
working with one or more AWSs, use the STATUS AWS command to display
and change the display formats and column boundaries or all existing AWSs.
See Chapter 17, “AWS: Displaying/Changing AWS Information” on
page 17-1 for additional information.
See Chapter 5, “Defining the Display Format” for information.
BOUNDS Contains: Current or default left and right column boundary settings
to be used by any command that locates, edits or shifts data.
Change: Overtype field BOUNDS LEFT or RIGHT with
appropriate column number; use SET BOUNDS command. (If an
AWS is attached, the STATUS AWS command or BOUNDS line
command may be used.) See Chapter 4, “Defining Column
Boundaries” for information.
SET DISPLAY Contains: Left and right display margins established by default, the
last executed SET DISPLAY command, or the last change to this
display.
Change: Overtype SET DISPLAY LEFT or RIGHT with
appropriate column number(s); use SET DISPLAY command. (If an
AWS is attached, the STATUS AWS command can be used.)
CURRENT DISPLAY
Contains: Left and right display margins temporarily set by the last
command locating data outside of the SET DISPLAY boundaries or
by the values typed in the COLS field.
Change: This field is not modifiable.
num Contains: Current or default sequence number display setting.
Change: Overtype field with NUM, NUMX, NUM2 or NONUM;
use SET DISPLAY command. (If an AWS is attached, the
STATUS AWS command can be used.)
char Contains: Current or default data display mode.
Change: Overtype field with CHAR or HEX; use SET DISPLAY
command. (If an AWS is attached, the STATUS AWS command can
be used.)
cjust Contains: Current or default screen positioning to occur as a result
of executing a FIRST, LAST, NEXT, PREV, INCL, or EXCL
primary command.
Change: Overtype field with CENTERED, LOCKED, JUSTIFIED
or CJUSTIFIED; use SET SEARCH command. (If an AWS is
attached, the STATUS AWS command can be used.)
MODE Contains: Current or default character translation mode.
Change: Overtype field with BASIC, XTENDED or STANDARD;
use SET MODE command. (If an AWS is attached, the STATUS
AWS command can be used.)
CURSOR Contains: Current or default location at which the cursor is
positioned after a command is executed.
Change: Overtype field with HOME, INIT or DATA; use SET
CURSOR command.
To begin the display with the line containing a specific attribute, include the first one
to four characters of the field name. For example, to begin the display with the line
containing DATE FMT, you could enter:
STATUS SESSION D or
STATUS SESSION DA or
STATUS SESSION DAT or
STATUS SESSION DATE
Finally, you can produce a non-modifiable display by including the LIST operand with
the command, as in:
STATUS SESSION LIST
Unless noted otherwise, an attribute shown in the modifiable display can be changed
using the appropriate SET command or by overtyping the field. (Note that some of the
attributes have site-defined default and maximum values. To display these values, use
the STATUS SYSTEM command.)
The following example illustrates the type of information provided by the STATUS
SESSION command at a 43-line terminal.
|
7 > APPLID(A=4IROS3) USER(PH,DORDA=2) L PENDING
8
| > AWS(PH.DUPCR) SCRL CSR COLS ====1 ===79 PAU(PH.RAMB) A<AMB>3
| >....+....1....+....2....+....3....+....4....+....5....+....6....+....7..
| ROSCOE SESSION STATUS
7 _
8
>
>
....+....1....+....2....+....3....+....4....+....5....+....6.
ROSCOE SYSTEM STATUS
TIME Command
7 TIME 8
>
> AWS(AAA.SHIPRATE) SCRL FULL COLS ====7 ===72
> ..<1....+....2....+....3....+....4....+....5....+
============================= T O P =============
=====1 IDENTIFICATION DIVISION
7 >
8
>
....+....1....+....2....+....3....+....4....+....5....+..
=9/=6/88 15.3=.27 - ELAPSED =1:29:4= - CPU .34=
After viewing this information, you can reattach the data you were working with, or
issue any other CA-Roscoe command.
This chapter describes how you can print data at a system or 328x (or compatible)
printer. The descriptions cover how to:
■ Identify the data you want to print. It can be all or part of:
– The currently displayed screen.
– The active AWS.
– One or more library members or the Library Selection List.
Also see Chapter 34, “Library: Performing Library Management Tasks” for
information about printing data through the Library Facility Print Function
panel or the Selection List.
– The currently attached job output file.
Also see Chapter 30, “Jobs: Viewing Job Output” for information about
using the modifiable STATUS JOB display to print job output.
– The currently attached data set object.
Also see Chapter 27, “Data Sets: Performing Data Management Tasks” for
information about printing data through the Data Set Facility Print Function
panel or a Selection List.
■ Qualify the data that you want printed (for example, printing multiple copies or
printing only selected lines or columns of the data).
■ Control printers and printing locations. This includes:
– Displaying information about available printers and printing locations.
– Directing your data to print at an alternate location (like a different system or
328x-type printer).
■ Control and monitor the data after it has been scheduled for printing.
Data from any of the sources identified in the previous figure can be combined as long
as the total number does not exceed 12. To illustrate, the following example shows
how you can combine data from eight different sources. This example also uses the
INSEP operand to cause the data from each source to begin on a new page:
PRINT MEM1 DSN AWS 1= 4= AWS 9= 1== JOB LIB AAA.MEM2 SCR INSEP
1 2 3 4 5 6 7 8
You can also print a copy of the current screen display when an RPF program or other
application (like ETSO or CA-eMAIL+) is in control of the terminal. Assuming that
the CA defaults are in effect, you can do this by entering:
:P
in any unprotected field and pressing PF12. (The cursor must immediately follow the
command :P.)
If the CA defaults are not in effect, the STATUS SYSTEM display will identify the
site-defined:
■ Escape character: The field RSCESCCH identifies the character to use. The
default is a colon (:).
■ PF key: The field RCSESCPF identifies the PF key to use. The default is PF12.
CAPS Operand:
prints any alphabetic characters in the library member named INVLIST in uppercase.
(The data itself is not changed.)
TYPE Operand:
TYPE can be used to designate which printer control characters are to be recognized,
where:
TYPE ANS Recognizes ANSI control characters.
TYPE DEF Recognizes CA-Roscoe formatting pseudo-commands. (This is the
default.)
TYPE MCC Recognizes machine control characters.
>
> AWS(PRI.INVLIST1) SCRL FULL COLS ====1 ===72
> <...+....1....+....2....+....3....+....4....+....5...
================================ T O P ==============
===1== This data illustrates the use of the formatting
===2== pseudo-commands.
===3== :p.
===4== The preceding .SK 2 command causes two blank
===5== lines to be inserted in the printed output.
===6== :TOP
===7== The :TOP command causes a page EJECT to occur.
===8==
===9== The pseudo-commands must begin in the first posi-
==1=== tion of a line and be the only data on that line.
FORMAT Operand:
where:
tag Optional name that you can assign to the print request.
number Print request number assigned by CA-Roscoe.
id Location at which the request is scheduled for printing.
Note: A print request is any data that you direct to a system or 328x-type printer.
You can assign a name (referred to as a tag) to a print request. If included, the tag
must be one- to eight- characters in length, begin with an alphabetic character, and be
bound by apostrophes, as in:
PRINT 'MASTER' DSN
Here, the name MASTER is assigned to the print request that prints the contents of the
currently attached data set object.
To reference a scheduled print request (that is, to hold a request), you must include
either the CA-Roscoe-assigned request number or the user-assigned tag name with the
appropriate command. See 7.4, “Controlling and Monitoring Print Requests” on
page 7-13 for additional information.
■ To print a range of lines within the active AWS, include the appropriate starting
and ending line numbers with the command, as in:
PRINT 1== 5==
■ To print a range of lines within an attached data set object, job output file or
library member, specify the appropriate line numbers after identifying the data to
be printed, as in:
PRINT JOB 1== 5==
■ When printing data from multiple sources, identify the data to be printed and the
appropriate line numbers, as in:
PRINT INVLIST 6== 1=== AWS 12== 23== DSN 1== 5==
■ To print any display that does not include line numbers (like the current screen
display or a Data Set Facility Selection List), assume that the data are numbered
from one by one. Thus, to print the first ten lines of the current screen display,
PRINT SCREEN 1 1=
You can also limit a print request to include only the data appearing within specific
columns.
■ If the display includes a Scale Line (like the active AWS, a library member,
attached job output file or data set object), use the Scale Line values to determine
the appropriate column numbers. For example, if you enter:
PRINT JOB COLS 1= 3=
only the data appearing within column 10 through 30 will be included in the print
request.
■ If the display does not include a Scale Line (like the current screen display), the
left-most displayed position is assumed to be column one. Thus, if you enter:
PRINT SCREEN COLS 1 1=
only the data appearing in the first ten positions on the screen will be included in
the print request.
When you issue the PRINT command, your data are directed to the default printing
location associated with your terminal.
You can change your printing location for a single request or for the remainder of your
terminal session.
To specify an alternate location for a single request, use the DEST operand with the
PRINT command. For example, to print the contents of the active AWS at the
location identified as PR05, you would enter:
PRINT DEST PR=5
Use the SET RPSDEST command to alter the default printing location for the duration
of your terminal session (or until you execute another SET RPSDEST command). For
example, to change the default printing location to PR12, you would enter:
SET RPSDEST PR12 2
where printer-name is the name your site has assigned to that printer.
Note: If you need to use a non-standard size paper (like the paper width and/or
length differs from the default), include the PW and PL operands with the
PRINT command. For example, if you are using paper that allows only 50
print lines where each line can contain a maximum of 40 characters, you
would enter:
PRINT PL 5= PW 4=
You can use the tag name in place of the request number, as in:
PRINT CANCEL MASTER
To check the status of all of your outstanding print requests, you can enter either:
PRINT STATUS or PRINT STATUS ALL
To check the status of a particular request, you must include the tag or print request
number of the desired request. For example, to check the status of a print request
whose tag name is MASTER, enter:
PRINT STATUS MASTER
To check the status of the print request assigned the number 278, enter:
PRINT STATUS 278
Having held one or more requests, you can release them using the PRINT RELEASE
command, as in:
PRINT RELEASE MASTER
or
PRINT RELEASE 598
or
PRINT RELEASE ALL
You can use PRINT HOLD and PRINT RELEASE to rearrange the priorities of your
own print requests. The steps you follow are:
1. Hold all of your outstanding requests at the appropriate location.
2. Release the print request you want printed first, then release your remaining print
requests.
This example assumes that the terminal's default printing location is PRT01 and that
ABC was implicitly scheduled to print at that location. If you reroute a held request,
the request is automatically released.
This chapter describes the basic format of the screen displayed during a CA-Roscoe
session. It also discusses how you can:
■ Split the screen, (allowing two concurrent CA-Roscoe subsessions).
■ Lock the screen by invoking the Terminal Lock Facility.
7 _
8
1
>
> AWS(PRI.INVLIST) SCRL FULL COLS ====1 ===72 2
> <...+....1....+....2....+....3....+....4....+....5....+....6.
================================ T O P ======================
===1== IDENTIFICATION DIVISION.
===2== PROGRAM-ID. INVLIST.
===3==
===4==
===5== ENVIRONMENT DIVISION.
===6==
===7== CONFIGURATION SECTION.
===8== SOURCE-COMPUTER. IBM-3=81.
===9== OBJECT-COMPUTER. IBM-3=81.
==1=== 3
==11== INPUT-OUTPUT SECTION.
==12== FILE-CONTROL.
==13== SELECT INVENTORY-FILE
==14== ASSIGN TO UT-S-SYSIN.
==15== SELECT INVENTORY-REPORT
==16== ASSIGN TO UT-S-SYSPRINT.
U V
Note: This screen and all others shown in this manual are representations of the
actual screens. The screen widths are modified to allow them to fit within the
margins of this manual. This results in an abbreviated System Information and
Scale Line.
This area is where you enter all primary commands, Monitor commands and RPF
program names. You can enter one or more commands or program names per line.
(See Chapter 2, “Commands and Command Components” for additional information
about entering commands in this area.)
DSN() dsn A data set object is displayed. The data are not modifiable;
portions of selection lists and function panels are modifiable.
The fully qualified name of the data set object is shown on the
line below this keyword.
HLP(..HELP..) A HELP member is displayed. It is not modifiable.
JOB(name, no) Job output is displayed. The data are not modifiable. The job
name and number are bound by parentheses following the
keyword.
LIB(pfx.mem) Library facility data are displayed. The displayed member is not
modifiable; portions of the selection list and function panels are
modifiable. When a member is displayed, its prefixed name,
bound by parentheses, follows the keyword.
STA(name, no) Information about the currently attached job output is displayed.
Portions of the display are modifiable.
The right side of the display might also contain:
A<name> An AWS is attached. Its name is bound by < and >.
PGM(pfx.mem) An RPF program is executing. PGM is followed by the prefixed
name of the library member containing the executing program.
PAU(pfx.mem) An RPF program is executing and is in a pause state. PAU is
followed by the prefixed name of the library member containing
the executing program.
The SCRL Field
This modifiable field contains the value used by the PF keys that are assigned
scrolling functions. You can change this value at any time by issuing the SET
SCROLL command, or by positioning the cursor to the start of this field and
entering one of the values shown in the following table.
When an AWS is attached, line commands can be used to enter and modify the
displayed data. (For additional information about using line commands, see Chapter 2,
“Commands and Command Components.”)
When the screen is split, each presentation area represents a single CA-Roscoe
subsession. Each subsession is allocated its own AWS and can be used to perform any
command or function handled through the single display format. These subsessions
allow you to have two simultaneous independent CA-Roscoe sessions. (If there is a
site sign-on program or if you have a sign-on program, these programs are executed
each time you split the screen.)
When you split the physical screen into two logical presentation areas, each screen
contains:
■ A Command Area, consisting of one to three lines. (Use the SET CMDLINES
command to specify the number of lines comprising this area.)
■ A System Control Area, containing a Response Line, System Information Line and
Scale Line.
■ An Execution Area, containing the maximum number of lines allowed as
determined by the type of split screen you invoked.
The minimum size of a presentation area is 11 lines. The maximum size is determined
by the type of screen split being requested.
7 8
>
> AWS() SCRL FULL COLS ====1 ===72
> <....+....1....+....2....+....3....+....4....+....5....+....6.
...... ================================= T O P ======================
===1== AAAAA
...... ============================== B O T T O M ===================
7- 8
> S1 PENDING
>
>....+....1....+....2....+....3....+....4....+....5....+....6....+....7
To cause a full-screen split when a partial-screen split is currently in effect, move the
cursor to the last line of the appropriate presentation area and press PF1 or PF13. That
presentation expands to to fill the terminal screen.
:S
in any unprotected field of the screen and pressing PF12. (The cursor must
immediately follow the command.) Note that the colon and PF key assignment are the
CA-Roscoe defaults. Use the STATUS SYSTEM command to determine if your site
management has changed these defaults.
Partial-Screen Split
7 >
8
> AWS() SCRL FULL COLS ====1 ===72
> <....+....1....+....2....+....3....+....4....+....5....+....6..
...... ================================= T O P =======================
===1== AAAAA
...... ============================== B O T T O M ====================
) ) ) ) ) ) ) ) ) ) ) ) ) ) ) ) )
_
>
>
>....+....1....+....2....+....3....+....4....+....5....+....6....+....7
U V
If the physical screen contains an even number of lines, the upper presentation
area will contain one more line than the lower presentation area.
■ divide the screen unequally:
Position the cursor to any line other than those used to perform an equal- or
full-screen split and press PF1 or PF13. (For example, if you position the cursor
to the thirteenth line of a 43-line terminal screen and press PF1 or PF13, the upper
screen will contain 12 lines, the separator will be on the thirteenth line and the
lower presentation area will use the remaining lines.
Note that you cannot change the screen size if an RPF program executing in either
presentation area contains the command SET SCREEN NOMODIFY.
When a partial-screen split is in effect, use the cursor positioning keys to move the
cursor from one area to the other, the new presentation area becomes active; the old
presentation area is inactive.
■ If the newly activated presentation area is less than three-fourths the size of the
deactivated presentation area, the sizes of the two areas are interchanged.
■ If the cursor is positioned to the line separating the two areas, both presentation
areas are considered inactive.
You can activate one presentation area while deactivating the other by pressing PF2 or
PF14, the CA-Roscoe default PF-key assignments for swapping. This bounces the
cursor from the active presentation area to the inactive area. Thus, activating the new
area.
When a full-screen split is in effect, pressing PF2 or PF14 causes the logical screens to
be bounced, where the new screen contains the cursor and is, thus, the active screen.
When a full-screen split is in effect and an RPF program or another application (like
ETSO or CA-eMAIL+) is in control of the terminal, you can swap the logical screens
by entering:
:W
in any unprotected field of the screen and pressing PF12. (The cursor must
immediately follow the command.) Note that the colon and PF key assignment are the
CA-Roscoe defaults. Use the STATUS SYSTEM command to determine if your site
management has changed these defaults.
You can end your CA-Roscoe session while the screens are split by entering OFF or
OFFON in either presentation area.
If, when you terminate split screens or sign-off CA-Roscoe, there is data in an AWS
with a RECOVERABLE attribute, it is saved in a library member named SAVAWSnn,
where nn is a unique identifier.
If a full-screen split is in effect and an RPF program or another application (like ETSO
or CA-eMAIL+) is in control of the terminal, you can terminate split screen processing
by entering:
:E
in any unprotected field of the screen and pressing PF12. (The cursor must
immediately follow the command.) Note that the colon and PF key assignment are the
CA-Roscoe defaults. Use the STATUS SYSTEM command to determine if your site
management has changed these defaults.
allows you to bounce between the terminal's primary and alternate screen sizes.
Additional operands of this command permit you to switch to a specific size, as in:
SCREEN 2
which changes the screen size to 24 rows by 80 columns. See the CA-Roscoe
Command Reference Guide for additional information about using this command.
the terminal lock screen (as illustrated in the following example) is displayed.
7 >
8
....+....1....+....2....+....3....+....4....+....5....+....6....+....7.
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
||||| TLO=1 TERMINAL LOCKED ||||||||
||||| ||||||||
||||| KEY your-key DATE =9/19/94 ||||||||
||||| TERMID terminal-id TIME 14.35.5= ||||||||
||||| APPLID application-id VERSION 6.= ||||||||
||||| ||||||||
||||| To continue enter password => ||||||||
||||| To terminate enter 'OFF' => ||||||||
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
||||||||| ||||| ||||| || ||| ||||| |||||
|||||||| || |||| || ||||| ||||||||| |||||| || ||||| ||||||||||
|||CA-| || |||| || ||||| ||||||||| |||||| || ||||| |||||||||||
|||||| |||| || ||||| ||| |||||| || ||||| ||||||||
||||| ||| |||| || ||||||||||| ||| |||||| || ||||| |||||||||||||
|||| ||| ||| || ||||||||||| ||| |||||| || ||||| ||||||||||||||
||| ||| ||| ||| ||| || ||||| |||||||||
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
U V
When this screen is displayed, you must enter either your CA-Roscoe password (to
resume your session) or the OFF command (to terminate your session).
Note: The Terminal Lock Facility is not available if you have no CA-Roscoe
password, are using a typewriter device, or are accessing CA-Roscoe through a
terminal defined to CICS.
There are two other ways the Terminal Lock Screen can be displayed.
1. When an RPF program or another application (like ETSO or CA-EMAIL+) is in
control of the terminal, you can force the Terminal Lock screen by:
■ Checking the STATUS SYSTEM display to verify the site-defined escape
character prefix (identified by the RCSESCCH field) and PF key (identified
by the RCSESCPF field).
■ Assuming the defaults are in effect, entering in any unprotected field of the
display:
:L
and pressing PF12. (The cursor must immediately follow the command :L.)
2. Site management can force the terminal to be locked if there is no activity for a
site-specified period of time. (If the CA-Roscoe Automatic Signoff Facility is in
use when the Terminal Lock screen is displayed, you will be signed off
CA-Roscoe if there is no terminal activity within the site-specified time period.)
In addition to causing the Terminal Lock screen to be displayed, you can use the SET
TLOCK command to: 1) activate the Terminal Lock Facility, if it is inactive and 2)
change the site-defined inactivity period. See the CA-Roscoe Command Reference
Guide for additional information about the SET TLOCK command.
You can use the SEND command or the BulletinBoard System to direct a message
containing one or more lines to any other CA-Roscoe user.
only messages sent by the operator are displayed. (Regardless of the setting, the
messages are always added to your library member ZZZZZMSG.)
To permit messages created by the SEND command to be displayed, you would enter:
SET SEND ALL
If you are signed on and receiving messages when someone sends you a message and
it is a:
■ One-Line Message:
The message is displayed on the Response Line the next time you press the
ENTER key or a PF key. As shown in the following example, the message text is
preceded by the sender's prefix.
7 8
> pfx RECEIVED YOUR REPORT. THANKS, JOHN
> AWS() SCRL FULL COLS ====7 ===72
> ...1....+....2....+....3....+....4....+....5....+....
...... ============================= T O P =================
===1== IDENTIFICATION DIVISION.
■ Multi-Line Message:
The following example illustrates the format of the message you will receive the
next time you press the ENTER key or a PF key.
Whether or not you are signed on or receiving messages, an entry is always added to
the top of the your library member ZZZZZMSG. Each entry consists of two lines,
where the first line indicates the date, time and sender's name. The second line
contains either: 1) the one-line message or 2) the name of the library member that was
created to hold the multi-line message.
On the ZMsg screen, fill in the fields with the appropriate information. Enter the
CA-Roscoe prefix or the key of the user you are sending the message to. If the key or
prefix does not exist, you will receive an error message on the Error/Status line. Enter
the message text in the Message field.
To send the message, press ENTER. The message will be sent, and your message
field will be immediately updated to include this information. The Status line on the
top of the screen tells you that the message was sent, and to what prefix.
10.1 Signing On
In addition to describing the CA-Roscoe sign-on screen, this section provides
information about how to bypass the sign-on screen when signing on from VTAM
terminals or accessing CA-Roscoe from CICS terminals, a TSO session or another
CA-Roscoe.
The following example illustrates the CA-Roscoe sign-on screen that is displayed at
3270-type terminals.
7 8
>APPLID(A=4IROS3)
>
....+....1....+....2....+....3....+....4....+....5....+....6....+....7
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|||| |||||||
|||| |||||||
|||| KEY _ DATE =9/19/92 |||||||
|||| PASSWORD TIME 14.35.49 |||||||
|||| GROUP CODE TERMID A=1IX=17 |||||||
|||| NEW PASSWORD > |||||||
|||| > (Repeat for verification) |||||||
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|||||||| ||||| ||||| ||| ||| ||||| |||||
||||||| || |||| || ||||| ||||||||| |||||| || ||||| ||||||||||
||CA-| || |||| || ||||| ||||||||| |||||| || ||||| |||||||||||
||||| |||| || ||||| ||| |||||| || ||||| ||||||||
|||| ||| |||| || ||||||||||| ||| |||||| || ||||| ||||Ver 6.=||
||| ||| ||| || ||||||||||| ||| |||||| || ||||| ||||Glvl 94=4|
|| ||| ||| ||| ||| || ||||| |||||||||
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|||| COPYRIGHT (C) 1994 COMPUTER ASSOCIATES INTERNATIONAL, INC. ||||||
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
U V
To sign on to CA-Roscoe, complete the following fields:
KEY (Required.) Enter the sign-on key assigned to you by site
management. The cursor is positioned to this field when the
sign-on screen is displayed.
PASSWORD (May be required.) Enter your password if you have been
assigned one.
A password protects you against unauthorized access. Thus,
for security reasons, your password is not displayed when you
enter it.
After completing the appropriate fields, press the ENTER key to have the information
transmitted to CA-Roscoe. As soon as you are signed on:
■ The system sign-on message is displayed, if established by your site management.
■ The system sign-on program is executed, if established by your site management.
■ Your sign-on program is executed, if you have created one.
Your site management will tell you what application ID to use. If the ID is, for
example, ROSCOE, you can display the CA-Roscoe sign-on screen by entering:
ROSCOE
and pressing the ENTER key. You can now sign on as described earlier.
You can bypass the CA-Roscoe sign-on screen by entering sign-on information with
the VTAM application ID. To do this, you would use the format:
──applid──signonkey──┬─────────────────────────────┬──────────
└─/password─┬─────────────┬─/─┘
└─/group-code─┘
Examples:
If your sign-on key is SMITH and you have no password or group code, you would
enter:
ROSCOE SMITH
If you sign-on key is SMITH and your password is MYPASS, you would enter:
ROSCOE SMITH/MYPASS
You can sign on to one CA-Roscoe from another CA-Roscoe at any time using the
ETSO CALL command in the form:
──CALL──prog──┬────────────────────┬──┬────────────┬──────────
└─signonkey/password─┘ └─ROSID=code─┘
Notes:
■ If you do not enter your sign-on key and password, either:
– The information is provided by your site security system and, thus, the
CA-Roscoe sign-on screen is bypassed, or
– The CA-Roscoe sign-on screen is displayed.
■ There is an optional user group code:
– If specified explicitly, will be passed to the target CA-Roscoe.
– If specified implicitly with an asterisk (*), the user group code from your
current CA-Roscoe session will be passed to the target CA-Roscoe.
– If your site security system is providing the sign-on information, the user
group code from your current CA-Roscoe session will be passed to the target
CA-Roscoe.
■ ROSID= allows you to designate which CA-Roscoe you want to sign on to. You
may omit ROSID= if:
– Your site is executing a single CA-Roscoe, or
First, create a full-screen split. In the new screen, enter the CALL command with the
appropriate program name and identify the target CA-Roscoe, as in:
──CALL──prog──┬──────────────────────┬──ROSID=ROSA────────────
└─signonkey──/password─┘
You are now signed on to the CA-Roscoe identified as ROSA. To bounce back to the
ROS1, your host CA-Roscoe, enter: '; (Host CA-Roscoe RCS Escape Character)'
;W
and press PF12, where the ; is defined as the host CA-Roscoe RCS escape character.
When you are returned to ROS1, the ETSO application is viewed as suspended. You
can execute CA-Roscoe commands, RPF programs, and so on. You can swap back to
the target CA-Roscoe at any time to continue your session on ROSA.
Since the target CA-Roscoe has a different RCS escape character, it is possible to
request a full-screen split on that CA-Roscoe. This gives you four CA-Roscoe screens,
two on the host and two on the target. It is also possible for you to access yet another
CA-Roscoe from the target.
When you end your target CA-Roscoe session you are returned to your host
CA-Roscoe session.
As can be seen by the preceding example, it is possible for you to access multiple
CA-Roscoes from a single terminal.
──transid──┬──────────────────────────┬──┬────────────┬───────
└─signonkey─┬───────────┬──┘ └─ROSID=code─┘
└─/password─┘
Notes:
■ See the CA-Roscoe Installation Guide for complete information about setting up
CICS interface modules and TRANSID resources.
■ If you do not enter your sign-on key and password, either:
– The information is provided by your site security system and, thus, the
CA-Roscoe sign-on screen is bypassed, or
– The CA-Roscoe sign-on screen is displayed.
■ ROSID= allows you to designate which CA-Roscoe you want to sign on to. You
can omit ROSID= if:
– Your site is executing a single CA-Roscoe, or
– You have no preference as to which CA-Roscoe you are signed on to when
your site is executing multiple CA-Roscoe systems.
When you end your CA-Roscoe session, you are returned to CICS.
From the TSO READY prompt or from ISPF/PDF Option 6, you can access
CA-Roscoe using the sign-on format:
──cpid──┬──────────────────────────┬──┬──────────────────┬────
└─signonkey─┬───────────┬──┘ └─ROSID=─┬──────┬──┘
└─/password─┘ └─code─┘
where cpid is the name of a site-defined TSO Command Processor. For example, if
the TSO Command Processor for CA-Roscoe is ROSF, your sign-on key is
MYSIGNON and your password is MINE, you might enter:
ROSF MYSIGNON/MINE
Notes:
■ If you do not enter your sign-on key and password, either:
– The information is provided by your site security system and, thus, the
CA-Roscoe sign-on screen is bypassed, or
– The CA-Roscoe sign-on screen is displayed.
■ ROSID= allows you to designate which CA-Roscoe you want to sign on to. You
may omit ROSID= if:
– Your site is executing a single CA-Roscoe, or
– You have no preference as to which CA-Roscoe you are signed on to when
your site is executing multiple CA-Roscoe systems.
When you end your CA-Roscoe session, you are returned to TSO.
WARNING:
The TSO restriction on the use of PA1 is applicable during your CA-Roscoe
session. If you should press the PA1 key, it is ignored.
If your site permits you to control your password, you have two different methods for
creating, changed and deleting it.
You can use the NEW PASSWORD fields on the CA-Roscoe sign-on screen to:
■ Create a Password.
Enter your password in the NEW PASSWORD field. To verify that the password
is spelled correctly, reenter it on the next line. The password must be one to ten
characters in length and cannot contain a slash (/) as one of its characters.
■ Change a Password.
Enter your current password in the PASSWORD field. Then enter your new
password in the NEW PASSWORD field (and on the following line for
verification). The next time you sign on to CA-Roscoe, your new password will
be in effect.
■ Eliminate a Password.
Enter spaces in the NEW PASSWORD field and on the following line.
A sign-on program consists of one or more CA-Roscoe commands that are saved as a
library member. If you have a sign-on program, it is executed every time you sign on
to CA-Roscoe and every time you split the screen.
A sign-on program is useful when, for example, you want certain CA-Roscoe session
attributes to always be in effect. Rather than entering the commands establishing each
attribute every time you sign on to CA-Roscoe, you can include the commands in a
library member and then have the commands in that member automatically executed
for you. (See Chapter 6, “Displaying Session Attributes/Information” for additional
information.)
The following example contains a sample sign-on program. In addition to using some
of the commands that set session attributes, it also changes the functions assigned to
some of the PF keys.
7 SAVE MYSIGN_
8
>
> AWS( ) SCRL FULL COLS ====1 ===72
> <...+....1....+....2....+....3....+....4....+....5....6....+
...... ================================ T O P =====================
===1== <<MYSIGN>>
===2== SET MODE XTENDED : Set character translation
===3== SET DISPLAY ALL 1 72 NUM : Set display format
===4== SET DISPLAY AWS 7 8= NUMX : Set AWS display format
===5== TAB $ : Set tab character
===6== TAB 16 2= 42 : Set tab positions
===7== SET ; : Set command delimiter
===8== : PF key assignments follow
===9== LET AWS.PF13 = '+FETCH +C1+/ATTACH'
==1=== LET JOB.PF13 = '+ATTACH JOB +C1+'
==11== LET DSN.PF13 = '+ATTACH DSN +C1+'
==12== LET LIB.PF13 = '+ATTACH +C1+'
==13== LET PF14 = '+DETACH +C1+'
==14== LET PF15 = '+SCROLL +C1+ +C2+ +C3+'
============================= B O T T O M ==================
U V
When creating a library member that is to be your sign-on program:
■ Only one command may appear per line in the member.
■ The first line in the member should contain the library member name.
If you do include the name, it must be bound by angle brackets (<< and >>).
(Notice line 100 in the previous figure contains <<MYSIGN>>, where MYSIGN
is the name of the member.)
To establish or change the member containing your sign-on program, enter the
command SIGNON followed by the appropriate library member name. For example:
SIGNON MYSIGN
establishes the library member named MYSIGN as your sign-on program. Once
established, the library member remains your sign-on program until you specify
another one or eliminate the existing one.
To eliminate a sign-on program, enter the SIGNON command with no operand, as in:
SIGNON
Eliminating a sign-on program does not delete the library member. It simply prevents
the commands comprising that member from being executed each time you sign on to
CA-Roscoe.
If any existing AWS with a RECOVERABLE attribute contains data when you sign
off (or are automatically signed off), the contents of each AWS is saved as a library
member named SAVAWSnn, where nn is a unique ID.
The time that you specify may not exceed your site-defined maximum. (Use the
STATUS SYSTEM command to display the site-defined default and maximum
inactivity time periods.)
If your site is not using this facility, it will be noted on the STATUS SYSTEM
display. You then have the option of activating and deactivating the facility using the
SET AUTOFF command.
When a PF/PA key with a variable assignment is pressed, the entire Command
Area is read to build a valid PF/PA key assignment. Thus, all of the information
needed by a PF/PA key must appear on the same line and precede any other
command or data.
When an assignment includes variables, the combined length of the assignment
after the variables have been replaced by values plus any additional
commands/data found in the Command Area must not exceed 255 characters in
length.
You have the option of changing any of the PF/PA key assignments provided by your
site. New assignments:
■ Can be established at any time during a terminal session.
■ Remain in effect until you sign off or change them. If you decide that you always
want certain assignments to be in effect, you can add the commands establishing
those assignments to your signon program. Then, each time you sign on, the
commands are executed and the PF/PA functions are automatically reassigned for
you.
11.4.1 Syntax
The syntax to assign a function to a PF or PA key is:
──LET──┬────────┬──┬─PAv─┬──=──'string'───────────────────────
└─scope.─┘ └─PFv─┘
scope Qualifies the operational range of this key. If omitted, the operation
applies to all forms of attached data. If specified, it must be one of
the following:
AWS. Designates that the operation affects only the active
AWS.
DSN. Designates that the operation affects only the attached
data set object.
JOB. Designates that the operation affects only the attached
job output.
LIB. Designates that the operation affects only the attached
library member.
PAv PA key whose assignment is to be changed, where v is a value
between 1 and 10.
PFv PF key whose assignment is to be changed, where v is a value
between 1 and 24.
'string' Function to be performed. It must be delimited by apostrophes. It
may contain Command Line and/or RPF variables and, after the
variables have been replaced by their values, must not exceed 255
characters in length. (See the next section for additional information
about assigning functions.)
PA Keys You can assign one or more commands or one of the designated keyword
functions of a PA key.
PF Keys You can assign one or more commands or any keyword function to a PF
key. When assigning commands and keyword functions, you may include
multiple commands but only one function.
When variables are used within an assignment, the assignment must begin
with a special character (a plus sign in these examples) that is also used to
delimit the variable portion of the assignment, as in:
LET PF4 = '+FETCH +C1+/ATTACH' or
LET PF5 = '+RENUMBER/SAVE +C1+'
If you omit the special character, the variable is not recognized. (In both
cases, C1 is assumed to be a library member name, not a Command Line
variable.)
Caution IMPORTANT:
When variables are used in an assignment, the length of the assignment,
after all variable substitution has been performed, plus any other
commands/data specified in the Command Area may not exceed 255
characters.
The following functions can be used to position the display. Unless noted otherwise:
■ These functions can only be assigned to PF keys, and
■ Any changes made to the current frame are applied.
Note: A frame is equivalent to the number of lines in the Execution Area. (Page is a
synonym for frame.)
POSITION BOTTOM The display is positioned so that it ends with the last
displayable line.
POSITION TOP The display is positioned so that it begins with the first
displayable line.
SCROLL BACK The display is positioned backward based on the value
specified in the SCRL field of the System Information
Line. If the number of remaining lines is less than the
SCRL field value, the action is identical to POSITION
TOP.
SCROLL BACK Csr The display is positioned so that the line at which the
cursor is positioned is the last displayed line. If the
number of preceding lines is less than the size of the
Execution Area, the display is unchanged.
The following functions control split-screen processing. They can only be assigned to
PF keys.
END Split-screen processing is terminated; the two logical screens are
returned to a single physical screen.
SPLIT Split-screen processing is invoked; the physical screen is divided into
two logical screens.
SWAP Active and inactive split screens are interchanged; the cursor is moved
from one logical screen to the other.
This chapter describes the user documentation and online tools that are provided with
CA-Roscoe.
Finally, each user should have a copy of the CA-Roscoe Reference Summary and,
optionally, a copy of the RPF Reference Summary.
7 _
8
>
> HLP(...HELP...) SCROLL FULL DISPLAY ==1 =79
>....+....1....+....2....+....3....+....4....+....5....+....6
SAVE
. . .
U V
As with all HELP displays, the information presented includes:
Function A one-sentence description of the command or facility.
Syntax The syntax of the command.
Level List of HELP members that provide additional and/or related
information about the command or facility.
The following figure identifies the PF keys that are used to position within and
between HELP displays.
To obtain information about the HELP facility itself, enter the command:
HELP
The Tutorial presents you with a menu of 12 independent learning modules. You can
complete the modules in order, use only certain modules, or vary the order in which
you complete the modules.
The resulting HELP display explains how to invoke the Tutorial at your company.
Chapter 15. AWS: Copying Data Within and Into an AWS . . . . . . . . 15-1
15.1 Copying Data Within the Active AWS . . . . . . . . . . . . . . . . . . . 15-2
15.1.1 Using a Primary Command . . . . . . . . . . . . . . . . . . . . . . . 15-2
15.1.2 Using Line Commands . . . . . . . . . . . . . . . . . . . . . . . . . 15-3
15.2 Copying Data to an AWS . . . . . . . . . . . . . . . . . . . . . . . . . . 15-8
15.2.1 Alternate Form of Screen Copy . . . . . . . . . . . . . . . . . . . . 15-9
15.2.2 Copying All or a Range of Lines . . . . . . . . . . . . . . . . . . . . 15-10
15.2.3 Copying Based on a Character String . . . . . . . . . . . . . . . . . 15-10
15.3 Copying Data Between Screens . . . . . . . . . . . . . . . . . . . . . . . 15-12
15.3.1 Copying All or a Range of Lines . . . . . . . . . . . . . . . . . . . . 15-13
15.3.2 Copying Based on a Character String . . . . . . . . . . . . . . . . . 15-13
When you sign on to CA-Roscoe, an AWS (or Active Work Space) is automatically
allocated for your use. If you split the screen, a second AWS is automatically allocated
for that subsession (a split screen appears). These AWSs are named ROSn, where n is
a unique identifier. (The name of the AWS that you are currently working with is
shown at the right side of the System Information Line.) All data entry and editing
that you do during your CA-Roscoe session is done in one of these temporary work
areas.
Note: See Chapter 8, “Selecting a Screen Format” on page 8-1 for information about
the CA-Roscoe split screen facility.
You can place data in an AWS by entering it from the terminal or copying it from the
CA-Roscoe library, an attached job output file or an OS data set. After editing the
data, you can store it as a member in the CA-Roscoe library, print a copy of it at a
328x-type or system printer, submit it to the operating system, write it to a data set or
delete it.
The data in an AWS is stored in the form of variable length records not exceeding 255
characters in length. (Each line in an AWS is considered to be a record.) These
records are kept in order by six-digit sequence numbers that are created and
maintained externally from your data. The maximum number of records that you can
have in an AWS is set by your site management.
Any data remaining in an AWS when you sign off is automatically saved for you if
the AWS has a RECOVERABLE attribute. The data is saved in the CA-Roscoe library
as a member. One member is created for each recoverable AWS that you are using.
The members are named SAVAWSnn, where nn is a unique identifier. These members
are also created in the event of a network shutdown or system failure. The next time
you sign back on to CA-Roscoe, you can use these members to restore your AWS(s).
To view the entire contents of a specific AWS and make it the active AWS, you might
enter:
ATTACH AWS SAMPLE
When working with the currently active AWS, you can use ATTACH to:
■ Limit the display to a particular range of lines. For example, to view only lines
200 through 800 of the currently active AWS, you would enter:
ATTACH 2== 8==
■ Begin the display with the first occurrence of a particular character string. For
example, assume that the active AWS contains a COBOL program and you want
to begin the display with the line containing PROCEDURE DIVISION. To do
this, enter:
ATTACH 'PROCEDURE DIVISION'
The display begins with the first line in the active AWS that contains the specified
string. (Note that the string specified with ATTACH must be enclosed by a special
character that is not found within the string itself.)
Also refer to Chapter 27, “Data Sets: Performing Data Management Tasks” on
page 27-1 and Chapter 34, “Library: Performing Library Management Tasks” on
page 34-1 for additional commands that can be used to place data within an AWS.
You can also use the modifiable display provided by the STATUS AWS command to
rename or change AWS attributes. See Chapter 17, “AWS: Displaying/Changing
AWS Information” on page 17-1 for details.
You can use the CREATE command to name and define the attributes of one or more
additional AWSs. The maximum number of additional AWSs that you can work with
is set by site management.
where SAMPLE is the name assigned to this AWS. You can use almost any one- to
eight-character name that conforms to CA-Roscoe member naming conventions. (The
restricted names are FLIP, NEXT, PREV, ROSn, SYSn and TMPn (where n is a
numeric value); B, F, N, P, T, and R are also restricted.)
Since no attributes are defined with the CREATE command in the preceding example,
the default values are used. The attributes that you can assign to an AWS (and their
default values) are:
■ RECOVERABLE or NONRECOVERABLE
These define whether the contents of the AWS is to be backed up on disk and
recovered in the event of a session or system failure. The default is
RECOVERABLE.
■ SESSION, SPLIT, RPF or LEVEL:
These define the retention period for the AWS, where:
SESSION Discards the AWS when you end your session. (Default)
SPLIT Discards the AWS when the screen in which the AWS was
created is terminated.
RPF Discards the AWS when the RPF application containing the
CREATE command terminates (In this case, application refers
to the initiating RPF program and all of its subordinate RPF
programs.)
LEVEL Discards the AWS when the RPF program containing the
CREATE command terminates.
■ ACTIVE or INACTIVE
These define whether the AWS is to become the active AWS for the screen
containing the command. The default is ACTIVE.
■ IMPLICIT or EXPLICIT
These define how the AWS is to be identified when a SELECT command is
issued. The default is IMPLICIT. (See 13.10, “Selecting an AWS” on page 13-14
for additional information.)
■ NEW, REUSE or RETAIN
These define the type of AWS being created, where:
NEW Indicates this is a new AWS. (Default)
REUSE Reuses an existing AWS after deleting its contents.
RETAIN Reuses an existing AWS while retaining its contents.
The attributes described thus far relate only to an AWS that you create. Once created,
each AWS has its own attributes that affect how data are displayed and/or handled. To
display all of the attributes associated with each existing AWS, use the command:
STATUS AWS
Also see Chapter 17, “AWS: Displaying/Changing AWS Information” on page 17-1
for a description of all AWS attributes.
You can also use the modifiable display provided by the STATUS AWS command to
discard one or more AWSs. (See Chapter 17, “AWS: Displaying/Changing AWS
Information” on page 17-1 for details.)
Finally, the retention attribute associated with an AWS also controls when that AWS
will be discarded. For example, if you create an AWS with the retention attribute of
SPLIT, that AWS will be discarded when the split screen in which the CREATE
command was executed is terminated. (See 13.5, “Creating an AWS” on page 13-6 for
additional information.)
This example assumes that all three commands appear in the Command Area when the
ENTER key is pressed. The results would be different if the active AWS is attached
and the commands are entered one at a time, where:
■ Lines 600 through 900 are deleted. The AWS pointer is positioned to the line
following the last deleted line. The data are then redisplayed. The redisplay of
attached data causes the pointer to be positioned to the first displayed line.
■ The line at which the pointer is currently positioned (the first line of the active
AWS) is then copied after line 2100. The data are again redisplayed. Again, the
AWS pointer is positioned to the first displayed line.
■ The AWS contents are then explicitly redisplayed. The display begins with the
first line of the active AWS.
When using the asterisk (*) to reference the current pointer position, you can qualify it
with a positive or negative value, as in:
*-5 References the line that is five lines after the current pointer position.
*+5 References the line that is five lines before the current pointer position.
For additional information, see the CA-Roscoe Command Reference Guide. When
applicable, the command descriptions include the position of the pointer after the
command is executed.
If the AWS that you are viewing exceeds the number of lines in your terminal screen,
you can reposition the display by:
■ Pressing any of the scrolling PF keys.
■ Using the POINT command with the LINE operand. For example, to reposition
the display to begin with line 2500, you would enter:
POINT AWS LINE 25==
To position to the first or last line of the display, you would enter:
POINT AWS LINE T or POINT AWS LINE B
When browsing the STATUS AWS display, entering an * (asterisk) in the first
unprotected field for a specific entry repositions the display to begin with that
entry.
The line commands shown in the following figure can be used to reposition the
displayed data. Simply enter the appropriate line command in the sequence number
field of the display.
COMMAND ACTION AFTER COMMAND EXECUTED
v Display begins with line v (display begins with line 500 if that value is
typed in the sequence number field of any line).
* Display begins with the line that contained the *. Can be qualified
with:
+v Display begins v number of lines after the line that contained the
command.
-v Display begins v number of lines before the line that contained
the command.
+P [v] Display scrolled forward one or v number of pages, where a page equals
the number of lines in the Execution Area.
-P [v] Display scrolled backward one or v number of pages.
T+ Display begins with the first line of the active AWS. Can be qualified
with:
v Display begins v number of lines after the first line of the active
AWS.
B- Display contains the last line of the active AWS. Can be qualified with:
v Display begins v number of lines before the last line of the
active AWS.
7 ATTACH INVLIST
8
>
> AWS(XYZ.SAMPLE) SCRL FULL COLS ====7 ===72 LINE ==1
> ...1....+....2....+....3....+....4....+....5....+....6....+..
...... ============================== T O P ========================
=====1 IDENTIFICATION DIVISION.
=====2 PROGRAM-ID. SAMPLE.
=====3 ENVIRONMENT DIVISION.
7 8
ATTACH AWS )
>
> LIB(XYZ.INVREPT) SCRL FULL COLS ====7 ===72
> ...1....+....2....+....3....+....4....+....5....+....6....+..
============================== T O P ========================
===1== IDENTIFICATION DIVISION.
===2== PROGRAM-ID. INVREPT.
===3== ENVIRONMENT DIVISION.
7 >
8
> AWS(XYZ.SAMPLE) SCRL FULL COLS ====7 ===72 LINE ==1
> ...1....+....2....+....3....+....4....+....5....+....6....+..
============================== T O P ========================
=====1 IDENTIFICATION DIVISION.
=====2 PROGRAM-ID. SAMPLE.
=====3 ENVIRONMENT DIVISION.
When you reATTACH the AWS, the display begins with the first line of the prior
display. To reattach at a different location within the same data, you can:
■ Use the AWS operand with the FIRST, NEXT, LAST and PREV commands to
begin the display with the line containing a specific string, as in:
FIRST AWS /DD/
■ Use the AWS operand with the INCL or EXCL command to begin the display
with a list of lines containing (or not containing) a specific string, as in:
INCL AWS /DD/
■ Use the AWS operand of the POINT command to begin the display with a
specific line, as in:
POINT AWS LINE 72==
Note: At most sites, data that you add or change in an AWS is automatically
translated to its corresponding uppercase characters (the word division is
translated to DIVISION). You can control how the data that you change is to
be treated. See Chapter 3, “Controlling Character Recognition” for additional
information.
To limit the operation to specific columns, include the appropriate column numbers
before the string, as in:
FILL 73 79 'INVLIST'
where columns 73 through 79 of every line in the active AWS will contain the string
INVLIST. If column numbers are omitted, the column boundaries currently in effect
are used. Thus, if the current column boundaries are 1 through 80 and you enter:
FILL 'QQQ'
columns 1 through 80 of every line in the active AWS will contain ***. (If the column
range is greater than the string, the string is repeated.)
Note: Column boundaries specified with the command effect only the execution of
the command. See Chapter 4, “Defining Column Boundaries” for additional
information.
To limit the operation to specific lines, specify the appropriate line numbers after the
string, as in:
FILL 73 79 'INVLIST' 1== 12==
Both PREFIX and SUFFIX allow you to limit their operation to a specific range of
lines by including the appropriate line numbers after the string, as in:
SUFFIX 'SAMPLE' 3== 9==
Neither operation is performed if the result would cause a line to exceed 255
characters.
Use the ORDER command to invoke the CA-Roscoe internal sort routine. Reorder
specific records of the AWS in descending order, as in:
ORDER AWS COL 1 7 DES
If more than one AWS is active, specify the name of the AWS to be reordered, as in:
ORDER AWS TMP2 COL 1 7 DES
You can reorder multiple groups of AWS records. Specify the columns to be
reordered, and the sorting order (ASCending or DEScending). If no order is specified,
the data will be sorted in ASCending order. You must use the word 'AND' (or its
character equivalent) to separate the sorting boundaries, as in:
ORDER AWS COL 1 7 DES AND COL 17 24
Note: The word 'AND' can also be represented by the '&' (ampersand) or '@' (the at
sign).
If sites or users set the '&' as a command delimiter, it will override the sort
syntax and function as a delimiter. To use '&' within the ORDER command,
the command delimiter must be set to another character. See 6.5, “Synopsis of
Session Attributes” on page 6-15 for information on changing the command
delimiter.
A maximum of six order criteria are permitted. When sorting multiple column groups,
the sort is done in order of the columns specified. So, in the example above, columns
1 through 7 are reordered, and then columns 17 through 24 are sorted with respect to
the first sort.
where every occurrence of the character A is replaced with the character B. Multiple
characters can be specified as search and replacement characters, as in:
XLATE /A1Q/B9 /
You can limit an operation to specific columns and/or lines. Specify the columns to
be searched before the character(s). Specify the line numbers to be searched after the
character(s), as in:
XLATE 2= 75 /-/ / 1== 92==
where only the data within columns 20 through 75 of lines 100 through 9200 are to be
affected.
Note: Column boundaries specified with the command effect only the execution of
that command. See Chapter 4, “Defining Column Boundaries” for additional
information.
Enter the appropriate command in the sequence number field. Then enter the search
and replacement character(s) in the data portion of the same line. As illustrated in the
following screen, the strings must be delimited.
7 8
>
> AWS(AAA.DATEFILE) SCRL FULL COLS ====7 ===72
> <..1....+....2....+....3....+....4....+....5....
==61== ORDER NO. DATE REQUESTED DATE DELIVERED
XLB2== '/'- '
==63== A12984-XX =9/14/91 12/15/91
==64== A23563-XX =1/=4/92 =2/=1/92
==65== A45887-XX =6/2=/92 =9/19/92
7 8
>
> AWS(AAA.DATEFILE) SCRL FULL COLS ====7 ===72
> <..1....+....2....+....3....+....4....+....5....
==61== ORDER NO. DATE REQUESTED DATE DELIVERED
==62==
==63== A12984-XX =9-14-91 12-15-91
==64== A23563-XX =1-=4-92 =2-=1-92
==65== A45887-XX =6-2=-92 =9-19-92
Once search and replacement characters are specified, they are remembered until you
change them. This allows you to selectively change specific occurrences of a
character.
The character strings must be delimited by a special character not found within either
of the strings.
You can limit an edit operation to specific columns and/or lines. Specify the columns
to be searched before the character strings. Specify the line numbers to be searched
after the strings. For example:
EDIT 2= 75 /INVENTORY-BALANCE/INVENTORY-AMOUNT/ 1== 92==
causes the command to affect only the data within columns 20 through 75 of lines 100
through 9200.
Note: Column boundaries specified with the command affect only the execution of
that command. See Chapter 4, “Defining Column Boundaries” for additional
information.
By default, the search is for any string of characters that match the edit string. To
avoid possible confusion, you can qualify the string with the keyword WORD,
BEGIN, PREFIX, EMBED, SUFFIX, or END. (See Chapter 20, “AWS: Locating
Data Within an AWS” for additional information about these qualifiers.) For example,
if you enter:
EDIT /THE/AN/ WORD
the search is for every occurrence of THE that is preceded and followed by a
non-alphanumeric character. If you omitted the qualifier, words such as OTHER and
THERE would match the search string and would be changed.
In addition to replacing a character string, you can also use EDIT to:
■ Delete a character string from one or more lines.
By defining a null replacement string, every occurrence of the search string will
be deleted. For example, to delete every occurrence of the string
INVENTORY-BALANCE from the active AWS, you would specify:
EDIT /INVENTORY-BALANCE//
Lines containing the string are not deleted; only the string is deleted from those
lines.
■ Replace the entire contents of one or more lines.
Defining a null search string, the contents of every line will be overlaid with the
replacement string. For example, to replace the current contents of lines 1800
through 2000 with the string FILLER, you would enter:
Enter the appropriate command in the sequence number field. Then enter the search
and replacement character strings in the data portion of the same line. The strings
must be delimited.
7 8
>
> AWS(AAA.DATEFILE) SCRL FULL COLS ====7 ===72
> <..1....+....2....+....3....+....4....+....5....+6....+....
...... ============================= T O P =======================
EB 1== /PART-NUMBER-MSTR/PART-NUMBER-OUT/_
===2== PROGRAM-ID. INVLIST.
===3== ENVIRONMENT DIVISION.
Once edit strings are specified, they are remembered until you change them by
entering another edit line command. This allows you to selectively change specific
occurrences of a string. For example, assume you only want to change certain
occurrences of the string THIS to THAT. Once you have specified the string, you can
scroll through the active AWS, entering the appropriate edit line command where
needed.
Using the primary command to illustrate, you can activate the tracking facility by
entering:
SET EDITCHNG ON
When the facility is active, any subsequent EDIT primary command or E, EB, or ET
line command causes a change indicator to appear in the sequence number field of
affected lines. The indicator remains in the sequence number field until you:
■ Replace the contents of the active AWS,
■ Issue the RESET line command or SET EDITCHNG RESET command, or
■ Enter the SET EDITCHNG OFF command, or deactivate the facility via the
STATUS SESSION display.
The following examples illustrate how you might use this facility. Notice that the
search string is qualified as a prefix; thus line 6700 is not affected.
7 SET EDITCHNG ON 8
EDIT /IN-/INPUT-/ PREFIX
>
> AWS(AAA.DATEFILE) SCRL FULL COLS ====7 ===72
> <..1....+....2....+....3....+....4....+....5....+6....+....
==61== WORKING-STORAGE SECTION.
==62== =1 HOLDING-AREA.
==63== =2 IN-NAME PIC X(6) 'ROSCOE'.
==64== =2 IN-ADDR PIC X(9) 'PRINCETON'.
==65== =2 IN-STATE PIC X(2) VALUE 'NJ'.
==66== =1 WORK-AREA.
==67== =2 DATE-IN-PROCESS PIC X(8) 'XX/XX/XX'.
7 8
>
> AWS(AAA.DATEFILE) SCRL FULL COLS ====7 ===72
> <..1....+....2....+....3....+....4....+....5....+6....+....7...
==61== WORKING-STORAGE SECTION.
==62== =1 HOLDING-AREA.
==CHG> =2 INPUT-NAME PIC X(6) 'ROSCOE'.
==CHG> =2 INPUT-ADDR PIC X(9) 'PRINCETON'.
==CHG> =2 INPUT-STATE PIC X(2) VALUE 'NJ'.
==66== =1 WORK-AREA.
==67== =2 DATE-IN-PROCESS PIC X(8) 'XX/XX/XX'.
The change indicators placed in the sequence number field are modifiable. This means
you can overtype any indicator with a line command. After the command is executed,
the indicator is redisplayed.
If you want to track another edit operation, you can remove the change indicators by
issuing the RESET line command or:
SET EDITCHNG RESET
To deactivate the facility, either modify the STATUS SESSION display, or issue the
command:
SET EDITCHNG OFF
When the facility is deactivated, the change indicators remain displayed. To remove
these indicators, either:
■ Deactivate the facility by issuing:
SET EDITCHNG OFF RESET or
■ Issue the RESET line command after the facility is deactivated.
If you want to see a non-modifiable display of lines affected by the execution of the
EDIT primary command, specify the TRACE command prior to EDIT, as in:
TRACE
EDIT 'FILLER'FILLER'
NOTRACE
TRACE causes all affected lines to be displayed. While this facility is active, each
time you execute the EDIT command, a list of affected lines is displayed. The
NOTRACE command deactivates this facility.
Chapter 15. AWS: Copying Data Within and Into an AWS 15-1
15.1 Copying Data Within the Active AWS
Enter the COPY command followed by the number of the line to be copied and the
destination line number, as in:
COPY 295= 36==
In this example, the contents of line 2950 is to be copied at or after line 3600. (If the
destination line number exists, the data are inserted after it. If the line number does
not exist, the data are placed at that line number.)
Enter the COPY command with the number of the first and last line to be copied plus
the destination. For example, to copy lines 2500 through 2700 to the top of the active
AWS, you would enter:
COPY 25== 27== T
Use the Nv operand to duplicate lines, where v is the number of times the data are to
be repeated. For example, to copy lines 700 through 900 at, or after, line 2500 and
have those lines repeated three times, you would enter:
COPY 7== 9== 25== N3
As with the primary commands, you must indicate the line(s) to be copied and the
destination of that operation. (The destination line commands are shown in the
following table.)
■ To copy a single line:
Type C in the sequence number field of the line to be copied. (Also include a
destination line command in the sequence number field of the appropriate line.)
Chapter 15. AWS: Copying Data Within and Into an AWS 15-3
15.1 Copying Data Within the Active AWS
Chapter 15. AWS: Copying Data Within and Into an AWS 15-5
15.1 Copying Data Within the Active AWS
The following example illustrates how you can use overlay destination line commands.
Only the blank characters in the target lines are overlaid with corresponding data from
the source lines.
7 >
8
> AWS(PRI.INVLIST) SCRL FULL COLS ====7 ===72
> ...1....+....2....+....3....+....4....+....5....+
C =8== SAMPLE PIC X( ).
O2 9== PART-DESCRIPTION-IN
==1=== INVENTORY-BALANCE-IN
7 >
8
> AWS(PRI.INVLIST) SCRL FULL COLS ====7 ===72
> ...1....+....2....+....3....+....4....+....5....+
===8== SAMPLE PIC X( ).
===9== PART-DESCRIPTION-IN PIC X( ).
==1=== INVENTORY-BALANCE-IN PIC X( ).
The number of lines to be overlaid must be equal to or greater than the number of
lines being copied. For example, the upper screen in the previous example shows that
one line is to be copied (800) and that two lines are to be overlaid with that data (900
and 1000). The lower screen shows the result, where PIC X( ) has overlaid the
corresponding blank positions in the designated lines. (SAMPLE has been ignored
since its corresponding positions contain data.)
To copy one line immediately after itself, enter the R line command in the appropriate
sequence number field. To repeat one line multiple times, use Rv where v is the
number of times the line is to be repeated. To repeat a block of lines, enter the RR
line command in the sequence number field of the first and last line to be repeated.
The following example illustrates the result of entering R4 on line 3200. (Notice that
the sequence numbers of the repeated lines are incremented by 1, so as to have
minimal impact on preexisting sequence numbers.)
7 >
8
> AWS(PRI.INVLIST) SCRL FULL COLS ====7 ===72
> ...1....+....2....+....3....+....4....+....5....+
==3=== PART-DESCRIPTION-IN PIC X(26).
==31== INVENTORY-BALANCE-IN PIC S9(5).
R4 2== FILLER PIC X(3=).
==33== FD INVENTORY-REPORT
7 >
8
> AWS(PRI.INVLIST) SCRL FULL COLS ====7 ===72
> ...1....+....2....+....3....+....4....+....5....+
==3=== PART-DESCRIPTION-IN PIC X(26).
==31== INVENTORY-BALANCE-IN PIC S9(5).
==32== FILLER PIC X(3=).
==32=1 FILLER PIC X(3=).
==32=2 FILLER PIC X(3=).
==32=3 FILLER PIC X(3=).
==32=4 FILLER PIC X(3=).
==33== FD INVENTORY-REPORT
Chapter 15. AWS: Copying Data Within and Into an AWS 15-7
15.2 Copying Data to an AWS
──┬─COPY──┬──source ...──AWS-destination──┬─────────┬─────────
├─COPYS─┤ └─TP name─┘
└─COPYX─┘
The destination of the copy operation within the active AWS or designated AWS must
be specified as:
v Number of the line at, or after, which the data are to be inserted in the
AWS.
* After the line at which the AWS pointer is currently positioned.
T Before the first line of the AWS.
B or ,, After the last line of the AWS.
R Replace the contents of the AWS.
By default, the commands COPY, COPYS and COPYX bring data into the active
AWS. You can designate a different existing AWS by using the TO name operand.
Thus,
COPY DSN T
copies the currently attached data set object to the currently active AWS, while:
COPY AWS SAMPLE1 B TO SAMPLE2
copies the entire contents of the AWS named SAMPLE1 to the bottom of the AWS
named SAMPLE2.
:C
in any unprotected field and pressing PF12. (The cursor must immediately follow the
command :C.)
If the CA defaults are not in effect, the STATUS SYSTEM display identifies the:
■ Escape character: The field RCSESCCH identifies the character to use. The
default is a colon (:).
■ PF key: The field RCSESCPF identifies the PF key to use. The default is PF12.
The screen is copied to the AWS identified by the SET COPYDEST command.
Note: An AWS destination must be in effect for this type of copy operation to work
successfully.
Chapter 15. AWS: Copying Data Within and Into an AWS 15-9
15.2 Copying Data to an AWS
Both COPYS and COPYX allow you to specify a range of lines to be searched for a
string. To do this, include the appropriate line numbers after the string. For example,
to copy every line between 1 and 300 that contain the string NAME from the library
member UPLIST into the active AWS at, or immediately after, line 1200, you would
enter:
COPYS UPLIST /NAME/ 1 3== 12==
By default, the entire line of the source data are searched for the specified string.
You can limit the search operation to a specific range of columns. To limit the search
operation when copying from:
■ A library member, attached data set object or attached job output file:
– Use the SET BOUNDS primary command or BOUNDS line command to
change the column boundaries associated with the source data. (See
Chapter 4, “Defining Column Boundaries” for additional information.
– Specify a column range with the command, using the values shown on the
Scale Line. For example, to copy every line containing the string FILLER
within columns 10 through 50 of the attached job output file to the bottom of
the active AWS, you would enter:
COPYS JOB 1= 5= /FILLER/ B
■ The displayed screen or a Selection List:
Assume that the left-most displayed position is column one and include the
appropriate numbers, as in:
COPYX SCR 1 3= /QQQ/ R
where every line from the current screen not containing *** in the first thirty
positions of the line is copied to the active AWS and replaces its contents.
Chapter 15. AWS: Copying Data Within and Into an AWS 15-11
15.3 Copying Data Between Screens
──┬─XCOPY──┬──┬────────────┬──AWS-destination─────────────────
├─XCOPYS─┤ └─source ...─┘
└─XCOPYX─┘
The source operands allow you to designate the data that is to be copied. The operands
are:
DSN From the data set object attached in the other screen. (Also see
Chapter 27, “Data Sets: Performing Data Management Tasks” for
information about other ways you can copy a data set object into the
active AWS.)
JOB From the job output file attached in the other screen.
LIB From the library member or Selection List attached in the other screen.
(See Chapter 34, “Library: Performing Library Management Tasks” for
information about other ways you can copy library data into the active
AWS.)
mem Name of the library member to be copied.
The destination of the copy operation within the active AWS can be specified as:
v Number of the line at, or after, which the data are to be inserted in the
active AWS.
* After the line at which the AWS pointer is currently positioned.
T Before the first line of the active AWS.
B or ,, After the last line of the active AWS.
R Replace the contents of the active AWS.
Chapter 15. AWS: Copying Data Within and Into an AWS 15-13
15.3 Copying Data Between Screens
■ To copy every line between 1 and 300 that contains the string NAME from the
data set object attached in the other split screen to, or immediately after, line 1200
of the active AWS in the screen containing the command:
XCOPYS DSN /NAME/ 1 3== 12==
By default, the entire line in the source data are searched for the specified string.
where only columns 10 through 50 of lines 1200 through 2500 of the attached job are
searched for the string FILLER. All matching lines are copied to the active AWS,
replacing its prior contents.
This chapter describes how you can delete data from the active AWS using:
■ The DELETE primary command to delete one or more lines.
■ The DELETES and DELETEX primary commands to delete lines containing (or
not containing) a specific string.
■ The delete line commands.
■ 3270 hardware facilities (for example, ERASE EOF and DELETE keys).
By default, every line in the AWS is searched for the specified string. With both
DELETES and DELETEX, you can limit the number of lines searched. For example,
to delete all lines from the active AWS containing the string XYZ within lines 1
through 400, enter the line numbers after the string:
DELETES 'XYZ' 1 4==
Also by default, the area within the current (or default) column boundaries is searched
for the string. To limit the columns involved, enter the number of the starting and
ending columns searched. For example, to delete only those lines that do not contain
INVENTORY-BALANCE in columns 1 through 50 of the active AWS, enter the
column numbers before the string:
DELETEX 1 5= 'INVENTORY-BALANCE'
You can combine the operands to limit the search to a specific column range within
specific lines, as in:
DELETEX AWS SAMPLE 1 5== 'NEW RECORD' 1== 12==
where every line within the AWS named SAMPLE not containing NEW RECORD in
columns 1 through 500 of lines 100 through 1200 is deleted.
LINE MEANING
COMMAND
DS [v] [/string/] Deletes line (or lines within v number of lines) containing
string.
DSB [/string/] Deletes all lines containing string from this line to end of
active AWS.
DST [/string/] Deletes all lines containing string from first line through
this line.
DU [/string/] Deletes all lines from this line until first line containing
string.
DX [v] [/string/] Deletes line (or lines within v number of lines) not
containing string.
DXB [/string/] Deletes all lines not containing string from this line to end
of active AWS.
DXT [/string/] Deletes all lines not containing string from first line
through this line.
To display information about the active AWS plus all of the AWSs that are currently
in use, enter the command:
STATUS AWS
The following example illustrates the type of information displayed. Note that if the
bottom marker (== END OF LIST ==) is not displayed, the number of AWSs exceeds
the screen size. Use PF keys to scroll the display.
7 >
8
> AWS() SCRL FULL COLS ====1 ===79 A<ROS1>+
>....+....1....+....2....+....3....+....4....+....5....+....6....+....7....
ROSCOE AWS STATUS TOTAL SESSION\SPLIT RECOVERABLE
MAX: 6 CURR: 2 MAX: 2 CURR: 2 M
NAME STATUS ROS MEMBER CHG LINES INCR LAST CURRENT ACT
ASSOCIATED DATASET NAME VOLUME UNIT
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ROS1 (NONE) CHG 24 1== 24== 24==
(NONE)
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
MYAWS ABC.MYMEM 1137 1== 1137 1
TEST.SOURCE(MYSOURCE) MUROS1 338=
======================= END OF LIST =======================
U V
When appropriate, the second shaded area (the STATUS field) will indicate the result
of the operation after it is performed.
The amount of available information exceeds the width of 80-character screens. The
information is, therefore, divided into alternate displays. You can change the display to
view different information by entering:
SELECT ALT [v]
where v is the number of the display to be viewed next. If you omit the number, you
will proceed sequentially through the different displays. (The ALT field in the
following figures contains the number of the alternate display in which each field
appears.) The first two lines in the Execution Area remain constant as you scroll the
display, and contain the fields:
TOTAL Made up of two fields of information:
1. CURRENT: Number of AWSs currently in effect for the
user session.
2. MAX: Number of AWSs that can be created for the user
session.
SESSION\SPLIT Made up of two fields of information:
1. CURRENT: Number of AWSs with the SESSION or
SPLIT attributes that are active for the user session.
2. MAX: Number of AWSs that can be created with the
SESSION or SPLIT attributes.
RECOVERABLE Made up of two fields of information:
1. CURRENT: Number of recoverable AWSs in effect.
2. MAX: Number of recoverable AWSs that can be created.
Note: See 13.5, “Creating an AWS” on page 13-6 for more information.
This chapter describes the different facilities that you can use to enter data into the
active AWS. It also describes how you can manually or automatically format the data
while entering it.
Note: At most sites, data that you enter into the active AWS is automatically
translated to its corresponding uppercase characters (for example, if you enter
division, it is translated to DIVISION). You can control how the data that you
enter is to be recognized and treated. See Chapter 3, “Controlling Character
Recognition” for additional information.
As illustrated in the following example, the screen is opened to accept input, the
current (or default) increment is used for line number sequencing and the cursor is
placed at the to first line of the Execution Area, ready for data entry.
7 >
8
> AWS() SCRL FULL COLS ====7 ===72
> ...1....+....2....+....3....+....4....+....5....+....
...... ============================= T O P =================
===1== _
===2==
===3==
===4==
===5==
===6==
===7==
===8==
===9==
==1===
==11==
==12==
==13==
==14==
==15==
========================== B O T T O M ==============
U V
If you fill all lines in the Execution Area and still have more data to enter, press the
ENTER key. The data you have entered is recorded in the active AWS and a new
screen is displayed. The first line in the Execution Area of the new screen will contain
the last line of data that you entered.
Either of these actions causes the screen to close. Any data that had not been recorded
in the active AWS is now recorded, all unused lines are deleted from the Execution
Area, and the beginning and end of the data in that AWS is noted with TOP and
BOTTOM markers.
7 >
8
> AWS() SCRL FULL COLS ====7 ===72
> ...1....+....2....+....3....+....4....+....5....+....
==38== =5 CARRIAGE-CONTROL PIC X.
==38=1 _
==38=2
==38=3
==38=4
...... =5 FILLER PIC X(3=).
The current line number increment is used for sequence numbering. If the next
generated sequence number will exceed 999999, CA-Roscoe stops accepting input.
While this condition rarely occurs, issuing the RENUMBER command with a lower
starting sequence number and increment value usually resolves the problem.
In all cases, the cursor is automatically positioned to the first line in the Execution
Area, ready for data entry.
If you fill the Execution Area, press the ENTER key to continue entering data. The
entered data are recorded in the active AWS and a new screen is displayed. The first
line in the Execution Area of the new screen contains the last line of data that you
entered. (If the data you inserted generates sequence numbers that overflow into
existing AWS sequence numbers, the contents is renumbered by 1 until the overflow
condition is rectified.)
To terminate data entry, you can: 1) press the ENTER key, or 2) move the cursor to
the Command Area and enter a command.
Either of these actions causes the screen to close. All unused lines are deleted from
the Execution Area, any data that has not been recorded in the active AWS is then
recorded, and the beginning and end of the data in this AWS is noted with TOP and
BOTTOM markers.
When you use the TEXTENTR operand of the INPUT command, the format of the
Execution Area is different than when this operand is not used.
7 >
8
> AWS() SCRL FULL COLS ====7 ===72
> ...<....+....2....+....3....+....4....+....>....+
===1== THIS IS A SAMPLE.
_
7 >
8
> AWS() SCRL FULL COLS ====7 ===72
> ...<....+....2....+....3....+....4....+....>....+
===1== THIS IS A SAMPLE.
This sample shows how you can enter data in a wra
p mode and have it formatted for you when you dep
7 >
8
> AWS() SCRL FULL COLS ====7 ===72
> ...<....+....2....+....3....+....4....+....>....+
...... ========================== T O P ================
===1== THIS IS A SAMPLE.
===2== This sample shows how you can enter data
===2=1 in a wrap mode and have it formatted for
You can use the I and IB line commands to insert one or more empty lines in the
active AWS. Use:
I To insert one or more lines after the line containing the command.
IB To insert one or more lines before the line containing the command.
To insert multiple lines, enter Iv or IBv in the appropriate sequence number field,
where v is the number of lines to be inserted. You can request any number of blank
lines to be inserted. If you request more than can be displayed, the resulting screen
contains the maximum number of displayable lines.
The following example illustrates how you would insert one line after line 1900 and
three lines before line 2300.
7 >
8
> AWS(PRI.INVLIST) SCRL FULL COLS ====7 ===72
> ...1....+....2....+....3....+....4....+....5....+
I=19== =5 FILLER PIC X(7).
==2=== =5 PART-DESCRIPTION-IN PIC X(26).
==21== =5 INVENTORY-BALANCE-IN PIC S9(5).
==22== =5 FILLER PIC X(3=).
IB33== PROCEDURE DIVISION.
7 >
8
> AWS(PRI.INVLIST) SCRL FULL COLS ====7 ===72
> ...1....+....2....+....3....+....4....+....5....+
==19== =5 FILLER PIC X(7).
...... _
==2=== =5 PART-DESCRIPTION-IN PIC X(26).
==21== =5 INVENTORY-BALANCE-IN PIC S9(5).
==22== =5 FILLER PIC X(3=).
......
......
......
==23== PROCEDURE DIVISION
When you press the ENTER key after entering your data, the Execution Area is
examined. If there are any unused lines, they are removed. Lines containing data are
retained and assigned line numbers incremented by one.
You can use the SET AUTOINSERT command to activate an automatic line insertion
facility. When this facility is active, one or more data entry lines are inserted after you
have used all of the lines provided by an I or IB line command. (If the facility is not
active, the insert operation terminates.) The following examples show how to activate
the facility with a default line insertion value of 1. Once activated, new lines are
provided as long as you continue to enter data.
7 >
8
> AWS(PRI.INVLIST) SCRL FULL COLS ====7 ===72
> ...1....+....2....+....3....+....4....+....5....+
==19== =5 FILLER PIC X(7).
...... _
==2=== =5 PART-DESCRIPTION-IN PIC X(26).
7 >
8
> AWS(PRI.INVLIST) SCRL FULL COLS ====7 ===72
> ...1....+....2....+....3....+....4....+....5....+
==19== =5 FILLER PIC X(7).
==19=1 =5 filler pic X(1=)._
==2=== =5 PART-DESCRIPTION-IN PIC X(26).
7 >
8
> AWS(PRI.INVLIST) SCRL FULL COLS ====7 ===72
> ...1....+....2....+....3....+....4....+....5....+
==19== =5 FILLER PIC X(7).
==19=1 =5 FILLER PIC X(1=).
...... _
As with the TEXTENTR operand of the INPUT command, the TE line command
causes:
■ The sequence number field to be protected and invisible and the right margin to
be ignored. This allows you to enter data in a wrap mode. This means that if you
reach the right margin while entering data, the cursor automatically skips over the
invisible sequence number field, allowing continuous data entry.
■ The current column boundaries are recognized when the data are formatted after
you press the ENTER key.
7 >
8
> AWS() SCRL FULL COLS ====7 ===72
> ...<....+....2....+....3....+....4....+....>....+
...... ========================== T O P ================
TE=1== THIS IS A SAMPLE.
...... ======================= B O T T O M =============
7 >
8
> AWS() SCRL FULL COLS ====7 ===72
> ...<....+....2....+....3....+....4....+....>....+
...... ========================== T O P ================
===1== THIS IS A SAMPLE.
_
7 >
8
> AWS() SCRL FULL COLS ====7 ===72
> ...<....+....2....+....3....+....4....+....>....+
...... ========================== T O P ================
===1== THIS IS A SAMPLE.
This sample shows how you can enter data in a wra
p mode and have it formatted for you when you dep
To define a mask,
■ Enter the command MASK in the sequence number field of any line in the active
AWS.
■ Then, enter the mask in the data portion of the same line. The mask must be the
only data on the line. Ensure that this is the case by overlaying any other data
on the line with spaces, or by using the DELETE or ERASE EOF keys to delete
the remaining data.
■ Finally, press the ENTER key to establish the mask.
After the MASK command has been executed, the original contents of the line are
redisplayed.
Once the mask is defined, it remains in effect until you: 1) replace it with a new
mask definition, or 2) eliminate it.
To eliminate a mask, enter the command MASK in the sequence number field of any
line in the active AWS and press the ENTER key.
You can insert your data mask in the active AWS by using the:
■ IM (Insert Mask) line command.
To insert one copy of the mask, position the cursor to the sequence number field
of the line after which you want the line inserted. Type IM in the sequence
number field and press the ENTER key. A new line containing the mask is
inserted immediately after the line that contained the IM command.
To insert multiple copies of the mask, include the appropriate numeric value with
the command, as illustrated in the following figure.
The first screen in the following examples shows the mask being defined on line
3200. (Notice that only the mask appears on that line. The original contents are
restored when the command is executed.) The second screen shows how multiple
copies of the mask can be inserted. The third screen shows the resulting display.
7 >
8
> AWS(PRI.INVLIST) SCRL FULL COLS ====7 ===72
> ...1....+....2....+....3....+....4....+....5....+
==3=== =5 PART-DESCRIPTION-IN PIC X(26).
==31== =5 INVENTORY-BALANCE-IN PIC S9(5).
MASK!! !5 FILLER PIC X(3!).
==33== =1 INVENTORY-REPORT.
7 >
8
> AWS(PRI.INVLIST) SCRL FULL COLS ====7 ===72
> ...1....+....2....+....3....+....4....+....5....+
IM2=== =5 PART-DESCRIPTION-IN PIC X(26).
==31== =5 INVENTORY-BALANCE-IN PIC S9(5).
==32== =5 PART-NUMBER-OUT PIC X(6).
==33== =1 INVENTORY-REPORT.
7 >
8
> AWS(PRI.INVLIST) SCRL FULL COLS ====7 ===72
> ...1....+....2....+....3....+....4....+....5....+
==3=== =5 PART-DESCRIPTION-IN PIC X(26).
==3==1 =5 FILLER PIC X(3=).
==3==2 =5 FILLER PIX X(3=).
==31== =5 INVENTORY-BALANCE-IN PIC S9(5).
You can also use the OMT and OMB commands to overlay multiple lines. OMT
overlays all of the lines from the first line of the active AWS through the line
containing the command. OMB overlays all of the lines from the line containing the
command through the end of this AWS.
The following example illustrates how you can overlay lines with a mask. (It is
assumed the mask defined in the previous figure is still in effect.)
7 >
8
> AWS(PRI.INVLIST) SCRL FULL COLS ====7 ===72
> ...1....+....2....+....3....+....4....+....5....+
==33== =1 INVENTORY-REPORT.
OM3 == =5 FILLER
==35== =5 OUT-MONTH
==36==
7 >
8
> AWS(PRI.INVLIST) SCRL FULL COLS ====7 ===72
> ...1....+....2....+....3....+....4....+....5....+
==33== =1 INVENTORY-REPORT.
==34== =5 FILLER PIC X(3=).
==35== =5 OUT-MONTH PIC X(3=).
==36== =5 FILLER PIC X(3=).
The screen is opened for data entry immediately after the line at which the cursor was
positioned. Note that the column position of the cursor has no affect on this operation.
To insert data at the top or bottom of the active AWS, position the cursor before the
first line, or after the last line, of that AWS and again press the appropriate PF key.
If the number you specify already exists within the active AWS, your line replaces the
existing line. If it does not, your line is added to the active AWS. Using the following
examples to illustrate, when the ENTER key is pressed, the previous contents of line
3100 are replaced with the information appearing in the Command Area, while line
3101 is added to this AWS.
7 >
8
> AWS(PRI.INVLIST) SCRL FULL COLS ====7 ===72
> ...1....+....2....+....3....+....4....+....5....+
==3=== =5 PART-DESCRIPTION-IN PIC X(26).
==31== =5 PART-NUMBER PIC X(9).
==31=1 =5 PART-TOTAL-IN PIC X(3).
==32== =5 FILLER PIC X(3=).
All of the lines comprising the Command Area can be used to enter data in this
manner. You can also use the command delimiter to enter more than one line of data
per Command Area line.
When this facility is active, the cursor is automatically positioned under the first data
character when you insert data using the INPUT primary command, I or IB line
command or a PF key to which the INPUT function is assigned.
The following example illustrates how the cursor is positioned when you use the I line
command.
7 >
8
> AWS(PRI.INVLIST) SCRL FULL COLS ====1 ===8=
> <...+....1....+....2....+....3....+....4....+...
...... ============================= T O P ============
I==1== IDENTIFICATION DIVISION.
===2== ENVIRONMENT DIVISION.
===3== CONFIGURATION SECTION.
7 >
8
> AWS(PRI.INVLIST) SCRL FULL COLS ====1 ===8=
> <...+....1....+....2....+....3....+....4....+...
...... ============================= T O P ============
===1== IDENTIFICATION DIVISION.
...... _
===2== ENVIRONMENT DIVISION.
===3== CONFIGURATION SECTION.
To define tab positions, use the TAB command. You can define a maximum of eight
different tab positions. For example:
TAB 12 16 2= 32
The default tab character (the special character you include with your data) is the
logical not sign (¬). To change this character, use the TAB command again. For
example, to establish the percent sign (%) as the tab character, you would enter:
TAB %
As illustrated in the following example, the tab character and tab positions must be
defined in separate executions of the TAB command. When tab positions are in effect,
the tab character is used to indicate those positions on the Scale Line.
7 TAB %
8
TAB 12 16 2! 32
>
> AWS(PRI.INVLIST) SCRL FULL COLS ====1 ===8=
> <...+....1....+....2....+....3....+....4....+...
...... ============================= T O P ============
===1== IDENTIFICATION DIVISION.
7 >
8
> AWS(PRI.INVLIST) SCRL FULL COLS ====1 ===8=
> <...+....1.%..+%...%....+....3.%:
...... ============================= T O P ============
!!!1!! IDENTIFICATION DIVISION.
When the tab character and tab positions are set, you can format your data by
including the tab character with your data. You can do this when you are:
■ Initially entering data in the active AWS, or
■ Formatting data that is already in the active AWS.
To shift the contents of a line to the appropriate location, enter one or more tab
characters. As illustrated in the following example, entering one tab positions the data
following it to the next defined tab position (for example, entering a single tab
character at the beginning of line 3800 shifts the line to begin in column 12). To skip
one or more tab positions (as illustrated in line 3400), enter contiguous tab characters
(that is, not separated by spaces).
7 >
8
> AWS(PRI.INVLIST) SCRL FULL COLS ====7 ===72
> ...1.%..+%...2....+....3....+....%....+....5....+..
==33== FD INVENTORY-REPORT
==34== %%RECORD CONTAINS 133 CHARACTERS
==35== %%LABEL RECORDS ARE OMITTED
==36== %%DATA RECORD IS INVENTORY-REPORT-LINE.
==37== =1 INVENTORY-REPORT-LINE.
==38== %=5 CARRIAGE-CONTROL%PIC X.
==39== %=5 FILLER%PIC X(9).
==4=== %=5 PART-NUMBER-OUT%PIC X(1=).
7 >
8
> AWS(PRI.INVLIST) SCRL FULL COLS ====7 ===72
> ...1.%..+%...2....+....3....+....%....+....5....+..
==33== FD INVENTORY-REPORT
==34== RECORD CONTAINS 133 CHARACTERS
==35== LABEL RECORDS ARE OMITTED
==36== DATA RECORD IS INVENTORY-REPORT-LINE.
==37== =1 INVENTORY-REPORT-LINE.
==38== =5 CARRIAGE-CONTROL PIC X.
==39== =5 FILLER PIC X(9).
==4=== =5 PART-NUMBER-OUT PIC X(1=).
Note: The tab character will be treated as a data character if either of the following
conditions occur:
■ The data includes the tab character but no tab positions have been defined.
■ The data includes more tab characters than the number of defined tab positions
(for example, four tab positions are defined and the data includes five tab
characters.)
The commands described in this chapter can be used to format data or text that is in
the active AWS. These commands allow you to:
■ Center text lines.
■ Control the capitalization of alphabetic characters within the data.
■ Reformat text lines.
■ Shift one or more lines to the left or right.
■ Split and join text lines.
Note that the software tab facility (described in Chapter 18, “AWS: Entering and
Formatting Data in an AWS”) can also be used to position data within the active
AWS.
You can override the default or current column boundaries by including the BOUNDS
operand with the command. The following example shows how you can center the text
on multiple lines between columns 9 and 45.
7> 8
> AWS(AAA.SHIPRATE) SCRL FULL COLS ====7 ===72
> ..<1....+....2....+....3....+....4....+....5....+
...... ============================= T O P =============
===1== Q------------------------------------------------
===2== Q THIS PROGRAM PRINTS AN ESTIMATED
===3== Q SHIPPING COST REPORT. RATES
===4== Q DEPEND ON WEIGHT OF ORDER AND
===5== Q DISTRICT TO WHICH ORDER SHIPPED.
===6== Q------------------------------------------------
The text is centered between the default or current column boundaries. To change the
column boundaries, use the SET BOUNDS primary command or the BOUNDS in line
command.
In the following example, the BOUNDS line command is used to change the column
boundaries. The TCC line commands then center the text in the designated block of
lines between the boundaries.
7 >
8
> AWS(AAA.SHIPRATE) SCRL FULL COLS ====7 ===72
> ...1....+....2....+....3....+....4....+....5....+
...... ============================= T O P =============
BOUNDS Q-<----------------------------------->----------
TCC2== Q THIS PROGRAM PRINTS AN ESTIMATED
===3== Q SHIPPING COST REPORT. RATES
===4== Q DEPEND ON WEIGHT OF ORDER AND
TCC5== Q DISTRICT TO WHICH ORDER SHIPPED.
===6== Q------------------------------------------------
7 >
8
> AWS(AAA.SHIPRATE) SCRL FULL COLS ====7 ===72
> ..<1....+....2....+....3....+....4....>....5....+
...... ============================= T O P =============
===1== Q------------------------------------------------
===2== Q THIS PROGRAM PRINTS AN ESTIMATED
===3== Q SHIPPING COST REPORT. RATES
===4== Q DEPEND ON WEIGHT OF ORDER AND
===5== Q DISTRICT TO WHICH ORDER SHIPPED.
===6== Q------------------------------------------------
===7== IDENTIFICATION DIVISION.
There may be occasions when you want to retranslate one or more lines within the
active AWS. While you can do this by changing the current translation mode setting
and then modifying the appropriate lines, you can also use the primary and line
commands shown in the following table.
None of these commands, however, are text sensitive. When dealing with lines
containing text, you should use the TXTLCASE primary command or TLC line
command to control capitalization.
For example, to lowercase the characters within the current or default column
boundaries of line 100 through 500, you would enter:
TXTLCASE 1== 5==
You can use the optional BOUNDS operand to override the default or current column
boundaries. For example, to lowercase the characters between columns 9 and 45 of
lines 700 through 1200, you would enter:
TXTLCASE 7== 12== BOUNDS 9 45
To use this command, enter TLC in the sequence number field of the appropriate line.
When the ENTER key is pressed, all of the characters on the line containing the
command through the end of the current paragraph are translated to their
corresponding lowercase characters. The end of a paragraph is indicated by:
■ A blank line,
■ A change in indentation, or
■ The end of the active AWS.
Note that only the characters found within the default or current column boundaries are
translated. To change the column boundaries, you can use the SET BOUNDS primary
command or the BOUNDS line command.
The resulting display will show the reformatting text comprising those lines. Each
reformatted line will:
■ Begin at the default or current left column boundary. (In these examples, that is
column 9.)
EXCEPTION:
If the text within the designated lines begins inside the left column boundary,
the reformatted lines will begin at the column which contained the left-most
character comprising those lines. For example, if the left column boundary is
set to 9 and all of the text lines begin in column 15, the reformatted lines will
begin in column 15.
■ End at the default or current right column boundary or right display margin,
whichever is less. For example, assume that the terminal screen displays a line 72
characters in length. If the right column boundary is set at:
– Column 50 - The reformatted text will stop at column 50.
– Column 80 - The reformatted text will stop at column 72.
You can override the right column boundary for the execution of a command by
specifying the COLS operand. In the following example, lines 2 through 7 will be
reformatted and the reformatted lines will not extend beyond column 30.
7 TXTFLOW 2 7 COLS 3=
8
>
> AWS(AAA.SHIPRATE) SCRL FULL COLS ====7 ===72
> ..<1....+....2....+....3....+....4....+....5....+
...... ============================= T O P =============
=====1 Q------------------------------------------------
=====2 Q THIS PROGRAM PRINTS AN ESTIMATED
=====3 Q SHIPPING COST REPORT. SHIPPING RATES
=====5 Q DEPEND ON WEIGHT OR ORDER AND
=====7 Q DISTRICT TO WHICH ORDER SHIPPED
=====9 Q------------------------------------------------
7 >
8
> AWS(AAA.SHIPRATE) SCRL FULL COLS ====7 ===72
> ..<1....+....2....+....3....+....4....+....5....+
...... ============================= T O P =============
=====1 Q------------------------------------------------
=====2 Q THIS PROGRAM PRINTS AN
=====3 Q ESTIMATED SHIPPING
=====4 Q COST REPORT. SHIPPING
=====5 Q RATES DEPEND ON WEIGHT
=====6 OF ORDER AND DISTRICT
=====7 TO WHICH ORDER
=====8 SHIPPED.
=====9 Q------------------------------------------------
====1= IDENTIFICATION DIVISION.
7 >
8
> AWS(AAA.SHIPRATE) SCRL FULL COLS ====7 ===72
> ..<1....+....2....+....3....+....4....+....5....>
...... ============================= T O P =============
TF=1== Q THIS PROGRAM PRINTS AN ESTIMATED
===2== Q SHIPPING COST REPORT. SHIPPING RATES
===3== Q DEPEND ON WEIGHT OR ORDER AND
===4== Q DISTRICT TO WHICH ORDER SHIPPED.
7 >
8
> AWS(AAA.SHIPRATE) SCRL FULL COLS ====7 ===72
> ..<1....+....2....+....3....+....4....+....5....>
...... ============================= T O P =============
=====1 Q THIS PROGRAM PRINTS AN ESTIMATED SHIPPING COST
=====2 Q REPORT. SHIPPING RATES DEPEND ON WEIGHT OF
=====3 Q ORDER AND DISTRICT TO WHICH ORDER SHIPPED.
By specifying a numeric value with the command, you can override the right column
boundary. The following example illustrates how you would reformat the lines within
a paragraph so that the text does not extend beyond column 35.
7 >
8
> AWS(AAA.SHIPRATE) SCRL FULL COLS ====7 ===72
> .<.1....+....2....+....3....+....4....+....5....>
...... ============================= T O P =============
TF35=1 Q THIS PROGRAM PRINTS AN ESTIMATED SHIPPING COST
=====2 Q REPORT. SHIPPING RATES DEPEND ON WEIGHT OF
=====3 Q ORDER AND DISTRICT TO WHICH ORDER SHIPPED.
7 >
8
> AWS(AAA.SHIPRATE) SCRL FULL COLS ====7 ===72
> .<.1....+....2....+....3....+....4....+....5....>
...... ============================= T O P =============
=====1 Q THIS PROGRAM PRINTS AN
=====2 Q ESTIMATED SHIPPING COST
=====3 Q REPORT. SHIPPING RATES
=====4 DEPEND ON WEIGHT OF ORDER
=====5 AND DISTRICT TO WHICH ORDER
=====6 SHIPPED.
To limit the operation to specific lines, you can include the appropriate line numbers
with the command, as in:
LSHIFT 2 1== 5==
where only the contents of lines 100 through 500 are shifted two positions to the left.
By default, the data within the default (or current) column boundaries is shifted. You
can use the SET BOUNDS command to change the column boundaries for your
session. To change the boundaries for a single execution of the command, use the
BOUNDS operand, as in:
RSHIFT 5 BOUNDS 8 2=
where only the data within columns 8 through 20 are shifted five positions to the right.
Note: SET BOUNDS is described in Chapter 4, “Defining Column Boundaries.”
If you shift the contents of a line beyond right or left column boundary, the data are
lost. This may be useful if you want to clear a field. For example, if you enter:
LSHIFT 7
RSHIFT 7
the first seven positions within the default (or current) column boundary of each active
AWS line is blank-filled.
To prevent data from being lost by such an operation, include the TEXTSTOP operand
with the command. For example, if you enter:
LSHIFT 3= TEXTSTOP
every line in the active AWS is shifted 30 positions to the left. However, if any line
contains data that would be shifted beyond the left margin, the operation is stopped for
that line when the left margin is reached.
To change the column boundaries that are currently in effect, you can use the SET
BOUNDS primary command or BOUNDS line command. See Chapter 4, “Defining
Column Boundaries” for additional information.
The following example illustrates how you can use these line commands to format
data. The upper screen contains the unformatted data and appropriate line commands;
the lower screen shows the correctly formatted data (how the data will look after the
line commands are executed).
7 >
8
> AWS(PRI.INVLIST) SCRL FULL COLS ====1 ===72
> <...+....1....+....2....+....3....+....4....+....5.
...... ================================ T O P ============
>4=1== IDENTIFICATION DIVISION.
<4=2== PROGRAM-ID. INVLIST.
>>43== ENVIRONMENT DIVISION.
>>=4== CONFIGURATION SECTION.
===5== SOURCE-COMPUTER. IBM-37=.
===6== OBJECT-COMPUTER. IBM-37=.
7 >
8
>
> AWS(PRI.INVLIST) SCRL FULL COLS ====1 ===72
<...+....1....+....2....+....3....+....4....+....5.
...... ================================ T O P ============
===1== IDENTIFICATION DIVISION.
===2== PROGRAM-ID. INVLIST.
===3== ENVIRONMENT DIVISION.
===4== CONFIGURATION SECTION.
===5== SOURCE-COMPUTER. IBM-37=.
===6== OBJECT-COMPUTER. IBM-37=.
You can split one line into two using the TXTSPLIT primary or TS line command.
You can use the TXTSPLIT command to split a line at a specific location. The
following example shows line 300 being split at column 31 (top screen). Everything
from that position to the right column boundary is moved to the next line. The text
will begin at the left column boundary of that line. In this case, it means that the word
RATES is moved to line 301 and begins in position 9, which is the current left
boundary (bottom screen).
7 >
8
> AWS(AAA.SHIPRATE) SCRL FULL COLS ====7 ===72
> ..<1....+....2....+....3....+....4....+....5....+
...... ============================= T O P =============
===1== Q------------------------------------------------
===2== Q THIS PROGRAM PRINTS AN ESTIMATED
===3== Q SHIPPING COST REPORT.
===3=1 RATES
===4== Q DEPEND ON WEIGHT OF ORDER AND
===5== Q DISTRICT TO WHICH ORDER SHIPPED.
===6== Q------------------------------------------------
===7== IDENTIFICATION DIVISION.
A variation of the example shown in the previous figure uses the CURSOR operand.
For example, you could have split the line by positioning the cursor to column 31 on
line 300 and entering:
TXTSPLIT Q CURSOR TXTSPLIT
7 >
8
> AWS(AAA.SHIPRATE) SCRL FULL COLS ====7 ===72
> ..<1....+....2....+....3....+....4....+....5....+
...... ============================= T O P =============
=====1 Q------------------------------------------------
=====2 Q THIS PROGRAM PRINTS AN ESTIMATED
=====3 Q SHIPPING COST REPORT.
=====4 RATES
=====5 Q DEPEND ON WEIGHT
=====6 OF ORDER AND
=====7 Q DISTRICT TO WHICH
=====8 ORDER SHIPPED.
=====9 Q------------------------------------------------
====1= IDENTIFICATION DIVISION.
You can use the TXTJOIN command to rejoin two lines. In the following example,
the modified contents of line 4 are being rejoined to line 3. Since no column number
is specified, the contents of line 4 will begin one space after the current last word on
line 3.
7 TXTJOIN 3
8
>
> AWS(AAA.SHIPRATE) SCRL FULL COLS ====7 ===72
> ..<1....+....2....+....3....+....4....+....5....+
...... ============================= T O P =============
=====1 Q------------------------------------------------
=====2 Q THIS PROGRAM PRINTS AN ESTIMATED
=====3 Q SHIPPING COST REPORT.
=====4 SHIPPING RATES
=====5 Q DEPEND ON WEIGHT
=====6 OR ORDER AND
=====7 Q DISTRICT TO WHICH
=====8 ORDER SHIPPED.
=====9 Q------------------------------------------------
7 >
8
> AWS(AAA.SHIPRATE) SCRL FULL COLS ====7 ===72
> .<.1....+....2....+....3....+....4....+....5....+
...... ============================= T O P =============
=====1 Q------------------------------------------------
=====2 Q THIS PROGRAM PRINTS AN ESTIMATED
=====3 Q SHIPPING COST REPORT. SHIPPING RATES
=====5 Q DEPEND ON WEIGHT
=====6 Q OR ORDER AND
=====7 Q DISTRICT TO WHICH
=====8 Q ORDER SHIPPED.
=====9 Q------------------------------------------------
====1= IDENTIFICATION DIVISION.
The following example shows how you can rejoin multiple lines (lines 5 through 8, in
this case). The example also shows how you can have the joined lines begin in a
specific location. When a column number is specified with the command, the joined
text begins one space after the designated column (in the example, the joined text will
begin one space after column 26).
7 TXTJOIN 5 8 COLS 26
8
>
> AWS(AAA.SHIPRATE) SCRL FULL COLS ====7 ===72
> ..<1....+....2....+....3....+....4....+....5....+
...... ============================= T O P =============
=====1 Q------------------------------------------------
=====2 Q THIS PROGRAM PRINTS AN ESTIMATED
=====3 Q SHIPPING COST REPORT. SHIPPING RATES
=====5 Q DEPEND ON WEIGHT
=====6 Q OR ORDER AND
=====7 Q DISTRICT TO WHICH
=====8 Q ORDER SHIPPED.
=====9 Q------------------------------------------------
7> 8
> AWS(AAA.SHIPRATE) SCRL FULL COLS ====7 ===72
> .<.1....+....2....+....3....+....4....+....5....+
...... ============================= T O P =============
=====1 Q------------------------------------------------
=====2 Q THIS PROGRAM PRINTS AN ESTIMATED
=====3 Q SHIPPING COST REPORT. SHIPPING RATES
=====5 Q DEPEND ON WEIGHT OR ORDER AND
=====7 Q DISTRICT TO WHICH ORDER SHIPPED.
=====9 Q------------------------------------------------
====1= IDENTIFICATION DIVISION.
You can also insert lines for data entry when you split a line. In the following
example, TS2 is typed in the sequence number field of line 200 and the cursor is
positioned to column 31. When the ENTER key is pressed, everything from the cursor
position to the right column boundary is moved to begin at the left column boundary
of the new next line. Since a numeric value was specified with the command, the
appropriate number of data entry lines will be inserted between the split.
7 >
8
> AWS(AAA.SHIPRATE) SCRL FULL COLS ====7 ===72
> ..<1....+....2....+....3....+....4....+....5....+
...... ============================= T O P =============
===1== Q THIS PROGRAM PRINTS AN ESTIMATED
TS22== Q SHIPPING COST REPORT. RATES
-
===3== Q DEPEND ON WEIGHT OF ORDER AND
===4== Q DISTRICT TO WHICH ORDER SHIPPED.
7> 8
> AWS(AAA.SHIPRATE) SCRL FULL COLS ====7 ===72
> ..<1....+....2....+....3....+....4....+....5....+
...... ============================= T O P =============
===1== Q THIS PROGRAM PRINTS AN ESTIMATED
===2== Q SHIPPING COST REPORT.
......
......
===2=1 RATES
===3== Q DEPEND ON WEIGHT OF ORDER AND
===4== Q DISTRICT TO WHICH ORDER SHIPPED.
If anything is typed on the inserted lines (like text or a space), the lines are retained
when the next operation is performed. If nothing is entered, the lines are removed.
You can use the TJ line command to rejoin two lines. When this command is
executed, the joined line begins one space after the last word on the preceding line.
The following example shows how you can rejoin the modified contents of line 201 to
line 200. Since nothing was entered on the inserted lines, they are removed when the
operation is performed.
7 >
8
> AWS(AAA.SHIPRATE) SCRL FULL COLS ====7 ===72
> ..<1....+....2....+....3....+....4....+....5....+
...... ============================= T O P =============
===1== Q THIS PROGRAM PRINTS AN ESTIMATED
TJ=2== Q SHIPPING COST REPORT.
......
......
===2=1 SHIPPING RATES
===3== Q DEPEND ON WEIGHT OR ORDER AND
===4== Q DISTRICT TO WHICH ORDER SHIPPED.
7> 8
> AWS(AAA.SHIPRATE) SCRL FULL COLS ====7 ===72
> ..<1....+....2....+....3....+....4....+....5....+
...... ============================= T O P =============
===1== Q THIS PROGRAM PRINTS AN ESTIMATED
===2== Q SHIPPING COST REPORT. SHIPPING RATES
===3== Q DEPEND ON WEIGHT OR ORDER AND
===4== Q DISTRICT TO WHICH ORDER SHIPPED.
To have the joined line begin in a specific location, include a numeric value with the
command, where the value represents the column after which the text from the
following line is to be placed. For example, entering TJ35 causes the following line to
begin one space after column 35 of the line containing the command.
While the examples in this chapter show strings that are in character format, you can
also locate and display data that is in hexadecimal representation. See 20.3,
“Customizing the Operation” on page 20-10 for details.
The resulting display begins with the first line containing the string DATA.
For example, to locate and position the display to the first line containing the string
TEST-DATA, enter:
FIRST TEST-DATA
To locate and display the next occurrence of the same string, all you need enter is:
NEXT
Once specified, the string is remembered until you specify a different one. It is,
therefore, used with any subsequent EXCL, FIRST, INCL, LAST, NEXT or PREV
primary or line command that does not include a string. (The string specified with the
ATTACH command is also remembered and used with any subsequent EXCL, FIRST,
INCL, LAST, NEXT or PREV primary or line command that does not include a
string.)
By default, the entire AWS is searched for the string (every column of every line).
You can limit the extent of the operation to specific columns or lines. For example, to
locate the last occurrence of TEST-DATA and to limit the search to columns 10
through 50, you would enter:
LAST 1= 5= TEST-DATA
where the column numbers are specified before the string. To limit the search to a
specific number of lines, specific the appropriate value after the string. For example,
to search the previous 200 lines for the first occurrence of TEST-DATA, enter:
PREV TEST-DATA 2==
Note: Column boundaries specified with the command affect only the execution of
that command. See Chapter 4, “Defining Column Boundaries” for information
about changing boundaries for the terminal session.
Finally, you can combine a column range and line limit within a command, as in:
FIRST 1= 5= TEST-DATA 2==
To locate a string, enter the appropriate line command in the sequence number field
and the delimited search string in the data portion of the same line. The following
example shows how to find the last occurrence of the string PRINT-FILE.
7 >
8
> AWS(PRI.INVLIST) SCRL FULL COLS ====7 ===72
> ...1....+....2....+....3....+....4....+....5....+....
...... ============================= T O P =================
LAST /PRINT-FILE/TEST-DATA ASSIGN TO S-SYSIN.
-
==37== SELECT PRINT-FILE ASSIGN TO S-SYSPRINT.
==38== DATA DIVISION.
==39== FILE SECTION.
==4=== FD TEST-DATA
==41== LABEL RECORDS ARE OMITTED
==42== DATA RECORD IS TEST-RECORD.
==43== =1 TEST RECORD PIC X(8=).
==44== FD PRINT-FILE
==45== LABEL RECORDS ARE OMITTED
U V
If the string was specified with a previously executed ATTACH, EXCL, FIRST,
INCL, LAST, NEXT or PREV primary or line command, you need not respecify it.
Once a character string is specified, it is remembered and available for use until you
change it.
By default, the entire line is searched. To limit the search to specific columns, you can
use the modifiable STATUS DISPLAY screen, the SET BOUNDS primary command
or the BOUNDS line command. See Chapter 4, “Defining Column Boundaries” for
additional information.
To locate all lines not containing a specific string, use the EXCL primary or line
command. Again, the resulting display is modifiable. To produce a non-modifiable
display, use the OMIT primary command.
The INCL and EXCL primary commands display all lines including or excluding a
specific character string. For example, to display all lines that do not contain the string
TEST-DATA, specify:
EXCL TEST-DATA
To then display all of the lines that contain the same string, all you need enter is:
INCL
When you do not specify a string, the string specified with the previous ATTACH,
EXCL, FIRST, INCL, LAST, NEXT or PREV primary or line command is assumed.
To limit the search to specific columns or numbers of lines, specify the column
numbers before the string and the number of lines after the string. For example,
EXCL 12 4= DATA 4==
limits the search for DATA to columns 12 through 40 of the next 400 lines.
Note: Column boundaries specified with the command affect only the execution of
that command. See Chapter 4, “Defining Column Boundaries” for information
about changing boundaries for the remainder of the terminal session.
The following example illustrates the type of display resulting from the execution of
an INCL or EXCL command.
If the number of lines containing (or not containing) the string exceeds the size of your
terminal screen, you can:
1. Press one of the PF keys to which a scroll function is assigned. The direction of
the scan depends on the value of the PF key that is pressed, or
2. Enter the INCL or EXCL line command, with no operand, in the sequence number
field of a line and press ENTER. The scan begins with that line and continues
towards the end of the data.
After pressing the ENTER key, the resulting display begins with the designated line.
Note: While the INCL/EXCL display shows only the appropriate lines within the
active AWS, all of the lines may be affected by the action of a primary or line
command. If, for example, you delete a range of lines (using either a primary
or line command), all of the displayed and non-displayed lines within that
range are deleted.
Use the OMIT command to produce a non-modifiable display of all lines not
containing a specific string.
As illustrated in the following example, the resulting display contains the number and
contents of each line containing the string.
7 _
8
>
>
> ...1....+....2....+....3....+....4....+....5....+....6
==31== =5 INVENTORY-BALANCE-IN PIC S9(5).
==46== =5 INVENTORY-BALANCE-OUT PIC ZZ,ZZ9.
==75== MOVE INVENTORY-BALANCE-IN
==76== TO INVENTORY-BALANCE-OUT.
With both commands, you can limit the operation to: 1) a specific range of columns
and 2) a specific range of lines. For example,
OMIT 2= 5= 'PIC' 15= 9==
displays all lines that do not contain the string PIC in columns 20 through 50 of lines
150 through 900.
The following example shows the display that might result after executing an INCL
line command.
7 >
8
> AWS(PRI.INVLIST) SCRL FULL COLS ====7 ===72
> ...1....+....2....+....3....+....4....+....5....
...... ============================= T O P ============
INCL /WS-END-OF-FILE-SWITCH./
===2== PROGRAM-ID. INVLIST.
===3== ENVIRONMENT DIVISION.
===4== CONFIGURATION SECTION.
===5== SOURCE-COMPUTER. IBM-3=81.
If INCL or EXCL retrieve more lines than can be displayed on the screen at one time,
you can reposition the display by:
1. Entering the INCL or EXCL line command, with no operand, in the sequence
number field of a line and pressing ENTER. The scan begins with that line and
continues towards the end of the data, or
2. Pressing one of the PF keys to which a scroll function is assigned. The direction
of the scan depends on the value of the PF key that is pressed.
After pressing the ENTER key, the resulting display begins with the designated line.
Note: While the INCL/EXCL display shows only the appropriate lines within the
active AWS, all of the lines may be affected by the action of a primary or line
command. If, for example, you delete a range of lines (using either a primary
or line command), all of the displayed and non-displayed lines within that
range are deleted.
and you want to search for the string THE. Without qualification, the words THE,
OTHER, BROTHER and THEIR match the search string. By including a qualifier, you
can designate the type of string match that is to occur, as in:
THE WORD Qualifies THE as a word, only THE matches.
THE PREFIX Qualifies THE as beginning a word, only THEIR matches.
THE BEGIN Qualifies THE as beginning or being a word - THE and THEIR
match.
THE EMBED Qualifies THE as contained within a word - OTHER and BROTHER
match.
TEST END Qualifies TEST as ending or being a word - only CONTEST
matches.
TEST SUFFIX Qualifies TEST as ending a word - only CONTEST matches.
where the string is bound by apostrophes and contains an even number of characters,
as in:
FIRST X'C1'
When using:
■ The primary commands FIRST, LAST, NEXT, PREV, INCL or EXCL, you do
not need to delimit the hexadecimal string.
When using the comparable line commands, as illustrated in the following
example, the string must be bound by delimiters.
■ For primary commands SEARCH or OMIT, the string must be bound by
delimiters. (Note that the resulting display is not modifiable and shows only the
character format of matching lines.)
The search string itself can be specified in either uppercase or lowercase characters.
For the search operation, it is translated to uppercase. Thus, you will have the same
result if you specify:
FIRST X'C1'
or
first x'c1'
7 >
8
> AWS() SCRL FULL COLS ====7 ===78
> <...+....1....+....2....+....3....+....4....+....5...
...... ============================= T O P =================
LAST== /X'C1'/ THOMAS W
4CDECDC4444444ECDDCE4444E4=4=444444444444444444444444
=866194=======386412====6=1=3========================
-----------------------------------------------------
===2== SMITHSOM SALLY S
4EDCECEDD44444ECDDE44444E4=4=444444444444444444444444
=24938265=====21338=====2=2=1========================
-----------------------------------------------------
===3== WALTERS JOHN
4ECDECDE444444DDCD44444444=4=444444444444444444444444
=6133592======1685========1=3========================
-----------------------------------------------------
By specifying a screen positioning operand with the FIRST, NEXT, LAST, PREV,
INCL or EXCL primary command, you can also control how the resulting display is to
be positioned. The screen positioning operands are:
CJUSTIFIED The display margins are to be altered if the entire matching string
does not fall within the current margin. (This is the default
positioning.)
JUSTIFIED The display margins are always to be altered so that the first
character of the string begins in the left-most position of the line.
CENTERED The display margins are to be altered to center the matching string
on the line. If centering would cause an invalid left margin (less
than 1), the display is not altered.
LOCKED The display margins are not to be altered even if the matching string
occurs to the left or right of the current margins.
If the string is not found, the display is repositioned to: 1) the end of the active AWS
or given range if FIRST or NEXT are specified, or 2) the beginning of the active
AWS or given range if LAST or PREV are specified.
This chapter describes how you can use primary and line commands to move one or
more lines within the active AWS.
Note that a move operation (unlike a copy operation) is destructive (the lines being
moved are deleted from their original location after being inserted in their new
location).
In addition to a line number, the destination can also be indicated through the keyword
operands:
* After the line at which the AWS pointer is currently positioned.
T Before the first line of the active AWS.
B or ,, After the last line of the active AWS.
For example, to move lines 1200 through 2800 to the bottom of the active AWS, you
would enter:
MOVE 12== 28== B
The following example illustrates how you can use overlay destination line commands.
Notice that only the blank characters in the target lines are overlaid with corresponding
data from the source lines.
7 >
8
> AWS(PRI.INVLIST) SCRL FULL COLS ====7 ===72
> ...1....+....2....+....3....+....4....+....5....+
M =8== SAMPLE PIC X( ).
O2 9== PART-DESCRIPTION-IN
==1=== INVENTORY-BALANCE-IN
7 >
8
> AWS(PRI.INVLIST) SCRL FULL COLS ====7 ===72
> ...1....+....2....+....3....+....4....+....5....+
===8== SAMPLE PIC X( ).
===9== PART-DESCRIPTION-IN PIC X( ).
==1=== INVENTORY-BALANCE-IN PIC X( ).
The number of lines to be overlaid must be equal to or greater than the number of
lines being moved. For example, the upper screen in the previous figure shows that
one line is to be moved (line 800) and that two lines are to be overlaid with that data
(lines 900 and 1000). The lower screen in the previous figure shows the result, where
PIC X( ) has overlaid the corresponding blank positions in the designated lines.
(SAMPLE has been ignored since its corresponding positions contain data.)
CA-Roscoe stores data in the form of variable length records not exceeding 255
characters in length. (There is one record for each line in an AWS). To keep these
records in their proper order, a six-digit sequence number is assigned to each line.
These sequence numbers are maintained by CA-Roscoe and are stored externally to the
data records themselves.
When you begin entering data in the active AWS, default sequence numbering begins
with 100 and is incremented by 100. If you copy, move or insert lines within the
existing data, the new lines are incremented by one (for example, if you insert three
lines between lines 200 and 300, the new lines are numbered 201, 202 and 203). If
you add lines to the end of the AWS, the current line number increment value is used.
If you then delete any lines, a gap is left in the sequence numbers.
renumbers the entire contents of the AWS from 100 by 100. You can change the
starting and increment values, as in:
RENUMBER 5= 1=
You can also renumber a range of lines within the AWS. For example,
RENUMBER FROM 9== TO 25=1 START 9== BY 1=
renumbers only lines 900 through 2501, where the starting line number is 900 and the
increment value is 10.
Finally, you can also renumber data when you bring it into the AWS using the FETCH
command. For example if you enter:
FETCH INVLIST START 5= BY 5=
the contents of the library member named INVLIST are placed in the active AWS and
that data are then renumbered beginning with 50 and incremented by 50.
renumbers the AWS from 100 by 50 and places the new line numbers within columns
1 through 6 of the data. To place the current line numbers in the data (without
renumbering), use the SEQ command, as in:
SEQ IN 73 8
which places the current sequence numbers in the data beginning in column 73 and
extending for eight positions.
If you add sequence numbers to the AWS and data exists in the designated columns,
the data are overlaid by the sequence numbers.
the sequence number attribute is set so that line numbers will be placed in columns 1
through 6 when this AWS data are PRINTed or SUBMITted. (If data appears in the
designated sequence number field, the number is omitted; data are not overlaid.)
To prevent sequence numbers from being included, you can change the attribute by
issuing the command:
NOSEQ
Once established, this attribute remains in effect until: 1) you specifically change it by
issuing another SEQ/NOSEQ command, or 2) it is overridden by the sequence number
attribute of a library member that is FETCHed or SAVEd.
An AWS is a temporary work area. Data that is within the active AWS may be saved
at any time as a member in the CA-Roscoe library. To modify that member, you must
bring a copy of it back into the active AWS. Once there, you can use any of the
primary or line commands to change the data. The contents of the library member
remains intact until you specifically replace it.
where the entire contents of the active AWS is saved in a member named INVLIST.
(The following figure lists the CA-Roscoe member naming conventions.)
If you do not want to save the entire AWS, you can include line numbers with the
command. Only the data within the designated range of lines will be saved as the
member. For example, if you enter:
SAVE INVLIST 1== 12==
only lines 100 through 1200 of the active AWS are saved in the member named
INVLIST.
it applies to all keyword operands and their abbreviaions. For example, NOW is a
keyword operand of the SEND command. If you name a library NOW and then
attempt to send the contents of that member to another user by issuing SEND NOW,
CA-Roscoe treats NOW as an operand, not as a member name.
If you do use keyword operands as library member names, you must specify your
prefix when referencing these members. For example, if your prefix is AAA, you
would enter:
ATTACH AAA.JOB
COPY AAA.DSN
SEND AAA.NOW
It is also recommended that you do not use member names beginning with: ZZZZZ
or SAVAWS. Members created with these characters can be deleted when the
CA-Roscoe site administrator runs CA-Roscoe library maintenance.
The following table summarizes the various options you can specify.
To update the contents of a member with specific lines from the active AWS, include
the appropriate line numbers with the command, as in:
UPDATE INVLIST 7== 49==
In this example, the entire contents of the member INVLIST is replaced with lines 700
through 4900 of the active AWS.
If you want to update the last member that you FETCHed, SAVEd or UPDATEd, you
can use an asterisk (*) in place of a library member name, as in:
FETCH INVLIST
RENUMBER
UPDATE Q
At the same time you are updating the contents of a member, you can also change its
description, sequence number attribute and/or access attribute, as in:
UPDATE INVLIST 'New Inventory List' SHARED
In this example, the member description and access attribute are changed; since no
sequence number attribute is specified, that attribute is not changed. (See 23.1.3,
“Assigning a Description and/or Attributes” on page 23-4 for additional information
about member descriptions and attributes.)
Chapter 24. Data Sets: Introducing the Data Set Facility . . . . . . . . . . 24-1
24.1 Attaching the Data Set Facility . . . . . . . . . . . . . . . . . . . . . . . 24-2
24.1.1 Using Wildcard Characters to Create a Catalog or VTOC Selection
List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-8
24.1.2 Using Wildcard Characters to Create a CA-Librarian, PDS or Volume
Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24-9
24.2 Using Data Set Facility Function Panels . . . . . . . . . . . . . . . . . . 24-10
24.3 Using Data Set Facility Selection Lists . . . . . . . . . . . . . . . . . . . 24-12
24.3.1 Entering Function Codes . . . . . . . . . . . . . . . . . . . . . . . . 24-13
24.3.2 Refreshing a Selection List . . . . . . . . . . . . . . . . . . . . . . . 24-15
Chapter 25. Data Sets: Attaching a Data Set Object at the Terminal . . . 25-1
25.1 Attaching a CA-Librarian Selection List . . . . . . . . . . . . . . . . . . 25-2
25.1.1 Using a Primary Command . . . . . . . . . . . . . . . . . . . . . . . 25-2
25.1.2 Using the Data Set Facility . . . . . . . . . . . . . . . . . . . . . . . 25-3
25.1.3 Selection List Description . . . . . . . . . . . . . . . . . . . . . . . . 25-4
25.2 Attaching a Catalog Selection List . . . . . . . . . . . . . . . . . . . . . . 25-7
25.2.1 Using a Primary Command . . . . . . . . . . . . . . . . . . . . . . . 25-7
25.2.2 Using the Data Set Facility . . . . . . . . . . . . . . . . . . . . . . . 25-8
25.2.3 Selection List Description . . . . . . . . . . . . . . . . . . . . . . . . 25-9
25.3 Attaching a Generation Data Group Data Set . . . . . . . . . . . . . . . . 25-14
25.4 Attaching a PDS Member/CA-Librarian Module . . . . . . . . . . . . . . 25-15
25.4.1 Using a Primary Command . . . . . . . . . . . . . . . . . . . . . . . 25-15
25.4.2 Using the Data Set Facility Menu . . . . . . . . . . . . . . . . . . . 25-16
25.4.3 Using a Selection List . . . . . . . . . . . . . . . . . . . . . . . . . . 25-17
25.4.4 Attached Data Description . . . . . . . . . . . . . . . . . . . . . . . 25-17
25.5 Attaching a PDS Selection List . . . . . . . . . . . . . . . . . . . . . . . 25-18
25.5.1 Using a Primary Command . . . . . . . . . . . . . . . . . . . . . . . 25-18
25.5.2 Using the Data Set Facility . . . . . . . . . . . . . . . . . . . . . . . 25-19
25.5.3 Selection List Description . . . . . . . . . . . . . . . . . . . . . . . . 25-20
25.6 Attaching a Sequential Data Set . . . . . . . . . . . . . . . . . . . . . . . 25-26
25.6.1 Using a Primary Command . . . . . . . . . . . . . . . . . . . . . . . 25-26
25.6.2 Using the Data Set Facility Menu . . . . . . . . . . . . . . . . . . . 25-26
25.6.3 Using a Selection List . . . . . . . . . . . . . . . . . . . . . . . . . . 25-27
25.6.4 Attached Data Description . . . . . . . . . . . . . . . . . . . . . . . 25-27
25.7 Attaching a Volume Selection List . . . . . . . . . . . . . . . . . . . . . 25-28
25.7.1 Using a Primary Command . . . . . . . . . . . . . . . . . . . . . . . 25-28
25.7.2 Using the Data Set Facility . . . . . . . . . . . . . . . . . . . . . . . 25-29
25.7.3 Selection List Description . . . . . . . . . . . . . . . . . . . . . . . . 25-30
25.8 Attaching a VTOC Selection List . . . . . . . . . . . . . . . . . . . . . . 25-33
25.8.1 Using a Primary Command . . . . . . . . . . . . . . . . . . . . . . . 25-33
25.8.2 Using the Data Set Facility . . . . . . . . . . . . . . . . . . . . . . . 25-34
25.8.3 Selection List Description . . . . . . . . . . . . . . . . . . . . . . . . 25-35
25.9 Selecting the Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25-38
When working with OS data sets or CA-Librarian master files, you can use primary
commands or the Data Set Facility to:
■ Directly access data that is in a:
– Sequential data set.
– Partitioned Data Set (PDS) member or CA-Librarian module.
– Generation Data Group (GDG) data set.
■ Produce Selection Lists that contain information about:
– All or selected volumes.
– All or selected data sets on a specific volume (for example, the VTOC
information).
– All or selected entries on a VSAM, ICF or OS CVOL catalog.
– All or selected members/modules on a PDS (like the PDS directory) or
CA-Librarian master file (like the master file index).
■ Browse through the attached data or Selection List. While browsing, you can
locate and note the occurrences of specific character strings. You can also browse
other types of attached data (like an AWS) and then return to the data you were
browsing.
■ Perform a variety of data management functions which include:
– Copying all or part of a data set object into an AWS
– Printing all or part of a data set object at a 328x-type printer or a system
printer.
Note: A data set object can be a sequential data set, PDS member or
CA-Librarian module. In the form of a Selection List, it can also be a
PDS directory, CA-Librarian index, list of catalog entries, volume table of
contents or list of volumes.
■ Allocating, deleting, renaming, cataloging, and so on.
You can perform all of these operations using the Data Set Facility or primary
commands. Many can also be performed using Selection Lists that are provided
through the Data Set Facility.
Chapter 24. Data Sets: Introducing the Data Set Facility 24-1
24.1 Attaching the Data Set Facility
If you enter either of these commands with no operand, the menu is displayed.
You can include a function code and data set name with the DSN command.
If you include a function code and that function has a panel associated with it, you can
bypass the Data Set Facility menu and display the function panel. For example, if you
enter:
DSN AL TEST.NEW
the Allocate Function Panel is displayed with TEST.NEW in the DATA SET field.
If no panel is associated with the function, the Data Set Facility menu is displayed
along with any information that you provided with the command. For example, if you
enter:
DSN CT TEST.NEW VOL STOR=1
the Data Set Facility menu will show CT in the FUNCTION field, TEST.NEW in the
DATA SET field and STOR01 in the VOLUMES field. To perform this function,
press the ENTER key. (The Data Set Facility menu will be redisplayed, allowing you
to perform other functions.)
If you are currently viewing a data set object, you can redisplay the menu by entering:
SELECT MENU
to bounce the display between the last available specific and generic data set name.
7 8
>
> DSN() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6....
DATA SET FACILITY
FUNCTION ==>
Chapter 24. Data Sets: Introducing the Data Set Facility 24-3
24.1 Attaching the Data Set Facility
ARCHIVE LEVEL Enter the archive level of the CA-Librarian master file
module to be involved in the operation. (The module must
be in ARCHIE format.) If omitted, the most current level of
the module is assumed. The level can be specified in one of
the following forms:
Lx Absolute level number (between 0 and 65535) as
reported on the CA-Librarian Update Report.
-y Relative level number between 0 and 255. The
current level is -0; -1 is one level older than the
current.
yymmddhhmmss
Date and time when the desired archive level was
current. An even number of digits (starting from
the right) can be omitted. They are assumed to
have the highest values consistent with the values
of the specified digits.
PASSWORD Enter one or two passwords (established by your site).
If one password is specified, it is treated as the data set or
CA-Librarian master file module password.
If two passwords are specified, the first is treated as the data
set password and the second is treated as the CA-Librarian
password.
If omitted and a password is required, access is denied.
PGMR NAME Enter the one- to 15-character programmer name to be used
when selecting modules for inclusion in a CA-Librarian
Selection List. Only those modules marked as owned by the
specified programmer are included in the Selection List. If
omitted, all appropriate modules (as qualified by the other
fields) are included.
MCD CODE Enter the Management code of the CA-Librarian master file.
MCD is only required when the master file contains PROD2
modules.
Chapter 24. Data Sets: Introducing the Data Set Facility 24-5
24.1 Attaching the Data Set Facility
MODULE TYPE Enter one of the following to designate the type of modules
to be included in a CA-Librarian Selection List:
PROD0 Includes only those modules with PROD0
security status.
PROD1 Includes only those modules with PROD1
security status.
PROD2 Includes only those modules with PROD2
security status.
TEST Includes only those modules with TEST security
status.
If omitted, all appropriate modules (as qualified by other
fields) are included.
LANGUAGE Enter the language code designating the programming
language type of the modules that are to be included in a
CA-Librarian Selection List. If omitted, all appropriate
modules (as qualified by other fields) are included.
DISPLAY FORMAT Enter one of the following to designate the extent of
information that is to be included in a Selection List:
HIST Only history records for the specified
CA-Librarian master file module are to be
displayed.
QUICK, SHORT, or LONG
The amount of information to be included in the
initial Selection List display.
Note: HIST, QUICK, SHORT and LONG are mutually
exclusive. (Abbreviate as H, Q, S and L
respectively.) Whichever setting you select is
remembered at sign off and is reinstated when you
sign back on.
Note: QUICK is ignored if you request a qualified
CA-Librarian Selection List.
Chapter 24. Data Sets: Introducing the Data Set Facility 24-7
24.1 Attaching the Data Set Facility
Chapter 24. Data Sets: Introducing the Data Set Facility 24-9
24.2 Using Data Set Facility Function Panels
The field ACTION in the previous figure indicates whether the function is performed
directly or requires additional information. For example, the information you provide
through the menu is sufficient to catalog a data set (function code CT) but insufficient
to allocate a data set (function code AL).
=[code.code]
■ If you enter only the equal sign (=), you are returned to the menu.
■ If you specify =X, the Data Set Facility is terminated.
■ If you specify any other code (like =AL), the appropriate function-related panel is
displayed. If you include a subfunction code, the appropriate function-related panel
is displayed and its OPTION field will contain the subfunction code.
If the function-related panel is displayed while the screens are split, you can use PF
keys to scroll the panel.
Information about attaching a data set object is described in the next chapter. The
remaining Data Set Facility functions are described in Chapter 27, “Data Sets:
Performing Data Management Tasks.”
Chapter 24. Data Sets: Introducing the Data Set Facility 24-11
24.3 Using Data Set Facility Selection Lists
The information is displayed as a Selection List in the Execution Area of the screen.
This allows you to issue primary commands in the Command Area at any time during
your session.
The first line of each Selection List contains a top marker (==TOP==). If the bottom
marker (==BOTTOM==) is not displayed, the number of entries in the list exceeds the
screen size. You can use PF keys to scroll within the list.
The amount of information available with each Selection List exceeds the width of
80-column screens. The information is, therefore, divided into alternate display
formats. To view the different formats sequentially, enter the command:
SELECT ALT
To view a specific format, enter the number of that format with the command, as in:
SELECT ALT 2
See Chapter 25, “Data Sets: Attaching a Data Set Object at the Terminal” for
information about displaying each type of Selection List. The information includes a
description of the fields comprising each list. The alternate display numbers shown
with the description are for 80-column screens. Additional formats (containing
variations of the information) are available at terminals supporting wider screen sizes.
If you specify the same function code multiple times, they are processed sequentially.
If you specify different function codes, the codes are processed sequentially within the
following function hierarchy:
X Terminate Data Set Facility.
D Delete data set, member or module.*
DX Delete the members of a PDS without deleting the data set itself.*
UC Uncatalog a data set.
R Rename data set, member or module.*
DA Define an alias for a: 1) PDS member or 2) non-VSAM data set or
ICF/VSAM user catalog.
DG Define a generation data group.
RL Release unused DASD space.
CM Compress a partitioned data set.
P Print a data set, member or module.
CT Catalog a data set.
I Inquire about data set.*
G Get attributes.
C Copy a data set, member or module.
AL Allocate a new data set.
AM Allocate an SMS-managed data set.
H Attach CA-Librarian module history.
A Attach data set, member or module.*
Note: * This function cannot be performed through a Selection List if the data set is
password protected. Use the Data Set Facility menu or appropriate primary
command instead.
Chapter 24. Data Sets: Introducing the Data Set Facility 24-13
24.3 Using Data Set Facility Selection Lists
The following example illustrates how you can enter multiple functions codes on a
Selection List. To qualify a function, specify information in the STATUS field. (See
Chapter 27, “Data Sets: Performing Data Management Tasks” for information about
each of the functions you can perform through a Selection List.)
7 8
>
> DSN() SCRL FULL COLS ====1 ===72 LINE ====1
....+....1....+....2....+....3....+....4....+....5....+....6..
==================================== T O P ===================
VOLSER UNIT DSNS DSCBS CONTG--CYL--AVAIL CONTG--TRK--AVAIL
STOR=1 673 288 1=17 2 2 116 2
DATA SET NAME STATUS ORG RFM BLKSZ LRECL
ABC.TEST.ASM
A ABC.TEST.LOAD PO U 12288 1
I ABC.TEST.OBJECT PO FB 8==
ABC.TEST1.LOAD
D BASE.TEST.TESTLOAD PO U 13=3=
R DATA.TEST.LOAD PO U 12288 1
U V
The functions in “Data Set: Selection List Function Hierarchy Example” are processed
in the following order:
1. The data set BASE.TEST.TESTLOAD will be deleted. (A delete confirmation
panel may be displayed.)
2. A rename panel will then be automatically displayed so that you can change the
name of DATA.TEST.LOAD.
3. An information panel for ABC.TEST.OBJECT is then presented and any
remaining unexecuted functions are placed in a pending state. After viewing the
information, you can:
■ Resume function code execution by entering the command SELECT NEXT.
The next function (like attach ABC.TEST.LOAD) will be performed.
■ Terminate execution by entering SELECT PREV (to return to the Selection
List) or SELECT MENU (to return to the Data Set Facility menu). In either
case, any unexecuted functions are ignored.
4. Finally, the data set ABC.TEST.LOAD is displayed.
Note that all function codes are evaluated before any one is executed. If an invalid or
incomplete function is specified, the PG functions are placed in a pending state and a
message is displayed. To resume execution, you must either:
1. Correct the invalid/incomplete function, or
2. Remove it by typing a space over it.
If multiple function codes are specified and one of them is X, all of the other function
codes are ignored -- the Data Set Facility is immediately terminated.
The following example illustrates how the Selection List might appear after performing
the actions noted in “Data Set: Selection List Function Hierarchy Example” on
page 24-14.
7 8
>
> DSN() SCRL FULL COLS ====1 ===72 LINE ====1
....+....1....+....2....+....3....+....4....+....5....+....6..
==================================== T O P ===================
VOLSER UNIT DSNS DSCBS CONTG--CYL--AVAIL CONTG--TRK--AVAIL
STOR=1 673 288 1=17 2 2 116 2
DATA SET NAME STATUS ORG RFM BLKSZ LRECL
ABC.TEST.LOAD )ATTACH PO U 12288 1
ABC.TEST.OBJECT )INFO PO FB 8==
ABC.TEST1.LOAD
BASE.TEST.TESTLOAD )DELETE PO U 13=3=
DATA.TEST.LOAD )RENAME PO U 12288 1
EDU.TEST.OBJECT
U V
The more functions you perform through the same Selection List, the more completion
messages and information will be displayed. At any point, you can redisplay the
Selection List with the most current information (for example, the deleted entries
removed and renamed entries shown with their new names). To do this, enter the
command:
REFRESH
Chapter 24. Data Sets: Introducing the Data Set Facility 24-15
24.3 Using Data Set Facility Selection Lists
If you include the QUICK, SHORT or LONG operand with the REFRESH command,
you can designate the amount of information you want displayed. For example, to
redisplay an updated version of the Selection List shown in the previous figure without
any of the data set information, you would enter:
REFRESH QUICK
Chapter 25. Data Sets: Attaching a Data Set Object at the Terminal 25-1
25.1 Attaching a CA-Librarian Selection List
Depending on the data set object you are currently viewing, you can also display a
CA-Librarian Selection List by entering the command:
SELECT DIR
If the data set is not cataloged or is password-protected, you must include the
appropriate volume serial number and password, as in:
ATTACH DSN LIBR.SOURCE VOL STOR!2 PSWD MYPASS
You can also qualify the display to include only those entries that are associated with a
specific programmer, module type or language code. For example, to attach a Selection
List containing only the names of the modules associated with the programmer named
JONES, you would enter:
ATTACH DSN LIBR.TEST PGMR JONES
Finally, you can use wildcard characters to create a Selection List containing only
those modules that meet specific criteria. For example, if you enter:
ATTACH DSN LIBR.SOURCE(RO+)
the resulting Selection List will contain only those modules whose names begin with
RO. (The following table identifies the wildcard characters that can be used with
module names.)
If the data set is not cataloged or is password protected, you must enter the appropriate
information in the VOLUMES and/or PASSWORD fields, as illustrated in the
following example.
7 8
>
> DSN() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6....
DATA SET FACILITY
FUNCTION ===> A
Chapter 25. Data Sets: Attaching a Data Set Object at the Terminal 25-3
25.1 Attaching a CA-Librarian Selection List
7 >
8
> DSN() SCRL FULL COLS ====1 ===72 LINE ====1
....+....1....+....2....+....3....+....4....+....5....+....6.
=================================== T O P ===================
DATA SET NAME VOLSER MEMS ORG RECFM BLKSZ LRECL
TEST.LIBR.SOURCE STOR=1 24 PS F 4276 =
MEMBER STATUS PSWD LAST-MODIFIED DESCRIPTION CREATED
AMODULE 8212=1112338 FIRST MODULE 12/
BMODULE 8412=8==45=4 SECOND MODULE =8/
CMODULE 86=4=22=1218 THIRD MODULE =7/
DMODULE 85=5=1233==5 1=/
You can use this Selection List to perform one or more of the following functions:
A - Attach a module
C - Copy a module
D - Delete a module
G - Get module attributes
H - Attach module history
P - Print a module
R - Rename a module
X - Terminate Data Set Facility
* - Position Selection List
To perform one or more of these functions, type the appropriate code(s) in the first
area shown in “Data Set: CA-Librarian Selection List.” With Copy, Print and
Rename, you must provide additional information in the STATUS field. (See the
appropriate section in Chapter 27, “Data Sets: Performing Data Management Tasks”
for details.) After performing the function, the STATUS field will indicate the result
of each operation.
The amount of information provided through the Selection List exceeds the width of
80-column screens. The information is, therefore, divided into alternate displays. You
can change the display to view the different information by entering:
SELECT ALT [v]
where v is the number of the display to be viewed next. If you omit the number, you
will proceed sequentially through all of the different displays.
The ALT field in the following table contains the number of the alternate display in
which each field appears on an 80-column screen. If you are using a terminal
supporting a wider screen, additional displays (containing variations of the same
information) are available.
The extent of information shown when the Selection List is initially displayed depends
on whether you requested a QUICK, SHORT or LONG display format. The following
table lists all of the information that can be provided and identifies the display format
with which it is associated (Q for QUICK, S for SHORT and L for LONG).
If the list is produced with the QUICK or SHORT display format, you can use the G
(Get Attributes) code to fill-in the fields for one or more modules.
The first two lines in the Execution Area (following the TOP marker) remain constant
as you scroll through the list and provide the following information:
DATA SET NAME Name of the CA-Librarian master file about which information
was requested.
VOLSER Serial number of the volume on which the data set resides.
MEMS Number of modules in the master file.
ORG Data set organization.
RECFM Record format.
BLKSZ Block size of the file.
LRECL Logical record length.
The remaining fields identify the modules comprising a CA-Librarian master file and
include the information shown in the following table.
Chapter 25. Data Sets: Attaching a Data Set Object at the Terminal 25-5
25.1 Attaching a CA-Librarian Selection List
Depending on the current data set object, you can display a Catalog Selection List by
entering the command:
SELECT CAT
SELECT CAT cannot be used if you are currently viewing a CA-Librarian or PDS
Selection List for which a Catalog Selection List was not previously requested.
Chapter 25. Data Sets: Attaching a Data Set Object at the Terminal 25-7
25.2 Attaching a Catalog Selection List
7 8
>
> DSN() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6.
DATA SET FACILITY
FUNCTION ===> A
7 >
8
> DSN() SCRL FULL COLS ====1 ===72 LINE ====1
....+....1....+....2....+....3....+....4....+....5....+....6.
=================================== T O P ===================
SEARCH ARGUMENT MATCHES CATALOG NAME TYPE
TEST.Q.MACLIB 6 CATALOG.UMUROS1 ICF
DATA SET NAME STATUS TYPE VOLUME DEVICE
TEST.AA.MACLIB NONVSAM STOR=2 33
TEST.BA.MACLIB ALIAS
TEST.CC.MACLIB SQ====1 ROOG=4 34
TEST.DDD.MACLIB NONVSAM STOR=2 33
You can use this Selection List to perform the following functions:
A Attach a data set
AL Allocate a data set
AM Allocate an SMS-managed data set
C Copy a data set
CM Compress a PDS
CT Catalog a data set
D Delete a data set
DA Define an alias
DG Define a GDG
DX Delete members of PDS; keep the data set
G Get data set attributes
I Display data set information
P Print a data set
R Rename a data set
RL Release space
UC Uncatalog a data set
X Terminate Data Set Facility
* Position Selection List
To perform one or more of these functions, type the appropriate code(s) in the first
area shown in the previous example. With Copy and Print, you must provide
additional information in the STATUS field. (See the appropriate section in
Chapter 27, “Data Sets: Performing Data Management Tasks” on page 27-1 for
details.) After performing the function, the STATUS field will indicate the result of
each operation.
Chapter 25. Data Sets: Attaching a Data Set Object at the Terminal 25-9
25.2 Attaching a Catalog Selection List
The amount of information provided through the 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 by entering:
SELECT ALT [v]
where v is the number of the display to be viewed next. If you omit the number, you
will proceed sequentially through all of the different displays.
The ALT field in the following table contains the number of the alternate display in
which each field appears on an 80-column screen. If you are using a terminal
supporting a wider screen, additional displays (containing variations of the same
information) are available.
The extent of information shown when the Selection List is initially displayed depends
on whether you requested a QUICK, SHORT or LONG display format. The following
table lists all of the information that can be provided and identifies the display format
with which it is associated (Q for QUICK, S for SHORT and L for LONG).
If the list was produced with the QUICK or SHORT display format, you can use the G
(Get Attributes) code to fill-in the fields for one or more partitioned data sets.
The first two lines in the Execution Area (following the TOP marker) remain constant
as you scroll through the list and show:
SEARCH ARGUMENT
Name of the data set you specified through the ATTACH DSN command
or the Data Set Facility menu.
MATCHES
Number of data set names that matched the specified data set criteria.
CATALOG NAME
Name of the catalog(s) in which the data sets are cataloged. (This field
contains *MULTIPLE CATALOGS* if the data sets in the List are
cataloged in more than one catalog.)
TYPE The type of catalog(s) searched. The types are:
CVOL Control volume.
ICF Integrated catalog facility.
VSAM VSAM user catalog.
N/A More than one catalog and they are different types.
The remaining fields identify the data sets comprising the catalog and include the
information shown in below.
Chapter 25. Data Sets: Attaching a Data Set Object at the Terminal 25-11
25.2 Attaching a Catalog Selection List
Notes:
■ The STATUS field is not displayed when the CREDT, REFDT and EXTDT are
displayed.
■ The fields STORCLAS, DATACLAS, MGMTCLAS, and DTYP are displayed
only when the IBM DFSMS is installed at the site.
Chapter 25. Data Sets: Attaching a Data Set Object at the Terminal 25-13
25.3 Attaching a Generation Data Group Data Set
or, use the Data Set Facility menu, as illustrated in the example below.
7 >
8
> DSN() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6.
DATA SET FACILITY
FUNCTION ===> A
When GDG is attached, the data are presented in a format similar to the one shown in
the following example.
7 8
>
> DSN() SCRL FULL COLS ====7 ===78 LINE =====1
> TEST.GENSET(G===1V==)
> ...1....+....2....+....3....+....4....+....5....+....
...... ============================= T O P =================
=====1 IDENTIFICATION DIVISION.
=====2 PROGRAM-ID. INVREPT.
=====3 ENVIRONMENT DIVISION.
=====4 CONFIGURATION SECTION.
=====5 SOURCE-COMPUTER. IBM-3=81.
=====6 OBJECT-COMPUTER. IBM-3=81.
The System Information Line begins with DSN(). Immediately below is the name of
the attached data set. (As illustrated in preceding example, when a PDS member or
CA-Librarian module is attached, its name is included with the data set name.)
The right side of the System Information Line shows the number of the first line in the
current display. This is to assist you in keeping track of where you are as you scroll
forward and backward through the data.
The attached data are delimited by a top (==TOP==) and bottom (==BOTTOM==)
marker. You can position the display by using primary commands or one of the PF
keys to which scrolling functions are assigned.
When a CA-Librarian module is attached, you can bounce the display between the
source code and module history records by entering:
SELECT ALT
If the member/module is on a data set that is not cataloged, you must specify the serial
number of the volume on which the data set resides, as in:
ATTACH DSN TEST.SOURCE(INVREPT) VOL SHR=7
If you are working with CA-Librarian master files, you can qualify the information
that is to be displayed. For example, you can specify which archive level of the
module you want attached, as in:
ATTACH DSN TEST.LIBR(MOD1) ARC -3
If you do not specify an archive level, the most current level of the module is attached.
By default, the display begins with the first line in the member/module. You can use
the LINE operand to begin the display with a specific line, as in:
ATTACH DSN TEST.SOURCE(INVREPT) LINE 12==
Chapter 25. Data Sets: Attaching a Data Set Object at the Terminal 25-15
25.4 Attaching a PDS Member/CA-Librarian Module
As illustrated in the following example, if the data set containing the member/module
is not cataloged, you must also include the serial number of the volume on which the
data set resides in the VOLUMES field.
7 >
8
> DSN() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6.
DATA SET FACILITY
FUNCTION ===> A
As with the primary command, you can qualify the information you want displayed.
The following example illustrates how you can display the third archive level of the
CA-Librarian module MOD1 on TEST.LIBR.
7 >
8
> DSN() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6.
DATA SET FACILITY
FUNCTION ===> A
If you do not specify an archive level, the most current level of the module is attached.
7 >
8
> DSN() SCRL FULL COLS ====1 ===72 LINE ====1
....+....1....+....2....+....3....+....4....+....5....+....6.
=================================== T O P ===================
DATA SET NAME VOLSER MEMS ORG RECFM BLKSZ LRECL
TEST.SOURCE STOR=1 4 PO FB 16== 8=
MEMBER STATUS VV.MM CREATED LAST-MODIFIED SIZE INIT MOD
INVIN =1.== =4/29/85 =4/29/85 14:41 36 36 =
A INVREPT
PAY52
TEST1 =1.== 11/=5/84 11/=5/84 11:42 2 2 =
7 >
8
> DSN() SCRL FULL COLS ====7 ===78 LINE =====1
> TEST.SOURCE(INVREPT)
> ...1....+....2....+....3....+....4....+....5....+....
...... ============================= T O P =================
=====1 IDENTIFICATION DIVISION.
=====2 PROGRAM-ID. INVREPT.
=====3 ENVIRONMENT DIVISION.
=====4 CONFIGURATION SECTION.
=====5 SOURCE-COMPUTER. IBM-3=81.
=====6 OBJECT-COMPUTER. IBM-3=81.
The System Information Line begins with DSN(). Immediately below is the name of
the attached data set and member/module name.
The right side of the System Information Line shows the number of the first line in the
current display. This is to assist you in keeping track of where you are as you scroll
forward and backward through the data.
The attached data are delimited by a top (==TOP==) and bottom (==BOTTOM==)
marker. You can position the display by using primary commands or the PF keys to
which scrolling functions are assigned.
Chapter 25. Data Sets: Attaching a Data Set Object at the Terminal 25-17
25.5 Attaching a PDS Selection List
Depending on the data set object you are currently viewing, you can also display a
PDS Selection List by entering the command:
SELECT DIR
If the data set is not cataloged or is password-protected, you must include the
appropriate volume serial number and password, as in:
ATTACH DSN TEST.SOURCE VOL STOR=2 PSWD MYPASS
You can also use wildcard characters to create a Selection List containing only those
members that meet specific criteria. For example, if you enter:
ATTACH DSN TEST.SOURCE(RO+)
the resulting Selection List will contain only those members whose names begin with
RO. (The following table identifies the wildcard characters that can be used with
member names.)
If the data set is not cataloged or is password protected, you must enter the appropriate
information in the VOLUMES and/or PASSWORD fields, as illustrated below.
7 >
8
> DSN() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6....
DATA SET FACILITY
FUNCTION ===> A
Chapter 25. Data Sets: Attaching a Data Set Object at the Terminal 25-19
25.5 Attaching a PDS Selection List
The following example illustrates the type of Selection List displayed when you
request information about a data set that contains a load library.
7 >
8
> DSN() SCRL FULL COLS ====1 ===72 LINE ====1
....+....1....+....2....+....3....+....4....+....5....+....6.
=================================== T O P ===================
DATA SET NAME VOLSER MEMS ORG RECFM BLKSZ LRECL
TEST.LOAD STOR=5 14 PO U 12288 12288
MEMBER STATUS --------------- ATTRIBUTES --------------
DOIT1 RENT REUS
DOIT2 RENT REUS
DOIT3 RENT REUS REFR AM=31 RM
DOIT4 RENT REUS REFR AC=1
You can use this Selection List to perform one or more of the following functions:
A Attach a member
C Copy a member
D Delete a member
DA Define an alias
G Get attributes
P Print a member
R Rename a member
X Terminate Data Set Facility
* Position Selection List
To perform one or more of these functions, type the appropriate code(s) in the first
area shown in the previous example. With Copy, Print and Rename, you must provide
additional information in the STATUS field. (See the appropriate section in
Chapter 27, “Data Sets: Performing Data Management Tasks” on page 27-1 for
details.) After performing the function, the STATUS field will indicate the result of
each operation.
The amount of information provided through the 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 by entering:
SELECT ALT [v]
where v is the number of the display to be viewed next. If you omit the number, you
will proceed sequentially through all of the different displays.
The ALT field in the following table contains the number of the alternate display in
which each field appears on an 80-column screen. If you are using a terminal
supporting a wider screen, additional displays (containing variations of the same
information) are available.
The display format setting (QUICK, SHORT or LONG) is ignored when a PDS
Selection List is displayed. The Selection List contains all available information.
The first two lines in the Execution Area (following the TOP marker) remain constant
as you scroll through the directory. The information includes:
DATA SET NAME Name of the data set about which information was requested.
VOLSER Serial number of the volume on which the first resides.
MEMS Number of members comprising the data set.
ORG Data set organization of the file.
RECFM Record format of the file.
BLKSZ Block size of the file.
LRECL Logical record length of the file.
The remaining fields identify the members comprising the data set and include the
information shown in the following table.
Chapter 25. Data Sets: Attaching a Data Set Object at the Terminal 25-21
25.5 Attaching a PDS Selection List
The following example illustrates the type of Selection List displayed when you
specify a data set which contains a source, macro, procedure or object library.
7 >
8
> DSN() SCRL FULL COLS ====1 ===72 LINE ====1
....+....1....+....2....+....3....+....4....+....5....+....6.
=================================== T O P ===================
DATA SET NAME VOLSER MEMS ORG RECFM BLKSZ LRECL
TEST.SOURCE STOR=1 12 PO FB 16== 8=
MEMBER STATUS VV.MM CREATED LAST-MODIFIED SIZE INIT MOD
INVIN =1.== =4/29/85 =4/29/85 14:41 36 36
INVREPT
TEST1 =1.== 11/=5/84 11/=5/84 11:42 2 2
TEST2 =1.13 =1/=9/85 =1/23/85 16:28 5 4
WORK=
WORK1 =1.=1 =2/2=/85 =5/1=/85 =7:38 51 51
WORK2 =1.== =2/2=/85 =2/2=/85 =8:45 41 41
You can use this Selection List to perform one or more of the following functions:
A Attach a member
C Copy a member
D Delete a member
DA Define an alias
| E Edit a member
G Get attributes
P Print a member
R Rename a member
| SU Submit a member
X Terminate Data Set Facility
* Position Selection List
To perform one or more of these functions, type the appropriate code(s) in the first
area shown in the previous example. With Copy, Print and Rename, you must provide
additional information in the STATUS field. (See the appropriate section in
Chapter 27, “Data Sets: Performing Data Management Tasks” on page 27-1 for
details.) After performing the function, the STATUS field will indicate the result of
each operation.
Chapter 25. Data Sets: Attaching a Data Set Object at the Terminal 25-23
25.5 Attaching a PDS Selection List
The amount of information provided through the 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 by entering:
SELECT ALT [v]
where v is the number of the display to be viewed next. If you omit the number, you
will proceed sequentially through all of the different displays.
The ALT field in the following table contains the number of the alternate displays in
which each field appears on an 80-column screen. If you are using a terminal
supporting a wider screen, additional displays (containing variations of the same
information) are available.
The display format setting (QUICK, SHORT or LONG) is ignored when a PDS
Selection List is displayed. The Selection List contains all available information.
The first two lines in the Execution Area (following the TOP marker) remain constant
as you scroll through the directory and show:
DATA SET NAME Name of the data set about which information was requested.
VOLSER Serial number of the volume on which the file resides.
MEMS Number of members comprising the data set.
ORG Data set organization of the file.
RECFM Record format of the file.
BLKSZ Block size of the file.
LRECL Logical record length of the file.
The remaining fields identify the members comprising the data set and include the
information shown in the following table.
Chapter 25. Data Sets: Attaching a Data Set Object at the Terminal 25-25
25.6 Attaching a Sequential Data Set
If the data set is not cataloged, you must specify the serial number of the volume on
which it resides. For example, if TEST.MASTER is not cataloged and resides on
volume SHR07, you could attach it by entering:
ATTACH DSN TEST.MASTER VOLUME SHR=7
By default, the display begins with the first line of the data set. You can use the LINE
operand to begin the display with a specific line, as in:
ATTACH DSN TEST.MASTER LINE 2==
7 >
8
> DSN() SCRL FULL COLS ====1.===72
....+....1....+....2....+....3....+....4....+....5....+....6.
DATA SET FACILITY
FUNCTION ===> A
7 >
8
> DSN() SCRL FULL COLS ====1.===72 LINE ====1
....+....1....+....2....+....3....+....4....+....5....+....6.
==================================== T O P ===================
VOLSER UNIT DSNS DSCBS CONTG--CYL--AVAIL CONTG--TRK--AVAIL
STOR=1. 673 288 1=17 2 2 116 2
DATA SET NAME STATUS ORG RFM BLKSZ LRECL
ABC.TEST.ASM PO FB 8= 8=
A ABC.TEST.LOAD PO U 12288 12288
ABC.TEST.OBJECT PO FB 8== 8=
7> 8
> DSN() SCRL FULL COLS ====7 ===78 LINE =====1
> TEST.SOURCE
> ...1....+....2....+....3....+....4....+....5....+....
...... ============================= T O P =================
=====1 IDENTIFICATION DIVISION.
=====2 PROGRAM-ID. INVREPT.
=====3 ENVIRONMENT DIVISION.
=====4 CONFIGURATION SECTION.
=====5 SOURCE-COMPUTER. IBM-3=81.
=====6 OBJECT-COMPUTER. IBM-3=81.
The System Information Line begins with DSN(). Immediately below is the name of
the attached data set. The right side of the System Information Line shows the
number of the first line in the current display. This is to assist you in keeping track of
where you are as you scroll forward and backward through the data.
The attached data are delimited by a top (==TOP==) and bottom (==BOTTOM==)
marker. You can position the display by using primary commands or the PF keys to
which scrolling functions are assigned.
Chapter 25. Data Sets: Attaching a Data Set Object at the Terminal 25-27
25.7 Attaching a Volume Selection List
If you are currently viewing a data set object, you can display a previously created
Volume Selection List by entering the command:
SELECT VOL
You can also combine these qualifiers within a single execution. For example, to
produce a Selection List containing all volumes beginning with STOR that reside on
3380s and are defined as private or public, you would enter:
ATTACH VOL STOR+ UNIT 338= TYPE PRIVATE PUBLIC
The following example shows how you can use the wildcard characters shown in
previous table to request information about all volumes beginning with STOR that
reside on 3380s and are defined as private.
7 >
8
> DSN() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6.
DATA SET FACILITY
FUNCTION ===> A
Chapter 25. Data Sets: Attaching a Data Set Object at the Terminal 25-29
25.7 Attaching a Volume Selection List
7 >
8
> DSN() SCRL FULL COLS ====1 ===72 LINE ====1
....+....1....+....2....+....3....+....4....+....5....+....6..
==================================== T O P ===================
VOLUME UNIT TYPE MATCHES
STOR+ 338= ALL 2
VOLUME STATUS UNIT DEVTYPE INDEX SMS DEVSTAT VOLSTAT
STOR=1 4=1 338= ACTIVE NO A PRIV/R
STOR=2 4== 338= ACTIVE NO A PRIV/R
You can use this Selection List to perform one or more of the following functions:
A Attach volume's VTOC
C Copy VTOC of volume
G Get volume information
I Display volume information
P Print VTOC of volume
X Terminate Data Set Facility
* Position Selection List
To perform one or more of these functions, type the appropriate code in the first area
shown in the previous example. With Copy and Print, you must provide additional
information in the STATUS field. (See the appropriate section in Chapter 27, “Data
Sets: Performing Data Management Tasks” on page 27-1 for details.) After
performing the function, the STATUS field will indicate the result of each operation.
The amount of information provided through the 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 by entering:
SELECT ALT [v]
where v is the number of the display to be viewed next. If you omit the number, you
will proceed sequentially through all of the different displays.
The ALT field in the following table contains the number of the alternate display in
which each field appears on an 80-column screen. If you are using a terminal
supporting a wider screen, additional displays (containing variations of the same
information) are available.
The extent of information shown when the Selection List is initially displayed depends
on whether you requested a QUICK, SHORT or LONG display format. The following
table lists all of the information that can be provided, and identifies the display format
with which it is associated (Q for QUICK, S for SHORT and L for LONG).
If the list was produced with the QUICK or SHORT display format, you can use the G
(Get Information) code to fill-in the fields for one or more volumes.
The first two lines in the Execution Area (following the TOP marker) remain constant
as you scroll through the display and show:
VOLUME Search string (including wildcard characters) used to build the Selection
List.
UNIT Unit type used to build the Selection List.
TYPE Device type used to build the Selection List, shown as ALL or
PRIVATE, PUBLIC and/or STORAGE.
MATCHES Number of volume matching the selection criteria.
The remaining fields identify the data sets on the volume and include the information
shown below.
Chapter 25. Data Sets: Attaching a Data Set Object at the Terminal 25-31
25.7 Attaching a Volume Selection List
If you are currently viewing a data set object, you can display a previously created
VTOC Selection List by entering the command:
SELECT VTOC
Using the wildcard characters shown in the following table, you can qualify the
displayed information. For example, to create a Selection List containing only those
data sets starting with TEST and ending with SOURCE on STOR02, you would enter:
ATTACH DSN TEST.QQ.SOURCE VOLUME STOR=2
Chapter 25. Data Sets: Attaching a Data Set Object at the Terminal 25-33
25.8 Attaching a VTOC Selection List
The following example illustrates how you might request information about the data
sets on STOR01.
7 >
8
> DSN() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6.
DATA SET FACILITY
FUNCTION ===> A
7 >
8
> DSN() SCRL FULL COLS ====1 ===72 LINE ====1
....+....1....+....2....+....3....+....4....+....5....+....6.
==================================== T O P ===================
VOLSER UNIT DSNS DSCBS CONTG--CYL--AVAIL CONTG--TRK--AVAIL
STOR=1 673 288 1=17 2 2 116 2
DATA SET NAME STATUS ORG RFM BLKSZ LRECL
ABC.TEST.ASM PO FB 8=
ABC.TEST.LOAD PO U 12288 1
BASE.TEST.TESTLOAD PO U 13=3=
DATA.TEST.LOAD PO U 12288 1
You can use this Selection List to perform one or more of the following functions:
A Attach a data set
AL Allocate a new data set
AM Allocate an SMS-managed data set
C Copy a data set
CM Compress a PDS
CT Catalog a data set
D Delete a data set
DA Define an alias
DX Delete member of PDS; keep the data set
G Get attributes
I Display data set information
P Print a data set
R Rename a data set
RL Release space
UC Uncatalog a data set
X Terminate Data Set Facility
* Position Selection List
To perform one or more of these functions, type the appropriate code in the first area
shown in the previous example. With Copy, Print and Rename, you must provide
additional information in the STATUS field. (See the appropriate section in
Chapter 27, “Data Sets: Performing Data Management Tasks” on page 27-1 for
details.) After performing the function, the STATUS field will indicate the result of
each operation.
Chapter 25. Data Sets: Attaching a Data Set Object at the Terminal 25-35
25.8 Attaching a VTOC Selection List
The amount of information provided through the 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 by entering:
SELECT ALT [v]
where v is the number of the display to be viewed next. If you omit the number, you
will proceed sequentially through all of the different displays.
The ALT field in the following table contains the number of the alternate display in
which each field appears on an 80-column screen. If you are using a terminal
supporting a wider screen, additional displays (containing variations of the same
information) are available.
The extent of information shown when the Selection List is initially displayed depends
on whether you requested a QUICK, SHORT or LONG display format. The following
table lists all of the information that can be provided and identifies the display format
with which it is associated (Q for QUICK, S for SHORT and L for LONG).
If the list was produced with the QUICK or SHORT display format, you can use the G
(Get Attributes) code to fill-in the fields for one or more partitioned data sets.
The first two lines in the Execution Area (following the TOP marker) remain constant
as you scroll through the display and show:
VOLSER Serial number of the volume.
UNIT Unit address associated with the device on which the volume is
mounted.
DSNS Number of data sets on the volume.
DSCBS Number of available DSCBs on the volume.
CYL Total number of contiguous free (available) cylinders and the total
number of free cylinders.
TRK Total number of free (available) tracks and maximum number of
contiguous free tracks.
MATCHES Number of data sets on the designated volume.
The remaining fields identify the data sets on the volume and include the information
shown in the following table.
The STATUS field is not displayed when the fields CREDT, REFDT and EXTDT are
displayed.
Chapter 25. Data Sets: Attaching a Data Set Object at the Terminal 25-37
25.9 Selecting the Display
SELECT string The resulting display depends on the string you specify. If the
string contains:
■ A period (like TEST.ABC), it is treated as a data set name. If
the data set appeared on a previously displayed Catalog or
VTOC Selection List, the appropriate list is displayed. If it
did not appear in any previous Selection List and a:
1. Catalog Selection List was previously displayed, the
catalog is searched for the data set, or
2. VTOC Selection List was previously displayed, the
VTOC is searched for the data set.
■ More than six characters, it is treated as a PDS member or
CA-Librarian module name. If the member/module did not
appear in a previous Selection List, the current
PDS/CA-Librarian master file is searched for the designated
member/module.
■ Six or less characters, the name is treated as:
1. A member/module if a PDS or CA-Librarian Selection
List was previously displayed.
2. A volume serial number if a PDS or CA-Librarian
Selection List was not previously displayed.
The appropriate Selection List is then displayed.
SELECT VOL To redisplay a previously displayed Volume Selection List.
SELECT VTOC To display a VTOC Selection List.
Depending on the current display, it will either be the previously
displayed Selection List or the Selection List representing the
contents of the volume on which the data set you are currently
viewing resides.
Chapter 25. Data Sets: Attaching a Data Set Object at the Terminal 25-39
25-40 CA-Roscoe 6.0 User Guide
Chapter 26. Data Sets: Browsing Data Set Objects
The Data Set Facility is also detached by entering the function code X on the menu,
any function panel or any selection list. This function code is comparable to the
DETACH DSN command. (If you enter X on a Selection List that includes other
function codes, those functions will be ignored.)
ATTACHing another data set object causes the current data set object to be implicitly
detached. If you are detaching a sequential data set, PDS member or CA-Librarian
module and you have assigned NOTE names, those names are deleted when the data
are detached.
If you execute a command that causes output to the Execution Area (like ATTACHing
an AWS) or if you press the CLEAR key, the Data Set Facility is placed in a pending
state and can be reattached at any time.
While this description assumes you are locating strings that are in character format,
you can also locate the hexadecimal representation of a string. See 26.2.3,
“Customizing the Operation” on page 26-5 for details.
The first occurrence of the string DIVISION in the member/module INVLIST will be
the first line of the resulting display.
To find the last occurrence of the same string, all you need enter is:
LAST
Once you have specified a search string, it is remembered and used with any
subsequent EXCL, FIRST, INCL, LAST, NEXT or PREV command that does not
include a string.
By default, the full line length is searched for your string. You can include column
numbers with the command to qualify the search for a single operation. For example:
NEXT 1= 3= SAMPLE
examines columns 10 through 30 for the next occurrence of SAMPLE. After the
command executes, the defaults are reestablished. To change the column boundaries
for the remainder of your session, use the SET BOUNDS command. (See Chapter 4,
“Defining Column Boundaries” for additional information.)
Also, by default, every line in the data set object is searched until it finds the string or
reaches the site-defined maximum. You can limit the search to a specific number of
lines by specifying the number after the string. For example, to find the last
occurrence of SAMPLE within the last 200 lines of currently displayed data set object,
you would enter:
After the command executes, the site-defined value is reestablished. If you want to
continue searching 200 lines at a time, you can either:
■ Press PF6 or PF18 to reexecute the last command, or
■ Use the SET DSNCNT command to alter the line limit for the rest of your session
or until you change it with another SET DSNCNT command. (See the description
of SET DSNCNT in the CA-Roscoe Command Reference Guide.)
If you do not specify a number, a site-defined maximum number of lines are searched.
(You can use the SET DSNCNT command to establish your own search limits. See the
CA-Roscoe Command Reference Guide for details.)
You can also limit the search for the character string to particular columns. For
example, if you want to display every line that does not contain the string
TEST-DATA in columns 30 through 80, you would enter:
EXCL 3= 8= TEST-DATA
Note: Column boundaries specified with the command affect only the execution of
that command. See Chapter 4, “Defining Column Boundaries” for information
about changing boundaries for the terminal session.
If the number of lines to be displayed exceeds the size of your terminal screen, press
one of the PF keys to which a scrolling function is assigned. The INCL or EXCL
operation will resume scanning for the previously specified string (like TEST-DATA).
The direction of the scan depends on the value assigned to the PF key. (The search
string is remembered for subsequent use; column number limits and line number limits
apply only to the command with which they are specified.)
If you determine that you want to see the data that follows a particular line, use:
■ The cursor positioning keys to move the cursor to the appropriate line and then
press the ENTER key, or
■ The POINT command. For example, if an EXCL display includes line 150 and
you want to display the lines following it, you would enter:
POINT LINE 15=
The resulting display will begin with line 150.
Doing either of these actions or entering any primary command terminates the
INCL/EXCL operation.
Note: When you create an INCL/EXCL display from a Selection List, you can enter
any function code(s). If a function results in another display (like attaching an
entry in the list), the INCL/EXCL operation is terminated.
The current setting of the SET MODE command determines how the string specified
with FIRST, NEXT, LAST, PREV, INCL or EXCL is to be treated. See Chapter 3,
“Controlling Character Recognition” for additional information.
In all of the examples used thus far, the search string has not been delimited. With
these commands, you only need to delimit the string when it:
■ Includes a space (like FIRST /TEST DATA/),
■ Is a numeric (like NEXT /519/), or
■ Is the same as a keyword operand or operand abbreviation of the command (like
INCL /JOB/).
By default, the search is for any string of characters that match the search string. To
limit the search operation, you can include the qualifier operands. These operands are
WORD, PREFIX, BEGIN, EMBED, END and SUFFIX.
For example, assume the attached data set object contains the line:
'THE OTHER BROTHER ATE THEIR APPLE DURING THE CONTEST'
and you want to search for the string THE. Without qualification, the words THE,
BROTHER and THEIR match the search string. By including a qualifier, you can
designate the type of string match that is to occur, as in:
THE WORD Qualifies the string as a word; only THE matches.
THE PREFIX Qualifies the string as beginning a word; only THEIR matches.
THE BEGIN Qualifies the string as beginning or being a word; THE and THEIR
match.
THE EMBED Qualifies the string as contained within a word; OTHER and
BROTHER match.
TEST END Qualifies the string as ending or being a word; only CONTEST
matches.
TEST SUFFIX Qualifies the string as ending a word; only CONTEST matches.
where the string is bound by apostrophes and contains an even number of characters,
as in:
FIRST X'C1'
When using the primary commands FIRST, LAST, NEXT, PREV, INCL or EXCL,
you do not need to delimit the hexadecimal string.
If a line containing (or not containing) the search string is found, it becomes the first
displayed line of the resulting display. By specifying a screen positioning operand with
the command, you can control how the display is positioned. The screen positioning
operands are:
CJUSTIFIED The display margins are to be altered if the entire matching string
does not fall within the current margin. (This is the default
positioning.)
JUSTIFIED The display margins are always to be altered so that the first
character of the string begins in the left-most position of the line.
CENTERED The display margins are to be altered to center the matching string
on the line. If centering would cause an invalid left margin (for
example, less than 1), the display is not altered.
LOCKED The display margins are not to be altered even if the matching string
occurs to the left or right of the current margins.
When browsing a Selection List, entering an * (asterisk) in the first unprotected field
for a specific entry repositions the display to begin with that entry.
To assign a name to a line that is not the first displayed line, qualify the asterisk. For
example, to assign the name LOC2 to the line that is five lines after the first displayed
line, you would enter:
NOTE Q+5 LOC2
Once you have assigned a name to a specific line, you can return to that line at any
time by using the POINT command. To return to the line noted as LOC1, you would
enter:
POINT LOC1
If you determine that you no longer need to note a specific line, you can eliminate the
NOTE name with the DROP command, as in:
DROP LOC2
Any outstanding NOTE names are automatically deleted when you detach the data,
attach another data set or go to a higher level (for example, if you display a PDS
Selection List after viewing a member of that PDS).
7 ATTACH_
8
>
> DSN() SCRL FULL COLS ====7 ===72 LINE ==1
> TEST.SOURCE(INVREPT)
> ...1....+....2....+....3....+....4....+....5....+
...... ============================== T O P ============
=====1 IDENTIFICATION DIVISION.
=====2 PROGRAM-ID. INVREPT.
=====3 ENVIRONMENT DIVISION.
7 ATTACH DSN )
8
> D PENDING
> AWS (PRI.INVREPT) SCRL FULL COLS ====7 ===72
> ...1....+....2....+....3....+....4....+....5....
...... ======================== T O P =================
===1== IDENTIFICATION DIVISION.
===2== PROGRAM-ID. INVREPT.
===3== ENVIRONMENT DIVISION.
7 >
8
> DSN() SCRL FULL COLS ====7 ===72 LINE ==1
> TEST.SOURCE(INVREPT)
> ...1....+....2....+....3....+....4....+....5....+
...... ============================= T O P =============
=====1 IDENTIFICATION DIVISION.
=====2 PROGRAM-ID. INVREPT.
=====3 ENVIRONMENT DIVISION.
The center screen in previous example shows D PENDING. This note is provided to
remind you that the Data Set Facility can be reattached at any time.
When you reattach the Data Set Facility, the display begins with the first line of the
previous display. To reattach at a different location within the same data set object,
you can:
■ Use the LINE operand of ATTACH to specify the desired line number, as in:
ATTACH DSN Q LINE 5==
■ Use the POINT command to begin the display with the line assigned a NOTE
name, as in:
POINT DSN NAME1
■ Use the DSN operand with the FIRST, NEXT, LAST and PREV commands to
begin the display with the line containing a specific string, as in:
FIRST DSN /DD/
■ Use the DSN operand with the INCL or EXCL command to begin the display
with a list of lines containing (or not containing) a specific string, as in:
INCL DSN /DD/
This chapter describes how you can perform the following functions at any time during
your terminal session:
■ Allocating a data set.
■ Cataloging a data set.
■ Compressing a partitioned data set.
■ Copying a data set object into an AWS.
■ Defining an alias for:
1. a non-VSAM data set or ICF/VSAM user catalog, or
2. member of a partitioned data set.
■ Defining a Generation Data Group.
■ Deleting a data set, PDS member or CA-Librarian module.
■ Inquiring about a specific data set or volume.
■ Printing a data set object.
■ Renaming a data set, PDS member or CA-Librarian module.
■ Uncataloging a data set.
■ Writing to a data set.
These functions can be performed using primary commands, the Data Set Facility
menu or the appropriate Selection List.
If the attributes, space requirements, or device location for your new data set are
similar to those of an existing data set, you can use the LIKE operand to establish the
existing data set as a model for the new one. For example:
ALLOCATE DSN TEST.NEW VOLUME STOR=2 LIKE TEST.OLD
uses the attributes, space parameters and device location of the existing data
(TEST.LOAD) as the model in allocating the new data set (TEST.NEW).
■ You can also allocate certain types of VSAM data sets if the proper modeling
information is established in the DFSMS data classes. For example, assume that
the DFSMS data class CLUSTER contains the required information to allocate a
more commonly used type of VSAM key-sequenced data set. You can allocate
such a cluster with:
ALLOCATE DSN VSAM.CLUSTER DATACLAS CLUSTER KEYOFF 64 ...
Note that in this example, the KEYOFF operand is used to either override
information in the data class definition or to provide information that is not
present in it.
You can then verify the data set name and add or change the appropriate information.
When you press the ENTER key, the data set will be allocated using the values
displayed.
The following example assumes you entered the AL function code and that you want
to allocate a new data set with the same attributes as an existing data set named
TEST.OLD. Once the information is displayed, you can change the data set name and
make any other necessary attribute changes. When you press the ENTER key, the
allocation is performed.
The following example illustrates the panel displayed when you use the AL function
code.
7 >
8
> DSN() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....
ALLOCATE NEW DATA SET
DSORG ===> PO
RECFM ===> FB
LRECL ===> 8=
BLKSIZE ===> 352=
KEYLEN ===>
EXPDT ===> (MM/DD/YY)
CATALOG ===> YES (Y,N)
U V
The fields comprising this panel include:
DATA SET Enter the one- to 44-character fully qualified name of the data set to
be allocated. The name may be further qualified with:
+v Relative generation number of GDG data set to be
allocated, specified as a value between 1 and 255.
VOLUMES Enter the one- to six-character serial number of the volume on which
the data set is to be allocated. One to six serial numbers can be
specified.
■ If both VOLUMES and UNIT NAMES are specified and the
volume is mounted, UNIT NAMES is ignored. If the volume is
not mounted and the unit name refers to a mass storage device,
an MSS mount is attempted.
■ If UNIT NAMES is specified and VOLUMES is omitted, only
those volumes within the designated generic or esoteric group
that have a Use attribute of STORAGE are eligible for
allocation.
KEYLEN Enter the data set key length as a value between 0 and 255. If
omitted, the default is 0.
EXPDT Enter the data set expiration date in the form consistent with the
format displayed on the panel. (This format is established by the
SET DATEFORM command.)
If the year is specified with two digits, it is assumed to represent a
year in the twentieth century. Years beyond 1999 can only be
specified at sites with MVS/XA SP2.2.0 or higher. At such sites, the
year must not exceed 2155.
If omitted, the data set has no expiration date.
CATALOG Designates whether the data set is to be cataloged by entering either:
YES Catalog the data set.
If the data set cannot be cataloged (that is, it is already
cataloged or you have insufficient access authority for
the catalog), the command is rejected. Reexecute the
command, specifying NO.
NO Do not catalog the data set.
If omitted, the data set is cataloged.
The following example illustrates the panel displayed when you use the AM function
code.
7 >
8
> DSN() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....
ALLOCATE NEW SMS-MANAGED DATA SET
DSORG Enter the data set organization, specified as DA, DAU, PO,
POU, PS or PSU. If omitted, the data set organization is
undefined.
RECFM Enter any valid data set record format. If omitted, the record
format is undefined.
LRECL Enter the data set logical record length as a value between 0
and 32760. If omitted, the default is 0.
BLKSIZE Enter the data set block size as a value between 0 and 32760.
If omitted, the default is 0.
■ BLKSIZE is required if UNITS BLK is specified, and the
value cannot exceed 65535.
RECORG Enter the VSAM data set record organization, specified as:
ES VSAM entry-sequenced data set.
KS VSAM key-sequenced data set.
LS VSAM linear space data set.
RR VSAM relative record data set.
If omitted, a non-VSAM data set is assumed.
KEYLEN Enter the data set key length as a value between 0 and 255. If
omitted, the default is 0.
KEYOFF Enter the VSAM key-sequenced data set key offset as a value
between 0 and 32760. If omitted, the default is 0.
EXPDT Enter the data set expiration date in the form consistent with
the format displayed on the panel. (This format is established
by the SET DATEFORM command.)
If the year is specified with two digits, it is assumed to
represent a year in the twentieth century. Years beyond 1999
can only be specified at sites with MVS/XA SP2.2.0 or higher.
At such sites, the year must not exceed 2155.
If omitted, the data set has no expiration date.
You can also enter the CT function code, data set name and volume serial number on
the Data Set Facility menu, as in the following example.
7 >
8
> DSN() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6.
DATA SET FACILITY
FUNCTION ===> CT
7 8
>
> DSN() SCRL FULL COLS ====1 ===72 LINE ====1
....+....1....+....2....+....3....+....4....+....5....+....6..
==================================== T O P ===================
VOLSER UNIT DSNS DSCBS CONTG--CYL--AVAIL CONTG--TRK--AVAIL
STOR=1 673 288 1=17 2 2 116 2
DATA SET NAME STATUS ORG RFM BLKSZ LRECL
TEST.ASM PO FB 8= 8=
TEST.LOAD PO U 12288 12288
CT TEST.NEW PO FB 8== 8=
When using the CATALOG primary command or the Data Set Facility menu, you can
catalog a data set that resides on a maximum of six volumes, as in:
CATALOG DSN TEST.NEW VOL STOR=1 STOR=2 STOR=3
You cannot, however, catalog an SMS-managed data set using this facility.
Note: If the first (or only) volume specified is available for inspection, CA-Roscoe
verifies that the designated data set exists. If the data set does not exist, the
request is rejected. No check is made for any other volumes specified.
If the first (or only) volume specified is not available for inspection, no check
is made for the data set's existence; the request is honored. (This permits
catalog entries to be created for tape and DASD data sets residing on volumes
that are only accessible from another system.)
One of these commands is COPY DSN, which allows you to copy all or selected lines
of the currently attached data or Selection List into the active or a specific AWS. The
following example illustrates how you can copy all of the attached data set object to
the top of the active AWS.
7 COPY DSN T_
8
>
> DSN() SCRL FULL COLS ====7 ===78 LINE =====1
> TEST.SOURCE(INVREPT)
> ...1....+....2....+....3....+....4....+....5....+....
...... ============================= T O P =================
=====1 IDENTIFICATION DIVISION.
=====2 PROGRAM-ID. INVREPT.
=====3 ENVIRONMENT DIVISION.
=====4 CONFIGURATION SECTION.
You must indicate the appropriate AWS destination by specifying one of the
following:
v Copy at or after the line specified by v.
T Copy to the top of the AWS.
B Copy to the bottom of the AWS.
* Copy after the line at which the AWS pointer is currently positioned.
R Replace the contents of the AWS with the copied data.
All of these commands allow you to limit the number of lines to be copied, as in:
COPYS DSN /DATE-FIELD/ 9== 18== 1==
which copies every line containing the string DATE-FIELD within lines 900 through
1800 of the currently attached data set object at or after line 100 in the active AWS.
For additional information about using these commands, see Chapter 15, “AWS:
Copying Data Within and Into an AWS.”
The IMPORT command can be used to copy all or part of a specific data set into the
active AWS or a designated library member, without accessing the data set first. (Note
that when IMPORTing into the active AWS, the current AWS contents is overlaid by
the IMPORTed data.)
The following example illustrates how you can use this panel to place one copy of
lines 1200 through 2500 of the data set TEST.SOURCE after line 500 of the active
AWS.
7 8
>
> DSN() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....
COPY DATA SET
OPTION ===> C
DATA SETS Enter the one- to 44-character fully qualified name of the
data set to be copied. The name may be further qualified
with:
dsnmem One- to eight-character PDS member or
CA-Librarian module name.
v Relative generation number of the GDG data set
to be copied, specified as 0 (most recent) or a
minus number (as in -1).
VOLUMES Enter the one- to six-character serial number of the volume
on which the data set resides. One to six volumes can be
specified. This field is required if the data set is not
cataloged.
UNIT NAMES Enter the one- to eight-character unit name associated with
the device type(s) on which the data set resides. It may be
either an IBM-defined generic name (like 3350) or a
site-defined esoteric name (like SYSDA). This field is
required if the data set is not cataloged and resides on a mass
storage device.
ARCHIVE LEVEL Enter the archive level of the CA-Librarian master file
module to be copied. (The module must be in ARCHIE
format.) If omitted, the most current level of the module is
copied. Specify the level using one of the following forms:
Lx Absolute level number (between 0 and 65535) as
reported on the CA-Librarian Update Report.
-y Relative level number between 0 and 255. The
current level is -0; -1 is one level older than the
current.
yymmddhhmmss 0
Date and time the desired archive level was
current. An even number of digits (starting from
the right) can be omitted. They are assumed to
have the highest values consistent with the values
of specified digits.
If any other form of Selection List is displayed, you can perform any of the functions
that are valid with that Selection List. When performing a copy operation, type a C
before the name of each entry in the list to be copied. Then, tab to the STATUS field
and enter a destination code. The destination codes are:
* Copy after the line at which the AWS pointer is currently positioned.
v Copy at or after the line specified by v.
B Copy to the bottom of the active AWS.
R Replace the contents of the active AWS with the copied data.
T Copy to the top of the active AWS.
The following example illustrates how you can copy multiple data sets from a
Selection List.
7 8
>
> DSN() SCRL FULL COLS ====1 ===72 LINE ====1
....+....1....+....2....+....3....+....4....+....5....+....6..
==================================== T O P ===================
VOLSER UNIT DSNS DSCBS CONTG--CYL--AVAIL CONTG--TRK--AVAIL
STOR=1 673 288 1=17 2 2 116 2
DATA SET NAME STATUS ORG RFM BLKSZ LRECL
C TEST.NEW ) PO FB 8=
C TEST.NEW1 T PO U 12288 1
C TEST.NEW2 B PO FB 8==
Note: Password-protected data sets cannot be copied from a Selection List. Use the
Copy Function panel or the COPY primary command.
or, by entering the CM function code, data set name and volume containing it on the
Data Set Facility menu, as in the following example.
7 8
>
> DSN() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6.
DATA SET FACILITY
FUNCTION ===> CM
or, by entering the CM code on a Catalog or VTOC Selection List, as in the following
example.
7 8
>
> DSN() SCRL FULL COLS ====1 ===72 LINE ====1
....+....1....+....2....+....3....+....4....+....5....+....6..
==================================== T O P ===================
VOLSER UNIT DSNS DSCBS CONTG--CYL--AVAIL CONTG--TRK--AVAIL
STOR=2 673 288 1=17 2 2 116 2
DATA SET NAME STATUS ORG RFM BLKSZ LRECL
TEST.ALPHA PO FB 8= 8=
TEST.BETA PO U 122 88 12288
CM TEST.SAMPLE PO FB 8== 8=
Your site management has the option of designating the utility program that is to
perform the compression processing. (As distributed, the IBM utility IEBCOPY is
used.) The designated data set must be eligible for compression processing by that
utility program. (See the description of the COMPRESS command in the CA-Roscoe
Command Reference Guide for a list of requirements.)
When the data set is compressed, messages are directed to a library member named
ZZZZZCMP. You can use the SET DSNCMLST command to designate the type of
messages you want written to that member.
The following example illustrates how you might establish SAMPLE as the alias for
the user catalog named CATALOG.TEST.
7 8
>
> DSN() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6.
DEFINE DATA SET ALIAS
Notes:
■ The GDG must be cataloged in a catalog that is accessible to CA-Roscoe.
■ Both the primary command and the function panel allow you to specify a retention
period. The retention period may be any date up to the 365th day of the year 2155
at sites with MVS/XA SP2.2.0 or higher. At other sites, the maximum retention
period is the 365th day of the year 1999.
If you omit LIKE, other operands of this command can be used to define all of the
appropriate characteristics. These operands can also be used to override specific
characteristics of the model you have specified through LIKE. For example, if you
want to use all of the characteristics of TEST.GDG.OLD except for the number of
generation data sets that may be associated with the new GDG, you might enter:
DEFINE GDG TEST.GDG.NEW LIKE TEST.GDG.OLD LIMIT 1=
If you specify the name of an existing GDG when you request the panel, the panel
will contain that name and the characteristics associated with that GDG (as illustrated
in the following example). You can then change the GDG name and make any other
necessary changes. When you press the ENTER key, the GDG is defined.
7 8
>
> DSN() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....
DEFINE GENERATION DATA GROUP
SCRATCH Designates whether the generation data set's format-1 DSCB in the
VTOC is to be deleted when the data set is uncataloged (either
implicitly through EMPTY or explicitly through a delete or
uncatalog request). The action can be specified as:
YES Deletes the generation data set's format-1 DSCB from
the VTOC when the data set is uncataloged. (This
allows the space assigned to the data set to be made
available to other users.)
NO Prevents the data set's format-1 DSCB from being
deleted, causing the space to remain allocated to the data
set.
OWNER Enter the one- to eight-character owner identifier that is to be placed
in the GDG's catalog entry. OWNER is ignored if the GDG is to be
cataloged in a CVOL catalog.
FOR Enter the number of days for which the GDG is to be kept. It must
be a value between 0 and 9999.
TO Enter the date through which the GDG is to be kept.
■ FOR and TO are mutually exclusive.
They are ignored if a GDG is to be cataloged in a CVOL. If an
SMS-managed data set is to be created in an ICF catalog, FOR
or TO can be overridden by the specifications in the data set's
SMS management class.
The date can resolve to any date up to the 365th day of the year
2155 at sites with MVS/XA SP2.2.0 or higher. At other sites,
the maximum retention period is the 365th day of the year 1999.
You can also delete the following types of VSAM objects: ALIAS, AIX, CLUSTER,
GDGBASE, PAGESPACE and PATH.
Notes:
■ When deleting a data set or member/module through the Delete Function Panel or
a Selection List, you have the option of requesting that a Delete Confirmation
panel be displayed. You can control this option using the ATTACH DSN
command or the Data Set Facility menu.
– When CONFIRM DELETE is in effect, a Delete Confirmation panel is
displayed. This panel contains the name of each data set or member/module
you marked for deletion. You must confirm this operation before it is
performed.
– When CONFIRM DELETE is not in effect, the designated data set(s) or
member(s)/module(s) are deleted when you press the ENTER key.
Note: CONFIRM DELETE is always in effect when you attempt to delete all of
the members comprising a PDS.
See 27.7.4, “Delete Confirmation Panels” on page 27-33 for additional
information.
■ When deleting a data set, an uncatalog operation is:
– Always performed for an SMS-managed data set.
– Performed for a non-SMS-managed data set if the data set to be deleted is
cataloged and the volumes on which it resides match those specified in the
catalog.
■ When deleting from a Selection List, data sets, members, or modules having
unconventional names (for example, member names containing lowercase and/or
non-displayable characters,) will be deleted.
The following example illustrates how you can use this panel to delete a
password-protected data set named TEST.OLD that has an expiration or retention date.
7 8
>
> DSN() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....
DELETE DATA SET
OPTION ===> D
U V
The fields comprising this panel include:
OPTION Enter the code that is appropriate for the action you want to
perform. The codes are:
D Delete and uncatalog, if appropriate, the designated data set.
S Delete the designated member/module.
X Delete all of the members comprising the designated PDS.
(The data set itself is not deleted.)
M Display a Selection List of members/modules. (Use the field
PGMR NAME, MODULE TYPE and LANGUAGE to
produce a qualified CA-Librarian Selection List.)
DATA SETS Enter the one- to 44-character fully qualified name of the data set to
be deleted. The name can be further qualified with:
dsnmem One- to eight-character PDS member or CA-Librarian
module name.
v Relative generation number of the GDG data set to be
deleted, specified as 0 (most recent) or a minus number
(like -1).
DATA SETS
(cont.)
* Deletes all members of the PDS; the data set itself is
retained and a compress operation is performed.
VOLUMES Enter the one- to six-character serial number of the volume on which
the data set resides. One to six volumes can be specified. This field
is required if the data set is not cataloged.
UNIT NAMES Enter the one- to eight-character unit name associated with the
device type(s) on which the data set resides. It can be either an
IBM-defined generic name (like 3350) or a site-defined esoteric
name (like SYSDA). This field is required if the data set is not
cataloged and resides on a mass storage device.
ARCHIVE LEVEL
Enter the archive level of the CA-Librarian master file module to be
copied. (The module must be in ARCHIE format.) If omitted, the
most current level of the module is copied. The level can be
specified as:
Lx Absolute level number (between 0 and 65535) as
reported on the CA-Librarian Update Report.
-y Relative level number between 0 and 255. The current
level is -0; -1 is one level older than the current.
yymmddhhmmss 0
Date and time when the desired archive level was
current. An even number of digits (starting from the
right) can be omitted. Omitted digits are assumed to
have the highest values that are consistent with the
values of those digits that are specified.
OVERRIDE RETPD
Designates whether the data set's retention or expiration date is to be
overridden by entering either:
YES Delete data set, regardless of its retention or expiration
date.
NO Delete data set only if the retention or expiration date is
passed.
Note: If omitted, the default is NO.
The following fields only have meaning when you specify the M option to display a
list of CA-Librarian module names.
PGMR NAME Enter the one- to 15-character programmer name to be used
when selecting modules for inclusion in a CA-Librarian Selection
List. Only those modules marked as owned by the specified
programmer are included in the Selection List. If omitted, all
modules are included.
MODULE TYPE Enter the type of modules to be included in a CA-Librarian
Selection List by specifying one of the following:
PROD0 Includes only those modules with PROD0 security
status.
PROD1 Includes only those modules with PROD1 security
status.
PROD2 Includes only those modules with PROD2 security
status.
TEST Includes only those modules with TEST security
status.
LANGUAGE Enter the CA-Librarian language code designating the
programming language type of the modules that are to be
included in a CA-Librarian Selection List.
The following example illustrates how you can delete multiple data sets from a
Selection List.
7 8
>
> DSN() SCRL FULL COLS ====1 ===72 LINE ====1
....+....1....+....2....+....3....+....4....+....5....+....6..
=================================== T O P ===================
VOLSER UNIT DSNS DSCBS CONTG--CYL--AVAIL CONTG--TRK--AVAIL
STOR=1 673 288 1=17 2 2 116 2
DATA SET NAME STATUS ORG RFM BLKSZ LRECL
D TEST.NEW PO FB 8= 8=
TEST.NEW1 PO U 12288 12288
D TEST.NEW2 PO FB 8== 8=
Note: You cannot delete a password protected data set through a Selection List. To
delete such a data set, use the Data Set Facility menu or the DELETE DSN
command.
The following example illustrates the type of confirmation panel displayed when you
attempt to delete a data set.
7 >
8
> DSN() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....
CONFIRM ==> ENTER (Y)ES TO CONFIRM DELETE
DATASET NAME CREATED VOLSER
TEST.NEW 12/19/85 STOR=1
TEST.NEXT 1=/3=/84 STOR=2
TEST.LAST 11/12/86 STOR=1
The following example illustrates the type of confirmation panel displayed when you
attempt to delete the members comprising a PDS (without deleting the data set itself).
7 8
>
> DSN() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....
CONFIRM ==> ENTER (Y)ES TO CONFIRM DELETE OF PDS DIRECTO
DSN: TEST.PDS.SAMPLE
CREATED: 11/=1/88
VOLSER: STOR=2
MEMBERS: 1=
Finally, the following example illustrates the type of panel displayed when you attempt
to delete one or more PDS members or CA-Librarian modules.
7 8
>
> DSN() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....
CONFIRM ==> ENTER (Y)ES TO CONFIRM DELETE
TEST.CURRENT CREATED: =9/29/1986 VOLSER: STOR=1
MEMBER LAST MODIFIED
BADJCL =4/=5/88 =9:12
WIDGET =7/2=/86 16:=4
To delete the entries, enter either YES or Y in the CONFIRM field. Entering any other
value in this field terminates the operation. (You will be returned to the Delete
Function panel or the previous Selection List. The STATUS field of that Selection List
will contain *DENYDEL.)
If you enter a primary command when a delete confirmation panel is displayed, the
operation is either terminated or paused. If the command is:
■ Data set related (like SELECT MENU), the operation is terminated and the action
is performed.
■ Not data set related (like ATTACH LIB), the operation is paused. The panel is
redisplayed when the Data Set Facility is reattached, allowing you to complete the
operation.
or, specifying the I function code and data set name on the Data Set Facility menu, as
in the following example.
7 >
8
> DSN() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6.
DATA SET FACILITY
FUNCTION ===> I
or, specifying the I function code on a Catalog or VTOC Selection List, as in the
following example:
7 8
>
> DSN() SCRL FULL COLS ====1 ===72 LINE ====1
....+....1....+....2....+....3....+....4....+....5....+....6.
=================================== T O P ===================
SEARCH ARGUMENT MATCHES CATALOG NAME TYPE
TEST.Q.SOURCE 6 CATALOG.UMUROS1 ICF
DATA SET NAME STATUS TYPE VOLUME DEVICE
TEST.SAMPLE1.SOURCE NONVSAM STOR=1 338=
I TEST.SAMPLE2.SOURCE NONVSAM STOR=1 338=
TEST.SAMPLE3.SOURCE ALIAS
================================ B O T T O M ================
U V
The following example illustrates the type of information displayed. This example
assumes you are using a terminal that displays more than 24 lines. If you are using
split screens or your terminal displays only 24 lines, or if the data set has more extents
than fit within the screen, you may scroll to see the rest of the information.
7 >
8
> DSN() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6.
DATA SET INFORMATION
DATA SET ===> ROSCOE.CREATE.PDSE
ENTRY TYPE ===> NONVSAM
MGMTCLAS ===> SMS
STORCLAS ===> SMS
VOLUMES ===> SMS==1
DEVTYPE ===> 338=
SEQ NO ===>
DATACLAS ===>
DSNTYPE ===> LIB
or, specifying the I function code and volume serial number on the Data Set Facility
menu, as in the following example.
7 8
>
> DSN() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6.
DATA SET FACILITY
FUNCTION ===> I
7 8
>
> DSN() SCRL FULL COLS ====1 ===72 LINE ====1
....+....1....+....2....+....3....+....4....+....5....+....6.
=================================== T O P ===================
VOLUME UNIT TYPE MATCHES
STOR+ 338= PRIVATE 2
VOLUME STATUS UNIT DEVTYPE CONTG--CYL--AVAIL CONTG--TRK
I STOR=1 4=1 338= 1 1 15
STOR=2 4== 338= 2 13 31
================================ B O T T O M ================
U V
The following example illustrates the type of information displayed. If you have split
the screen so that all of the information is not displayed, you can scroll the display.
7 8
>
> DSN() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6.
VOLUME INFORMATION
TOTAL TRACKS ON VOLUME => 2655= MAXIMUM BLOCK SIZE => 3276=
TOTAL TRAKS USED => 26239 TRACK SIZE => 47968
PERCENT OF VOLUME USED => 96 TRACKS PER CYLINDER => 15
──┬───┬──┬──────┬──┬────┬────────────────────
└─x─┘ └─-yyy─┘ └─-z─┘
When the data are scheduled for printing, a message is displayed. It contains the
printing location, tag (if specified) and print request number assigned by CA-Roscoe.
Once scheduled, all references to a specific print request must be by its tag or number.
All of the operands of the PRINT command can be used when printing attached data.
For example, to print only lines 5 through 25 of the currently attached data, you would
enter:
PRINT DSN 5 25
Note: See Chapter 7, “Printing Data” for additional information about the PRINT
command, and how requests can be monitored and controlled.
The following example illustrates how you can use this panel to print a copy of
TEST.SAMPLE.SOURCE.
7 8
>
> DSN() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6...
PRINT DATA SET
OPTION ===> P
You can use the following fields to customize the print operation.
1ST LINE Enter the number of the line at which the print operation is to
begin. If omitted, the first line is assumed.
LAST LINE Enter the number of the last line to be included in the print
operation. If omitted, the end of the data set object is assumed.
While Selection Lists do not contain line numbers, treat them as
though they are numbered from 1 by 1.
PAGE LEN Enter the length of the paper in number of print lines as a
numeric value between 0 and 99. On printers with the hardware
capability to set page length, the number must be the same
length as specified to the printer. The default is site-defined.
SEQ NUMBRS Designate whether sequence number are to be printed by
specifying either:
YES Designates that sequence numbers are to be printed.
NO Designates that sequence numbers are not to be
printed.
If omitted, the default is YES.
TYPE/FORMAT Designate the format of the output by specifying either:
DEF (Default.) A top and bottom margin may be set.
ANS ANSI print control characters are recognized.
MCC Machine printer control characters are recognized.
DUMP Format each line with offsets, hexadecimal data and
EBCDIC data to the right of the line.
CHEX Format each line with offsets and hexadecimal data
to the right of the line.
VHEX Format each line in character data with hexadecimal
data shown vertically below.
TOP MARGIN v (Recognized only with TYPE DEF.) Enter the number of blank
lines to be skipped from the top of the page before printing
begins. v can be 0 through 99. The default is site-defined.
BOT MARGIN v (Recognized only with TYPE DEF.) Enter the number of blank
lines to be skipped at the bottom of the page. v can be 0
through 99. The default is site-defined.
1ST COL Number of the column at which the print operation is to start.
The value must be between 1 and the maximum length of the
line. If omitted, the default is 1.
LAST COL Number of the column at which the print operation is to stop.
The value must be greater than the starting column and not
exceed the maximum line length. If omitted, the maximum line
length is assumed. (The maximum line length of data set objects
is 32,767.)
To print one or more entries, type a P before the name of each entry. By default, the
request will print at the printing location assigned for the terminal you are using. To
print at a different location, tab to the STATUS field and enter the appropriate
destination name.
The following example illustrates how you can print multiple entries from a Selection
List.
7 8
>
> DSN() SCRL FULL COLS ====1 ===72 LINE ====1
....+....1....+....2....+....3....+....4....+....5....+....6..
==================================== T O P ===================
VOLSER UNIT DSNS DSCBS CONTG--CYL--AVAIL CONTG--TRK--AVAIL
STOR=1 673 288 1=17 2 2 116 2
DATA SET NAME STATUS ORG RFM BLKSZ LRECL
P TEST.NEW PO FB 8=
TEST.NEW1 PO U 12288 1
P TEST.NEW2 PR99 PO FB 8==
In the preceding example, the data set TEST.NEW will print at the terminal's default
printing location. The data set TEST.NEW2 will print at the location identified (in the
STATUS field) as PR99.
or, by entering the RL function code and data set name on the Data Set Facility menu,
as in the following example.
7 >
8
> DSN() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6.
DATA SET SELECTION MENU
FUNCTION ===> RL
or, by entering the RL function code on a Catalog or VTOC Selection List, as in the
following example.
7 8
>
> DSN() SCRL FULL COLS ====1 ===72 LINE ====1
....+....1....+....2....+....3....+....4....+....5....+....6..
==================================== T O P ===================
VOLSER UNIT DSNS DSCBS CONTG--CYL--AVAIL CONTG--TRK--AVAIL
STOR=1 673 288 1=17 2 2 116 2
DATA SET NAME STATUS ORG RFM BLKSZ LRECL
RL ABC.TEST.ASM PO FB 8= 8=
ABC.TEST.LOAD PO U 12288 12288
ABC.TEST.OBJECT PO FB 8== 8=
You can also rename the following types of VSAM objects: AIX, CLUSTER, DATA,
INDEX, PAGESPACE and PATH.
Notes:
■ The volumes on which the data set resides must be mounted and online.
■ A recatalog operation is:
– Always performed for an SMS-managed data set.
– Performed for a non-SMS-managed data set if the data set to be renamed is
cataloged and the volumes on which the rename is performed match those
specified in the catalog.
If the designated data set is password-protected, you must include the password with
the command, as in
RENAME DSN TEST.OLDNAME NEWNAME TEST.NEWNAME PSWD MYPSS
The following example illustrates how you might use this panel to rename a member
of a password-protected data set.
7 8
>
> DSN() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....
RENAME DATA SET
OPTION ===> S
U V
The fields comprising this panel include:
OPTION Enter the code that is appropriate to perform the desired action.
The codes are:
R Rename a data set.
S Rename a single member/module.
M Display a Selection List of members/modules. (Use the
field PGMR NAME, MODULE TYPE and LANGUAGE
to produce a qualified CA-Librarian Selection List.)
DATA SET Enter the one- to 44-character fully qualified name of the data
set to be renamed. The name may be qualified with:
dsnmem One- to eight-character PDS member or
CA-Librarian module name.
DATA SET
(cont.)
v Relative generation number of the GDG data set to
be renamed, specified as 0 (most current) or a minus
number (like -1).
VOLUMES Enter the one- to six-character serial number of the volume on
which the data set resides. One to six volumes can be specified.
VOLUMES is required if the data set is not cataloged.
UNIT NAMES Enter the one- to eight-character unit name associated with the
device type(s) on which the data set is to be allocated. It can be
either an IBM-defined generic name (like 3350) or a site-defined
esoteric name (like SYSDA) This field is required if the data set
is not cataloged and resides on a mass storage volume.
ARCHIVE LEVEL Enter the archive level of the CA-Librarian master file module to
be renamed. (The module must be in ARCHIE format.) If
omitted, the most current level of the module is renamed. The
level can be specified as:
Lx Absolute level number (between 0 and 65535) as
reported on the CA-Librarian Update Report.
-y Relative level number between 0 and 255. The
current level is -0; -1 is one level older than the
current.
yymmddhhmmss
Date and time when the desired archive level was
current. An even number of digits (starting from the
right) can be omitted. Omitted digits are assumed to
have the highest values that are consistent with the
values of those digits that are specified.
PASSWORD Enter one or two passwords (established by the site). If one
password is specified, it is treated as the data set or
CA-Librarian master file module password.
If two passwords are specified, the first is treated as the data set
password and the second is treated as the CA-Librarian
password.
If omitted and a password is required, access is denied.
MCD CODE Enter the management code of the CA-Librarian master file.
MCD is only required when the master file contains PROD2
modules.
The next three fields only have meaning when you specify the M option to display a
list of member/module names.
PGMR NAME Enter the one- to 15-character programmer name to be used when
selecting modules for inclusion in a CA-Librarian Selection List.
Only those modules marked as owned by the specified programmer
are included in the Selection List. If omitted, all modules are
included.
MODULE TYPE
Enter the type of modules to be included in a CA-Librarian
Selection List by specifying one of the following:
PROD0 Includes only those modules with PROD0 security
status.
PROD1 Includes only those modules with PROD1 security
status.
PROD2 Includes only those modules with PROD2 security
status.
TEST Includes only those modules with TEST security status.
LANGUAGE Enter the CA-Librarian language code designating the programming
language type of the modules that are to be included in a
CA-Librarian Selection List.
NEW DATA SET
Enter the new data set or member/module name specified as either:
dsn One- to 44-character fully qualified new name for the
data set.
dsnmem One- to eight-characer new member/module name.
+v Relative generation number to be assigned to GDG
(Generation Data Group) data set, specified as a value
between 1 and 255.
7 >
8
> DSN() SCRL FULL COLS ====1 ===72 LINE ====1
....+....1....+....2....+....3....+....4....+....5....+....6..
==================================== T O P ===================
DATA SET NAME VOLSER MEMS ORG RECFM BLKSZ LRECL
TEST.OLD1 STOR=1 3 PO U 12288 12288
MEMBER STATUS --------------- ATTRIBUTES --------------
To rename one or more data sets, use the R function code. Since the STATUS field is
not large enough to hold a 44-character data set name, all of the data sets that you
marked will be presented to you through a subordinate panel (such as the one
illustrated in the following example). To rename a data set, overtype the second
occurrence of the old name with the new name.
7 >
8
> DSN() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....
ENTER NEW DATASET NAME ON LINE FOLLOWING OLD DATA SET NAME
DATASET NAME CREATED VOLSER
TEST.OLD 12/11/84 STOR=2
TEST.NEW
TEST.OLD1 1=/3=/86 STOR=1
TEST.NEW1
TEST.OLD2 11/15/85 STOR=1
TEST.NEW2
You cannot rename a password-protected data set from a Selection List. To rename a
data set, use the Data Set Facility menu or the RENAME DSN command.
or, specify the UC function code and data set name on the Data Set Facility menu, as
shown in the following example.
7 8
>
> DSN() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6.
DATA SET FACILITY
FUNCTION ===> UC
You can also specify the UC code on a VTOC Selection List, as in the following
example.
7 8
>
> DSN() SCRL FULL COLS ====1 ===72 LINE ====1
....+....1....+....2....+....3....+....4....+....5....+....6..
==================================== T O P ===================
VOLSER UNIT DSNS DSCBS CONTG--CYL--AVAIL CONTG--TRK--AVAIL
STOR=1 673 288 1=17 2 2 116 2
DATA SET NAME STATUS ORG RFM BLKSZ LRECL
ABC.TEST.ASM PO FB 8= 8=
ABC.TEST.LOAD PO U 12288 12288
UC ABC.TEST.NEW PO FB 8== 8=
Using EXPORT: Use the EXPORT command to write data to an existing data set.
If the data are in:
■ The active AWS, you need only specify the name of the data set that is to receive
the data, as in:
EXPORT DSN=TEST.STAT
where the contents of the active AWS will replace the data in the sequential data
set named TEST.STAT.
The following example displays the type of confirmation message you would
receive after issuing this command, assuming that SET MSGLEVEL INFO is in
effect.
7 8
>
>
>....+....1....+....2....+....3....+....4....+....5....+....6
EXP6= 25= RECORDS WRITTEN TO DATA SET
TEST.STAT
ON VOLUME STOR=3
EXP69 SUCCESSFUL EXECUTION OF EXPORT
■ A Library Member, use the INPUT= operand to name the desired member, as in:
EXPORT DSN=TEST.STAT INPUT=INDATA
where the contents of TEST.STAT are replaced by the contents of the member
INDATA.
■ The active AWS and one or more library members, use the INPUT= operand and
the *, as in:
EXPORT DSN=TEST.STAT INPUT=INDATA/Q/ABC.MORE
The asterisk (*) indicates where contents from the active AWS are to be placed in
the input. A maximum of ten different input sources can be specified and can be
any combination of the AWS contents and library members. Note that if any of
the members belong to another user, that individual's prefix must be specified.
You can also use the EXPORT command to write data to an existing CA-Librarian
master file or to an existing CA-Panvalet member. For more information about
EXPORTing, see the CA-Roscoe Command Reference Guide.
Using EDSN: Use the EDSN command to edit a data set by establishing a data set
editing session.
■ If you do not specify any operands, as in:
EDSN
the Edit Data Set Facility, as shown in the following example, will be displayed.
7 <...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+.. 8
EDIT DATASET FACILITY
FUNCTION ===>
You can only perform two functions from this panel: Edit or Terminate. To edit a
data set, specify E in the FUNCTION field and the appropriate data set name in
the DATA SET field. If a volume, unit, password, or archive level are required,
you will be prompted accordingly. Edit (E) will begin the data set editing session,
and the specified data set will be attached in a modifiable AWS.
■ If you specify a data set name with the command, as in:
EDSN TEST.STAT
the data set will be displayed in your AWS.
Once the data set is displayed, you can edit it using CA-Roscoe editing conventions.
(See Chapter 14, “AWS: Changing Data Within an AWS” for information about
editing and manipulating data within an AWS.)
If there is data in the AWS before the EDSN command is invoked, it is temporarily
replaced by the data set. That is, the AWS that the data set is placed in becomes
active, and your other AWS(s) is (are) placed in the background. (Use the STATUS
AWS command to display information about all AWSs in use. See Chapter 17,
“AWS: Displaying/Changing AWS Information” for details.)
Executing a command that causes output to the Execution Area (for example,
ATTACH LIB) or pressing the CLEAR key places the Data Set Editing Facility in a
'pending' state. The data set can be edited again at any time by issuing:
EDSN Q
When you have completed editing the data set, save the data by entering:
SDSN
The data set will be saved (or updated if it already exists) and the editing session will
be discontinued. If you do not want to save the data set, enter:
CDSN
The Data Set Edit Facility remains active until explicitly deactivated using the SDSN
or CDSN commands, selecting X from the Edit Data Set Facility panel, or until the
CA-Roscoe session is ended. For complete information about the EDSN, CDSN, and
SDSN commands, see the CA-Roscoe Command Reference Guide.
The following example assumes the JCL to be checked is in the active AWS. The
resulting display shows the error messages provided after the JCK command is
executed.
7 JCK
8
>
> AWS( ) SCRL FULL COLS ====1 ===72
> <...+....1....+....2....+....3....+....4....+....5.
...... ================================ T O P ============
=====1 //STARTJCL JOB ==2=5,ROBERTS,CLASS=X
=====2 // MSGCLASS=A
=====3 //COB EXEC PGM=IKFCBL==
=====4 //SYSLIN DD DSN=&&LOADSET,DISP=(,PASS),
=====5 // UNIT=SYSDA,SPACE=(TRK,(5,5))
=====6 //SYSPRINT DD SYSOUT=A
=====7 //SYSUT1 DD UNIT=SYSDA,SPACE=(CYL,4,4)
=====8 //SYSUT2 DD UNIT=SYSDA,SPACE=(CYL,(4,4))
=====9 //SYSUT3 DD UNIT=SYSDA,SPACE=(CYL,(4,4))
====1= //SYSUT4 DD UNIT=SYSDA,SPACE=(CYL,(4,4))
====11 //SYSIN DD Q
============================= B O T T O M ========
U V
7 >
8
>
....+....1....+....2....+....3....+....4....+....5....+....
// MSGCLASS=A
CAY6==6S VERB 'MSGCL' IS UNKNOWN
//SYSLIN DD DSN=&&LOADSET,DISP=(,PASS),
UNIT=SYSDA,SPACE=(TRK,(5,5))
CAY6=87W BLKSIZE NO SPECIFIED FOR NEW OR DUMMY DATA SET -
POTENTIAL S=13 IN EXECUTION
//SYSUT1 DD UNIT=SYSDA,SPACE=(CYL,4,4)
CAY6=48E '4' IS ILLEGAL OPERAND FOR 'RLSE' PARAMETER OF
'SPACE'
U V
To check source code in a CA-Roscoe library member, enter the command RUN COB,
followed by the library member name. For example, to check the contents of the
library member INVLIST, enter:
RUN COB INVLIST
By site option, you can receive JES2 or JES3 messages at your terminal when your
job completes execution. If your site permits this notification, your site management
will tell you what change needs to be made to the JOB statement in your JCL.
If the data has the attribute SEQ, you can use the SET SUBMIT command to control
whether sequence numbers are included, where:
■ SET SUBMIT NOSEQ excludes sequence numbers.
■ SET SUBMIT SEQ places sequence numbers in the location defined by the data's
sequence number attribute.
If you submit data without specifying the SET SUBMIT command and the data are in:
■ The active AWS; the AWS sequence attribute controls whether sequence numbers
are to be included.
Use the SEQ or NOSEQ command to change the sequence attribute of the active
AWS. NOSEQ suppresses the insertion of sequence numbers, while SEQ specifies
that sequence numbers are to be included and designates the location of those
sequence numbers.
■ A library member; the member's sequence attribute controls whether sequence
numbers are to be included.
The following table summarizes how you can control sequence numbers in submitted
jobs.
──+INC──┬─AWS───────────┬─────────────────────────────────
└──┬──────┬─mem─┘
└─pfx.─┘
where:
AWS Includes the contents of the active AWS.
mem Name of the library member whose contents is to be included. If the
member belongs to another user, that individual's prefix must be
included.
The data being submitted (like the active AWS and/or library members) can
contain any number of +INC statements. It can even contain only +INC
statements, as in:
+INC LEADJCL
+INC MYPROG
+INC ENDJCL
The included data can contain +INC statements. You are allowed 64 levels of
+INC nesting.
■ Enabling Expansion:
The SET SUBMIT command controls whether or not +INC statements are to be
expanded when the job is submitted.
To have +INC statements expanded (for example, to include the library member or
active AWS contents), specify the INCLUDE operand with SET SUBMIT before
issuing the SUBMIT command, as in:
SET SUBMIT INCLUDE
SUBMIT
Once you have enabled expansion, it remains in effect until you disable it or
terminate your session.
You can disable +INC expansion by specifying:
SET SUBMIT NOINCLUDE
The SET MASTER command controls whether these statements are to be expanded
when the job is submitted. For example, you might enter:
SET MASTER ROSCOE.LIBR : Activate and name master file
SUBMIT TEST1 : -INCs in member TEST1 expanded
SET MASTER OFF : Deactivate -INC expansion
SUBMIT TEST2 : -INCs in TEST2 not expanded
SET MASTER ON : Reactivate with same master file
Once you identify the CA-Librarian master file to be used, it remains in effect until
you:
■ specify another master file,
■ disable expansion, or
■ terminate your session.
It can also be used to execute operator commands and check the system console.
If you enter this command with no operands, the Job Facility primary menu is
displayed.
You can include a job name and job number with the AJOB command to qualify the
job display.
If a specified job can be found, it is attached and AJOB terminates. If the specified
job cannot be found, or if the job name uses a wildcard specification, then a Job
Selection list is presented based on the JOB/GRP NAME value.
When you are viewing job output, you can redisplay the primary menu at any time by
entering:
SELECT MENU
To end AJOB processing, select the function X (TERMINATE) from the main menu.
The CLEAR key will discontinue AJOB processing from any Job Facility panel or
display from which it is pressed (with the exception of a CONSOLE display caused by
a command from the OPERATOR COMMAND panel). It will leave the most recent
job attached that had been selected for viewing.
When CLEAR is pressed during a CONSOLE display, it will cause the CONSOLE
display to be cleared and will redisplay the OPERATOR COMMAND panel.
7 8
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....
JOB FACILITY
FUNCTION ===>
U V
The fields comprising this menu include:
FUNCTION The job function to be performed. Specify one of the codes
listed on the bottom of the menu. (See 28.3.2, “Using Job
Facility Functions” on page 28-12 for a complete description
of each function.)
JOB/GRP NAME The specific name or prefix (wildcard) of job(s) to be included
in the selected function.
JOB NUMBER Number of the job. Must be numeric or left blank.
FILE NUMBER Number of the file to qualify the selected display. Must be
numeric or Last; if no value is specified, a value of 1 is used.
PAGE NUMBER Number of the page to qualify the selected display. Must be
numeric or Last; if no value is specified, a value of 1 is used.
LINE NUMBER Line number of job data to qualify the selected display. Must
be numeric or Last; if no value is specified, a value of 1 is
used.
DEST/CLASS The printer destination used in the PRINT JOB function, or
class of jobs displayed by the ATTACH JOB function.
ACTIVE JOB TYPE The qualification to show active TSO jobs (TSO), active tasks
submitted through JES (JES), active started tasks (STC), or all
active jobs (ALL) displayed for the ATTACH JOB function.
A value here causes the JOB/GRP NAME value to be ignored.
CONTROL CHARS Specifies whether control characters are included when a job is
attached, copied, or printed. A default of NO is used when the
AJOB facility is initially invoked.
CONFIRM CANCEL Specifies whether a confirmation panel is displayed for any
jobs selected for cancel. A default of YES is used when the
AJOB facility is initially invoked.
The following table lists each function code and its corresponding description and
action.
---------------------------------------------------------------------------
A - ATTACH C - COPY L - LAST FILE S - STATUS
AT - ALTER CN - CANCEL P - PRINT NN - NTH FILE
PF1/13: MENU PF3/15: EXIT PF7/19: BACK
U V
The fields comprising the job selection list can be used to change or further qualify the
display, and include:
FUNCTION requires M, F, B, or X; M invokes the Primary Menu; X will
discontinue AJOB processing (exits to CA-Roscoe); F will cause a
scroll forward for a large display; B will cause a scroll backward
for a large display; F and B are retained in this slot for subsequent
scrolling by hitting the ENTER key; Any other value redisplays the
screen with new information (beginning with the first job).
The PF key numbers listed at the bottom of the display will
achieve the same result as the functions.
JOB NAME The name or prefix of jobs shown in the display. It can include a
wildcard character. Users can change this value to show jobs with
a different job name or job prefix. (This slot shows no value and
is unmodifiable if the ATTACH INITIATORS selections was made
from the Primary Menu.)
FILE Number of the file within the job to qualify the function request.
Must be numeric or Last; if no value is specified, a value of 1 is
used.
PAGE Number of the page within the job to qualify the function request.
Must be numeric or Last; if no value is specified, a value of 1 is
used.
LINE Line number within the job to qualify the function request. Must
be numeric or Last; if no value is specified, a value of 1 is used.
You can manipulate the jobs in the selection list by using the line commands displayed
at the bottom. Specify the following codes in the field to the left of a job to invoke
the corresponding service (multiple selections may be made):
A ATTACH this job using the FILE, PAGE, or LINE values appearing in their
respective locations.
AT Present the ALTER JOB panel for the corresponding job.
C Present the COPY JOB panel for the corresponding job.
CN Present the CANCEL JOB confirmation panel for the corresponding job if
CONFIRM CANCEL is YES on the Primary Menu; or cancel the job with no
confirmation if CONFIRM CANCEL is NO on the Primary Menu.
L ATTACH JOB LAST FILE for this job using PAGE, and/or LINE values
appearing in their respective locations. The value appearing in the FILE ===>
slot is ignored, and is reset to LAST for subsequent displays of this panel.
P Present the PRINT JOB panel for the corresponding job.
S ATTACH the corresponding job using the STATUS JOB display.
NN ATTACH JOB FILE NN for the corresponding job using PAGE or LINE
values appearing in their respective locations; The value appearing in the FILE
field is ignored, and is reset to this value for subsequent displays of this panel.
Notes:
When you issue selections A, L, S, and NN, the AJOB facility is placed in a
suspended display state (you will see PGM(xx.AJOB) appearing on the CA-Roscoe
status line) and the following is true:
■ The job is attached and CA-Roscoe commands can be issued on the command line
to do any job or non-job processing.
■ RPFs are NOT SUPPORTED while AJOB is in this state.
■ The SCREEN command is NOT SUPPORTED while AJOB is in this state.
■ PF keys set to SPLIT, SWAP, and END will not be recognized, however, issuing
the corresponding :S or :W commands on the command line and pressing PF12
will cause the SPLIT and SWAP functions to take place.
To invoke the Operator Control display from the Job Facility menu, enter the code OP
in the FUNCTION field. The following example illustrates this.
7 8
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....
JOB FACILITY
FUNCTION ===> OP
U V
When you select the OPER CONTROL function, the Operator Control panel will be
displayed. From this panel, you can:
■ Execute CONSOLE commands using the CMD and CMM subcommands.
■ Execute CONSOLE commands you may have in a CA-Roscoe library member.
■ Display the MVS Master Trace Table using the CONSOLE MTT command.
■ Display the UCB address of defined consoles currently active in the system.
■ Display messages written to a designated console.
7 8
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....
OPERATOR CONTROL
COMMAND ===>
- OR -
LIB MEMBER ===>
This chapter describes how to monitor the status of a job using the AJOB command or
the DISPLAY command.
■ AJOB enables you to display a job menu or selection list. From these displays
you can select functions to determine the status of a job and obtain information
regarding it.
■ DISPLAY can be used to directly monitor the status of a job.
| Note: CA-Roscoe supports the six-digit job number support added with z/OS
| JES2/JES3 1.2.
7 8
>
>
....+....1....+....2....+....3....+....4....+....5....+....6....+...
JOBNO JOBNAME STATUS C PRTY SID ORIGIN STEP/LINE HELD CPUTIME
----- ------- ------------ - ---- ---- ------ --------- ---- -------
2=85 COMPILE AWAIT PRT(H) 1 SYSH R1=
4678 COMPILE EXEC =:==:2= X 6 SYSH R1= LINKMOD =1.44
5232 COMPILE AWAIT EXEC X 6 SYSH R1= QPOS(18) YES
The information displayed above can be displayed using the Job Facility. Enter:
AJOB COMPILE
---------------------------------------------------------------------------
A - ATTACH C - COPY L - LAST FILE S - STATUS
AT - ALTER CN - CANCEL P - PRINT NN - NTH FILE
PF1/13: MENU PF3/15: EXIT PF7/19: BACK
U V
■ All jobs containing your prefix in the site-designated location of the job name.
Enter:
DISPLAY or AJOB
If your site requires your CA-Roscoe prefix to be part of the job name, the
resulting display shows the status of all jobs that contain your prefix in the
designated location.
■ All jobs beginning with specific characters. For example,
DISPLAY ROS+ or AJOB ROS+
displays status information about all job names beginning with ROS. (The plus
sign (+) indicates that additional characters may follow those specified.
■ All jobs that contain specific characters in a specific location. For example,
entering:
DISPLAY MASK=R*SC*E or AJOB R*SC*E
might display the status of jobs named ROSCOE or RASCAE. (The asterisk (*)
represents any character that is valid in a job name. See 28.3.1, “Wildcard
Characters” on page 28-11 for information on using wildcard characters in job
names.)
■ Any job whose name matches a DISPLAY subcommand, as in:
DISPLAY JOB=QUEUE
to display information about all initiators used by the operating system and the names
and number of executing jobs.
You can also specify: AJOB INIT and receive the same result.
7 <...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....
8
JOB FACILITY
FUNCTION ===> I
7 8
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....
JOB INFORMATION
The first four fields of the Job Information panel are variable. They will contain the
name and number of the job you entered on the primary menu. If you would like to
display a different job, you must change the following job information:
The remaining fields display information specific to the job you have indicated. The
screen will be automatically refreshed according to the value you specify in the
REFRESH INTERVAL field.
To exit this panel, select the option X (EXIT). You will be returned to the Job
Facility main menu.
If there are multiple jobs with the same name, include the number of the job you want
to examine, as in:
ATTACH JOB SAMPLE 2=85
| Note: CA-Roscoe supports the six-digit job number support added with z/OS
| JES2/JES3 1.2.
If you do not include a job number, the first available job is selected and attached.
You can also attach a job by specifying just its job number, as in:
ATTACH JOB 2=85
When a job is attached, the display begins with the first line of the first file. The files
are presented to you in a format that is similar to a hard-copy listing. For example,
assume that the job SAMPLE compiles, link-edits and executes a COBOL program in
an MVS/JES2 environment. Its output is divided into the following files:
File 1 JES2 job log.
File 2 Listing of JCL statements.
File 3 Allocation and condition code messages.
File 4 Listing produced by the COBOL compiler.
File 5 Listing produced by the linkage editor.
File 6 Output produced by the COBOL program.
You can begin the display at any location within the job by including the number of
the appropriate file, page and/or line with the ATTACH JOB command. For example,
to begin the display of the job SAMPLE with the tenth line on the second page of the
third file, enter:
ATTACH JOB SAMPLE FILE 3 PAGE 2 LINE 1=
To attach a job from the Job Facility menu, enter the code A in the function field and
the appropriate job name in the JOB/GRP NAME field. The following example
illustrates this.
7 8
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+...
JOB FACILITY
FUNCTION ===>A
To attach a job from a job selection list, enter the code A in the command field on the
far left, next to the job to be attached. The following example illustrates this.
---------------------------------------------------------------------------
A - ATTACH C - COPY L - LAST FILE S - STATUS
AT - ALTER CN - CANCEL P - PRINT NN - NTH FILE
PF1/13: MENU PF3/15: EXIT PF7/19: BACK
U V
30.1.1.3 When Can a Job be Viewed?
Your site management will tell you what special SYSOUT class(es) they have
established.
The following example assumes the site has defined T and H as special SYSOUT
classes. As illustrated, you can specify one of the special SYSOUT classes with the
individual DD statements or with the MSGCLASS= operand on the JOB statement.
(DD statements containing SYSOUT=* use the SYSOUT class specified with
MSGCLASS=.) Notice that two of the SYSPRINT files are directed to class T while
the third is directed to class H.
7 >
8
> AWS() SCRL FULL COLS ====1 ===72
>....+....1....+....2....+....3....+....4....+....5....+....6
==================================== T O P =================
U V
Unless restricted by site management, any user can attach any job.
With this form of the command, all files from the hold queue are released and all
user-assigned NOTE names are deleted. Each file is disposed of according to its
PRINT/NOPRINT status. (Files marked PRINT are routed to the appropriate printer;
files marked NOPRINT are deleted.)
If you are the first person to attach the job and you release it, the job is released.
Other users will be notified the next time they press the ENTER key or use a PF key
to scroll.
If you execute a command that causes output to the Execution Area (like ATTACHing
an AWS) or if you press the CLEAR key, the attached job is placed in a pending state
and can be reattached at any time.
If you are using the Job Facility, you can detach a job from the Alter Job/File
Attributes panel. Select the function AT from either the Job Facility menu, or from a
job selection list. This will display the Alter Job/File Attribute panel.
Note: See 30.3.1.2, “Using the Job Facility” on page 30-18 for more information
about the Alter Job panel.
From the Alter Job display, you can select the options DETACH (DJ) or DETACH
HOLD (DH). Enter the appropriate code in the OPTION field and the corresponding
job name in the JOB NAME field and press ENTER. The request will then be issued.
The DETACH commands can also be issued while the Job Facility is in a suspended
state.
While this description assumes you are locating strings that are in character format,
you can also locate the hexadecimal representation of a string. See the section,
30.2.2.3, “Customizing the Operation” on page 30-10 for details.
You can use the following commands to find and display specific occurrences of a
string within the currently attached file.
FIRST Locate the first occurrence of a string.
NEXT Locate the next occurrence of a string.
LAST Locate the last occurrence of a string.
PREV Locate the previous occurrence of a string.
The first occurrence of the string DIVISION in the currently attached file will be the
first line of the resulting display.
To find the last occurrence of the same string, all you need enter is:
LAST
Once you have specified a search string, it is remembered and used with any
subsequent EXCL, FIRST, INCL, LAST, NEXT or PREV command that does not
include a string.
By default, the entire file (for example, the full length of every line) is searched for
your string. You can include column and/or line numbers with the command to qualify
the search for a single operation. For example:
NEXT 1= 3= SAMPLE
examines columns 10 through 30 for the next occurrence of SAMPLE. After the
command executes, the defaults are reestablished. To change the column boundaries
for the remainder of your session, use the SET BOUNDS command. (See Chapter 4,
“Defining Column Boundaries” for additional information.)
By including a value after the string, you can limit the search to a specific number of
lines. For example, to find the last occurrence of SAMPLE within the last 200 lines of
currently displayed data, you would enter:
LAST SAMPLE 2==
You can use the INCL command to display every occurrence of a particular string
within a given number of lines. For example, to find every occurrence of the string
TEST-DATA in the next 100 lines of the currently displayed data, you would enter:
INCL TEST-DATA 1==
If you do not specify a number, the site-defined number of lines are searched. (You
can use the SET JOBCNT command to establish your own search limit. See the
CA-Roscoe Command Reference Guide for details.)
You can also also limit the search for the character string to particular columns. For
example, if you want to display every line that does not contain the string
TEST-DATA in columns 30 through 80, you would enter:
EXCL 3= 8= TEST-DATA
If the number of lines to be displayed exceeds the size of your terminal screen, press
one of the PF keys to which a scrolling function is assigned. The INCL or EXCL
operation resumes scanning for the previously specified string (for example,
TEST-DATA). The direction of the scan depends on the value assigned to the PF key.
(The search string is remembered for subsequent use; column number limits and line
number limits apply only to the command with which they are specified.)
Note: Column boundaries specified with the command affect only the execution of
that command. See Chapter 4, “Defining Column Boundaries” for information
about changing boundaries for the terminal session.
If you determine that you want to see the data that follows a particular line, use:
■ The cursor positioning keys to move the cursor to the appropriate line and then
press the ENTER key, or
■ The POINT command. For example, if an EXCL display includes line 150 and
you want to display the lines following it, you would enter:
Doing either of these actions or entering any primary command terminates the
INCL/EXCL operation.
The current setting of the SET MODE command determines how the string specified
with FIRST, NEXT, LAST, PREV, INCL or EXCL is to be treated. See Chapter 3,
“Controlling Character Recognition” for additional information.
In all of the examples used thus far, the search string has not been delimited. With
these commands, delimit the string only when it:
■ Includes a space (like FIRST /TEST DATA/),
■ Is a numeric (like NEXT /519/), or
■ Is the same as a keyword operand or operand abbreviation of the command (like
INCL /JOB/).
By default, CA-Roscoe searches for any set of characters and/or spaces that exactly
match the specified string. To limit the search operation, you can include the qualifier
operands. These operands are WORD, PREFIX, BEGIN, EMBED, END and SUFFIX.
For example, assume the attached file contains the line:
'THE OTHER BROTHER ATE THEIR APPLE DURING THE CONTEST'
and you want to search for the string THE. Without qualification, the words THE,
BROTHER and THEIR match the search string.
By including a qualifier, you can designate the type of string match that is to occur, as
in:
THE WORD Qualifies the string as a word; only THE matches.
THE PREFIX Qualifies the string as beginning a word; only THEIR matches.
THE BEGIN Qualifies the string as beginning or being a word; THE and THEIR
match.
THE EMBED Qualifies the string as contained within a word; OTHER and
BROTHER match.
TEST END Qualifies the string as ending or being a word; only CONTEST
matches.
TEST SUFFIX Qualifies the string as ending a word; only CONTEST matches.
where the string is bound by apostrophes and contains an even number of characters,
as in:
FIRST X'C1'
When using the primary commands FIRST, LAST, NEXT, PREV, INCL or EXCL,
you do not need to delimit the hexadecimal string.
If a line containing (or not containing) the search string is found, it becomes the first
displayed line of the resulting display. By specifying a screen positioning operand with
the command, you can control how the display is positioned. The screen positioning
operands are:
CJUSTIFIED The display margins are to be altered if the entire matching string
does not fall within the current margin. (This is the default
positioning.)
JUSTIFIED The display margins are always to be altered so that the first
character of the string begins in the left-most position of the line.
CENTERED The display margins are to be altered to center the matching string
on the line. If centering would cause an invalid left margin (for
example, less than 1), the display is not altered.
LOCKED The display margins are not to be altered even if the matching string
occurs to the left or right of the current margins.
The files comprising your job are presented to you individually. For example, assume
you are currently viewing a file and now want to view the next sequential file, you can
do this by entering:
NEXT FILE
Note: You can display a list of the files in your job by issuing the STATUS JOB
command.
When using these commands to locate a string, once you have specified the object of
your search (like FILE in this case), it is remembered. To return to the previous file,
you only need enter:
PREV
You can also use the POINT command to position to a specific file. For example, to
view the fifth file in your job, enter:
POINT FILE 5
If you want to begin the display with the second page of the fifth file, you would
enter:
POINT FILE 5 PAGE 2
Caution:
The number of the currently displayed file and page are shown above the Scale
Line to assist you in keeping track of your location within your job output.
If the contents of the file you are viewing exceeds the number of lines in your terminal
screen, you can position the display within the file by:
■ Pressing any of the scrolling PF keys.
■ Using the FIRST, NEXT, LAST and PREV commands with the PAGE or LINE
keyword operand. For example, to position the display to begin with the last page
of the currently displayed file, you would enter:
LAST PAGE
While to position to the first line of that file, you would enter:
FIRST LINE
■ Using the POINT command with the PAGE or LINE operands. For example, to
position the display to begin with line 500 of the currently attached file, you
would enter:
POINT LINE 5==
To position to the first or last line, you would enter:
POINT LINE T or
POINT LINE B
When you are browsing a file, you can assign a one- to six-character name to the line
containing the string; thus enabling you to return to that line later. For example, to
assign the name LOC1 to the first displayed line, you would enter:
NOTE LOC1 or
NOTE QLOC1
To assign a name to a line that is not the first displayed line, qualify the asterisk. For
example, to assign the name LOC2 to the line that is five lines after the first displayed
line, you would enter:
NOTE Q+5 LOC2
Once you have assigned a name to a specific line, you can return to that line at any
time by using the POINT command. To return to the line noted as LOC1, you would
enter:
POINT LOC1
the resulting display shows each assigned name and the file, page and line to which it
is assigned.
If you determine that you no longer need to note a specific line, you can eliminate the
NOTE name with the DROP command, as in:
DROP LOC2
Any outstanding NOTE names are automatically deleted when you detach the member,
attach another member or return to the menu.
7 ATTACH_
8
>
> JOB(INVREPT,5283) SCRL FULL COLS ====1 ===73 F 4 P 1
> <....+....1....+....2....+....3....+....4....+...
============================== T O P ============
=====1 IDENTIFICATION DIVISION.
=====2 PROGRAM-ID. INVREPT.
=====3 ENVIRONMENT DIVISION.
7 ATTACH JOB )
8
> J PENDING
> AWS(PRI.INVREPT) SCRL FULL COLS ====7 ===72
> ...1....+....2....+....3....+....4....+....5....
...... ======================== T O P =================
===1== IDENTIFICATION DIVISION.
===2== PROGRAM-ID. INVREPT.
===3== ENVIRONMENT DIVISION.
7> 8
> JOB(INVREPT,5283) SCRL FULL COLS ====1 ===73 F 4 P 1
> <....+....1....+....2....+....3....+....4....+...
============================= T O P =============
=====1 IDENTIFICATION DIVISION.
=====2 PROGRAM-ID. INVREPT.
=====3 ENVIRONMENT DIVISION.
The center screen in the previous examples shows J PENDING. This note is
provided to remind you that the job may be reattached at any time.
When you reattach the job, the display begins with the first line of the prior display.
To reattach at a different location within the same data, you can:
■ Use the FILE, PAGE and/or LINE operands of ATTACH to specify the desired
starting location, as in:
ATTACH JOB Q FILE 3
ATTACH JOB Q FILE 3 LINE 12==
ATTACH LIB Q FILE 3 PAGE 2
■ Use the POINT command to begin the display with a specific location, as in:
POINT JOB FILE 4
POINT JOB FILE 4 LINE 12==
POINT JOB FILE 4 PAGE 2
or with the line assigned a NOTE name, as in:
POINT LIB NAME1
■ Use the JOB operand with the FIRST, NEXT, LAST and PREV commands to
begin the display the the line containing a specific string, as in:
FIRST JOB /DD/
■ Use the JOB operand with the INCL or EXCL command to begin the display with
a list of lines containing (or not containing) a specific string, as in:
INCL JOB /DD/
If you are working with jobs using AJOB and the Job Facility, you can also attach an
AWS, a data set object or a library member/list, browse that data and then return to
job output. AJOB will be suspended while you process other data. You can issue any
of the following commands to return to the job data and continue AJOB processing:
Note: You can enter the commands shown above as listed, or you can use their
abbreviations which are shown in uppercase (for example, SEL MENU).
These tasks can be performed using primary commands, the Job Facility menu, or a
job selection list.
Multiple users can attach the same job. If you are not the first person to attach the job,
you cannot change the attributes of its files.
If you are the first person to attach the job, you can change the attributes of its files by
using:
■ The modifiable STATUS JOB display.
The display produced by STATUS job can be used to control the printing of a file
at a system or 328x-type printer. (See section, 30.3.3, “Displaying File Attributes”
on page 30-23 for additional information.)
■ The ALTER command.
Use ALTER to change the system printer attributes associated with one or more
files, as in:
ALTER JOB PRINT CLASS A
which changes the SYSOUT class for the currently displayed job to A. If the file
is not currently displayed, you must identify it, as in:
ALTER JOB FILE 3 NOPRINT
which prevents the third file in the job from being printed.
To mark all files to be printed, use the ALL operand. (Use of this operand may
be restricted by site management.) For example, to mark all files to be printed in
Class V, enter:
ALTER JOB ALL PRINT CLASS V
Other operands permit you to change the printer ID (DEST), the number of copies
to be printed (COPIES), and the output form number (FORM).
To alter file attributes from the Job Facility menu, enter the code AT in the
FUNCTION field and the appropriate job name in the JOB/GRP NAME field. The
following example shows how to alter a job from the Job Facility menu.
7 8
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+...
JOB FACILITY
FUNCTION ===> AT
7 8
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+...
ALTER JOB/FILE ATTRIBUTES
Select one of the four OPTIONs listed on the screen and fill in all appropriate fields,
which consist of the following:
OPTION Requires AT, DJ, DH, or X; X returns to invoking Primary
Menu or Job Selection display; AT will issue an ALTER JOB
request; DJ will issue the DETACH JOB request; DH will issue
To alter file attributes from a job selection list, enter the code AT in the command
field to the left of the appropriate job(s). More than one job may be selected. The
following example shows how to alter a job from a job selection list.
---------------------------------------------------------------------------
A - ATTACH C - COPY L - LAST FILE S - STATUS
AT - ALTER CN - CANCEL P - PRINT NN - NTH FILE
PF1/13: MENU PF3/15: EXIT PF7/19: BACK
U V
When you select the ALTER function, the Alter Job/File Attributes panel will be
displayed. It will contain the name of the first job which was selected from the
selection list. See the Alter Job panel and its description in “Jobs: Alter Job Panel
Display” on page 30-18.
You can use a variety of commands to copy all or part of the currently attached job
output file into the AWS. These commands include:
COPY JOB Copies all or part of a file into an AWS, as in:
COPY JOB T [TO SAMPLE]
which copies all of the currently attached job to the top of the AWS
named SAMPLE. (If an AWS name is not included, the data are
copied to the active AWS.)
COPYS JOB Copies one or more lines containing the specified string from the
attached file into an AWS, as in:
COPY JOB /DD/ 28== 53== 1==
which copies every line containing the string DD between line 2800
and 5300 to (or after) line 100 in the active AWS.
COPYX JOB Copies one or more lines not containing the specified string from the
attached file into an AWS.
XCOPY JOB Copies all or part of the attached file from one split screen into the
active AWS of the screen containing the command.
XCOPYS JOB Copies one or more lines containing the specified string from the
attached file in one split screen into the active AWS of the screen
containing the command.
XCOPYX JOB Copies one or more lines not containing the specified string from the
attached file in one split screen into the active AWS of the screen
containing the command.
For additional information about these commands and how they may be used, see
Chapter 15, “AWS: Copying Data Within and Into an AWS.”
You can use the Job Facility menu to copy all or part of a job into the AWS. Enter
the code C in the FUNCTION field and the appropriate job name in the JOB/GRP
NAME field. The following example shows how to copy a job from the primary
menu.
7 8
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+...
JOB FACILITY
FUNCTION ===> C
7 8
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+...
COPY JOB
Select the Copy option and fill in all appropriate fields, as listed below:
To copy a job from a job selection list, enter the code C in the command field to the
left of the appropriate job(s). More than one job may be selected. The following
example shows how to copy a job from a selection list.
---------------------------------------------------------------------------
A - ATTACH C - COPY L - LAST FILE S - STATUS
AT - ALTER CN - CANCEL P - PRINT NN - NTH FILE
PF1/13: MENU PF3/15: EXIT PF7/19: BACK
U V
When you select the COPY function, the Copy Job panel will be displayed. It will
contain the name of the first job which was selected from the selection list. See the
Copy Job panel and its description in “Jobs: Copy Job Display” on page 30-21.
You can display information about the currently attached job by entering:
STATUS
If your job is attached but not currently displayed, you can display the same
information by including the JOB keyword, as in:
STATUS JOB
The following example shows the type of information that is displayed using either
method.
7 >
8
> STA(SAMPLE,2=85) SCRL FULL COLS ====1 ===72 JOB PENDING
....+....1....+....2....+....3....+....4....+....5....+....6....+
ROSCOE ALTER/STATUS PROCESSOR
JOB NAME NO FILE LINE PAGE/ LINE FIND LIMIT I/O COUNT
SAMPLE 2=85 1 1 1 1 2== 1=
U V
The status information includes:
JOB NAME Name of the job currently attached.
NO Number of the job currently attached.
FILE Number of the file currently pointed to.
LINE Number of the line within the file currently pointed to.
PAGE/ Number of the page currently pointed to.
LINE Number of the line within the page currently pointed to.
CPY (Modifiable) Use this field to change the number of copies of a file to be
printed.
NOTE CA-Roscoe-assigned file description.
If you change one or more of the modifiable fields and then decide that these changes
should not be applied, you can:
1. Overtype the appropriate field(s), or
2. Press PA1 or the CLEAR key to refresh the display.
To display the status of a job from a job selection list, enter the code S in the
command field to the left of the appropriate job(s). More than one job may be
selected. The following example shows how to display status information from a job
selection list.
---------------------------------------------------------------------------
A - ATTACH C - COPY L - LAST FILE S - STATUS
AT - ALTER CN - CANCEL P - PRINT NN - NTH FILE
PF1/13: MENU PF3/15: EXIT PF7/19: BACK
U V
When you select the STATUS function, the first job selected will be ATTACHed to
the STATUS JOB display. See the STATUS Job display and its description in “Jobs:
STATUS JOB Display” on page 30-23.
There are a variety of commands you can use to request that one or more files be
printed at a system or 328x-type printer.
■ Use the PRINT command to direct all or the currently attached file to a system or
328x-type printer. For example, if you enter:
PRINT JOB
All of the currently attached file is printed at the 328x-type printer associated with
your terminal.
For a detailed description of the PRINT command and how requests can be
monitored and controlled, see Chapter 7, “Printing Data.”
Use the ALTER command to change a file's print status and alter its system
printer destination. When the job is released, the file will be printed.
■ Use the modifiable STATUS JOB display or a Job List 'A' panel to designate
whether a file is to print at a system or 328x-type printer.
■ Use the CK function of the Job List Facility. The job is terminated, and a listing
of the job output is produced.
You can use the Job Facility menu to print a job. Enter the code P in the FUNCTION
field and the appropriate job name in the JOB/GRP NAME field. The following
example shows how to print a job from the primary menu.
7 8
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+...
JOB FACILITY
FUNCTION ===> P
7 8
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+...
PRINT JOB
U V
Select the PRINT option and fill in all appropriate fields, which consist of the
following:
OPTION requires P or X; X returns to invoking Primary Menu or Job
Selection display; P indicates to issue a PRINT JOB request;
Any other value redisplays the Print Job screen.
JOB NAME The specific job name to be printed.
JOB NUMBER The specific job number name to be printed.
FILE NUMBER File to be printed; Must be numeric.
DESTINATION The printer destination used to print the job file.
CLASS Print class to be assigned to the job file.
FIRST LINE First line of file to be printed. Must be numeric or left
blank.
LAST LINE Last line of file to be printed. Must be numeric or left blank.
FIRST COLUMN First column of file to be printed. Must be numeric or left
blank.
LAST COLUMN Last column of file to be printed. Must be numeric or left
blank.
TAG Name to be assigned to print request. Defaults to user's
CA-Roscoe ID.
OUTPUT TYPE Specification of print format. Must be DEF, ANS, or MCC,
or left blank (defaults to DEF).
TOP MARGIN Number of blank lines to be skipped from the top of the page
before printing begins. Must be numeric or left blank.
(Applicable only when OUTPUT TYPE is specified DEF).
BOTTOM MARGIN Number of blank lines to be skipped at bottom of page.
Must be numeric or left blank. (Applicable only when
OUTPUT TYPE is specified DEF).
PAGE LENGTH Length of paper in number of print lines. Must be numeric
or left blank. (Applicable only when OUTPUT TYPE is
specified DEF).
PAGE WIDTH Width of paper in printing columns. Must be numeric or left
blank.
COPIES Number of times to print file. Defaults to 1.
NOTIFY Specifies whether a notification message is displayed when
the request is printed. Must be YES, NO, or left blank.
SEPARATOR Specifies whether separator pages are included. Must be
YES, NO, or left blank.
ALIGN Specifies whether a physical page alignment is forced. Must
be YES, NO, or left blank.
SEQ NUMS Specifies whether sequence numbers are included when the
data are printed. Must be YES, NO, or left blank.
To print a job from a job selection list, enter the code P in the command field to the
left of the appropriate job(s). More than one job may be selected. The following
example shows how to print a job from a job selection list.
---------------------------------------------------------------------------
A - ATTACH C - COPY L - LAST FILE S - STATUS
AT - ALTER CN - CANCEL P - PRINT NN - NTH FILE
PF1/13: MENU PF3/15: EXIT PF7/19: BACK
U V
When you select the PRINT function, the Print Job panel will be displayed. Fill in the
appropriate fields there to print the job. See the Print Job display and its description
in “Jobs: Print Job Display” on page 30-27.
The PURGE monitor command can be used to cancel a job from the system queue.
Note: Sites have the option of restricting the use of this command; check with your
site system programmer for more information about using PURGE.
For example, to cancel the job named SAMPLE, enter:
PURGE SAMPLE
If there are multiple jobs with the same name, you must specify the number of the job,
as in:
PURGE SAMPLE 1234
You can use the Job Facility menu to cancel a job. Enter the code CN in the
FUNCTION field and the appropriate job name in the JOB/GRP NAME field. Check
the value displayed in the CONFIRM CANCEL field to see whether a confirmation
panel will be presented. The default, YES, will present the Cancel Job Confirmation
panel from which you can confirm the job information. If you do not want to confirm
job cancellations, overtype this value with NO. The following example illustrates
how to cancel a job from the Job Facility menu.
7 8
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+...
JOB FACILITY
FUNCTION ===> CN
When you select the CANCEL JOB function, and the CONFIRM CANCEL value is
YES, the Cancel Job Confirmation panel will be displayed:
7 8
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+...
CANCEL JOB CONFIRMATION
JOB INFORMATION:
1234 SAMPLE AWAITING PRINT (H) 15 ANY LOCAL
From this screen, select Y (YES) to cancel the job listed under JOB INFORMATION.
If you do not want to cancel the job, select N (NO) and you will be returned to the job
menu.
To cancel a job from a job selection list, enter the code CN in the command field to
the left of the appropriate job(s). More than one job may be selected. The following
example shows how to cancel a job from a job selection list.
---------------------------------------------------------------------------
A - ATTACH C - COPY L - LAST FILE S - STATUS
AT - ALTER CN - CANCEL P - PRINT NN - NTH FILE
PF1/13: MENU PF3/15: EXIT PF7/19: BACK
U V
When you select the CANCEL function, the Cancel Job Confirmation panel will be
displayed. Select YES to cancel the job. See the confirmation display and its
description in “Jobs: Confirm Job Cancel.”
The CA-Roscoe library system provides a permanent storage area for data that is in an
AWS. The data are stored in a library member that you create through the SAVE
command. This chapter describes how you can:
■ Attach a library member or Selection List of members.
■ Browse through the attached member or Selection List. While browsing, you can
locate and note the occurrences of specific character strings. You can also browse
other types of attached data (like an AWS) and then return to the data you were
browsing.
■ Perform a variety of library management functions which include:
– Copying all or part of a library member or Selection List into an AWS.
– Printing all or part of a library member or Selection List at a system or
328x-type printer.
– Renaming or deleting a library member.
– Changing library member attributes.
You can perform all of these operations using the Library Facility or primary
commands. Many of these operations can also be performed using the Selection List
provided through the Library Facility.
Note: See Chapter 23, “AWS: Saving and Updating a Library Member” for
additional information.
You can include a function code and library name with this command.
If you include a function code and that function has a panel associated with it, you can
bypass the Library Facility menu and display the function panel. For example, if you
enter:
LIBRARY C COBTEST
the Copy Function Panel is displayed with COBTEST in the MEMBER field.
If you are currently using the Library Facility, you can redisplay the menu by entering:
SELECT MENU
The variable information shown on the menu is determined by the format of the menu.
To change the format, you can use the command:
SELECT ALT [v]
If you omit the number v, you will proceed sequentially through the different formats.
If you specify a number, it can be:
1 To show the last specific member name.
2 To show the last executed RPF program name.
3 To show the last generic member name.
4 To show the last prefix or key.
7 >
8
> LIB() SCRL FULL COLS ====1 ===79
....+....1....+....2....+....3....+....4....+....5....+....6....+....7
LIBRARY FACILITY
FUNCTION ==>
The field ACTION in indicates whether the function is performed directly or requires
additional information. For example, the information you provide through the menu is
sufficient to attach a member (function code A) but is insufficient to rename a member
(function code R).
=[code.code]
■ If you enter only the equal sign (=), you are returned to the menu.
■ If you specify =X, the Data Set Facility is terminated.
■ If you specify any other code (like =C), the appropriate function-related panel is
displayed.
If the function-related panel is displayed while the screens are split, you can use PF
keys to scroll the panel.
All of the Library Facility functions are described in detail in Chapter 34, “Library:
Performing Library Management Tasks.”
The information is displayed as a Selection List in the Execution Area of the screen.
This allows you to issue primary commands in the Command Area while working with
the Selection List.
The first line of a Selection List contains a top marker (==TOP==). If the bottom
marker (==BOTTOM==) is not displayed, the number of members in the list exceeds
the screen size. You can use PF keys to scroll within the List.
The information displayed in the Selection List is separated into specific fields. Some
fields contain Library information and remain constant as you scroll through the
Selection List (for example, the SIGNON KEY and MEM fields.) There are also
fields which contain member-specific information. By default, these fields are
displayed alphabetically by member name, or by the order designated by the SET LIB
ORDER command.
To designate a specific Selection List order, enter the field and order criteria, as in:
SET LIB ORDER LINES ASC
See the CA-Roscoe Command Reference Guide for more information about using the
SET LIB ORDER command.
The amount of information available with each Selection List exceeds the width of
80-column screens. The information is, therefore, divided into alternate display
formats. To view the different formats sequentially, enter the command:
SELECT ALT
To view a specific format, enter the number of that format with the command, as in:
SELECT ALT 2
See Chapter 32, “Library: Attaching Library Data at the Terminal,” for information
about displaying each type of Selection List. The information includes a description of
the fields comprising each list. The alternate display numbers shown with the
description are for 80-column screens. Additional formats (containing variations of the
information) are available at terminals supporting wider screen sizes.
If you specify the same function code multiple times, they are processed sequentially.
If you specify different function codes, the codes are processed sequentially within the
following function hierarchy:
X Terminate Library Facility.
D Delete member.
R Rename member.
AT Alter member attributes/description.
P Print a member.
I Inquire about member.
C Copy a member.
A Attach member.
| E Edit a member
| SU Submit a member
The following example illustrates how you can enter multiple functions codes on a
Selection List. You can further qualify any function by specifying information in the
STATUS field (the second shaded area). (See Chapter 34, “Library: Performing
Library Management Tasks” for information about each of the functions you can
perform through a Selection List.)
7 >
8
> 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 82 = 223 2==== 117=1
MEMBER STATUS DESCRIPTION LINES ATR SEQNO
XYZ.ABLE 1 SHR N
A XYZ.BEGINJCL JCL: Link-Edit 1=
I XYZ.COBTEST1 Sample COBOL Prog. 193 SHR =
XYZ.COBTEST2 4=3 SHR =
D XYZ.JUNK 87 SHR N
R XYZ.MYRPF DOJCL RPF: Builds JCL 519
Notes:
■ All function codes are evaluated before any one is executed. If an invalid or
incomplete function is specified, the functions are placed in a pending state and a
message is displayed. To resume execution, you must either:
1. Correct the invalid/incomplete function, or
2. Remove it by typing a space over.
■ If multiple function codes are specified and one of them is X, all of the other
function codes are ignored. The Library Facility is immediately terminated.
7 >
8
> 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 82 = 223 2==== 117=1
MEMBER STATUS DESCRIPTION LINES ATR SEQNO
U V
The more functions you perform through the same Selection List, the more completion
messages will be displayed. At any point, you can redisplay the Selection List with the
most current information (for example, the deleted members removed and renamed
members shown with their new names). To do this, enter the command:
REFRESH
■ Selected Members:
You can use wildcard characters to produce a qualified Selection List containing
specific information about members that belong to you or another user. For
example, to display a Selection List containing only those names that include the
characters JCL, you would enter:
ATTACH LIB QJCLQ or ATTACH LIB XYZ.QJCLQ
or
ATTACH LIB XYZ.QJCLQ
The following table shows the wildcard characters that you can specify through
the primary command or the Library Facility menu.
7 >
8
> LIB() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6.
LIBRARY FACILITY
FUNCTION ===> A
To create a qualified Selection List, type an A in the FUNCTION field and the
appropriate prefix in the PREFIX field. Then use wildcard characters with the name
typed in the MEMBER field.
As illustrated in the following example, you can use the SEARCH field to further limit
the members that are to be included in the List.
7 >
8
> LIB() SCRL FULL COLS ====1 ===79
....+....1....+....2....+....3....+....4....+....5....+....6.
LIBRARY FACILITY
FUNCTION ==> A
7 >
8
> 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 82 = 223 2==== 117=1
MEMBER STATUS DESCRIPTION LINES ATR SEQNO
XYZ.ABLE 1 SHR NO
XYZ.BEGINJCL JCL: Link-Edit 1= SHR =7
XYZ.COBTEST1 Sample COBOL Prog. 193 SHR ==
XYZ.COBTEST2 4=3 SHR ==
XYZ.JUNK 87 SHR NO
XYZ.MYRPF RPF: Builds JCL 519 SHR NO
U V
You can use this Selection List to perform one or more of the following function:
A Attach a member
AT Alter attributes
C Copy a member
D Delete a member
I Display member information
P Print a member
R Rename a member
X Terminate Library Facility
* Position Selection List
Type the appropriate code(s) in the first shaded area shown in the previous figure.
With Alter, Copy, Print and Rename, you must provide additional information in the
STATUS field. (See the appropriate sections for details.) After performing a function,
the STATUS field will indicate the result of the operation.
The amount of information provided through the 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 by entering:
SELECT ALT [v]
where v is the number of the display to be viewed next. If you omit the number, you
will proceed sequentially through all of the different displays.
The ALT field in the following table contains the number of the alternate display in
which each field appears on an 80-column screen. If you are using a terminal
supporting a wider screen, additional displays (containing variations of the same
information) are available.
The first two lines in the Execution Area (following the TOP marker) remain constant
as you scroll through the Selection List and show:
SIGNON KEY Sign-on key associated with the individual whose members are
included in the display.
MATCH Optional field included only when selection criteria was used to
produce the List.
MEM Number of library members included in the Selection List.
EXCL Number of library members that site management excluded from the
display.
BLOCKS Number of library blocks used by the members included in the List.
M-LINES Maximum number of lines the owner of these members may save in
the library or N/A if the owner has 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
the information shown in the following table.
If your terminal screen displays more than 80 characters, you can issue SELECT ALT
4 to view all of the preceding information. At all terminals, you can place all of this
information into an AWS by using the FULL operand of the COPY (LIB) command.
An additional field is provided when you view or copy all of the library information.
The field is named CRT and indicates how the member was created. It will contain:
■ Blanks, if the member was created online.
■ BCH, if the member was created by a batch program.
■ MON, if the member was created by a Monitor command.
■ POS, if the member was created by an obsolete post-processor.
The 'LIB' operand is required if the Library Facility is not active. For example, to
sort a displayed Selection List by year of member creation date, in ascending order,
enter:
ORDER CREATED COL 7 8 ASC
Notice that the CREATED field is on the second alternate screen. The list will be
reordered even if the CREATED field is not displayed. Use the SELECT ALT
command to display the CREATED field.
You can also reorder more than one field at a time. For example, to reorder a
Selection List by sequence attributes and ascending line count, enter:
ORDER LIB SEQNO LINES ASC
Sorting is done in order of the operands specified. So, in the last example, the
Selection List is reordered by sequence attributes, and then by line counts.
Note: A maximum of six order criteria are permitted.
You can set the default order of a Library Selection List to a specific field. Every
time you attach a Library Selection List, it will be sorted by that criterion. Use the
SET LIB ORDER command, as in:
SET LIB ORDER LINES
Any subsequent order commands will override this setting. To reset the Library
Selection List display to the site default, specify:
SET LIB ORDER DEFAULT
To browse a member that belongs to another user, you must include that user's prefix.
For example, to attach the member COBPROG that belongs to the individual assigned
the prefix ABC, you would enter:
ATTACH ABC.COBPROG
Operands of this command allow you to control the display. For example, you can:
■ Begin the display with a specific line, as in:
ATTACH TESTJCL LINE 12==
■ Begin the display with the first line containing a specific string, as in:
ATTACH TESTJCL /SYSOUT=/
Additional operands allow you to qualify the string. For example, to begin the display
with the first line containing a word that begins with SYS, you would enter:
ATTACH TESTJCL /SYS/ PREFIX
which will start at line 1200 of the member TESTJCL to search for the first word
beginning with the prefix SYS.
7 >
8
> LIB() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6.
LIBRARY FACILITY
FUNCTION ===> A
7 >
8
> 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 352 = 971 2==== 117=1
MEMBER STATUS DESCRIPTION LINES ATR SEQNO
7 8
>
> LIB(XYZ.COBTEST1) SCRL FULL COLS ====1 ===73 LINE =====1
> <....+....1....+....2....+....3....+....4....+....5..
============================= T O P ================
=====1 IDENTIFICATION DIVISION.
=====2 PROGRAM-ID. COBTEST.
=====3 ENVIRONMENT DIVISION.
=====4 CONFIGURATION SECTION.
=====5 SOURCE-COMPUTER. IBM-3=81.
=====6 OBJECT-COMPUTER. IBM-3=81.
The System Information Line begins with LIB and is followed by the prefixed name of
the currently attached library member.
The right side of the System Information Line shows the number of the first line in the
current display. This is to assist you in keeping track of where you are as you scroll
forward and backward through the data.
The attached data itself is delimited by a top (==TOP==) and bottom (==BOTTOM==)
marker. You can position the display by using primary commands and/or the PF keys
to which scrolling functions are assigned.
When you are browsing a Selection List, you can use the SELECT command to
change the display by entering:
SELECT ALT To position to the next sequential alternate display format. To
position to a specific alternate format, specify a number with the
command, as in:
SELECT ALT 3
This chapter describes how, while browsing the contents of a library member or
Selection List, you can:
■ Detach the Library Facility.
■ Locate the specific occurrences of a string within the attached member or
Selection List.
■ Position the display to a specific line, or to a line to which you have assigned a
name.
■ Reattach the library member or Selection List after browsing an AWS, a data set
object or job output file.
The Library Facility is also detached by entering the function code X on the menu,
any function panel or the Selection List. (If you enter X on the Selection List with
other function codes, those functions will be ignored.)
If you execute a command that causes output to the Execution Area (like ATTACHing
an AWS) or if you press the CLEAR key, the Library Facility is placed in a pending
state and can be reattached at any time.
While this description assumes you are locating strings that are in character format,
you can also locate the hexadecimal representation of a string. See 33.2.3,
“Customizing the Operation” on page 33-5 for details.
In this example, the first line containing the string PROCEDURE in the member
COBTEST1 will be the first displayed line.
Once attached, you can use the following commands to find and display specific
occurrences of a string.
FIRST Locate the first occurrence of a string.
NEXT Locate the next occurrence of a string.
LAST Locate the last occurrence of a string.
PREV Locate the previous occurrence of a string.
The first occurrence of the string DIVISION in the currently attached member will be
the first line of the resulting display.
To find the last occurrence of the same string, all you need enter is:
LAST
Once you have specified a search string, it is remembered and used with any
subsequent EXCL, FIRST, INCL, LAST, NEXT or PREV command that does not
include a string.
By default, the entire member (for example, the full length of every line) is searched
for your string. You can include column and line numbers with the command to
qualify the search for a single operation. For example:
NEXT 1= 3= SAMPLE
After the command executes, the defaults are reestablished. To change the column
boundaries for the remainder of your session, use the SET BOUNDS command. (See
Chapter 4, “Defining Column Boundaries” for additional information.)
By including a value after the string, you can limit the search to a specific number of
lines. For example, to find the last occurrence of SAMPLE within the last 200 lines of
currently displayed data, you would enter:
LAST SAMPLE 2==
If you do not specify a number, every line is searched. You can also limit the search
for the character string to particular columns.
Note: Column boundaries specified with the command affect only the execution of
that command. See Chapter 4, “Defining Column Boundaries” for information
about changing boundaries for the terminal session.
For example, if you want to display every line that does not contain the string
TEST-DATA in columns 30 through 80, you would enter:
EXCL 3= 8= TEST-DATA
If the number of lines to be displayed exceeds the size of your terminal screen, press
one of the PF keys to which a scrolling function is assigned. The INCL or EXCL
operation will resume scanning for the previously specified string (like TEST-DATA).
The direction of the scan depends on the value assigned to the PF key. (The search
string is remembered for subsequent use; column number limits and line number limits
apply only to the command with which they are specified.)
If you determine that you want to see the data that follows a particular line, use:
■ The cursor positioning keys to move the cursor to the appropriate line and then
press the ENTER key, or
■ The POINT command. For example, if an EXCL display includes line 150 and
you want to display the lines following it, you would enter:
POINT LINE 15=
The resulting display will begin with line 150.
Doing either of these actions or entering any primary command terminates the
INCL/EXCL operation.
Note: When you create an INCL/EXCL display from a Selection List, you can enter
any function code(s). If a function results in another display (that is, attaching
an entry in the list), the INCL/EXCL operation is terminated.
The current setting of the SET MODE command determines how the string specified
with FIRST, NEXT, LAST, PREV, INCL or EXCL is to be treated. See Chapter 3,
“Controlling Character Recognition” for additional information.
In all of the examples used thus far, the search string has not been delimited. With
these commands, you only need to delimit the string when it:
■ Includes a space (like FIRST /TEST DATA/),
■ Is a numeric (like NEXT /519/), or
■ Is the same as a keyword operand or operand abbreviation of the command (like
INCL /JOB/).
By default, CA-Roscoe searches for any set of characters or spaces that exactly match
the specified string. To limit the search operation, you can include the qualifier
operands. These operands are WORD, PREFIX, BEGIN, EMBED, END and SUFFIX
and you want to search for the string THE. Without qualification, the words THE,
BROTHER and THEIR match the search string. By including a qualifier, you can
designate the type of string match that is to occur, as in:
THE WORD Qualifies the string as a word; only THE matches.
THE PREFIX Qualifies the string as beginning a word; only THEIR matches.
THE BEGIN Qualifies the string as beginning or being a word; THE and THEIR
match.
THE EMBED Qualifies the string as contained within a word; OTHER and
BROTHER match.
TEST END Qualifies the string as ending or being a word; only CONTEST
matches.
TEST SUFFIX Qualifies the string as ending a word; only CONTEST matches.
where the string is bound by apostrophes and contains an even number of characters,
as in:
FIRST X'C1'
When using the primary commands FIRST, LAST, NEXT, PREV, INCL or EXCL,
you do not need to delimit the hexadecimal string.
If a line containing (or not containing) the search string is found, it becomes the first
displayed line of the resulting display. By specifying a screen positioning operand with
the command, you can control how the display is positioned. The screen positioning
operands are:
CJUSTIFIED The display margins are to be altered if the entire matching string
does not fall within the current margin. (This is the default
positioning.)
JUSTIFIED The display margins are always to be altered so that the first
character of the string begins in the left-most position of the line.
CENTERED The display margins are to be altered to center the matching string
on the line. If centering would cause an invalid left margin (for
example, less than 1), the display is not altered.
LOCKED The display margins are not to be altered even if the matching string
occurs to the left or right of the current margins.
When browsing the Selection List, entering an * (asterisk) in the first unprotected field
for a specific entry repositions the display to begin with that entry.
To assign a name to a line that is not the first displayed line, qualify the asterisk. For
example, to assign the name LOC2 to the line that is five lines after the first displayed
line, you would enter:
NOTE Q+5 LOC2
Once you have assigned a name to a specific line, you can return to that line at any
time by using the POINT command. To return to the line noted as LOC1, you would
enter:
POINT LOC1
If you determine that you no longer need to note a specific line, you can eliminate the
NOTE name with the DROP command, as in:
DROP LOC2
Any outstanding NOTE names are automatically deleted when you detach the member,
attach another member or return to the menu.
7 ATTACH_
8
>
> LIB() SCRL FULL COLS ====1 ===73 LINE ==1
> <...+....1....+....2....+....3....+....4....+....
============================== T O P ============
=====1 IDENTIFICATION DIVISION.
=====2 PROGRAM-ID. INVREPT.
=====3 ENVIRONMENT DIVISION.
7 ATTACH LIB )
8
> L PENDING
> AWS(PRI.INVREPT) SCRL FULL COLS !!!!7 !!!72
> ...1....+....2....+....3....+....4....+....5....
...... ======================== T O P =================
!!!1!! IDENTIFICATION DIVISION.
!!!2!! PROGRAM-ID. INVREPT.
!!!3!! ENVIRONMENT DIVISION.
7 >
8
> LIB() SCRL FULL COLS ====1 ===73 LINE ==1
> <...+....1....+....2....+....3....+....4....+....
============================= T O P =============
=====1 IDENTIFICATION DIVISION.
=====2 PROGRAM-ID. INVREPT.
=====3 ENVIRONMENT DIVISION.
The center screen above shows L PENDING. This note is provided to remind you that
the Library Facility may be reattached at any time.
When you reattach the Library Facility, the display begins with the first line of the
prior display. To reattach at a different location within the same data, you can:
■ Use the LINE operand of ATTACH to specify the desired line number, as in:
ATTACH LIB Q LINE 5==
■ Use the POINT command to begin the display with the line assigned a NOTE
name, as in:
POINT LIB NAME1
■ Use the LIB operand with the FIRST, NEXT, LAST and PREV commands to
begin the display the line containing a specific string, as in:
FIRST LIB /DD/
■ Use the LIB operand with the INCL or EXCL command to begin the display with
a list of lines containing (or not containing) a specific string, as in:
INCL LIB /DD/
This chapter describes how you can perform any of the following functions during
your terminal session:
■ Alter a member's access attribute, sequence number attribute or description.
■ Copy all or part of the attached member or Selection List.
■ Delete one or more library members.
■ Inquire about a member.
■ Print all or part of the attached member or Selection List.
■ Rename one or more members.
These functions can be performed using primary commands, the Library Facility menu
or the appropriate Selection List.
You cannot modify the contents of a library member. To change a member's contents,
you must place a copy of it in an AWS. When you have finished making your
changes, you must use the UPDATE command to update the original member contents
with the contents of the active AWS. For example, to renumber the contents of the
member SAMPLE, you might enter:
FETCH SAMPLE
RENUMBER
UPDATE Q
ALTER does not affect any attributes that are not specified with the command.
The following table summarizes the values you can specify with this command. These
values can also be used when using a primary command to rename a library member.
7 >
8
> LIB() SCRL FULL COLS ====1 ===79
....+....1....+....2....+....3....+....4....+....5....+....6....+....7
LIBRARY FACILITY
FUNCTION ==>
The following example illustrates how you can use the Selection List to change the
description and attributes of a member EXPLICITly.
7 >
8
> 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 82 = 223 2==== 117=1
MEMBER STATUS DESCRIPTION LINES ATR SEQNO
XYZ.ABLE 2 SHR NOSEQ
XYZ.BEGINJCL JCL: Link-Edit 1= SHR =73,8
XYZ.COBTEST1 Sample COBOL Prog. 193 SHR ==1,6
AT XYZ.COBTEST2 test cobol prog._ 4=3 SHR =
After typing an AT before the name of the appropriate member, tab to the
DESCRIPTION, ATR or SEQNO field and overtype the current values. (You can use
the values described in the table in the first subsection of 34.1, “Altering Member
Attributes” on page 34-2.
If no line numbers are included, all of the attached data are copied to the designated
destination within the active AWS.
You must indicate the appropriate AWS destination by specifying one of the
following:
v Copy at or after the line specified by v.
T Copy to the top of the AWS.
B Copy to the bottom of the AWS.
* Copy after the line at which the AWS pointer is currently positioned.
R Replace the contents of the AWS with the copied data.
Each of these commands allows you to limit the number of lines to be copied, as in:
COPYS LIB /DATE-FIELD/ 9== 18== 1==
which causes every line containing the string DATE-FIELD within lines 900 through
1800 of the currently attached data to be copied at or after line 100 in the AWS.
When copying from a Selection List, you can designate whether you want the header
portion of the list included with the data. (By default, the header is included.) For
example, if a Selection List is displayed:
COPYX LIB /JCL/ T NOHDR
copies every line not containing the string JCL within the currently attached Selection
List to the top of the AWS. No header information is included in the copied data.
You can also use these same commands to copy a library member that is not currently
attached into an AWS. To do so, specify the member name with the command, as in:
COPY COBTEST1 ... or
COPYS COBTEST1 /DATE-FIELD/ ...
Other commands that you can use to bring one or more library members into the
active AWS include:
FETCH Brings all or part of a library member into the active AWS, as in:
FETCH INVLIST or
FETCH INVLIST 5== 27==
where all (or lines 500 through 2700) of the member named INVLIST are
copied into the active AWS. If the active AWS contained data, that data
are overlaid by the contents of the member.
To bring in data from a library member owned by another individual,
include the person's CA-Roscoe prefix with the member name, as in:
FETCH RLM.LISTSEQS
Optionally, you can renumber the data that you bring into the AWS, as in:
FETCH INVLIST START 1== BY 5=
where the data, after being placed in the AWS, is renumbered starting with
100 and incremented by 50.
CHAIN Brings one or more members into the active AWS in the order specified in
the command, as in:
CHAIN MEM1 MEM2 MEM3
MERGE Brings one or more members into the active AWS and merges the contents
of those members by their line numbers.
A library member's access attribute determines the extent of access (like ATTACH,
COPY, and so on) other CA-Roscoe users have to that member. If a member has an
EXECONLY or RESTRICTED access attribute, only the owner of that member can
access it. While site management has the option of changing the extent of access their
users have to SHARED members, the default is that any CA-Roscoe user can access
members with this attribute.
The following example illustrates how you might use this panel to place one copy of
lines 900 through 1800 of the member COBTEST1 at the top of the active AWS.
7 8
>
> LIB() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....
COPY LIBRARY MEMBER
OPTION ===> S
1ST LINE Enter the number of the first line to be copied. If omitted,
the operation begins with the first line.
LAST LINE Enter the number of the last line to be copied. If omitted,
the operation ends with the last line.
AWS TARGET Enter the destination of the operation by specifying:
v Number of the line at or after which the data are to be
copied within the active AWS.
* After the line at which the AWS pointer is currently
positioned.
T Before the first line of the active AWS.
B After the last line in the active AWS.
R Replace the contents of the active AWS with the
copied data.
Unless changed, the default is R.
AWS COPY COUNT Enter the number of copies of the attached data are to be
placed in the active AWS. If omitted, the default is 1.
LIST HEADERS Enter YES or NO to designate whether Selection List header
lines are to be included in the copy operation.
If the Selection List is not provided through the Copy Function panel, you can
perform any of the functions that are valid with the Selection List.
To copy members, place a C before the name of each appropriate member. Then, tab
to the STATUS field and enter a destination code. (If the Selection List is produced
through the Copy Function Panel and you omit a destination code, the member
replaces the current contents of the active AWS.)
The following example illustrates how you can copy multiple library members from a
Selection List.
7 >
8
> 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 82 = 223 2==== 117=1
MEMBER STATUS DESCRIPTION LINES ATR SEQNO
U V
Notes:
■ If you delete a member and then determine that you need it, contact your site
management. As long as the member has been saved on a library system backup,
it can be restored.
■ When deleting a member through the Delete Function panel or the Selection List,
you have the option of requesting that a Delete Confirmation panel be displayed.
You can control this option using the ATTACH LIB command or the Library
Facility menu.
– When CONFIRM DELETE is in effect, a Delete Confirmation panel is
displayed. This panel contains the name of each member you marked for
deletion. You must confirm this operation before it is performed.
– When CONFIRM DELETE is not in effect, the designated data members are
deleted when you press the ENTER key.
See 34.3.4, “Delete Confirmation Panel” on page 34-14 for additional information.
The following example illustrates how you might use this panel to delete the member
named JUNK.
7 8
>
> LIB() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....
DELETE LIBRARY MEMBER
OPTION ===> S
As illustrated in the following example, you can delete one or more members by
typing a D before each appropriate member name.
7 >
8
> 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 82 = 223 2==== 117=1
MEMBER STATUS DESCRIPTION LINES ATR SEQNO
The following example illustrates the confirmation panel that might be displayed when
CONFIRM DELETE is in effect and you attempt to delete one or more members
through a Selection List.
7 >
8
> LIB() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....
CONFIRM ==> ENTER (Y)ES TO CONFIRM DELETE
MEMBER CREATED UPDATED ACCESS DESCRIPTION
COBTEST1 =6/=4/87 11/=9/88 11/=9/88 Sample COBOL Prog.
JUNK 12/=1/85 =6/=6/86 =6/=6/86
To delete the entries, enter either YES or Y in the CONFIRM field. Entering any other
value in this field terminates the operation. (You will be returned to the Delete
Function panel or the previous Selection List. The STATUS field of that Selection List
will contain *DENYDEL.)
If you enter a primary command when a delete confirmation panel is displayed, the
operation is either terminated or paused. If the command is:
■ Related to the Library Facility (for example, SELECT MENU): the operation is
terminated and the action is performed.
■ Not related to the Library Facility (for example, ATTACH DSN): the operation is
paused. The panel is redisplayed when the Library Facility is reattached, allowing
you to complete the operation.
or, specifying the I function code and member name on the Library Facility menu, as
in the following example.
7 >
8
> LIB() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6.
LIBRARY FACILITY
FUNCTION ===> I
or, specifying the I function code on the Selection List, as in the following example.
7 8
>
> 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 82 = 223 2==== 117=1
MEMBER STATUS DESCRIPTION LINES ATR SEQNO
XYZ.A 1 SHR NOSEQ
XYZ.BEGINJCL JCL: Link-Edit 1= SHR =73,8
I XYZ.COBTEST1 Sample COBOL Prog. 193 SHR ==1,6
XYZ.COBTEST2 4=3 SHR ==1,6
7 8
>
> LIB() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6.
LIBRARY MEMBER INFORMATION
U V
The member information includes:
PREFIX Prefix assigned to the individual who owns the member.
NAME Name of the library member.
LAST ACCESS Date the member was last accessed.
LAST UPDATE Data the member was last updated.
CREATION Date the member was created.
RECORD COUNT Number of lines in the member.
BLOCK COUNT Number of library blocks used by the member.
ATTRIBUTE Member's access attribute.
SEQUENCE Member's sequence number attribute.
DESCRIPTION Member's description, if available.
The last three fields are unprotected. See 34.1, “Altering Member Attributes” on
page 34-2 for information about changing these fields.
When the data are scheduled for printing, a message is displayed. It contains the
printing location, tag (if specified) and print request number assigned by CA-Roscoe.
Once scheduled, all references to a specific print request must be by its tag or number.
All of the operands of the PRINT command can be used when printing attached data.
For example, to print only lines 500 through 2500 of the currently attached data, you
would enter:
PRINT LIB 5== 25==
While Selection Lists do not include line numbers, you can treat them as though they
are numbered from 1 by 1.
Note: See Chapter 7, “Printing Data” for additional information about the PRINT
command and how requests can be monitored and controlled.
The following example illustrates how you might use this panel to print a copy of the
member named MYPROG.
7 >
8
> LIB() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6...
PRINT LIBRARY MEMBER
OPTION ===> S
You can use the following fields to customize the print operation.
1ST LINE Enter the number of the line at which the print operation is to
begin. If omitted, the first line is assumed.
LAST LINE Enter the number of the last line to be included in the print
operation. If omitted, the end of the member/Selection List is
assumed.
While Selection Lists do not contain line numbers, treat them as
though they are numbered from 1 by 1.
To print one or more members, type a P before the name of each member. By default,
the request will print at the printing location assigned for the terminal you are using.
To print at a different location, tab to the STATUS field and enter the appropriate
destination name.
The following example illustrates how you can print multiple entries from the
Selection List.
7 >
8
> 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 82 = 223 2==== 117=1
MEMBER STATUS DESCRIPTION LINES ATR SEQNO
In this example, the member BEGINJCL will print at the terminal's default printing
location. The member COBTEST2 will print at the location identified as PR99.
Optionally, you can also change the description or attributes of the member, as in:
RENAME TESTJCL PRODJCL /Production JCL/ SHARED SEQ
See 34.1, “Altering Member Attributes” on page 34-2 for additional information.
7 8
>
> LIB() SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....
RENAME LIBRARY MEMBER
OPTION ===> S
OPTION Enter the code that is appropriate to perform the desired action. The
codes are:
S Rename a single member.
M Display a Selection List. (If only a prefix is specified, the
Selection List will contain all members associated with that
prefix. If the MEMBER field contains a name that includes
wildcard characters, a qualified Selection List is displayed.)
PREFIX Enter the two- or three-character prefix assigned to the individual
who owns the member. (Required only if the displayed prefix is
inappropriate.)
MEMBER Enter the member's current name. (Required only if the displayed
name is inappropriate.)
NEW PREFIX Enter the two- or three-character prefix assigned to the individual
who owns the member. (Site management may allow users to
rename members belonging other users.)
NEW NAME Enter the new member name. The name must comply with the
CA-Roscoe member naming conventions and must not currently
exist in your library.
To rename one or more members, use the R function code and type the member name
in the STATUS field. (When the Selection List is redisplayed, the STATUS field will
contain *RENAMED - confirming the operation performed successfully.)
7 8
>
> LIB() SCRL FULL COLS ====1 ===72 LINE ====1
....+....1....+....2....+....3....+....4....+....5....+....6..
==================================== T O P ===================
SIGNON KEY MEM EXCL BLOCKS LINES
SMITH 352 = 971 5=984
MEMBER STATUS DESCRIPTION LINES ATR SEQNO
XYZ.A 1 SHR N
XYZ.BEGINJCL JCL: Link-Edit 1= SHR =
XYZ.COBTEST1 Sample COBOL Prog. 193 SHR =
R XYZ.COBTEST2 INVREPT 4=3 SHR =
XYZ.JUNK 87 SHR N
XYZ.MYRPF RPF: Builds JCL 519 SHR N
The facilities provided with BulletinBoard System can be used by all CA-Roscoe
users, and can be performed in conjunction with other CA-Roscoe activities.
where:
pfx is the prefix of the profile containing the panels and programs comprising
this facility. The default is RBX.
This is the distributed RPF program that invokes the BulletinBoard System.
At initial sign-on, the BBS (BulletinBoard System) News Announcement screen will
be presented. After you view this screen, it will not be presented again unless you
specifically request it (using PF2/14 for NEWS or through UTILITY.) If any new
announcements are posted, this screen will be presented automatically at your next
sign-on.
All tasks available in each mode are PF-key functions and are displayed at the bottom
of each screen. To send a message or perform any function, use the corresponding
PF-key. Some screens have functions which are specific to one task only. Many
screens have the same PF-key options. This means that a particular PF-key number
may have several different functions, changing from screen to screen, according to the
mode level. If a PF-key is blank, it has no function.
The following PF-keys have the same function on every screen (or are disabled):
PF7/19 Backward Scrolls the display backward, toward the top of the member.
PF8/20 Forward Scrolls the display forward, toward the bottom of the member.
PF10/22 Top Makes the base entry for the thread the first line of the screen.
PF11/23 Bottom Displays the bottom of the message text.
And on every screen except the one that is used to create a thread title,
PF3/15 Exit Returns to the previous mode level. (On the "create a thread title"
screen, PF3/15 CANCEL cancels the thread that was just created.)
7 8
-- BBS -----------------------------------------------------------------------
Thread Titles
New Message Thread Entry-2 ZZB New Message Thread Entry-1 ZZC
No Threads------------------ ZZD
------------------------------------------------------------------------------
PF1 Utility 2 Ignore! 3 Exit 4 Lastread 5 Firstnew 6 Addmsg
7 Backward 8 Forward 9 Refresh 1= Top 11 Bottom 12 Zmsg
U V
The top line, containing hyphens, is the Error/Status line. It contains the current
processing RPF ID. In this case, it will be BBS, for BulletinBoard System. Any
messages returned from BBS will appear on this line.
The portion of the screen just below the Error/Status line contains the titles of all
message threads. A thread is a series of one or more related messages. The threads,
as listed here, are the initial message topics. All related responses are threaded to this
message entry.
Each thread can contain 999 messages. All threads have prefix codes, beginning with
ZZZ, through AAA. Each new thread is given a corresponding code. This can be
used as a quick reference, to associate the thread by code instead of its title. This
code will be the prefix of all of the thread's entries.
By default, the threads that have not been viewed will be in high intensity. If you
have already viewed the thread and all of its corresponding messages, the thread will
be in low intensity.
Note: The threads are highlighted following CA-Roscoe standard panel attribute
coding. The Utility function (PF1/13) allows the changing of these thread
attributes. By default, unread threads and messages are unprotected and high
intensity (UH), and the threads and messages that have been read are
unprotected and low (normal) intensity (UL).
All of the possible tasks a user can perform from the Message Selection list are listed
at the bottom of the screen as PF-key functions. The PF-keys that are specific to this
screen are:
PF1/13 Utility Brings up the BulletinBoard Utility menu from which options may
be set, messages and threads can be printed, the News can be
viewed, or the user profile can be condensed.
PF2/14 Ignore! Marks a selected thread in low (normal) intensity, as if it was
read. If there are any new entries added, they will not be marked
by high intensity. No entries will be highlighted, so the entire
thread can be "ignored."
If Ignore! is already active, PF2 will deactivate Ignore!
PF4/16 Lastread Brings up the last message you read.
PF5/17 Firstnew Brings up the first new message you have not read. (NEW
denotes not yet viewed).
PF6/18 Addmsg Adds a thread or a message to a thread, using the AddMsg panel.
PF9/21 Refresh Refreshes the screen with any new information.
PF12/24 Zmsg Sends another CA-Roscoe user a message, using the Zmsg panel.
7 -- BBS -----------------------------------------------------------------------
8
New Message Thread Entry-1 Prefix:
New Message Thread Entry-1 === This will be entry #1 =>ZZC ==1
This will be entry #2 =>ZZC ==2 This will be entry #3 =>ZZC ==3
This will be entry #4 =>ZZC ==4 This will be entry #5 =>ZZC ==5
This will be entry #6 =>ZZC ==6 This will be entry #7 =>ZZC ==7
This will be entry #8 =>ZZC ==8
------------------------------------------------------------------------------
PF1 Utility 2 Ignore! 3 Exit 4 Prevnew 5 Nextnew 6 Addmsg
7 Backward 8 Forward 9 Refresh 1= Top 11 Bottom 12 Zmsg
U V
The first line following the error/status line is the title of the thread you selected from
the previous screen. The prefix of that thread is on the far right of the same line.
The title is also the first thread of the list, and will have the code 000. Each
subsequent entry is given a code incremented by one. This code is added to the prefix
to create a member name for the thread entry. Each thread entry can be associated by
its member name, and its title.
This screen also has PF-key functions listed on the bottom. The PF-keys specific to
this screen are:
PF4/16 Prevnew Displays the first new message that precedes the thread you are
currently displaying. (NEW is the same as not yet viewed.)
PF5/17 Nextnew Displays the next new message that follows the thread you are
currently displaying.
Note: If there are no new (unviewed) messages within that
thread, Prevnew and Nextnew will not execute. You
should receive a message on the Error/Staus line that will
tell you there are "no new messages that way," (where
that way will either be before the message - Prev, or
following the message- Next). Use Enter to view the
message.
7 -- BBS -----------------------------------------------------------------------
8
Title: This will be entry #7 =>ZZC LAST Name: ZZC==7 Date&co
------------------------------------------------------------------------------
From: RO, ROSCOE.CONTROL
------------------------------------------------------------------------------
PF1 Utility 2 Ignore! 3 Exit 4 Prevmsg 5 Nextmsg 6 Addmsg
7 Backward 8 Forward 9 1= Top 11 Bottom 12 Zmsg
U V
The fields of this panel are:
Error/Status line This is the line of hyphens at the top. It contains the
mode BBS on the left. Any messages issued by
BBS will be displayed on the right.
Title This is the thread title that appeared on the previous
screen.
The PF-key functions specific to this screen are the same as the previous screen,
except for PF4, PF5, and PF9:
PF4/16 Prevmsg Displays the thread entry that precedes the currently displayed
entry.
PF5/17 Nextmsg Continues to the next sequential message.
PF9/21 Is not used.
You can add a new thread to the Message Selection List or a new thread entry to an
existing thread from any screen that has PF6/18 Addmsg.
With the cursor on any thread or entry, press PF6/18. You will be placed in the Reply
mode; the error/status line will have Reply in the left corner.
7 -- Reply ---------------------------------------------------------------------
8
New Message Thread Entry-2
From: RO, ROSCOE.CONTROL
The bottom half of the screen is in the Insert mode, and is open for entering text.
There is a sequence line number at the top of the insert area. It is much like the
sequence line number in your CA-Roscoe Edit session. All of the parameters you
have set for CA-Roscoe editing are propagated in the BBS Editor session (that is, tab
settings and the tab character).
The line just above the sequence line number will display the Insert Mode, and the
number of lines that are available for entering data. To the left of the insert area is the
sequence number field and a one character command area. This single character field
will contain asterisks when you are in the insert mode. Once you press ENTER or a
PF-key, you will be in the Edit mode, and this field will contain a period that is
Unprotected Low-intensity.
Enter the text of the message you want to create. You can then edit the message
either by typing over the existing text of the message, or by issuing line commands in
the single character command area. There are two edit commands that can be used in
this field:
d deletes any line it is placed next to.
i opens the lower portion of the screen to the insert mode, just after the line
on which it was entered.
7 -- Reply ---------------------------------------------------------------------
8
New Message Thread Entry-2
From: RO, ROSCOE.CONTROL
Seq . ----+----¬----+¬---2----+----3----+----4----¬----5----+----6----+----7-¬
==1 . This is the message text.
==2 . It can be any message.
==3 . It can be as long as you want.
==4 . End of message.
------------------------------------------------------------------------------
PF1 Help 2 CopyMem 3 Exit 4 Bwd (Top) 5 Fwd (Top) 6
7 Backward 8 Forward 9 1= Top 11 Bottom 12 ZMsg
U V
After you have completed entering the text, you can select one of the commands listed
at the bottom of the Reply screen. The functions specific to this screen are:
PF1/13 Help Invokes the Help facility.
PF2/14 CopyMem Copies a member you specify into the message text.
PF4/16 Bwd (Top) Scrolls the top half of the screen backward one screen.
PF5/17 Fwd (Top) Scrolls the top half of the screen forward one screen.
If you do not want to use any of the functions, and the thread or message text is
complete, Exit from the Reply panel using PF3/15. This will take you to a screen that
has only one open field. This is the thread title panel of the BBS.
Enter the title of your thread or message. The title field will accept up to 30
characters.
7 8
-- BBS -----------------------------------------------------------------------
------------------------------------------------------------------------------
PF1 2 NewThread 3 Cancel 4 5 6 EditAgain
7 8 9 1= 11 12
U V
There are only four functions you can perform from this screen.
1. If you created a new thread, use PF2/14 NewThread. This will add your thread to
the Message Selection list, under the title you issue on this screen.
2. If you do not want to add a thread or message at this time, you can use PF3/15
Cancel, and cancel the entire message. You will return to the panel you were on
before using PF6/18 Addmsg.
3. If you want to go back to the message text and edit it, use PF6/18 EditAgain.
You will return to the Reply panel, and will be in Edit Mode.
4. If you want to create the thread or message that will be added to an existing
thread, press ENTER. This will add your thread or message, and you will return
to the panel you were at when you selected PF6/18 Addmsg.
7 8
-- BBS ----------------------------------------------------- Press PF3 to exit
Current message: ZZB=== - New Message Thread Entry
Note: The BBS index data are NOT refreshed after any of these functions.
U V
The Utility display has several fields:
Error/Status As seen previously, this is the line of hyphens at the top. It will
contain any messages issued by Utility.
Current message: This is the thread entry you were viewing or pointing to when you
entered the Utility panel. The display will contain the member
name of the message (thread prefix + code), and the message title.
Utilities The five BBS utilities:
1. Set Options
2. Show News
3. Prune Profile
4. Print Message
5. Print Thread
The parameter values you set will be saved from one BulletinBoard session to the
next. They will remain in effect until you change them again.
7 8
-- BBSOpt -------------------------------------------------- Press PF3 to exit
Saved AWS name prefix: BBSAWS Panel member name prefix: ZZZZZP
U V
The BBSOpt fields are:
■ Save AWS on entry(Y/N)?
Before entering the BBS, the AWS can be saved so that you can resume
processing when you exit. This is important if you do not want to lose the data
in your active AWS. The default is set to 'Y', to save the AWS.
■ Saved AWS name prefix:
This is a prefix you can give to the saved AWS that was saved on entry to the
BBS. You can give the AWS a six-character prefix so you will know it was
created by BBS. The default prefix is BBSAWS.
The BBS News panel is displayed to you the very first time you sign onto the
BulletinBoard System. You will not be presented with the announcements again
unless you specifically request it or new announcements are posted. When this
information is updated, you will be presented with the BBS News screen when you
sign-on BBS.
There may be times when you need to refer to this information again. The Show
News utility will allow you to specifically request to view the announcements.
You can redisplay the BBS News Announcement panel from the Utility Option menu.
The field Show News will place you in the ZAnn mode. This is the Announcement
mode. The screen will contain all current BBS news and information that is posted by
your site. Shown below is a sample of the information that a site can 'Broadcast.'
7 8
-- ZAnn ----------------------------------------------------------------------
more =>
Current BBS News
============== S T A R T O F A N N O U N C E M E N T S =============
===> You will not be presented with this 'news' again unless
you request it or it changes.
Now, PRESS PF3 to Exit this 'news' and enter the Bulletin
Board System.
------------------------------------------------------------------------------
PF1 Help 2 3 Exit 4 5 6
7 Backward 8 Forward 9 1= Top 11 Bottom 12 ZMsg
U V
PRUNING IN PROGRESS
on the Error/Status line, on the right side. After BBS has finished the Pruning
function, you will remain in the initial BBS Utility menu panel.
| Note: Pruning deletes all but the last viewed thread entry.
The Print Message Utility will put you in DoPrint mode, and will display the screen
shown in the panel below.
7 8
-- DoPrint -------------------------------------------------------------------
------------------------------------------------------------------ Line 1 of 9
=================================== T O P ====================================
--------------------------------------------- New Message Thread Entry-2
From: RO, ROSCOE.CONTROL
------------------------------------------------------------------------------
PF1 Help 2 3 Exit 4 Print 5 6
7 Backward 8 Forward 9 1= Top 11 Bottom 12 ZMsg
U V
The Print Message screen contains the following fields:
Error/Status As seen previously, this is the line of hyphens at the top. The mode
on the left will be DoPrint. The right side of the line will display any
messages issued by DoPrint.
Destination: The destination output is sent to. If this is blank, the default set with
the Set Options utility will be used.
PRINT Tag The name that will identify the printed output.
Message text The text of the message you want to print will be displayed in the
bottom portion of this screen. The first line of the message will
contain its title.
To print the message, fill in the two fields listed on the top of the screen, and press
PF4/16 PRINT. You will receive a response on right side of the Error/Status line that
will tell you if the print request was successful.
The Print Thread Utility will put you in DoPrint mode, shown in the following panel.
7 8
-- DoPrint -------------------------------------------------------------------
more =>
Destination: DEFAULT. PRINT Tag: ZZB.....
----------------------------------------------------------------- Line 1 of 36
=================================== T O P ====================================
Thread title: New Message Thread Entry-2
------------------------------------------------------------------------------
PF1 Help 2 3 Exit 4 Print 5 6
7 Backward 8 Forward 9 1= Top 11 Bottom 12 ZMsg
U V
The Print Thread screen contains the following fields:
Error/Status As seen previously, this is the line of hyphens at the top. The
mode on the left will be DoPrint. The right side of the line will
display any messages issued by DoPrint.
Destination: The printer destination the output will be sent to. If this is blank,
the default set with the Set Options utility will be used.
PRINT Tag The name that will identify the printed output. The thread prefix
code will be the first three characters.
<= more => This field will be displayed if the threads comprise more that one
screen.
Thread entries The rest of the display will contain the thread and all the thread
entries comprising it. Each thread will be separated by a line of
hyphens; the thread entry title will be on the right side and the
thread it defines will be below.
To print the thread, fill in the two fields listed on the top of the screen, and press
PF4/16 PRINT. You will receive a response on right side of the Error/Status line telling
you if the print request was successful.
PF12/24 ZMSG.
This function is listed on all screens, in all modes (except when already within the
ZMsg mode), and is always PF12/24. Issuing the ZMsg command will place you in
the ZMsg mode.
=================================== T O P ==================================
JOB NOTI: JES REQUEST =====3 SUBMITTED TO DEST ADRPMVS3
================================ B O T T O M ===============================
------------------------------------------------------------------------------
PF1 Help 2 News 3 Exit 4 Swap 5 Delete 6 FindUser
7 Backward 8 Forward 9 SetOpts 1= Top 11 Bottom 12 Refresh
U V
The ZMsg display shown above has several fields:
Error/Status The first line of hyphens at the top. If you request an invalid
function, ZMsg will issue a highlighted error message in this
field. Otherwise, the field will contain the time the screen was
last updated.
Prefix/Key Enter the 2- or 3- character CA-Roscoe prefix, or the CA-Roscoe
key of the user to which you are sending a message. If you
enter data in both fields, only the prefix is used. ZMsg then
checks that a valid prefix or key was entered. If it is invalid,
you will be notified in the Error/Status line.
<= more => This field and its arrows are displayed when there are more
messages to be viewed, but do not fit on the screen. If '<=' is
shown, press PF7/19 to scroll backward to view more messages.
If '=>' is shown, press PF8/20 to scroll forward.
Message The line on which you enter the text of the message to be sent to
another CA-Roscoe user.
If you want to begin your ZMsg message communications with a clear message
display, use PF5/17 Delete. This will delete all messages contained in the display (the
ZZZZZMSG member).
If GetMsgs is not active, the date, time, and your key will be on the line
directly above the message(the message will be in ZZZZZMSG format):
MM/DD/YY HH:MM:SS MYKEY
– The messages you receive are highlighted, and contain the first eight
characters of the sender's CA-Roscoe key, followed by the message text (and
the date and time if GetMsgs is inactive.)
To send the message, press ENTER. The message will be sent, and your message
field will be immediately updated to include this information. The following panel
displays this activity.
7 8
-- ZMsg ----------------------------------------------- Message sent to pfx=ro
=================================== T O P ==================================
JOB NOTI: JES REQUEST =====3 SUBMITTED TO DEST ADRPMVS3
ROSCOE.C: send this message to myself
Q>>RO : send this message to myself
================================ B O T T O M ===============================
------------------------------------------------------------------------------
PF1 Help 2 News 3 Exit 4 Swap 5 Delete 6 FindUser
7 Backward 8 Forward 9 SetOpts 1= Top 11 Bottom 12 Refresh
U V
You can see that the Status line on the top of the screen tells you that the message was
sent, and to what prefix. Because GetMsgs is active, you see only the message and
key or prefix. Notice that the new messages are added after the existing message from
the Console. In this example, the user sent a message to himself, so the display
contains both messages sent and received.
From this ZMsg panel, you can also choose any of the PF-key functions listed on the
bottom. The following functions are specific to this ZMsg screen:
PF1/13 Help Displays Help for ZMsg.
PF2/14 News Displays the current News Announcements specific to the ZMsg
mode.
PF4/16 Swap Switches text display from column 1 to 40, and back.
7 8
-- ZMsgOpts ------------------------------------------------------ PF3 to exit
U V
The above panel shows the ZMsg options:
1. Suppress CA-Roscoe messages when exiting ZMsg? (Y/N):
This controls whether you receive all of the messages that were sent to you while
you were in the BBS. If this is set to 'Y', or YES, the words "Suppress active"
will appear on the right side of the Options line. When Suppress is active, a
CA-Roscoe SET SEND OPR command is issued. This command permits only those
messages sent by the operator to be displayed at your terminal, and therefore
suppresses all other messages. When you exit the BBS, you will not receive the
CA-Roscoe messages you already viewed in the ZMsg member.
If it is set to 'N', all CA-Roscoe messages will be redisplayed on the Response
line, one at a time, after you exit the BBS.
2. GetMsgs processing active? (Y/N):
This controls how the ZMsg member is displayed. When this is set to 'Y'(default),
the words "GetMsgs active" will appear on the right side of the Options line. The
contents of ZZZZZMSG are processed to make them easier to read. The message
text will only contain the key you sent the message to or received the message
from, a colon, and the message text. If GetMsgs is not active, the message text
will not be modified. It will contain the time and date, and will be in the original
ZZZZZMSG format.
Note: When GetMsgs is active, ZMsg will be slower, especially if there are
many messages.
7 8
-- FindUser ------------------------------------------------------------------
------------------------------------------------------------------------------
PF1 Help 2 News 3 Exit 4 5 6
7 Backward 8 Forward 9 1= Top 11 Bottom 12 ZMsg
U V
The information provided through FindUser is the same as the data you receive when
you issue the following command.
All other functions that can be executed from this panel have been previously
described.
CA-Roscoe supports the IBM program product DATABASE2 (DB2). This means that
you can execute the DB2 Command Processor. (This is controlled by site management.
See your site management to determine if this facility is available and how you can
execute the DB2 Command Processor.)
The option CA-Roscoe/DB2 may also be available at your site. It provides facilities
that can be used by application developers and data base administrators for the creation
of DB2 applications and objects. With this interface, these DB2 activities can be
performed during your CA-Roscoe session with other CA-Roscoe activities.
7 ROSCOE TO DB2
8
1. ROSCOE USING SQL TERMINAL INPUT (RUSTI)
2. SOURCE LANGUAGE DECLARES (DECLGEN)
3. CREATE APPLICATION PLAN (BIND)
4. REPLACE APPLICATION PLAN (REBIND)
5. REMOVE APPLICATION PLAN (FREE)
6. ISSUE DB2 COMMANDS (CMNDS)
7. EXECUTE PROGRAM UNDER ETSO (RUN)
<CLEAR> PFK3
REFRESH EXIT
U V
As illustrated by this sample menu, you can use this facility to execute the following
DB2 services:
■ Dynamic SQL Execution:
SQL statements entered into the active AWS or saved in a CA-Roscoe library
member can be executed and the results displayed at the terminal.
For detailed information about using this facility, see the CA-Roscoe/DB2 User Guide.
When developing an application, you are presented with a series of prompt panels that
allow you to:
■ Paint the panels that you want to use in the application.
DMF takes the information you supply and builds a panel which it then saves as a
member in your library. It places no restriction on the type of panel you can
define.
■ Designate the sequence in which the panels are to be used.
All you have to do is provide the name of the member containing the next panel
to be displayed. DMF generates the linkage between the panels to ensure that they
are displayed in their proper sequence.
■ Designate how the panel information is to be processed.
When creating a panel, you can specify validation criteria for the input fields.
DMF generates an RPF program to verify those fields and invokes the program
when appropriate.
You can preset a panel field while defining the panel or through an initialization
RPF program. This flexibility means that you can include, for example, specific
default values (such as account numbers) when defining the panel or writing an
initialization program that provides variable values (such as a user's sign-on key).
The only RPF program you need to write is the execution program that evaluates
and processes the contents of the panel. Once you have associated this program
with your panel, DMF ensures that it is invoked at the appropriate point during the
execution of your application.
Since DMF builds the panels, you only have to be concerned with formatting the
information unique to each panel. DMF provides each panel with a title line, error
message line and lines for displaying PF key assignments.
One of the PF key functions is a Help facility. To use this facility, all you need do is
tell DMF which DMF Help panel to use. If the individual executing the application
requests Help, DMF will display the appropriate Help panel.
With these features, DMF frees you from doing the repetitive or routine portions of
your panel-driven application.
ETSO can also be used to execute interactive applications. Many of the applications
that currently run under TSO execute successfully under ETSO.
If you are interested in executing a specific application, you should contact your site
management to determine:
1. If the application is already defined to ETSO.
2. If not, what procedures should be followed to have the site evaluate the
application for execution under ETSO.
Frequently, sites provide RPF programs that handle file allocation and application
invocation. Thus, all you need to do is execute the RPF program. The sample RPF
programs shown in the following example illustrate two methods of executing the IBM
utility IEBCOPY.
7 IEBCOPY1
8
>
> AWS() SCRL FULL COLS ====1 ===72
> <...+....1....+....2....+....3....+....4....+....5...
...... ================================ T O P ==============
===1== <<IEBCOPY1>> : Execute Via ETSO
===2== ALLOCATE SYSPRINT SYSOUT=T
===3== ALLOCATE INDD DSN=SAMPLE.INPUT,DISP=SHR
===4== ALLOCATE OUTDD DSN=SAMPLE.OUTPUT,DISP=SHR
===5== ALLOCATE SYSUT3 UNIT=SYSDA,SPACE=(CYL,2)
===6== ALLOCATE SYSUT4 UNIT=SYSDA,SPACE=(CYL,2)
===7== ALLOCATE SYSIN DSN=SAMPLE.CONTROL,DISP=SHR
===8== CALL IEBCOPY
) ) ) ) ) ) ) ) ) ) ) ) ) ) )
IEBCOPY2
>
> AWS() SCRL FULL COLS ====1 ===72
> <...+....1....+....2....+....3....+....4....+....5...
...... ================================ T O P ==============
===1== <<IEBCOPY2>> : Execute Batch Job
===2== WRITE AWS T
===3== '//BATCHJOB JOB . . . '
===4== '// EXEC PGM=IEBCOPY'
===5== '//SYSPRINT DD SYSOUT=T'
===6== '//INDD DD DSN=SAMPLE.INPUT,DISP=SHR'
===7== '//OUTDD DD DSN=SAMPLE.OUTPUT,DISP=SHR'
===8== '//SYSUT3 DD UNIT=SYSDA,SPACE=(CYL,2)'
===9== '//SYSUT4 DD UNIT=SYSDA,SPACE=(CYL,2)'
==1=== '//SYSIN DD DSN=SAMPLE.CONTROL,DISP=SHR'
==11== ENDWRITE
==12== SUBMIT
U V
As illustrated in the upper portion of the screen, the ALLOCATE command allocates
the needed files and assigns them DD names that will be referenced by the application
during execution. The CALL command is then used to identify and initiate execution
of the application.
Note that the term file has a special meaning to ETSO. With ETSO, you can allocate
data sets and CA-Roscoe-managed files (like an AWS, a library member, or the
terminal).
You can allocate one or more AWSs. An AWS can be used as either an input or
output file or it can be both. To allocate the active AWS, use the AWS keyword with
the command, as in:
ALLOCATE SYSIN AWS
To allocate a specific AWS, use the AWS= keyword to identify the appropriate AWS,
as in:
ALLOCATE SYSIN AWS=SAMPLE
If an AWS is defined as an input file, the application will read from that AWS until
the end of the AWS is reached.
If an AWS is defined as both an input and output file, the input data in that AWS is
overlaid by the output data written to it when the application ends (either successfully
or unsuccessfully) or the application closes the output file.
A library member can also be used as both an input and output file. To allocate a
library member, include the member name with the keyword MEM=. If the library
member belongs to another user, include that user's prefix, as in:
ALLOCATE SYSIN MEM=XYZ.CONTROL
If a library member is designated as an input file, the contents will be read until the
end of the member is reached.
If you designate a library member as an output file and that member does not currently
exist, the member is created when data are written to it. (If the non-existent member is
defined as an input file, the application will terminate.)
To designate that the terminal is to be used as an input and/or output file, include an
asterisk (*) with the command, as in:
ALLOCATE SYSIN Q
When the terminal is used as an input or output file, you should determine what
escape sequence you want before executing the application. You need the escape
sequence to:
■ Indicate the end of input. When the application begins executing, the keyboard is
locked. The keyboard unlocks when the application requests input. To force an
end-of-input condition, enter the escape sequence in response to a prompt for
input.
■ Terminate an application. If the terminal is defined as an output file, the keyboard
is unlocked when output exceeding a screen is written to the terminal. At that
time, you can terminate the application by entering the escape sequence.
While site management has the option of changing the default, it is usually two
consecutive periods (..). To change the escape sequence, use the SET ESCAPE
command, as in:
SET ESCAPE //
Any sequential data set, PDS member or temporary data set can be designated by the
ALLOCATE command. For example:
■ To designate that all read/write operations to a file are to be ignored, follow the
DD name with the keyword DUMMY, as in:
ALLOCATE IGNOREDD DUMMY
■ To designate an output file, include the appropriate SYSOUT information, as in:
ALLOCATE SYSPRINT SYSOUT=(W,,LTRH) DEST=ABCD COPIES=2
■ To allocate space for a data set that is to be referenced by the application, you
might specify:
ALLOCATE SAMPLE DSN=ROSCOE.TEST
DISP=SHR VOL=STOR=2 UNIT=338= SPACE=(TRK,(2=,2=))
RECFM=FB LRECL=122 BLKSIZE=798
This example illustrates the type of information you can specify with the
command. It does, however, violate the rule that a command entered from the
terminal cannot exceed the width of the screen (it cannot be continued).
■ To use the attributes associated with a previously defined data set, use the LIKE=
operand. If the IBM DFSMS is not installed at the site, the existing data set's
DCB parameters are used. If DFSMS is installed, the attributes copied from the
existing data set are AVGREC, KEYLEN, KEYOFF, LRECL, RECORG (or
RECFM) and SPACE.
ALLOCATE SAMPLE2 DSN=ROSCOE.TEST2@LIKE=ROSCOE.TEST
SPACE=(TRK,(1=,5))
In this example, the SPACE= operand is used to override the space allocation in
the existing data set.
■ To allocate a data set that is defined in the CA-Roscoe JCL, use the JCLDD=
operand, as in:
ALLOCATE MYDD JCLDD=SITEDD
where SITEDD is the DD name associated with the data set. This form of
allocation is useful for data sets that are frequently referenced by one or more
users.
■ To concatenate data sets, list the data set object names in the appropriate order.
You can concatenate a maximum of ten names. They must be bound by
parentheses.
ALLOCATE SITELIB DSN=(ROSCOE.TEST1, ROSCOE.TEST2)...
■ To allocate a temporary data set, omit the keywords DUMMY, SYSOUT= and
DSN=, as in:
ALLOCATE SYSUT3 UNIT=SYSDA,SPACE=(CYL,2)
The following example illustrates the type of information that might be displayed.
7 >
8
>
....+....1....+....2....+....3....+....4....+....5....+....6.
DDNAME TYPE DISP MEMBER DATA-SET NAME
------ ---- ---- ------ -------------
SYSIN AWS
SYSIN1 LIBRARY pfx.CONTROL
IGNOREDD DUMMY
SYSPRINT SYSOUT CLASS=W FORM NAME=LTRH
DATASET NEW ROSCOE.TEST
DATASET NEW ROSCOE.TEST2
SYSUT3 DATASET NEW
When your application completes its execution, you should release all of the files that
you allocated. You can use the FREE command to release these files. For example, to
release the file with the DD name SYSIN, you would enter:
FREE SYSIN
If any of your files are still allocated when your terminal session ends, they are
automatically released. Also, if your application dynamically allocates any files, they
are freed when your application ends.
You can pass information to the application through the CALL command. For
example, if the application TEST expects an inventory number to be passed, you might
invoke the application by entering:
CALL TEST /SR2O5==/
If, after initiating execution, you decide to end the program, you can do so by pressing
the Attention key.
You also have the option of suspending application execution when it is prompting
you for input. To do so, enter:
:U
in any unprotected field and press PF12. The cursor must immediately follow the
command. (Note that the colon and PF key assignment are the CA-Roscoe defaults.
Use the STATUS SYSTEM display to determine if your site management has changed
these defaults.)
If you initiated execution through an RPF program, that program will tell you how to
resume execution.
2. ALLOCATE FT=5F==1 Q
3. ALLOCATE FT=6F==1 Q
4. ALLOCATE FT=7F==1 AWS
where:
■ FT05F001 is the DD name of the input file.
■ FT06F001 is the DD name of an output files that writes the prompts and
computed results.
■ FT07F001 is the DD name of a second output file that writes the computed
mortgage tables.
5. Initiate execution of the application.
The CALL command initiates execution of applications defined to ETSO.
Therefore, to execute MORTGAGE, enter:
CALL MORTGAGE
Because of the allocations, MORTGAGE writes prompts to the terminal requesting the
necessary input and reads your responses from the terminal. After you have entered all
of the information, MORTGAGE performs its calculations and writes the results to the
terminal and the active AWS.
When the applications end, you should use the FREE command to deallocate the files.
If you do not, your allocated files are automatically released when you sign off
CA-Roscoe.
If you want to change an allocation or execute another application that uses a file with
the same DD name, you must release it before reallocating it. For example, to
reexecute MORTGAGE and have the output written to the terminal instead of the
active AWS, you would enter:
FREE FT=7==1
ALLOCATE FT=7==1 Q
CALL MORTGAGE
Use the TSO command to execute TSO commands from within an RPF or from the
CA-Roscoe command line. The TSO command can be used in place of or in
conjunction with a CALL command. For example, to allocate files necessary for
logging onto ISPF, enter:
TSO EXEC 'TSTPRN.TSTPRN)=1.CLIST(LOGTSO)'
Or, to execute the CLIST MYEXEC from your TSO CLIST library, enter:
TSO %MYEXEC
If the TSO command invokes a full-screen process, that process will take over the
screen. If the process is a line-mode TSO command, output will be written to the
execution area.
Perhaps its most important feature is that RPF is designed to take full advantage of all
CA-Roscoe commands and facilities. All of the commands can be incorporated
without modification into RPF programs. By using CA-Roscoe commands with RPF's
interactive language, error-prone and complicated tasks can be simplified so that it
becomes easy to:
■ Enter, verify and edit data.
■ Create, save, access and modify library members.
■ Build, verify, submit and track jobs.
■ Retrieve, examine and, optionally, save resulting output.
■ Control utility functions and housekeeping tasks performed against OS data sets.
RPF programs are stored in the CA-Roscoe library, with names that follow standard
CA-Roscoe naming conventions.
It might prompt for information by displaying a full-screen panel such as the one
shown in the following example.
7 8
U P D A T E C U S T O M E R M A S T E R F I L E
CONTACT: ADDRESS:
TITLE:
Occasionally, an RPF program may be given a name that is also the name of a
CA-Roscoe command (SAVE, for example). When this occurs, more explicit
invocation of the program is required to avoid executing the CA-Roscoe command. To
explicitly execute an RPF program, precede the program name with the EXEC
command. For example, to execute an RPF program named SAVE, you would enter:
EXEC SAVE
For additional information about the RPF language and how to write RPF programs,
see the CA-Roscoe RPF Language Guide. You can also use TRAINING, which is an
interactive application that introduces RPF. For information about using this learning
aid, enter:
HELP TRAINING
Using just a few prompt panels, you can use SKETCH to:
■ Design a BMS or MFS map. The input can be from: 1) your responses to
SKETCH prompts, 2) an RPF panel, or 3) an existing map.
■ Specify individual fields within a map. Default values for the fields (for example,
attributes and colors) are automatically supplied by SKETCH.
You have the option of modifying the site-defined default values that are used in
generating the macros/statements defining: 1) all maps and map fields, or 2) a
particular map.
■ Generate the macros/statements used in creating the map(s).
Before generating the macros, you have the option of displaying a prototype map,
thus ensuring that the map you are about to generate is correct.
■ Generate the JCL to:
– Assemble and link-edit the BMS macros. You can also designate whether the
resulting output is to be used in an Assembler, COBOL or PL/I application
program.
– Create the online blocks for the MFS statements. You can designate whether
the resulting output is to be placed in the production or test library.
While a familiarity with BMS or IMS is helpful, it is not essential when defining the
panels and then generating them to create maps. SKETCH allows you to create and
maintain panels by using the WYSIWYG (What You See Is What You Get) method.
For additional information, see the CA-Roscoe Extended Development Tools Guide.
A.3 Signing On
At typewriter devices, CA-Roscoe issues a sign-on prompt like the one below:
To sign on, type the sign-on key given to you by your site management and depress
the RETURN key.
If RACF protection is in effect at your site and group codes are used, the group code
should be entered with the sign-on key (separated by a slash), as in:
If the account has previously been assigned a password (either by you or site
management), the following prompt is issued:
After this prompt is issued, the terminal types meaningless characters in the field
where the password is to be entered. This provides a mask, so that other users will not
be able to see your password as you enter it.
A new password can be entered at the same time as the current password. The two
passwords must be separated by a slash, as follows:
Once you have signed on, CA-Roscoe responds in a manner identical to that found at
3270-type terminals (that is, sign-on procedures are executed, the sign-on message is
displayed, and so forth.).
OFF
OFFON
If a line sent from the terminal to CA-Roscoe cannot be received due to noise on the
phone line, CA-Roscoe displays the following message:
Retype and resend the line. If such an error occurs while the terminal is executing an
RPF program, the program is terminated. If the error occurs while CA-Roscoe is
attempting to send data to the terminal, retry procedures are executed. In the rare case
that errors are found during the retry procedures (indicating severe communication
problems), CA-Roscoe signs the terminal off. Attempt to reestablish connection from
another terminal.
When any of these conditions occur, your are signed off. Any data in an AWS is
saved in your library as the member SAVAWSnn where 'nn' is a unique identifier.
Use the ATTACH JOB command to begin printing the output. After the number of
lines specified by the BREAK command have printed, the carriage stops at the right
side of the device. To continue listing the job, enter:
ATTACH JOB *
Index X-1
Allocate Function Panel Attributes (continued)
Description Of 27-4 Job Output File (continued)
Using 27-3 Displaying 30-23—30-24
Allocate SMS Function Panel Library Member
Description Of 27-7 Changing Default Access 6-17
Using 27-3 Automatic
Allocating Files Indentation
Data Set Under ETSO 38-5 Controlling 6-15
Data Sets 27-2, 27-3 Using 18-15
Library Member 38-4 Line Insertion
Terminal 38-5 Controlling 6-15
ALTER Command Using 18-9
AWS Attributes 13-5 Signoff
Job File Attributes 30-17 Controlling 6-15
Library Member Attributes 34-2, 34-3 Site Defaults 6-12
Altering Terminal Lock
AWS Attributes 13-5 Controlling 6-17
Job File Attributes Site Defaults 6-12
Commands 30-17 AWS
Job Facility 30-18 Adding String To Line
Selection List 30-19 At Beginning 14-2
STATUS JOB Display 30-23—30-24 At End 14-2
Library Member Attributes Between Specific Columns 14-2
Command 34-2, 34-3 Attaching 13-3
Function Panel 34-15, 34-16 Bringing Data Into 13-4
Selection List 34-3, 34-4 Creating 13-6, 13-7
Arithmetic symbols (syntax diagrams) xxvi Deleting Contents
ATTACH Command Using Line Commands 16-4
AWS 13-3 Using Primary Commands (By Line
Controlling Pausing 6-15 Number) 16-2
Data Set Facility Using Primary Commands (Lines Containing
Catalog Selection List 25-7, 25-8, 25-9—25-12 String) 16-3
Data Set 25-26, 25-27 Detaching 13-8
GDG 25-14 Discarding
LIBRARIAN Module 25-15—25-17 Change Attribute 13-5
LIBRARIAN Selection List 25-2 Display/Change Attributes 17-5
Menu 24-2 Explicit 13-9
PDS Member 25-15—25-17 Display/Change Attributes 17-1—17-6
PDS Selection List 25-18, 25-19 Editing Data
Volume Selection List 25-28 Changed Line Indicator (Controlling) 6-16
Job Output 30-2—30-6 Controlling Column Boundaries 4-1—4-5
Library Facility Editing Data (Character Strings)
Member 32-10, 32-11 Tracking Changes 14-8—14-10
Menu 31-3—31-5 Using Line Commands 14-7
Selection List 32-2 Using Primary Command 14-6, 14-7
VTOC Selection List 25-33—25-34 Editing Data (Characters)
Attributes Using Line Commands 14-5
Job Output File Using Primary Command 14-4
Change Using Command 30-17 Entering Data
Change Using Job Menu 30-18 Controlling Number of Inserted Lines 6-15
Change Using Selection List 30-19 From Command Area 18-14
Change Using STATUS JOB Using a Mask 18-11—18-12
Display 30-23—30-24
Index X-3
BulletinBoard System (continued) Catalog Selection List (continued)
Viewing Message Thread 35-5 Function Codes
Viewing Thread Entries 35-6, 35-7 List Of 25-9—25-12
ZMsg Function (PF12/24) 35-21—35-27 Reattaching 26-10, 26-11
ZMsg Mode 9-5 Search for String
All Occurrences 26-4
By Occurrence 26-3
C Non-Matching Occurrences 26-4
C Line Command 15-3 Selecting Different Level 25-38
CA-Librarian CB Line Command 15-4
-INC Statement Expansion CC Line Command 15-4
Controlling 6-16 CDSN Command 27-62
Attaching Module 25-15 Center Text
Attaching Selection List 25-2 Using Line Commands 19-3, 19-4
Using EXPORT Command 27-60 Using Primary Command 19-2
CA-Panvalet CHAIN Command 34-7
EXPORT Command Character Set
Using 27-60 Description Of 2-5
CA-Roscoe Display/Change Using STATUS AWS 17-5
Controlling Info Messages 6-16 Language
Documentation, User 12-2 Changing 6-15
HELP Facility 12-3—12-5 Defining 3-2
Online Tutorial 12-6 Reserved Characters 2-5, 2-6
Sign On Translation Mode
From CA-Roscoe 10-4, 10-5 Changing 6-16
From CICS 10-6 Defining 3-3
From TSO 10-7 Character Translation
From VTAM 10-3 Display/Change 17-5
Sign-on Screen 10-2—10-3 Character, Replace
CA-SysView Interface (BBS) 35-28 Using Line Command 14-5
CALL Command 38-8 Using Primary Command 14-4
Cancel Function (BBS) 35-10 CICS
Cancel Job Signing On Via 10-6
Using Job Facility 30-30 COB Command 28-3
Using Selection List 30-31 COBOL Syntax Checker 28-3
Capitalize Text COLS
Initial Cap Field on System Information Line 8-6
Using Line Commands 19-6 Column Boundaries
Using Primary Command 19-5 Display/Change 6-2, 6-3
Lowercase All Using STATUS AWS 17-3
Using Line Commands 19-5 Session Change
Using Primary Command 19-5 Using BOUNDS Line Command 4-5
Printing 7-3 Using SET BOUNDS 4-4
Uppercase All Using STATUS AWS 4-3
Using Line Commands 19-5 Using STATUS DISPLAY 4-3
Using Primary Command 19-5 Temporary Change 4-2
CATALOG Command 27-11, 27-12 Comma
Catalog Selection List repeat symbol, use in xxix
Attaching 25-7, 25-8 Command Area
Description Of 25-9—25-12 Change Size of 6-15
Detaching 26-2 Description 8-3
Index X-5
Data Set Facility (continued) Data Sets (continued)
Defining Alias 27-22 Printing (continued)
Detaching 26-2 Using Function Command 27-46
Function Panels 24-10 Using Selection List 27-51
Inquiring About Releasing Space 27-52
Data Set (Selection List) 27-36 Renaming
Volume 27-40 Using Command 27-53
Menu Description 24-3—24-7 Using Function Panel 27-54
Printing 27-44 Using Selection List 27-57
Releasing Space 27-52 Searching For String
Renaming 27-54 Lines Limit, Changing 6-16
Search for String Lines Limit, Site Default 6-13
All Occurrences 26-4 Uncataloging 27-58
By Occurrence 26-3 Writing To
Non-Matching Occurrences 26-4 Controlling Directory Updates 6-17
Selecting Display 25-38 Description 27-59, 27-60
Selection Lists Using EDSN 27-61
Function Code Hierarchy 24-13 Using EXPORT 27-59
Overview 24-12 Date Format
Refreshing 24-15 Changing 6-15
Uncataloging 27-58 Display Current 6-14
Data Sets Site Defined 6-13
Allocating DB Line Command 16-4
Command 27-2, 27-3 DB2 and CA-Roscoe 36-1
Attaching 25-26, 25-27 DD Line Command 16-4
Cataloging 27-11, 27-12 Default values (syntax diagrams) xxix
COMPRESS Message Control DEFINE ALIAS Command 27-23
Changing 6-16 DEFINE GDG Command 27-25
Compressing PDS Defining
Description 27-21 Alias Function Panel
Copying Description 27-23
Using Command 27-13 Displaying 27-22
Using Function Panel 27-16 Using 27-22
Using Selection List 27-20 GDG Function Panel
Define Alias Description 27-25
Using Command 27-22 Displaying 27-25
Using Function Panel 27-23 DELETE Command
Define GDG AWS Contents 16-2
Using Command 27-25 Data Set Object 27-28, 27-29
Using Function Panel 27-25 Library Member 34-11
Deleting Delete Confirmation Panel
Using Command 27-28, 27-29 Data Set Facility 27-33
Using Function Panel 27-29 Library Facility
Using Selection List 27-33 Description Of 34-14
Display Contents in HEX 5-7, 5-8 Detaching 34-14
DSCB Empty Control 6-16 Delete Function Panel
Editing 27-61 Data Set Facility 27-29
Function Panel 27-4 Library Facility 27-29
Inquiring About 27-36 DELETE Hardware Key 16-7
Migration Recall Control 6-16 DELETES Command 16-3
Printing
Using Command 27-44
Index X-7
Entering Data In AWS (continued) FIRST Command (continued)
Using Primary Commands (continued) Library Facility 33-3, 33-4
INPUT TEXTENTR Command 18-6, 18-7 FIRST Line Command 20-5
With Automatic Indentation 18-15 Firstnew Function (BBS) 35-4, 35-5
ERASE EOF Key Forced Signoff
Controlling Extent of Deletion 6-16 3270-Type Devices
Using to Delete (AWS Data) 16-6 STATUS DISPLAY Information 6-15
ET Line Command 14-7 Formatting
ETSO Data
Allocating Using Automatic Indentation 6-15
Data Sets 38-5 Using Line Commands 19-11, 19-12
Files 38-4—38-5 Using Primary Command 19-10, 19-11
Terminal 38-5 Using TAB Facility 18-16, 18-17
Applications FRAM (SCRL Field Value) 8-4
Executing 38-3 FREE Command 38-7
Change Escape Sequence 6-16 FULL (SCRL Field Value) 8-4
Determining Executable Applications 38-2
Executing
Applications 38-3, 38-8 G
TSO Procedures 38-10 Generation Data Group (GDG)
Freeing Files 38-7 See Data Set Facility
Overview 38-1 GetMsgs Processing (BBS) 35-23
Querying Files 38-7 GROUP CODE Field on Sign-on Screen 10-3
Release Allocated Files 38-7
Resume Application Execution 38-8
Suspend Application Execution 38-8
H
HALF (SCRL Field Value) 8-4
EXCL Command
HELP Command 12-3—12-5
AWS 20-6, 20-7
HELP Facility 12-3—12-5
Job Output 30-9
Hex
Library Facility 33-4
Locate String In 20-11, 20-12
EXCL Line Command 20-8, 20-9
Hexadecimal Display
Execution Area 8-6
Setting 5-7, 5-8
Exit Function (BBS) 35-2
Hierarchy
EXPLICIT
Command Evaluation 2-9
LIB ALTER Operand 34-3, 34-4
HLP Keyword on System Information Line 8-4
EXPORT Command 27-59, 27-60
Extended Time-Sharing Option
See ETSO I
I Line Command 18-8
IB Line Command 18-8
F Ignore! Function (BBS) 35-4
FETCH Command 34-7
IM Line Command 18-11
Fill Character
IMPLICIT
AWS 6-16
LIB ALTER Operand 34-3, 34-4
Display/Change 17-4
INCL Command
FILL Command 14-2
AWS 20-6, 20-7
FindUser Function (BBS) 35-28
Job Output 30-9
FIRST Command
Library Facility 33-4
AWS 20-3
INCL Line Command 20-8, 20-9
Job Output
Locate String 30-8
Position Within 30-12
Index X-9
Library Member
K Attaching 32-10, 32-11
KEY Field on Sign-on Screen 10-2 Copying
Keywords (syntax diagrams) xxvi Using Command 34-5, 34-6
Using Function Panel 34-8, 34-9
L Using Selection List 34-9, 34-10
Creating 23-2
Language Character Set
Deleting
Changing 6-15
Using Command 34-11
LAST Command
Using Function Panel 34-12
AWS 20-3
Using Selection List 34-13
Job Output
Display Format 5-7
Locate String 30-8
Displaying
Position Within 30-12
Data in HEX 5-7, 5-8
Library Facility 33-3, 33-4
Format of Display 32-12
LAST Line Command 20-5
HEX display 5-7, 5-8
Lastread Function (BBS) 35-4
Inquiring About 34-15, 34-16
LC Line Command 19-5
Position Display
LCB Line Command 19-5
To Named Line 33-8
LCC Line Command 19-5
To Specific Line 33-8
LCT Line Command 19-5
Printing
LIB
Using Command 34-17
Keyword on System Information Line 8-4
Using Function Panel 34-17
LIBRARIAN Selection List
Using Selection List 34-21
Detaching 26-2
Renaming
Reattaching 26-10, 26-11
Using 34-22
Search for String
Using Command 34-22
All Occurrences 26-4
Using Function Panel 34-22
By Occurrence 26-3
Using Selection List 34-23
Non-Matching Occurrences 26-4
Save AWS Contents As 23-2
Selecting Different Level 25-38
Search for String
LIBRARY Command 31-3—31-5
All Occurrences 33-4
Library Facility
Non-Matching Occurrences 33-4
Alter Member Attributes 34-2, 34-3
Specific Occurrence 33-3, 33-4
Attaching
Update Contents 23-5
Member 32-10, 32-11
Library Member Display
Selection List 32-2
Display Format 5-8
Copying 34-5, 34-6
Sequence Number Display 5-6
Deleting 34-11
Library System, Description 31-1
Detaching 33-2
Line Commands
Function Panels Description 31-6
Correcting Invalid/Incomplete 2-10
Inquiring About Member 34-15, 34-16
Description of Use 2-3, 2-4
Library System 31-1
Display Format Description 2-2
Menu 31-3—31-5
Evaluation Hierarchy 2-9
Printing 34-17
Locate CA-Roscoe Users (BBS) 35-28
Reattaching 33-10, 33-11
Locate/Display Data
Selection List
All Occurrences
Function Code Hierarchy 31-8, 31-9
In AWS (Modifiable Display) 20-7, 20-8, 20-9
Refresh 31-10
In AWS (Non-Modifiable Display) 20-7, 20-8
Using 31-7
By Occurrence
Wildcard Characters 32-3
In AWS (Line Commands) 20-5
In AWS (Primary Command) 20-3
Index X-11
MT Line Command 21-3 OM Line Command 18-12
OMB Line Command 18-12
OMIT Command 20-7, 20-8
N OMT Line Command 18-12
Name OO (Destination/Overlay) Line Command
Field on System Information Line 8-3 With COPY 15-5
Print Request With Move 21-4
Assigning 7-6 Operator
Displaying 7-13 Job Facility 28-15
News Announcements (BBS) ORDER Command 14-3
Description 35-2 ORDER Operand, Library Facility 32-9
View 35-15 Ordering Library Selection List 32-9
NewThread Function (BBS) 35-10 OT (Destination/Overlay) Line Command
NEXT Command With COPY 15-5
AWS 20-3 With Move 21-4
Job Output Overlay Line Commands
Locate String 30-8 With COPY 15-6
Position Within 30-12 With Move 21-5
Library Facility 33-3, 33-4
NEXT Line Command 20-5
Nextnew Function (BBS) 35-6 P
NONUM Parentheses
Define Sequence Number Display 5-6 syntax diagrams, use in xxvii
NOPRESERVE Mode Password
Character Translation 3-4 Changing User
NOTE Command During Session 10-8, 10-9
With Data Set, Member, Module 26-8, 26-9 When Signing On 10-3, 10-8
With Job Output 30-13 PASSWORD Field on Sign-on Screen 10-2
With Library Member 33-8, 33-9 PAU Keyword on System Information Line 8-4
Note Names PDS Member 25-15—25-17
Library Member 33-8, 33-9 PDS Selection List
Notification Messages Attaching 25-18, 25-19
PRINT Completion 7-8 Description Of 25-20
NUM Detaching 26-2
Define Sequence Number Display 5-6 Function Code List 25-20—25-22
NUM2 Inquire About
Define Sequence Number Display 5-6 Load Module 25-20—25-22
NUMX Source Module 25-23—25-25
Define Sequence Number Display 5-6 Reattaching 26-10, 26-11
Search for String
All Occurrences 26-4
O By Occurrence 26-3
O (Destination/Overlay/Drop) Line Command Non-Matching Occurrences 26-4
With COPY 15-4 Selecting Different Level 25-38
O (Destination/Overlay) Line Command PF/PA Keys
With COPY 15-4 BulletinBoard System 35-2
With Move 21-4 Changing Assignment
OB (Destination/Overlay) Line Command Description 11-8, 11-9
With COPY 15-5 Fixed Assignment 11-10, 11-11
With Move 21-4 Scroll Functions 11-13
Special Functions 11-15
Variable Assignment 11-11, 11-12
Index X-13
Programs (continued) RESET Line Command 2-11
parentheses Response Line 8-3
syntax diagrams, use in xxvii RPF Programs
punctuation Description Of 39-1
syntax diagrams, use in xxvi Execution Library, Control Use Of 6-16
Prune Profile Utility (BBS) 35-16 Looping
Punctuation marks (syntax diagrams) xxvi Change Limit 6-17
PURGE Command Limit Defaults 6-13
Job Output 30-30 Write Limit
Change Setting 6-17
Site Defaults 6-13
R RR Line Command 15-7
R Line Command 15-7 RSHIFT Command 19-10, 19-11
RBX Prefix 35-2
Read Message Attribute (BBS) 35-14
Reattaching S
AWS 13-13 SAVE Command
Data Set Object 26-10, 26-11 Assigning Attributes 23-4
Job Output 30-15 Assigning Description 23-4
Library Facility 33-10, 33-11 Creating Library Member 23-2
Reexecuting Last Command/RPF 2-6 Saving AWS Contents 23-2
Reformat Lines Scale Line 8-6
Using Line Command 19-8—19-9 Screen
Using Primary Command 19-7, 19-8 Change
REFRESH Command Copy Destination 6-15
Data Set Facility 24-15 Size 8-12
Library Facility 31-10 Components of
Refresh Function (BBS) 35-4 Command Area 8-3
Refreshing Selection List Description 8-2
Data Set Facility 24-15 Execution Area 8-6
Library Facility 31-10 Response Line 8-3
RELEASE Command 27-52 Scale Line 8-6
RENAME Command System Control Area 8-3—8-5
AWS 13-5 System Information Line 8-3
Data Set Object 27-53 Copy 15-9
Library Member 34-22 Print 7-2
Rename Function Panel Split
Data Set Facility 27-54 Full 8-7—8-8
Renaming Overview 8-7
AWS Partial 8-9
Using Command 13-5 Resplit 8-10
Using STATUS AWS 17-3 Swap 8-10, 8-11
Data Set Object Terminate 8-11
Using Command 27-53 Types of
Using Function Panel 27-54 Full/Half 8-7
Using Selection List 27-57 Terminal Lock 8-13, 8-14
Renumber AWS Contents SCREEN Command 8-12
Any Time 22-1—22-3 Screen Types of 10-2—10-3
RENUMBER Command 22-1—22-3 Sign-on 10-3
Reserved Sign-on' 10-2
Characters 2-5, 2-6
Index X-15
Session Attributes (continued) SET Command
Jobs STATUS DISPLAY Information 6-15
-INC Expansion Control, Changing 6-16 SET COPYDEST Command
+INC Expansion Control 6-17 STATUS DISPLAY Information 6-15
Data Width Control 6-17 SET CURSOR Command 6-15
Search Limits, Changing 6-16 SET DATEFORM Command 6-15
List Of 6-4 SET DISPLAY Command
Messages, Controling Display Change Display Format 5-7, 5-8
From CA-Roscoe 6-16 Change Display Margins 5-5
From Monitor 6-16 Change Sequence Number Display 5-6
PRINT Completion Notification Changing 7-8 STATUS DISPLAY Information 6-15
Printing Destination SET DSNCMLST Command
Changing 6-17 STATUS DISPLAY Information 6-16
Printing Location SET DSNCNT Command
Establish 7-10 Site Default 6-13
Printing Notification STATUS DISPLAY Information 6-16
Changing 6-17 SET DSNEMPTY Command 6-16
RPF SET DSNRECALL command 6-16
Control Execution Library Use 6-16 SET DUPCR command 6-16
Control Loop Limit 6-17 SET EDITCHNG Command
Control Write Limit 6-17 STATUS DISPLAY Information 6-16
Screen Copy Destination Tracking Changed Lines 14-8—14-10
Changing 6-15 SET EOF Command
Screen Positioning When String Located 6-17 Control ERASE EOF Use 16-6
SCRL Field Value STATUS DISPLAY Information 6-16
Changing 6-17 SET ESCAPE Command
Search Column Boundaries STATUS DISPLAY Information 6-16
Changing 6-15 SET EXECPFX command 6-16
Sequence Number Display 6-17 SET FILL Command
Signoff STATUS DISPLAY Information 6-16
Changing Option 6-15 SET JOBCNT Command
SET ATTACH Command 6-15 Site Default 6-13
SET AUTOFF Command STATUS DISPLAY Information 6-16
Site Defaults 6-12 SET MASTER Command
STATUS DISPLAY Information 6-15 STATUS DISPLAY Information 6-16
SET AUTOINDENT Command SET MODE Command
Inserting Lines 18-15 Control Character Recognition/Translation 3-3
STATUS DISPLAY Information 6-15 Control Non-Displayable Character Translation 3-4
SET AUTOINSERT Command STATUS DISPLAY Information 6-16
Insert Additional Lines 18-9 SET MONLEVEL command 6-16
STATUS DISPLAY Information 6-15 SET MONTRAP command 6-16
SET AWSDSPLY Command 6-15 SET MSGLEVEL Command
SET BOUNDS Command STATUS DISPLAY Information 6-16
Change Column Boundaries 4-4 With Job Submission 28-4
STATUS DISPLAY Information 6-15 Set Options Utility (BBS) 35-13
SET CHARSET Command SET PFKDELIM Command
Changing Language Code 3-2 STATUS DISPLAY Information 6-16
STATUS DISPLAY Information 6-15 SET RPSDEST Command
SET CMDLINES Command STATUS DISPLAY Information 6-9
STATUS DISPLAY Information 6-15 SET RPSNOTIFY Command
For PRINT Completion Notification 7-8
Index X-17
String Handling (continued) TEXTENTR (Operand of INPUT Command) 18-6, 18-7
Locate Non-Matching Occurrence TF Line Command 19-8—19-9
In AWS (Modifiable Display) 20-6, 20-7, 20-8 Thread entries, deleting 35-16
In AWS (Non-Modifiable Display) 20-7, 20-8 Thread Entry (BBS)
Locating By Occurrence Create 35-8, 35-9
In AWS (Line Commands) 20-5 Print 35-17
In AWS (Primary Command) 20-3 View 35-6
Translate Thread Title (BBS), Create 35-10
On Input/Edit 3-3 TIME Command 6-14
With Command 3-3 Time, Display 6-14
SUBMIT Command 28-4 Title, Message/Thread (BBS) 35-10
Submitting Data TJ Line Command 19-18
Changing Defaults 6-17 TRACE Command 14-10
Description 28-4 Tracking Changed Lines 14-8—14-10
SUFFIX Command 14-2 Translation, Character
Suppress Message Processing (BBS) 35-23 Non-display 3-4
Syntax Checking When Entering/Editing Data 3-3
COBOL 28-3 When Searching For String 3-3
JCL 28-2, 28-3 When Specified with CA-Roscoe Commands 3-3
Syntax diagrams TS Line Command 19-17
reading (how to) xxvi—xxx TSO
SYSOUT Class Requirements 30-5 Command 38-10
System Control Area 8-3—8-5 Procedure Execution 38-10
System Information Line 8-3 Signing on to CA-Roscoe 10-7
System Printers TSO Command 38-10
Changing Locations TT (Destination) Line Command 15-4
For Request 7-10 With Move 21-4
For Session 7-10 TTD (Destination/Drop) Line Command
Displaying Locations 7-11 With COPY 15-5
Setting Parameters 7-9 TUTORIAL, CA-Roscoe
Using 7-2 Description 12-6
TXTCENT Command 19-2
TXTFLOW Command 19-7
T TXTJOIN Command 19-15, 19-16
Tab Character TXTLCASE Command 19-5
Change Via STATUS AWS 17-5 TXTSPLIT Command 19-13, 19-14
TAB Command 18-16, 18-17 Typewriter Devices
TC Line Command 19-3 Establishing Communications A-2
TCB Line Command 19-3 Non-Executable Commands A-12
TCC Line Command 19-3 Signing Off A-6
TCT Line Command 19-3 Signing On A-4
TE Line Command 18-10 Using The Data Set Facility A-10
Terminal Lock Facility Viewing Job Output A-11
Changing Options 6-17
Invoking 8-13, 8-14
Site Defaults 6-12 U
Terminating 8-13, 8-14 UC Line Command 19-5
Terminate UCB Line Command 19-5
Split Screens 8-11 UCC Line Command 19-5
Terminal Lock Screen 8-13 UCT Line Command 19-5
W
Wildcard Characters
With Data Set Facility
For Catalog/VTOC Selection List 24-8
For LIBRARIAN/PDS/Volume Selection
List 24-9
Index X-19