Académique Documents
Professionnel Documents
Culture Documents
User Guide
6.0
SP3
This documentation and related computer software program (hereinafter referred to as the Documentation) is for
the end users 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 users 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 users
applicable license agreement.
The manufacturer of this documentation is Computer Associates International, Inc.
Provided with Restricted Rights as set forth in 48 C.F.R. Section 12.212, 48 C.F.R. Sections 52.227-19(c)(1) and (2) or
DFARS Section 252.227-7013(c)(1)(ii) or applicable successor provisions.
Contents
About This Guide
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
xvii
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . .
. . . . . .
. . . . . .
. . . . . .
. . . . .
. . . . . .
. . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . .
1-1
2-1
2-2
2-2
2-3
2-5
2-5
2-5
2-6
2-6
2-7
2-7
2-8
2-9
2-10
2-10
2-11
2-11
2-12
2-13
2-15
3-1
3-2
3-3
3-3
3-3
3-4
4-1
4-2
4-3
4-3
Contents iii
. . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . .
4-3
4-3
4-4
4-5
5-1
5-2
5-3
5-3
5-4
5-4
5-4
5-4
5-5
5-6
5-7
6-1
6-2
6-4
6-12
6-14
6-15
7-1
7-2
7-3
7-3
7-3
7-6
7-6
7-6
7-6
7-7
7-7
7-7
7-8
7-9
7-10
7-10
7-10
7-10
7-11
7-12
7-13
7-13
7-13
7-14
7-14
8-1
. . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . .
8-2
8-3
8-3
8-6
8-7
8-7
8-9
8-10
8-10
8-11
8-12
8-13
9-1
9-2
9-4
9-4
9-5
10-1
10-2
10-2
10-3
10-4
10-4
10-6
10-7
10-8
10-8
10-10
10-12
10-12
10-13
11-1
11-2
11-4
11-4
11-7
11-8
11-9
11-10
11-10
11-10
11-13
11-13
11-15
12-1
12-2
Contents v
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
12-3
12-6
. . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
13-1
13-2
13-3
13-4
13-5
13-6
13-8
13-9
13-10
13-10
13-11
13-11
13-12
13-13
13-14
14-1
14-2
14-2
14-2
14-3
14-4
14-4
14-5
14-6
14-6
14-7
14-8
15-1
15-2
15-2
15-3
15-3
15-3
15-3
15-3
15-6
15-7
15-8
15-9
15-10
15-10
15-12
15-13
. . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . .
. . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
15-13
16-1
16-2
16-2
16-3
16-4
16-6
16-6
16-7
17-1
18-1
18-2
18-2
18-3
18-6
18-8
18-8
18-9
18-10
18-11
18-11
18-11
18-13
18-14
18-15
18-15
18-16
18-16
18-17
19-1
19-2
19-2
19-3
19-5
19-5
19-6
19-7
19-7
19-8
19-10
19-10
19-11
19-13
19-13
19-13
19-15
Contents vii
. . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . .
. . . . . . . . . . . .
. . . . . . . . . . . .
. . . . . . . . . . .
. . .
. . .
. . .
. . .
. . .
. .
. . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
19-17
19-17
19-18
20-1
20-2
20-3
20-5
20-6
20-6
20-6
20-7
20-8
20-10
20-10
20-10
20-10
20-11
20-13
21-1
21-2
21-3
21-5
22-1
22-1
22-2
22-2
22-3
22-3
23-1
23-2
23-2
23-3
23-4
23-5
. . . . . . . . . . . . . . . . . . . . . . .
Chapter 25. Data Sets: Attaching a Data Set Object at the Terminal
25.1 Attaching a CA-Librarian Selection List . . . . . . . . . . . . . . .
25.1.1 Using a Primary Command . . . . . . . . . . . . . . . . . . . .
25.1.2 Using the Data Set Facility . . . . . . . . . . . . . . . . . . . .
25.1.3 Selection List Description . . . . . . . . . . . . . . . . . . . . .
25.1.3.1 Selecting Alternate Displays . . . . . . . . . . . . . . . . .
25.1.3.2 Display Format . . . . . . . . . . . . . . . . . . . . . . . .
25.1.3.3 Field Descriptions . . . . . . . . . . . . . . . . . . . . . .
25.2 Attaching a Catalog Selection List . . . . . . . . . . . . . . . . . . .
25.2.1 Using a Primary Command . . . . . . . . . . . . . . . . . . . .
25.2.2 Using the Data Set Facility . . . . . . . . . . . . . . . . . . . .
25.2.3 Selection List Description . . . . . . . . . . . . . . . . . . . . .
25.2.3.1 Selecting Alternate Displays . . . . . . . . . . . . . . . . .
25.2.3.2 Display Format . . . . . . . . . . . . . . . . . . . . . . . .
25.2.3.3 Field Descriptions . . . . . . . . . . . . . . . . . . . . . .
25.3 Attaching a Generation Data Group Data Set . . . . . . . . . . . . .
25.4 Attaching a PDS Member/CA-Librarian Module . . . . . . . . . . .
25.4.1 Using a Primary Command . . . . . . . . . . . . . . . . . . . .
25.4.2 Using the Data Set Facility Menu . . . . . . . . . . . . . . . .
25.4.3 Using a Selection List . . . . . . . . . . . . . . . . . . . . . . .
25.4.4 Attached Data Description . . . . . . . . . . . . . . . . . . . .
25.5 Attaching a PDS Selection List . . . . . . . . . . . . . . . . . . . .
25.5.1 Using a Primary Command . . . . . . . . . . . . . . . . . . . .
25.5.2 Using the Data Set Facility . . . . . . . . . . . . . . . . . . . .
25.5.3 Selection List Description . . . . . . . . . . . . . . . . . . . . .
25.5.3.1 Load Library Selection List . . . . . . . . . . . . . . . . .
25.5.3.2 Selecting Alternate Displays . . . . . . . . . . . . . . . . .
25.5.3.3 Display Format . . . . . . . . . . . . . . . . . . . . . . . .
25.5.3.4 Field Descriptions . . . . . . . . . . . . . . . . . . . . . .
25.5.3.5 Non-Load Selection List . . . . . . . . . . . . . . . . . . .
25.5.3.6 Selecting Alternate Displays . . . . . . . . . . . . . . . . .
25.5.3.7 Display Format . . . . . . . . . . . . . . . . . . . . . . . .
25.5.3.8 Field Descriptions . . . . . . . . . . . . . . . . . . . . . .
25.6 Attaching a Sequential Data Set . . . . . . . . . . . . . . . . . . . .
25.6.1 Using a Primary Command . . . . . . . . . . . . . . . . . . . .
25.6.2 Using the Data Set Facility Menu . . . . . . . . . . . . . . . .
25.6.3 Using a Selection List . . . . . . . . . . . . . . . . . . . . . . .
25.6.4 Attached Data Description . . . . . . . . . . . . . . . . . . . .
25.7 Attaching a Volume Selection List . . . . . . . . . . . . . . . . . .
25.7.1 Using a Primary Command . . . . . . . . . . . . . . . . . . . .
25.7.2 Using the Data Set Facility . . . . . . . . . . . . . . . . . . . .
25.7.3 Selection List Description . . . . . . . . . . . . . . . . . . . . .
25.7.3.1 Selecting Alternate Displays . . . . . . . . . . . . . . . . .
25.7.3.2 Display Format . . . . . . . . . . . . . . . . . . . . . . . .
25.7.3.3 Field Descriptions . . . . . . . . . . . . . . . . . . . . . .
25.8 Attaching a VTOC Selection List . . . . . . . . . . . . . . . . . . .
25.8.1 Using a Primary Command . . . . . . . . . . . . . . . . . . . .
25.8.2 Using the Data Set Facility . . . . . . . . . . . . . . . . . . . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
24-15
25-1
25-2
25-2
25-3
25-4
25-4
25-5
25-5
25-7
25-7
25-8
25-9
25-10
25-10
25-11
25-14
25-15
25-15
25-16
25-17
25-17
25-18
25-18
25-19
25-20
25-20
25-21
25-21
25-21
25-23
25-24
25-24
25-24
25-26
25-26
25-26
25-27
25-27
25-28
25-28
25-29
25-30
25-30
25-31
25-31
25-33
25-33
25-34
Contents ix
. . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
25-35
25-36
25-36
25-36
25-38
26-1
26-2
26-3
26-3
26-4
26-5
26-5
26-5
26-6
26-6
26-7
26-8
26-8
26-8
26-10
27-1
27-2
27-2
27-3
27-4
27-7
27-11
27-13
27-13
27-14
27-15
27-16
27-20
27-21
27-22
27-23
27-23
27-25
27-25
27-25
27-28
27-29
27-29
27-33
27-33
27-36
27-40
27-44
27-44
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
27-45
27-46
27-51
27-52
27-53
27-53
27-54
27-57
27-57
27-57
27-58
27-59
. . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . . .
. . . . . . . . . . . .
. . . . . . . . . . . .
. . . . . . . . . . . .
. . . . . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
28-1
28-2
28-2
28-3
28-4
28-4
28-5
28-6
28-7
28-9
28-11
28-12
28-13
28-15
29-1
29-2
29-4
29-5
29-6
29-7
30-1
30-2
30-2
30-3
30-4
30-4
30-5
30-6
30-6
30-7
30-7
30-7
Contents xi
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
30-8
30-8
30-8
30-9
30-10
30-11
30-11
30-12
30-12
30-13
30-13
30-15
30-16
30-17
30-17
30-17
30-18
30-19
30-20
30-20
30-20
30-22
30-23
30-23
30-25
30-26
30-26
30-26
30-29
30-30
30-30
30-30
30-31
. . . . . . . . . . .
. . . . . . . . . . . .
. . . . . . . . . . . .
. . . . . . . . . . . .
. . . . . . . . . . . .
. . . . . . . . . . . .
. . . . . . . . . . . .
. . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
31-1
31-2
31-3
31-6
31-7
31-8
31-10
32-1
32-2
32-2
32-5
32-6
32-7
. . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . .
. . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
32-7
32-9
32-10
32-10
32-11
32-11
32-12
32-13
33-1
33-2
33-3
33-3
33-4
33-5
33-5
33-5
33-6
33-6
33-7
33-8
33-8
33-8
33-10
34-1
34-2
34-2
34-3
34-3
34-5
34-5
34-7
34-8
34-9
34-11
34-11
34-12
34-13
34-14
34-15
34-17
34-17
34-17
34-21
34-22
34-22
34-22
34-23
Contents xiii
. . . .
35-1
35-2
35-2
35-3
35-5
35-6
35-8
35-11
35-12
35-13
35-15
35-16
35-16
35-17
35-18
35-20
35-20
35-21
35-22
35-24
35-25
35-27
35-28
. . . . . . . . . . . . . . . . . . . . . . . .
36-1
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
37-1
. . . . . . . . . . . . . .
38-1
38-2
38-3
38-4
38-4
38-4
38-5
38-5
38-7
38-8
38-9
38-10
. . . . . . . . . . . . . . .
39-1
Appendixes
. . . .
. . . . . . . . . . . . . . .
. . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . .
40-1
A-1
A-2
. A-3
. A-4
. A-6
. A-7
. A-9
A-10
A-11
A-12
. . . . . . . . . . .
. . . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
X-1
Contents xv
Organization
Chapter
Description
Introduces CA-Roscoe.
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
Chapter
Description
25
26
27
28
29
30
31
32
33
34
35
36
Introduces CA-Roscoe/DB2.
37
38
39
40
Introduces SKETCH.
APPENDIX A
Summary of Revisions
Displaying Session Attributes/Information:
The STATUS SESSION display now includes the new field:
SPLIT
CA-Roscoe Publications
The following publications are supplied with CA-Roscoe. They are divided into a
User Series and a System Series.
User Series
Name
Contents
Command Reference
Guide
Extended Development
Tools Guide
Reference Summary
Release Guide
User Guide
System Series
Name
Contents
CA-ACTIVATOR 2.1
Supplement
Installation Guide
Security Administration
Guide
System Commands
Guide
Related Publications
The following manuals are included in the CA90s Services Documentation set:
Title
Contents
The following manuals relate to CA-Roscoe and are available from Computer
Associates.
Title
Contents
CA90s Services
CA90s Services are a common set of services that may be used by any MVS
Computer Associates product. These services are maintained separately from the
product and are documented and installed separately as well. CA-Roscoe uses
CAIRIM for installation services and security.
Licensing Management Program (LMP)
CA-Roscoe now interfaces with CAIRIM services to determine product licensing
authorization.
comma
>
period
<
open parenthesis
equal sign
close parenthesis
not sign
addition
subtraction
multiplication
division
Required parameters appear on the same horizontal line (the main path of the diagram)
as the command or statement. The parameters must be separated by one or more
blanks.
Statement With Required Parameters
COMMANDPARM1PARM2
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.
Default Value for a Required Parameter
YES
COMMANDPARM1=NOPARM2
If you specify the command, you must write one of the following:
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.
Choice of Optional Parameters
COMMAND
PARM1
PARM2
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.
Repeatable Variable Parameter
!variable
COMMAND
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
If the repeat symbol contains punctuation such as a comma, you must separate
multiple parameters with the punctuation. The following example includes the repeat
symbol, a comma, and parentheses.
Separator with Repeatable Variable and Delimiter
,
!variable)
COMMAND(
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
COMMAND
COMMAND
COMMAND
(VALUEC)
(VALUEB,VALUEC)
(VALUEB,VALUEA)
(VALUEA,VALUEB,VALUEC)
The following example shows a list of parameters with the repeat symbol.
Optional Repeatable Parameters
!
!
!
COMMAND
PARM1
PARM2
PARM3
YES
PARM1=NO
PARM2
PARM3
PARM4
PARM5
COMMAND
(1)
PARM1
Note:
1 This is a note about the item.
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
1-1
2-1
2-2
2-2
2-3
2-5
2-5
2-7
2-9
2-10
2-13
2-15
3-1
3-2
3-3
3-3
3-3
3-4
4-1
4-2
4-3
4-3
4-4
4-5
5-1
5-2
5-3
5-3
5-4
5-5
5-6
5-7
6-1
6-2
6-4
6-12
6-14
. . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . .
. . . .
Chapter 10. Signing On and Off CA-Roscoe
10.1 Signing On
. . . . . . . . . . . . . . . . . . . . .
10.1.1 Using the CA-Roscoe Sign-on Screen . . . .
10.1.2 Accessing CA-Roscoe from VTAM Terminals
10.1.3 Accessing CA-Roscoe Through XTPM . . .
10.2 Customizing Sign On . . . . . . . . . . . . . . . .
10.2.1 Changing/Creating a Password . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
6-15
7-1
7-2
7-3
7-3
7-3
7-6
7-6
7-7
7-8
7-9
7-10
7-10
7-11
7-12
7-13
7-13
7-13
7-14
7-14
8-1
8-2
8-3
8-3
8-6
8-7
8-7
8-9
8-10
8-10
8-11
8-12
8-13
9-1
9-2
9-4
9-4
9-5
10-1
10-2
10-2
10-3
10-4
10-8
10-8
. . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . .
10-10
10-12
10-12
10-13
11-1
11-2
11-4
11-4
11-7
11-8
11-9
11-10
11-13
12-1
12-2
12-3
12-6
Chapter 1. Introduction
CA-Roscoe is an online program development system that you can use to perform
tasks such as:
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.
Line Commands
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.
SET DISPLAY AWS NUMX Display Format
EDIT /PRT/PART/
>
> 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).
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.
>
......
===1==
D2_
==D3 =
===4==
D5=5==
D5=6==
===7==
===8D9
==D9==
==1===
=D11==
D212==
...1....+....2....+....3....+....4....+....5....+....
============================= T O P =================
_
_
_
Characters Included
Alphabetic
Numeric
0-9
Special
Binary
Separator
Reserved
Double comma (,,), asterisk (*), minus sign (-) and the plus
sign (+). (See the next section, 2.2.1, Using Reserved
Characters.)
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
string
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.
&
(
)
_
+
=
!
:
'
"
'
}
{
?
<
>
.
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
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
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.
>
>
>
>
>
>
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.
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.
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.
_
>
>
....+....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
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
|
|
|
|
Optionally, you can indicate to CA-Roscoe to save or not save the command in the
command recall buffer if the command is equal to the previous command. This option
called "DUPCR" can be set as a system wide variable and defaults that duplicate
commands will always be saved.
SET DUPCR NO
XTENDED
All alphabetic data that you enter or edit will be retained exactly as
you entered it (it can contain a combination of uppercase and
lowercase characters).
STANDARD
PRESERVE
>
> AWS(PRI.INVLIST)
SCRL FULL COLS ====7 ===72
>
...1....+....2....+....3....+....4....+....5....+
...... ============================= T O P =============
BOUNDS ID<NTIFICATION DIVISION.
>
===2== PROGRAM-ID.
INVLIST.
>
> 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.
or
SET DISPLAY 1= 5= NUMX CHAR
Subsequent sections describe how to change each specific display format component.
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.
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
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.
The following example illustrates the display that results after issuing the command
SET DISPLAY HEX. (SET DISPLAY CHAR returns the data to character format.)
Character and Hex Display
>
> 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.
Display
Display
Display
Display
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.
>
> AWS()
SCRL FULL COLS ====1 ===79
A<name>
>....+....1....+....2....+....3....+....4....+....5....+....6
ROSCOE BOUNDS/DISPLAY STATUS
AWS:
LIB:
JOB:
DSN:
MODE
BOUNDS
LEFT RIGHT
1
8=
1
8=
1
255
1 32767
SET
DISPLAY
LEFT RIGHT
1
72
1
72
1
72
1
72
===> BASIC
CURRENT
DISPLAY
LEFT RIGHT
1
72
1
72
1
72
1
72
CURSOR
NUMX
NUM
NUM
NUM
CHAR
CHAR
CHAR
CHAR
CJUST
CJUST
CJUST
CJUST
===> INIT
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
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
char
cjust
MODE
CURSOR
SESSION
SESSION
SESSION
SESSION
D or
DA or
DAT or
DATE
The following example illustrates the type of information provided by the STATUS
SESSION command at a 43-line terminal.
STATUS SESSION Command Display
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
7 > APPLID(A=4IROS3)
USER(PH,DORDA=2) L PENDING
> AWS(PH.DUPCR)
SCRL CSR
COLS ====1 ===79 PAU(PH.RAMB)
A<AMB>3
>....+....1....+....2....+....3....+....4....+....5....+....6....+....7..
ROSCOE SESSION STATUS
AUTOFF
AUTOINSERT
CHAR SET
CMD LINE
CURREC
DELIMITER
DSNCNT
DSNRECALL
EDITCHNG
EXECPFX
==>
==>
==>
==>
==>
==>
==>
==>
==>
==>
24= ON
1 OFF
US ENGLISH
3 1
N/A
&
1=====
NONE
OFF
DFLT
LANGUAGE
MASTER
MAXREC
MONTRAP
PFKDELIM
RPSNOTIFY
SEARCH
SEND
SPLIT
STMTCNT
TLOCK
==>
==>
==>
==>
==>
==>
==>
==>
==>
==>
==>
ENGLISH
NONE
NONE
ON
/
OFF
NODBCS
ALL
CSR
4=96
3= OFF
U
ATTACH
ATTACH
AUTOINDENT
AWS TRANS
CHAR TRANS
COPYDEST
DATE FMT
DSNCMLSTL
DSNEMPTY
DUPCR
ESCAPE
HELPPFX
JOBCNT
==>
==>
==>
==>
==>
==>
==>
==>
==>
==>
==>
==>
PAUSE
OFF
N
B
(NONE)
AMERICAN SHORT
ERROR
OFF
YES
..
DFLT DFLT
1====
MONLEVEL
==> ERROR
MSGLEVEL
==> INFO
RPSDEST
==> USPRNCPK
SAVE ATTR ==> SHARED
SEA MODE
==> NOMIX
SIGNON
==> PH.SIGX
STATS
==> ON
SUBMIT
==> 8= INC SEQ
LOGOFF WRITECNT ==> 5=
V
Contains: Current or default setting designating whether
execution is to pause after an ATTACH command is executed.
Change: Overtype field with PAUSE or NOPAUSE; use SET
ATTACH command.
AUTOFF
Contains: Two fields, where the first field shows the current
number of minutes of inactivity that is allowed before the
terminal is automatically signed off, and the second field
shows the status of the automatic sign-off facility.
Change: Overtype the first field with a numeric value not
exceeding your site maximum and the second field with ON or
OFF; use SET AUTOFF command. (STATUS SYSTEM
shows the default and maximum values.)
AUTOINDENT
AUTOINSERT
|
|
|
|
AWS TRANS
|
|
CHAR SET
|
|
CHAR TRANS
|
|
CMD LINE
COPYDEST
CURREC
Contains: Two fields, where the first field shows the current
or default format used when dates are displayed at the
terminal, and the second field shows whether the year will be
displayed as two or four digits.
Change: Overtype the first field with AMERICAN,
EUROPEAN or INTERNATIONAL, and the second field with
SHORT or LONG; use SET DATEFORM command.
(STATUS SYSTEM shows the default values).
DELIMITER
DSNCMLST
DSNCNT
DSNEMPTY
DSNRECALL
|
|
DUPCR
|
|
EDITCHNG
EXECPFX
HELPPFX
JOBCNT
LANGUAGE
MASTER
MAXREC
MONLEVEL
MONTRAP
MSGLEVEL
PFKDELIM
RPSDEST
NOT ACT
NOT AUTH
NOT AVAL
SAVE ATTR
SEARCH
|
|
|
SEA MODE
SEND
SIGNON
SPLIT
STATS
STMTCNT
SUBMIT
TLOCK
WRITECNT
_
>
>
....+....1....+....2....+....3....+....4....+....5....+....6.
ROSCOE SYSTEM STATUS
AUTOFF
AUTOFF DEFAULT
AUTOFF MAXIMUM
===> ON
===> 9=
===> 24=
AUTTLOCK
===> OFF
AUTTLOCK DEFAULT ===> 5
AUTTLOCK MAXIMUM ===> 144=
JOBCNT DEFAULT
JOBCNT MAXIMUM
===> 999999
===> 999999
DSNCNT DEFAULT
DSNCNT MAXIMUM
DATE FORMAT
===> AMERICAN
SHORT
STMTCNT DEFAULT
STMTCNT MAXIMUM
===> 4=96
===> 3276=
RCSESCPF
RCSESCCH
===> 1=====
===> 999999
===> PF12
===> :
AUTOFF
AUTOFF DEFAULT
AUTOFF MAXIMUM
AUTTLOCK
AUTTLOCK DEFAULT
AUTTLOCK MAXIMUM
DATE FORMAT
DSNCNT DEFAULT
DSNCNT MAXIMUM
JOBCNT DEFAULT
JOBCNT MAXIMUM
RCSESCCH
RCSESCPF
STMTCNT DEFAULT
STMTCNT MAXIMUM
7 TIME
>
> AWS(AAA.SHIPRATE) SCRL FULL COLS ====7 ===72
>
..<1....+....2....+....3....+....4....+....5....+
============================= T O P =============
=====1 IDENTIFICATION DIVISION
>
>
....+....1....+....2....+....3....+....4....+....5....+..
=9/=6/88 15.3=.27 - ELAPSED =1:29:4= - CPU
.34=
The
The
The
The
current date,
current time,
elapsed time of your session, and
amount of CPU time for for your session.
After viewing this information, you can reattach the data you were working with, or
issue any other CA-Roscoe command.
Status Command
Attribute Affected
SET
SESSION
SET ATTACH
SESSION
SET AUTOFF
SESSION
SET
AUTOINDENT
SESSION
SET
AUTOINSERT
SESSION
SET AWSDSPLY
AWS
SET BOUNDS
DISPLAY
and AWS
SET CHARSET
SESSION
and AWS
SET CMDLINES
SESSION
SET COPYDEST
SESSION
SET CURSOR
DISPLAY
SET DATEFORM
SESSION
SET DISPLAY
DISPLAY
and AWS
|
|
|
Command
Status Command
Attribute Affected
SET DSNCMLST
SESSION
SET DSNCNT
SESSION
SET DSNEMPTY
SESSION
SET
DSNRECALL
SESSION
SET DUPCR
SESSION
To determine if duplicate
commands are to be saved in the
command recall buffer.
SET EDITCHNG
SESSION
SET EOF
AWS
SET ESCAPE
SESSION
SET EXECPFX
SESSION
SET FILL
AWS
SET JOBCNT
SESSION
SET MASTER
SESSION
Expansion of embedded
CA-Librarian -INC statements in
submitted jobs.
SET MODE
DISPLAY
and AWS
SET MONLEVEL
SESSION
SET MONTRAP
SESSION
SET MSGLEVEL
SESSION
Command
Status Command
Attribute Affected
SET PFKDELIM
SESSION
SET RPSDEST
SESSION
SET RPSNOTIFY
SESSION
SET SAVEATTR
SESSION
SET SCROLL
N/A
SET SEARCH
DISPLAY
and AWS
SET SEND
SESSION
SET STATS
SESSION
SET STMTCNT
SESSION
SET SUBMIT
SESSION
SET SYSID
N/A
SET TLOCK
SESSION
SET USERID
N/A
SET WRITECNT
SESSION
Description
PRINT <AWS>
PRINT mem(s)
PRINT LIB
PRINT DSN
PRINT JOB
PRINT SCREEN
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.
TYPE Operand:
TYPE can be used to designate which printer control characters are to be recognized,
where:
TYPE ANS
TYPE DEF
TYPE MCC
The TM and BM operands to change the site-defined top and bottom margins,
respectively. For example, if you want to begin printing six lines from the top of
the page (for example, have five blank lines precede the data) and stop printing
nine lines from the bottom, you would enter:
PRINT TYPE DEF TM 5 BM 9
Notes:
Use the PRINT DEVICE command to determine the default and current top
and bottom margins.
The left and right margins are determined by the placement of the data. In the
following screen, for example, the data extends from columns 5 through 53.
FORMAT Operand:
FORMAT can be used to specify the desired data format, where:
FORMAT DUMP
FORMAT CHEX
FORMAT VHEX
where:
tag
number
id
Note: A print request is any data that you direct to a system or 328x-type printer.
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.
1
>
> AWS(PRI.INVLIST) SCRL FULL COLS ====1 ===72
2
>
<...+....1....+....2....+....3....+....4....+....5....+....6.
===1==
===2==
===3==
===4==
===5==
===6==
===7==
===8==
===9==
==1===
==11==
==12==
==13==
==14==
==15==
==16==
================================ T O P ======================
IDENTIFICATION DIVISION.
PROGRAM-ID.
INVLIST.
ENVIRONMENT DIVISION.
CONFIGURATION SECTION.
SOURCE-COMPUTER. IBM-3=81.
OBJECT-COMPUTER. IBM-3=81.
3
INPUT-OUTPUT SECTION.
FILE-CONTROL.
SELECT INVENTORY-FILE
ASSIGN TO UT-S-SYSIN.
SELECT INVENTORY-REPORT
ASSIGN TO UT-S-SYSPRINT.
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.
Sv
DSN() dsn
HLP(..HELP..)
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)
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>
Scroll
Direction
FULL
Forward/Backward
Left/Right
Forward/Backward
Left/Right
Forward/Backward
Left/Right
FRAM or
Page
HALF
Permanent
Value
Scroll
Direction
CSR
Forward/Backward
Left/Right
Forward/Backward
Left/Right
Scroll
Direction
MAX
Forward/Backward
Left/Right
Forward/Backward,
Left/Right
PFv
The previous SCRL field value is restored after MAX or PFn is executed.
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-
>
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.
Alternate Full-Screen Split
If an RPF program or another application (like ETSO or CA-eMAIL+) is in control of
the terminal, you can request a full-screen split by entering:
: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.
>
> 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
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.
>
....+....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-| || |||| || ||||| ||||||||| |||||| || ||||| |||||||||||
||||||
|||| || |||||
||| |||||| || |||||
||||||||
||||| ||| |||| || ||||||||||| ||| |||||| || ||||| |||||||||||||
|||| ||| ||| || ||||||||||| ||| |||||| || ||||| ||||||||||||||
||| ||| |||
|||
|||
||
|||||
|||||||||
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
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.)
To display or change the site-defined time periods, issue the commands:
STATUS SYSTEM
STATUS SESSION
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.
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.
SEND Command: Receiving Multi-Line Message Notification
zmddhhmm
string
Optional note that the sender included with the SEND command
(for example, COMMITTEE REPORT).
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.
10.1 Signing On
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.
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. ||||||
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
PASSWORD
10.1 Signing On
GROUP CODE
NEW PASSWORD
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.
applidsignonkey
/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
If any of the sign-on information is incorrect, the CA-Roscoe sign-on screen is
displayed and all sign-on information must be reentered.
10.1 Signing On
CALLprog
signonkey/password ROSID=code
10.1 Signing On
CALLprogROSID=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.
10.1 Signing On
transid
signonkey ROSID=code
/password
10.1 Signing On
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.
SAVE MYSIGN_
>
> 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 ==================
AWS
DSN
JOB
LIB
PA1
Ignore Changes
same
same
same
PA2
HELP PFKEYS
ROSCOE
same
same
same
PF1
SPLIT
same
same
same
PF2
SWAP
same
same
same
PF3
END
same
same
same
PF4
ATTACH DSN
C1
SELECT C1
ATTACH
JOB * FILE
C1
EXEC PFK4
PF5
ATTACH JOB
C1 C2 C3
EXEC PFK5
ATTACH
JOB * C1 C2
C3
EXEC PFK5
PF6
Reexecute
same
same
same
PF7
SCROLL BACK
C1 C2
same
same
same
PF8
SCROLL
FORWARD C1
C2
same
same
same
PF9
GO
same
same
same
PF10
SCROLL LEFT
C1
same
same
same
PF11
SCROLL RIGHT
C1
same
same
same
PF12
INPUT
same
same
same
PF13
EXEC PFK13
same
same
same
PF14
EXEC PFK14
same
same
same
PF15
EXEC PFK15
same
same
same
PF16
EXEC PFK16
same
same
same
KEYS
AWS
DSN
JOB
LIB
PF17
EXEC PFK17
same
same
same
PF18
Reexecute
same
same
same
PF19
SCROLL BACK
C1 C2
same
same
same
PF20
SCROLL
FORWARD C1
C2
same
same
same
PF21
GO
same
same
same
PF22
SCROLL LEFT
C1
same
same
same
PF23
SCROLL RIGHT
C1
same
same
same
PF24
INPUT
same
same
same
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:
LETPAv='string'
scope. PFv
scope
DSN.
JOB.
LIB.
PAv
PFv
'string'
You can assign one or more commands or one of the designated keyword
functions of a PA key.
PF Keys
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.
Using Command Line Variables
You can assign a maximum of eight Command Line variables (named C1
through C8) to any PF key. Command Line variables cannot be assigned to
PA keys.
If you use Command Line variables in an assignment, you must provide
variable information in the Command Area of the screen. For example,
assume the following assignment is in effect:
LET PF4 = '+FETCH +C1+/ATTACH'
When PF4 is pressed, the Command Area is read for the needed variable
information. If WIDGET appears in the Command Area, the assignment is
treated as though the following commands were entered:
FETCH WIDGET & ATTACH
When you include multiple Command Line variables in an assignment, each
one must be delimited by the same special character, as in:
LET AWS.PF4 ='+ATTACH +C1+ +C2+ +C3+ +C4+'
So, when PF4 is pressed, the values found in the Command Area are assigned
sequentially to the variables. A value need not be supplied for all of the
variables in an assignment. If the supplied values form a valid command, the
remaining variables are ignored. For example, assume that the preceding
definition is in effect and the Command Area contains:
JOB Q
This assignment is treated as though the command ATTACH JOB * was
entered. Since this is a valid command, the variables C3 and C4 are ignored
and the command is executed.
The same principles apply when using any of the predefined keyword
functions instead of, or with, commands. For example, assume the following
definition is in effect:
LET PF12 = '+SCROLL +C1+ C2+ +C3+'
POSITION TOP
SCROLL BACK
SCROLL FORWARD
SCROLL FORWARD Csr The display is positioned forward so that the line at
which the cursor is positioned is the first displayed line.
SCROLL FORWARD [v] FRames or SCROLL FORWARD [v] Pages
The display is positioned forward one or v frames. If
less than vframes remain, the action is identical to
POSITION BOTTOM.
SCROLL FORWARD Full The display is positioned forward one line less than the
total number of lines in the current frame (the last line
of the new display is the first line of the old). If less
than a full frame of lines remain, the action is identical
to POSITION BOTTOM.
SCROLL FORWARD Half The display is positioned forward one-half frame. If less
than a half frame of lines remain, the action is identical
to POSITION BOTTOM.
SCROLL FORWARD [v] [Lines]
The display is positioned forward one or v lines. If less
than v lines remain, the action is identical to POSITION
BOTTOM.
SCROLL FORWARD Max Display positioning is identical to POSITION
BOTTOM.
SCROLL LEFT
SCROLL LEFT v
SCROLL RIGHT
SCROLL RIGHT v
SPLIT
SWAP
Active and inactive split screens are interchanged; the cursor is moved
from one logical screen to the other.
REPEAT
Changes made to the current frame are ignored. The attached data
remains attached.
As a PF key assignment, commands found in the Command Area are
executed.
As a PA key assignment, commands found in the Command Area are
ignored if this function is assigned to a PA key.
ENTER
QUIT
Changes made to the current frame are ignored; attached data are
detached. Commands entered in the Command Area are executed.
_
>
>
HLP(...HELP...) SCROLL FULL DISPLAY ==1 =79
>....+....1....+....2....+....3....+....4....+....5....+....6
SAVE
Function: Places contents of active AWS into library as a
member.
Syntax:
. . .
Syntax
Level
The following figure identifies the PF keys that are used to position within and
between HELP displays.
Display
PF Keys
Action
PF7/PF19
PF8/PF20
Scrolls forward.
PF10/PF22
PF11/PF23
To obtain information about the HELP facility itself, enter the command:
HELP
Other HELP displays that you may want to review are:
HELP MESSAGE x
HELP PFKEYS
HELP NEW
. . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
13-1
13-2
13-3
13-4
13-5
13-6
13-8
13-9
13-10
13-10
13-11
13-13
13-14
14-1
14-2
14-2
14-2
14-3
14-4
14-4
14-5
14-6
14-6
14-7
14-8
15-1
15-2
15-2
15-3
15-8
15-9
15-10
15-10
15-12
15-13
15-13
16-1
16-2
16-2
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . .
. . . . . . . .
. . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
16-3
16-4
16-6
16-6
16-7
17-1
18-1
18-2
18-2
18-8
18-11
18-13
18-14
18-15
18-15
18-16
19-1
19-2
19-2
19-3
19-5
19-5
19-6
19-7
19-7
19-8
19-10
19-10
19-11
19-13
19-13
19-17
20-1
20-2
20-3
20-5
20-6
20-6
20-8
20-10
20-10
20-10
20-10
20-11
20-13
. . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . . . . . . . . . . . . . .
. . .
. . .
. . .
. . .
. . .
. .
. . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
21-1
21-2
21-3
22-1
22-1
22-2
22-2
22-3
22-3
23-1
23-2
23-2
23-3
23-4
23-5
Chapter 13.
Chapter 13.
Chapter 13.
Another AWS.
The current screen display.
A library member.
An attached data set object.
An attached job output file.
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.
Chapter 13.
SPLIT
Discards the AWS when the screen in which the AWS was
created is terminated.
RPF
LEVEL
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
REUSE
RETAIN
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.
Chapter 13.
Chapter 13.
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.
Chapter 13.
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
+P [v]
-P [v]
T+
Display begins with the first line of the active AWS. Can be qualified
with:
v
B-
Display contains the last line of the active AWS. Can be qualified with:
v
Display begins v number of lines after the first line of the active
AWS.
ATTACH INVLIST
>
> 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.
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.
>
> 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==
Chapter 13.
XLT
XL [v]
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.
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
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.
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:
EDIT //FILLER/ 18== 2===
Replaces the search string with the replacement string on every line
beginning with the line on which it is entered and continuing through the last
line in the active AWS.
ET
Replaces the search string with the replacement string on every line
beginning with the first line of the active AWS and continuing through the
line on which the command is entered.
EE
Replaces the search string with the replacement string on every line within
the block of lines. (An EE must appear in the sequence number field of the
first and last line of the range.)
E [v]
Replaces the search string with the replacement string beginning with the line
on which the string is entered and continuing for v number of lines. If no
number is specified, only the line containing the command is changed.
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.
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.
7 SET EDITCHNG ON
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
Chapter 15. AWS: Copying Data Within and Into an AWS 15-1
Number of the line at, or after, which the data are to be placed.
After the line at which the AWS pointer is currently positioned.
Before the first line of the active AWS.
After the last line of the active AWS.
Chapter 15. AWS: Copying Data Within and Into an AWS 15-3
CB
To copy all lines from the line containing the command through the last
line of the active AWS.
CT
To copy all lines from the first line in the active AWS through the line
containing the command.
To copy repeatedly:
Type CR (for a single line copy) or CCR (on the first and last lines, for a block
copy) in the appropriate sequence number field. Then, type a destination line
command on the appropriate target sequence number field. The destination line
command that you use will either cause the CR or CCR command(s) to remain
displayed, allowing you to copy the same line(s) to multiple locations, or remove
the commands. (You can also use the RESET line command to remove a pending
CR or CCR command.) The following table shows all of the destination line
commands for Copy.
Command
Type
Meaning
A [v]
Destination Only
B [v]
BB [v]
TT [v]
O [v]
OD [v]
Overlay At
Destination
Command
Type
Meaning
OO
OB
OT
AD [v]
Destination And
Remove Pending CR
BD [v]
BBD [v]
TTD [v]
Chapter 15. AWS: Copying Data Within and Into an AWS 15-5
>
>
>
>
>
>
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.)
>
>
>
>
>
>
Chapter 15. AWS: Copying Data Within and Into an AWS 15-7
COPYsource ...AWS-destination
COPYS
TP name
COPYX
DSN
From the attached data set object. (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
LIB
mem
SCREEN
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.
B or ,,
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.
Chapter 15. AWS: Copying Data Within and Into an AWS 15-9
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
XCOPYAWS-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
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
Number of the line at, or after, which the data are to be inserted in the
active AWS.
B or ,,
Chapter 15. AWS: Copying Data Within and Into an AWS 15-13
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.
When copying from:
A library member, attached data set object or attached job output file. You can
limit the search operation to specific columns by:
Using 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.
Specifying a column range with the command, using the values shown on the
Scale Line, as in:
XCOPYS JOB 1= 5= /FILLER/ B
where every line containing the string FILLER in columns 10 through 50 of
the job attached in the other screen is copied to the bottom of the active AWS
in the screen containing the command.
The displayed screen or a Selection List: You can limit the search to a specific
column by assuming that the left-most displayed position is column one and
include the appropriate numbers, as in:
XCOPYS SCR 1 3= /QQQ/ R
where every line from other screen containing *** in the first thirty positions of
the line is copied to the active AWS of the screen containing the command and
replaces its contents.
Column numbers and line numbers can be specified together, as in:
XCOPYS JOB 1= 5= /FILLER/ 12== 25== R
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.
DB
To delete all lines from the line containing the command through the
last line of the active AWS.
DT
To delete all lines from the first line through the line containing the
command.
LINE
COMMAND
MEANING
DS [v] [/string/]
DSB [/string/]
DST [/string/]
DU [/string/]
Deletes all lines from this line until first line containing
string.
DX [v] [/string/]
DXB [/string/]
Deletes all lines not containing string from this line to end
of active AWS.
DXT [/string/]
>
> 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
Use the modifiable display to perform one or more of the following functions by
typing the appropriate code in the first field of the display.
A
AT
Attach AWS.
Alter AWS attributes. (Overtype the appropriate field(s) in the display with
the new attribute value(s).)
Delete contents of AWS.
Discard AWS and delete its contents.
Select AWS. (The AWS is activated but not displayed.)
Rename AWS. (Type the new AWS name in the STATUS field.)
Terminate display.
Position Selection List to begin with the designated AWS.
D
DS
S
R
X
*
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
SESSION\SPLIT
RECOVERABLE
Note: See 13.5, Creating an AWS on page 13-6 for more information.
The remaining fields are described in the following table. Note that the modifiable
fields include information about how their values can be changed.
Field Name
Description
ALT
NAME
ALL
ROS MEMBER
CHG
LINES
INCR
CURRENT
ACT
ASSOCIATED
DATASET
NAME
VOLUME
UNIT
L-BOUNDS-R
Field Name
Description
L-SET DIS-R
ALT
2
NUMBR
Field Name
Description
MODE
ALT
2
Field Name
Description
EOF
ALT
3
Use primary and line commands to enter data into the active AWS.
Define and use a mask to insert data into the active AWS.
Use a PF key to open the AWS for data entry.
Add, delete or replace data from the Command Area.
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.
>
> 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 ==============
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.
To indicate that you have completed data entry, either:
1. Press the ENTER key or any PF key having a scroll function, or
2. Move the cursor to the Command Area and enter a command.
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.
>
> 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=).
>
> AWS()
SCRL FULL COLS ====7 ===72
>
...<....+....2....+....3....+....4....+....>....+
===1== THIS IS A SAMPLE.
_
>
> 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
>
> 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
To insert one or more empty lines in the active AWS for data entry.
To allow for power typing techniques.
To insert one or more lines after the line containing the command.
To insert one or more lines before the line containing the command.
>
> 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.
>
> 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.
>
> 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).
>
> 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).
>
> 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).
>
> 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=).
...... _
>
> AWS()
SCRL FULL COLS ====7 ===72
>
...<....+....2....+....3....+....4....+....>....+
...... ========================== T O P ================
TE=1== THIS IS A SAMPLE.
...... ======================= B O T T O M =============
>
> AWS()
SCRL FULL COLS ====7 ===72
>
...<....+....2....+....3....+....4....+....>....+
...... ========================== T O P ================
===1== THIS IS A SAMPLE.
_
>
> 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
7 AWS:
TE Line Command
>
> 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
>
>
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.
>
>
>
>
>
>
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.)
AWS: Overlay Line Commands to Insert a Mask
>
>
>
>
>
>
=31==
=31=1
=5
=5
PART-NUMBER
PART-TOTAL-IN
PIC X(9).
PIC X(3).
>
> 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).
==32==
=5 FILLER
PIC X(3=).
>
> 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.
>
> 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.
>
> AWS(PRI.INVLIST)
SCRL FULL COLS ====1 ===8=
>
<...+....1....+....2....+....3....+....4....+...
...... ============================= T O P ============
===1==
IDENTIFICATION DIVISION.
......
_
===2==
ENVIRONMENT DIVISION.
===3==
CONFIGURATION SECTION.
TAB %
TAB 12 16 2! 32
>
> AWS(PRI.INVLIST)
SCRL FULL COLS ====1 ===8=
>
<...+....1....+....2....+....3....+....4....+...
...... ============================= T O P ============
===1==
IDENTIFICATION DIVISION.
>
> AWS(PRI.INVLIST)
SCRL FULL COLS ====1 ===8=
>
<...+....1.%..+%...%....+....3.%:
...... ============================= T O P ============
!!!1!!
IDENTIFICATION DIVISION.
>
> 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=).
>
> 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.)
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.
7>
> 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------------------------------------------------
>
> 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------------------------------------------------
>
> 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.
Primary
Command Line
LOWCASE
UPCASE
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.
TXTFLOW 2 7 COLS 3=
>
> 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------------------------------------------------
>
> 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.
>
> 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.
>
> 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.
>
> 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.
>
> 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 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.
Shift
Until
Data
Meaning
) [v]
> [v]
)) [v]
>> [v]
)B [v]
>B [v]
)T [v]
>T [v]
( [v]
< [v]
(( [v]
<< [v]
(B [v]
<B [v]
(T [v]
<T [v]
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).
Using Line Commands to Shift Data
>
> 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=.
>
>
> 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=.
>
> 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
This form of TXTSPLIT is especially useful when it is assigned to a PF key. Then,
you only need to position the cursor to the appropriate column within the appropriate
line and press the PF key. The following example shows how you can use TXTSPLIT
to split multiple lines. In this case, lines 400 and 500 are split at column 27.
Everything from that position through column 45 is moved to the appropriate next line,
beginning in column 12.
TXTSPLIT Command to Split Multiple Lines
>
> 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.
TXTJOIN 3
>
> 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------------------------------------------------
>
> 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).
AWS: TXTJOIN Command to Rejoin Multiple Lines
TXTJOIN 5 8 COLS 26
>
> 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>
> 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.
>
> 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>
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.
>
> 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>
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.
Locates
Locates
Locates
Locates
and
and
and
and
displays
displays
displays
displays
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==
>
> 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
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.
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.
To see the data that follows a particular line, you can:
Type an asterisk (*) in the sequence number field of that line.
Type the line number in the sequence number field of any line.
Alter the sequence number field of the line (for example, by deleting a leading
zero).
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.
As illustrated in the following example, the resulting display contains the number and
contents of each line containing the string.
AWS: SEARCH Command Display
>
>
>
...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.
>
> 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.
To see the data that follows a particular line, you can:
Type an asterisk (*) in the sequence number field of that line.
Type the line number in the sequence number field of any line.
Alter the sequence number field of the line (by deleting a leading zero).
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.
THE PREFIX
THE BEGIN
THE EMBED
TEST END
>
> 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========================
-----------------------------------------------------
JUSTIFIED
CENTERED
LOCKED
The display margins are not to be altered even if the matching string
occurs to the left or right of the current margins.
For example, to move lines 1200 through 2800 to the bottom of the active AWS, you
would enter:
MOVE 12== 28== B
MB
To move all lines from the line containing the command through the
last line of the active AWS.
MT
To move all lines from the first line in the active AWS through the
line containing the command.
Command
Type
Meaning
Destination Only
BB
TT
O [v]
Overlay At
Destination
OB
OO
OT
>
>
>
>
>
>
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.)
A
D
J
L
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.
SEQUENCE
NUMBER
ATTRIBUTE
SEQ
SEQ COBOL
SEQ s 1
NOSEQ
SHARED
EXECONLY
RESTRICTED
24-9
24-10
24-12
24-13
24-15
Chapter 25. Data Sets: Attaching a Data Set Object at the Terminal
25.1 Attaching a CA-Librarian Selection List . . . . . . . . . . . . . . .
25.1.1 Using a Primary Command . . . . . . . . . . . . . . . . . . . .
25.1.2 Using the Data Set Facility . . . . . . . . . . . . . . . . . . . .
25.1.3 Selection List Description . . . . . . . . . . . . . . . . . . . . .
25.2 Attaching a Catalog Selection List . . . . . . . . . . . . . . . . . . .
25.2.1 Using a Primary Command . . . . . . . . . . . . . . . . . . . .
25.2.2 Using the Data Set Facility . . . . . . . . . . . . . . . . . . . .
25.2.3 Selection List Description . . . . . . . . . . . . . . . . . . . . .
25.3 Attaching a Generation Data Group Data Set . . . . . . . . . . . . .
25.4 Attaching a PDS Member/CA-Librarian Module . . . . . . . . . . .
25.4.1 Using a Primary Command . . . . . . . . . . . . . . . . . . . .
25.4.2 Using the Data Set Facility Menu . . . . . . . . . . . . . . . .
25.4.3 Using a Selection List . . . . . . . . . . . . . . . . . . . . . . .
25.4.4 Attached Data Description . . . . . . . . . . . . . . . . . . . .
25.5 Attaching a PDS Selection List . . . . . . . . . . . . . . . . . . . .
25.5.1 Using a Primary Command . . . . . . . . . . . . . . . . . . . .
25.5.2 Using the Data Set Facility . . . . . . . . . . . . . . . . . . . .
25.5.3 Selection List Description . . . . . . . . . . . . . . . . . . . . .
25.6 Attaching a Sequential Data Set . . . . . . . . . . . . . . . . . . . .
25.6.1 Using a Primary Command . . . . . . . . . . . . . . . . . . . .
25.6.2 Using the Data Set Facility Menu . . . . . . . . . . . . . . . .
25.6.3 Using a Selection List . . . . . . . . . . . . . . . . . . . . . . .
25.6.4 Attached Data Description . . . . . . . . . . . . . . . . . . . .
25.7 Attaching a Volume Selection List . . . . . . . . . . . . . . . . . .
25.7.1 Using a Primary Command . . . . . . . . . . . . . . . . . . . .
25.7.2 Using the Data Set Facility . . . . . . . . . . . . . . . . . . . .
25.7.3 Selection List Description . . . . . . . . . . . . . . . . . . . . .
25.8 Attaching a VTOC Selection List . . . . . . . . . . . . . . . . . . .
25-1
25-2
25-2
25-3
25-4
25-7
25-7
25-8
25-9
25-14
25-15
25-15
25-16
25-17
25-17
25-18
25-18
25-19
25-20
25-26
25-26
25-26
25-27
25-27
25-28
25-28
25-29
25-30
25-33
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
. . .
24-1
24-2
24-8
. . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
. . . . . . . .
25-33
25-34
25-35
25-38
26-1
26-2
26-3
26-3
26-4
26-5
26-8
26-8
26-8
26-10
27-1
27-2
27-2
27-3
27-11
27-13
27-13
27-16
27-20
27-21
27-22
27-23
27-23
27-25
27-25
27-25
27-28
27-29
27-29
27-33
27-33
27-36
27-40
27-44
27-44
27-46
27-51
27-52
27-53
27-53
27-54
27-57
27-58
. . . . . . . . . . . . . . . . . . . . . . . . . . . .
27-59
Chapter 24. Data Sets: Introducing the Data Set Facility 24-1
8
>
> DSN()
SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6....
DATA SET FACILITY
FUNCTION
==>
DATA SET
VOLUMES
UNIT NAMES
VOLUME TYPES
ARCHIVE LEVEL
PGMR NAME
MODULE TYPE
DISPLAY FORMAT
==>
==>
==>
==>
==>
==>
==>
==>
A
AL
AM
C
CM
PASSWORD
MCD CODE
LANGUAGE
(Q,S,L,H) CONFIRM DELETE
ATTACH DSN
ALLOCATE DSN
SMS MANAGED ALLOC
COPY DSN
COMPRESS DSN
CT
D
DA
DG
I
CATALOG DSN
DELETE DSN
DEFINE ALIAS
DEFINE GDG
DATA SET INFO
==>
==>
==>
==> DSN: Y MEM: Y
P
R
RL
UC
X
PRINT DSN
RENAME DSN
RELEASE SPACE
UNCATALOG DSN
TERMINATE DSF
DATA SET
Chapter 24. Data Sets: Introducing the Data Set Facility 24-3
VOLUMES
UNIT NAMES
VOLUME TYPES
PUBLIC
STORAGE
ARCHIVE LEVEL
-y
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
PGMR NAME
MCD CODE
Chapter 24. Data Sets: Introducing the Data Set Facility 24-5
MODULE TYPE
PROD1
PROD2
TEST
DISPLAY FORMAT
CONFIRM DELETE
MEM
Chapter 24. Data Sets: Introducing the Data Set Facility 24-7
**
Example:
Possible Matches:
TEST1.ABC.+
TEST1.ABC.ALPHA
TEST1.ABC.BETA.SOURCE
TEST2.ABC+
TEST2.ABC.ALPHA
TEST2.ABCR.NEXT.LOAD
TEST3.AAA.SOURCE
TEST3.BBB
TEST4.**.SOURCE
*
TEST4.BBB.SOURCE
TEST4.BBB.NEXT.SOURCE
TEST5.A.BASE
TEST5.A.SAMPLE
TEST6.*.SAMPLE
TEST6.A.SAMPLE
TEST6.BBCCDD.SAMPLE
TEST7.CAB
TEST7.XYZAB
TEST8.ABC
TEST8.ABXYZ
TEST9.AAC.SOURCE
TEST9.ABEFGC.SOURCE
Example:
Possible Matches:
TEST.SOURCE(RO?)
ROE
ROS
ROW
RO
ROE
ROSCOE
Chapter 24. Data Sets: Introducing the Data Set Facility 24-9
Function
Action
Performed.
AL
Panel displayed.
AM
Panel displayed.
Panel displayed.
CM
Performed.
CT
Performed.
Panel displayed.
DA
Define an alias.
Panel displayed.
DG
Define a GDG.
Panel displayed.
Performed.
Panel displayed.
Panel displayed.
RL
Performed.
UC
Performed.
Performed.
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).
When additional information is needed, a function-related panel is displayed. When
such a panel is displayed, you can move from it to another panel or to the menu by
entering in the first panel field:
=[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
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.
DX
Delete the members of a PDS without deleting the data set itself.*
UC
DA
DG
RL
CM
CT
Get attributes.
AL
AM
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
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.)
Data Set: Selection List Function Hierarchy Example
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
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.
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
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
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
Character
Example:
Possible Matches:
LIBR.SOURCE(RO?)
ROE
ROS
ROW
AJCL
JCL
JCLEND
XJCLX
RO
ROE
ROSCOE
8
>
> DSN()
SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6....
DATA SET FACILITY
FUNCTION
===> A
DATA SET
VOLUMES
UNIT NAMES
ARCHIVE LEVEL
===>
===>
===>
===>
LIBR.NEWDATA
STOR=1
PASSWORD
===> SECRET
Chapter 25. Data Sets: Attaching a Data Set Object at the Terminal 25-3
>
> 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
C
D
G
H
P
R
X
*
- Attach a module
- Copy a module
- Delete a module
- Get module attributes
- Attach module history
- Print a module
- Rename a module
- 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 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.
VOLSER
MEMS
ORG
RECFM
Record format.
BLKSZ
LRECL
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
Field Name
Description
ALT
MODULE
ALL
PSWD
Non-displayed password
ALL
LAST-MODIFIED
ALL
DESCRIPTION
Description of the
module contents, if
available
CREATED
PROGRAMMER
LANG
SSTAT
BLKS
Number of blocks
allocated to the module
RECS
**
Example:
Possible Matches:
TEST1.ABC.+
TEST1.ABC.ALPHA
TEST1.ABC.BETA.SOURCE
TEST2.ABC+
TEST2.ABC.ALPHA
TEST2.ABCR.NEXT.LOAD
TEST3.AAA.SOURCE
TEST3.BBB
TEST4.**.SOURCE
TEST4.BBB.SOURCE
TEST4.BBB.NEXT.SOURCE
Chapter 25. Data Sets: Attaching a Data Set Object at the Terminal 25-7
Character
TEST5.A.BASE
TEST5.A.SAMPLE
TEST6.*.SAMPLE
TEST6.A.SAMPLE
TEST6.BBCCDD.SAMPLE
TEST7.CAB
TEST7.XYZAB
TEST8.ABC
TEST8.ABXYZ
TEST9.AAC.SOURCE
TEST9.ABEFGC.SOURCE
8
>
> DSN()
SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6.
DATA SET FACILITY
FUNCTION
===> A
DATA SET
VOLUMES
===> TEST.AQB.+
===>
>
> 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
AL
AM
C
CM
CT
D
DA
DG
DX
G
I
P
R
RL
UC
X
*
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
Control volume.
Integrated catalog facility.
VSAM user catalog.
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
Field Name
Description
ALT
DATA SET
NAME
All
TYPE
AIX
Alternate index
ALIAS
Alias name
CLUSTER
VSAM cluster
DATA
Data component
GDGBASE
INDEX
Index
component
PATH
Path
USERCAT
User catalog
VOLUME
VSAM volume
data set
VOLUME
DEVICE
ORG
RFM
Field Name
Description
ALT
LRECL
CREDT
REFDT
EXPDT
TRKS
IN-USE
%USED
EXT
STORCLAS
DATACLAS
MGMTCLAS
DTYP
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
>
> DSN()
SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6.
DATA SET FACILITY
FUNCTION
===> A
DATA SET
VOLUMES
===> TEST.GENSET(-1)
===>
When GDG is attached, the data are presented in a format similar to the one shown in
the following example.
Data Set: Sample ATTACHed Data Display
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.
Chapter 25. Data Sets: Attaching a Data Set Object at the Terminal 25-15
>
> DSN()
SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6.
DATA SET FACILITY
FUNCTION
===> A
DATA SET
VOLUMES
===> TEST.MASTER(INVREPT)
===> SHR=7
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.
Data Set: Attaching a CA-Librarian Module through the Menu
>
> DSN()
SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6.
DATA SET FACILITY
FUNCTION
===> A
DATA SET
VOLUMES
UNIT NAMES
ARCHIVE LEVEL
===> TEST.LIBR(MOD1)
===>
===>
===> -3
PGMR NAME
===>
If you do not specify an archive level, the most current level of the module is attached.
>
> 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
=
>
> 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
Character
Example:
Possible Matches:
TEST.SOURCE(RO?)
ROE
ROS
ROW
RO
ROE
ROSCOE
>
> DSN()
SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6....
DATA SET FACILITY
FUNCTION
===>
DATA SET
VOLUMES
UNIT NAMES
ARCHIVE LEVEL
===>
===>
===>
===>
TEST.NEWDATA
STOR=1
PASSWORD
===> SECRET
Chapter 25. Data Sets: Attaching a Data Set Object at the Terminal 25-19
>
> 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
C
D
DA
G
P
R
X
*
Attach a member
Copy a member
Delete a member
Define an alias
Get attributes
Print a member
Rename a member
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.
MEMS
ORG
RECFM
BLKSZ
LRECL
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
Field Name
Description
ALT
MEMBER
All
ATTRIBUTES
RENT
REUS
REFR
OVLY
TEST
Reentrant
Reusable
Refreshable
Overlay Format
Test symbols
present
NEXC
Not executable
LOAD
Only loadable
SCTR
Scatter Format
AC=N
Authorization
Code
AM=amode Addressing
mode
RM=rmode Residency
mode
SIZE
EP
TTR
ALIAS-OF
LASTMODIFIED
SSI-DATA
>
> 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
C
D
DA
E
G
P
R
SU
X
*
Attach a member
Copy a member
Delete a member
Define an alias
Edit a member
Get attributes
Print a member
Rename a member
Submit a member
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
VOLSER
MEMS
ORG
RECFM
BLKSZ
LRECL
The remaining fields identify the members comprising the data set and include the
information shown in the following table.
Field Name
Description
ALT
MEMBER
1/2
VV.MM
1/2
CREATED
1/2
LASTMODIFIED
1/2
SIZE
Number of records
currently in the member, if
available.
1/2
INIT
1/2
TTR
MOD
USER
1/2
Chapter 25. Data Sets: Attaching a Data Set Object at the Terminal 25-25
>
> DSN()
SCRL FULL COLS ====1.===72
....+....1....+....2....+....3....+....4....+....5....+....6.
DATA SET FACILITY
FUNCTION
===> A
DATA SET
VOLUMES
===> TEST.MASTER
===> SHR=7
>
> 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>
> 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
Ccharacter
Example:
Possible Matches:
??ROS1
ADROS1
MUROS1
MUAS
MURDS1
MUROS1
MUR
MUROS1
>
> DSN()
SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6.
DATA SET FACILITY
FUNCTION
===> A
DATA SET
VOLUMES
UNIT NAMES
VOLUME TYPES
===>
===> STOR+
===> 338=
===> PRIVATE
Chapter 25. Data Sets: Attaching a Data Set Object at the Terminal 25-29
>
> 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
C
G
I
P
X
*
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.
UNIT
TYPE
Description
ALT
VOLUME
ALL
UNIT
ALL
DEVTYPE
1/2
INDEX
SMS
DEVSTAT
VOLSTAT
CYL (CONTG)
CYL (AVAIL)
Chapter 25. Data Sets: Attaching a Data Set Object at the Terminal 25-31
Field Name
Description
ALT
TRK (CONTG)
TRK (AVAIL)
AV-XT
#DSNS
USED-XT
VTOC-TRKS
DSCBS
(TOTAL)
DSCBS (FREE)
%USED
TRKS (TOTAL)
TRKS (USED)
%USED
MAXBLK
TRKSIZE
TRK/CYL
**
Example:
Possible Matches:
TEST1.ABC.+
TEST1.ABC.ALPHA
TEST1.ABC.BETA.SOURCE
TEST2.ABC+
TEST2.ABC.ALPHA
TEST2.ABCR.NEXT.LOAD
TEST3.AAA.SOURCE
TEST3.BBB
TEST4.**.SOURCE
TEST4.BBB.SOURCE
TEST4.BBB.NEXT.SOURCE
Chapter 25. Data Sets: Attaching a Data Set Object at the Terminal 25-33
Character
TEST7.CAB
TEST7.XYZAB
TEST8.ABC
TEST8.ABXYZ
>
> DSN()
SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6.
DATA SET FACILITY
FUNCTION
===> A
DATA SET
VOLUMES
===>
===> STOR=1
>
> 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
AL
AM
C
CM
CT
D
DA
DX
G
I
P
R
RL
UC
X
*
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
UNIT
DSNS
DSCBS
CYL
TRK
The remaining fields identify the data sets on the volume and include the information
shown in the following table.
Field Name
Description
ALT
DATA SET
NAME
ALL
ORG
RFM
BLKSZ
LRECL
CREDT
Creation date.
REFDT
EXPDT
Expiration date.
TRKS
IN-USE
%USED
Percentage of allocated
tracks currently in use.
EXT
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
SELECT CAT
SELECT DIR
SELECT MENU
SELECT NEXT
SELECT PREV
SELECT string
SELECT VOL
SELECT VTOC
Chapter 25. Data Sets: Attaching a Data Set Object at the Terminal 25-39
Locate
Locate
Locate
Locate
the
the
the
the
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 PREFIX
THE BEGIN
THE EMBED
TEST END
TEST SUFFIX Qualifies the string as ending a word; only CONTEST matches.
or
/X'C1' /
JUSTIFIED
CENTERED
LOCKED
The display margins are not to be altered even if the matching string
occurs to the left or right of the current margins.
or
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.
or
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 issue the command:
STATUS NOTES
a list of all the names that you have assigned is displayed.
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).
ATTACH_
>
> 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.
ATTACH DSN )
>
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.
>
> 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/
These functions can be performed using primary commands, the Data Set Facility
menu or the appropriate Selection List.
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.
>
> DSN()
SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....
ALLOCATE NEW DATA SET
DATA SET
===> TEST.OLD
VOLUMES
===> STOR=2
UNIT NAMES ===>
UNITS
PRIMARY
SECONDARY
DIRECTORY
===>
===>
===>
===>
TRK
16
1=
6
DSORG
RECFM
LRECL
BLKSIZE
KEYLEN
EXPDT
CATALOG
===>
===>
===>
===>
===>
===>
===>
PO
FB
8=
352=
YES
(BLK, TRK,
(NUMBER OF
(NUMBER OF
(VALID FOR
or CYL)
ABOVE UNITS)
ABOVE UNITS)
PDS DATA SETS ONLY)
(MM/DD/YY)
(Y,N)
Enter the one- to 44-character fully qualified name of the data set to
be allocated. The name may be further qualified with:
+v
VOLUMES
UNITS
PRIMARY
SECONDARY
DIRECTORY
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.
If UNITS BLK is specified, BLKSIZE is required and the value
may not exceed 65535.
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
NO
>
> DSN()
SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....
ALLOCATE NEW SMS-MANAGED DATA SET
DATA SET
MGMTCLAS
STORCLAS
VOLUMES
UNITS
PRIMARY
SECONDARY
DIRECTORY
==>
==>
==>
==>
==>
==>
==>
==>
ROSCOE.CREATE.PDSE
SMS
(BLANK FOR
SMS
(BLANK FOR
SMS==1
TRK
(BLK, TRK,
1
(NUMBER OF
1
(NUMBER OF
(VALID FOR
DATACLAS
DSORG
RECFM
LRECL
BLKSIZE
==>
==>
==>
==>
==>
PO
FB
8=
8==
SECMODEL
DSNTYPE
==> TEST.SMS.OLD1
==> LIB
MGMTCLAS
STORCLAS
VOLUMES
PRIMARY
SECONDARY
DIRECTORY
DATACLAS
DSORG
RECFM
Enter any valid data set record format. If omitted, the record
format is undefined.
LRECL
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
VSAM
VSAM
VSAM
VSAM
Enter the data set key length as a value between 0 and 255. If
omitted, the default is 0.
KEYOFF
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.
SECMODEL
DSNTYPE
GENERIC
>
> DSN()
SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6.
DATA SET FACILITY
FUNCTION
===> CT
DATA SET
VOLUMES
UNIT NAMES
===> TEST.NEW
===> STOR=1
===>
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.)
COPY DSN T_
>
> 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
T
B
*
R
: PDS or CA-LIBRARIAN.
: CA-LIBRARIAN only.
8
>
> DSN()
SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....
COPY DATA SET
OPTION
===> C
DATA SET
VOLUMES
UNIT NAMES
ARCHIVE LEVEL
PGMR NAME
MODULE TYPE
1ST LINE
===> TEST.SOURCE
===>
===>
===>
===>
===>
===> 12==
AWS TARGET
LIST HEADERS
===> 5==
===> YES
PASSWORD
MCD CODE
LANGUAGE
LAST LINE
===>
===>
===>
===> 25==
Enter the code that is appropriate for the action you want to
perform. The codes are:
C
DATA SETS
VOLUMES
UNIT NAMES
ARCHIVE LEVEL
-y
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.
PASSWORD
PGMR NAME
MCD CODE
MODULE TYPE
Includes
Includes
Includes
Includes
modules
modules
modules
modules
with
with
with
with
1ST LINE
LAST LINE
AWS TARGET
LIST HEADERS
Copy after the line at which the AWS pointer is currently positioned.
Copy at or after the line specified by v.
Copy to the bottom of the active AWS.
Replace the contents of the active AWS with the copied data.
Copy to the top of the active AWS.
The following example illustrates how you can copy multiple data sets from a
Selection List.
Data Set: Copying Through a Selection List
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
C
C
TEST.NEW
TEST.NEW1
TEST.NEW2
)
T
B
PO FB
PO U
PO FB
8=
12288 1
8==
Note: Password-protected data sets cannot be copied from a Selection List. Use the
Copy Function panel or the COPY primary command.
8
>
> DSN()
SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6.
DATA SET FACILITY
FUNCTION
===> CM
DATA SET
VOLUMES
UNIT NAMES
===> TEST.SAMPLE
===>
===>
or, by entering the CM code on a Catalog or VTOC Selection List, as in the following
example.
Data Set: Compressing Through a Selection List
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
TEST.BETA
CM TEST.SAMPLE
PO FB
PO U
PO FB
8=
8=
122
88 12288
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.
8
>
> DSN()
SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6.
DEFINE DATA SET ALIAS
DATA SET
VOLUME
UNIT NAME
PASSWORD
===>
===>
===>
===>
CATALOG.TEST
ALIAS NAME
===>
SAMPLE
Enter the: 1) fully qualified name of the PDS in which the alias is to
be created plus the one- to eight-character name of the member for
which the alias is to be created; or 2) name of the non-VSAM data
set, ICF user catalog or VSAM user catalog for which the alias is to
be created.
VOLUME
UNIT NAME
PASSWORD
ALIAS
8
>
> DSN()
SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....
DEFINE GENERATION DATA GROUP
GDG NAME
===> TEST.GDG.OLD
LIMIT
EMPTY
SCRATCH
OWNER
FOR
TO
===> 15
===> NO
===> NO
===>
===>
===>
(1-255)
(Y,N)
(Y,N)
(1-9999)
(MM/DD/YYYY)
LIMIT
EMPTY
NO
SCRATCH
NO
OWNER
FOR
Enter the number of days for which the GDG is to be kept. It must
be a value between 0 and 9999.
TO
8
>
> DSN()
SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....
DELETE DATA SET
OPTION
===> D
DATA SET
VOLUME(S)
UNIT NAME(S)
OVERRIDE RETPD
PGMR NAME
MODULE TYPE
===> TEST.OLD
===>
===>
===> YES
===>
===>
D
M
S
X
DATA SETS
Enter the code that is appropriate for the action you want to
perform. The codes are:
D
Enter the one- to 44-character fully qualified name of the data set to
be deleted. The name can be further qualified with:
dsnmem
DATA SETS
(cont.)
*
VOLUMES
UNIT NAMES
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
-y
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
NO
PASSWORD
MCD CODE
The following fields only have meaning when you specify the M option to display a
list of CA-Librarian module names.
PGMR NAME
MODULE TYPE
LANGUAGE
PROD0
PROD1
PROD2
TEST
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
D
TEST.NEW
TEST.NEW1
TEST.NEW2
PO FB
PO U
PO FB
8=
8=
12288 12288
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.
>
> 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).
8
>
> DSN()
SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....
CONFIRM ==>
ENTER (Y)ES TO CONFIRM DELETE OF PDS DIRECTO
DSN:
CREATED:
VOLSER:
MEMBERS:
TEST.PDS.SAMPLE
11/=1/88
STOR=2
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.
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.
>
> DSN()
SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6.
DATA SET FACILITY
FUNCTION
===> I
DATA SET
VOLUMES
===> TEST.SAMPLE2.SOURCE
===>
or, specifying the I function code on a Catalog or VTOC Selection List, as in the
following example:
Data Set: Inquiring Through a Selection List
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 ================
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.
>
> 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
ALLOCATED TRACKS
USED TRACKS
ALLOCATED EXTENTS
USED EXTENTS
ALLOCATED DIR BLKS
USED DIR BLKS
NUMBER OF MEMBERS
UNITS
1ST EXTENT
SECONDARY EXTENTS
===>
===>
===>
===>
===>
===>
===>
===>
===>
===>
156
15=
5
5
25
22
127
TRK
1=8
12
DSORG
===>
PO
RECFM
===>
FB
LRECL
===>
8=
BLKSIZE
===>
8==
KEYLEN
===>
=
KEY OFF
===>
SECURITY
===> NONE
CREATED
===> 11/=4/85
ACCESSED
===> =3/2=/86
EXPIRATION ===>
EXTENT NO.
1ST TRACK (CCHH)
LAST TRACK (CCHH)
TRACKS
---------------------------------------------1
7425 (=1EF====)
7532 (=1F6===2)
1=8
2
12755 (=352===5)
12766 (=353===1)
12
3
12767 (=353===2)
12778 (=353===D)
12
4
12779 (=353===E)
1279= (=354===A)
12
5
12791 (=354===B)
128=2 (=355===7)
12
================================= B O T T O M ==============
The information is divided into two parts. The first describes the data set itself; the
second provides specific information about each extent.
The data set information includes:
DATA SET
ENTRY TYPE
MGMTCLAS
STORCLAS
VOLUMES
DEVTYPE
SEQ NO
DATACLAS
DSNTYPE
SMS data set type. This field will be LIB when the data set
is a PDSE, and will be blank when another data set type
(non-PDSE) has been defined.
ALLOCATED TRACKS
Total number of tracks allocated on the first (or only)
volume.
USED TRACKS
ALLOCATED EXTENTS
Total number of extents allocated on the first (or only)
volume.
USED EXTENTS
NUMBER OF MEMBERS
Number of members in the PDS or modules in a
CA-Librarian master file.
DSORG
RECFM
LRECL
BLKSIZE
KEYLEN
Key length.
KEYOFF
Key offset.
SECURITY
PWWR
PWRD
UNITS
1ST EXTENT
SECONDARY EXTENT
Number of allocation units for each subsequent extent.
CREATED
Creation date.
ACCESSED
EXPIRATION
Expiration date.
LAST TRACK CCHH) Ending CCHH address of the extent (in hexadecimal) and
the relative number on the volume (in EBCDIC).
TRACKS
8
>
> DSN()
SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6.
DATA SET FACILITY
FUNCTION
===> I
DATA SET
VOLUMES
===>
===> STOR=1
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 ================
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.
8
>
> DSN()
SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6.
VOLUME INFORMATION
VOLUME ==> STOR=1
DEVICE STATUS
VOLUME STATUS
=> A
=> PRIV
VTOC INDEX
SMS CONTROL
=> ACTIV
=> NO
DATA SETS
=>
VTOC TRACKS
=>
TOTAL DSCBS
=>
FREE DSCBS
=>
PERCENT OF VTOC USED=>
=>
=>
=>
=>
=>
8
49
127
1311
172
647
15
795
117
85
ADDRESS
DEVTYPE
DEVICE STATUS
=
=
=
=
=
Allocated.
Console.
Offline.
Online.
System Residence Volume.
=
=
=
=
=
=
=
=
=
Hardware error.
Busy.
Mount pending.
Not ready
Offline pending.
Unload pending.
Restricted to allocation.
Suspended due to ASM use.
Allocated to system.
z is shown as:
M
P
R
VOLUME STATUS
= Multi-system assignment.
= Reserve pending.
= Reserved/shared/exclusive control.
= Volume is resident.
= Volume is reserved.
= Volume is removable.
VTOC INDEX
SMS CONTROL
NONE
ACTIVE
DISABLED
CREATED
VTOC TRACKS
TOTAL DSCBS
FREE DSCBS
8
>
> DSN()
SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6...
PRINT DATA SET
OPTION
===> P
DATA SET
VOLUMES
UNIT NAMES
ARCHIVE LEVEL
PGMR NAME
MODULE TYPE
1ST LINE
TAG NAME
DEST
PAGE WIDTH
TYPE/FORMAT
1ST COL
===>
===>
===>
===>
===>
===>
===>
===>
===>
===>
===>
===>
TEST.SAMPLE.SOURCE
MUROS1
PASSWORD ===>
MCD CODE ===>
LANGUAGE ===>
1
LAST LINE ===> 999999 NOTIFY
SEPARATOR ===> YES
FORCEALIGN
PR17 COPIES
===> 1
CLASS
PAGE LEN
===>
SEQ NUMBRS
DEF TOP MARGIN ===>
BOT MARGIN
1
LAST COL
===> 32767
===>
===> NO
===> =
===> YES
===>
DATA SETS
Enter the code that is appropriate for the action you want to
perform. The codes are:
P
VOLUMES
UNIT NAMES
ARCHIVE LEVEL Enter the archive level of the CA-Librarian master file module to
be printed. (The module must be in ARCHIE format.) If
omitted, the most current level of the module is printed. The
level can be specified as:
Lx
-y
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
PGMR NAME
MCD CODE
MODULE TYPE
PROD1
PROD2
TEST
You can use the following fields to customize the print operation.
1ST LINE
LAST LINE
NOTIFY
SEPARATOR
NO
COPIES
CLASS
Enter the print class to be used at the location where the request
is to be printed. (Site management will tell you which classes are
valid for 328x-type printers and which are valid for system
printers.)
PAGE WIDTH
PAGE LEN
SEQ NUMBRS
NO
ANS
MCC
DUMP
CHEX
VHEX
TOP MARGIN v
BOT MARGIN v
1ST COL
LAST COL
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
P
TEST.NEW
TEST.NEW1
TEST.NEW2
PR99
PO FB
PO U
PO FB
8=
12288 1
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.
>
> DSN()
SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6.
DATA SET SELECTION MENU
FUNCTION
===> RL
DATA SET
VOLUMES
===> ABC.TEST.ASM
===>
or, by entering the RL function code on a Catalog or VTOC Selection List, as in the
following example.
Data Set: Release Space Through a Selection List
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
ABC.TEST.LOAD
ABC.TEST.OBJECT
PO FB
PO U
PO FB
8=
8=
12288 12288
8==
8=
8
>
> DSN()
SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....
RENAME DATA SET
OPTION
===> S
DATA SET
VOLUME(S)
UNIT NAME(S)
PASSWORD
PGMR NAME
MODULE TYPE
===> TEST.OLD1(MEMOLD)
===>
===>
===> MYPASS
===>
MCD CODE ===>
===>
LANGUAGE ===>
===> MEMNEW
M
R
DATA SET
DATA SET
(cont.)
v
VOLUMES
UNIT NAMES
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
-y
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
MCD CODE
The next three fields only have meaning when you specify the M option to display a
list of member/module names.
PGMR NAME
MODULE TYPE
Enter the type of modules to be included in a CA-Librarian
Selection List by specifying one of the following:
LANGUAGE
PROD0
PROD1
PROD2
TEST
dsn
dsnmem
+v
>
> 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 -------------R
JUNK1
JUNK2
R JUNK3
NEW1
NEW2
RENT REUS
RENT REUS REFR
RENT REUS REFR
AM=31
AC=1
>
> 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.
8
>
> DSN()
SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6.
DATA SET FACILITY
FUNCTION
===> UC
DATA SET
VOLUMES
UNIT NAMES
===> TEST.NEW
===>
===>
You can also specify the UC code on a VTOC Selection List, as in the following
example.
Data Set: Uncataloging Through a Selection List
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
ABC.TEST.LOAD
UC ABC.TEST.NEW
PO FB
PO U
PO FB
8=
8=
12288 12288
8==
8=
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.
Other operands of the EXPORT command allow you to:
Write to a PDS member by specifying the member name in parentheses after the
data set names, as in:
EXPORT DSN=TEST.SOURCE(PROG5) INPUT=MYPROG5
You can use the SET STATS command to control the SPF directory information
that is placed in the directory entry whenever a member is added or updated.
Write to an uncataloged data set by including the serial number with the VOL=
operand, as in:
EXPORT DSN=TEST.SOURCE(PROG5) VOL=SHAR=1
Add to the end of an existing data set by specifying MOD with the DISP operand,
as in:
EXPORT DSN=TEST.PROJ,DISP=MOD
where the contents of the active AWS is added to the end of the original contents
of the data set.
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.
Edit Data Set Facility Display
7 <...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+.. 8
EDIT DATASET FACILITY
FUNCTION ===>
DATA SET ===>
VOLUME
===>
UNIT
===>
E
PASSWORD
===>
ARCHIVE LEVEL ===>
- EDIT DATASET
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.
. . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . . .
. . . . . . . . . . . .
. . . . . . . . . . . .
. . . . . . . . . . . .
. . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . .
28-1
28-2
28-2
28-3
28-4
28-4
28-5
28-6
28-7
28-9
28-11
28-12
28-13
28-15
29-1
29-2
29-4
29-5
29-6
29-7
30-1
30-2
30-2
30-7
30-7
30-8
30-12
30-15
30-17
30-17
30-20
30-23
30-26
30-30
JCK
>
> 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 ========
>
>
....+....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'
CAY6===
Data Source
Attribute
Command Override
Action
AWS
NOSEQ
no command
Numbers excluded.
No affect
No affect
NOSEQ
No affect
SEQ
Numbers included at
location designated by
command.
no command
Numbers included at
location designated by
atrribute.
Numbers excluded.
Numbers included at
location designated by
atrribute.
NOSEQ
Numbers excluded.
SEQ
Numbers included at
location designated by
command.
NOSEQ
no command
SET SUBMIT NOSEQ
SET SUBMIT SEQ
Numbers excluded.
No affect.
No affect.
SEQ
no command
Numbers included at
location designated by
attribute.
Numbers excluded.
Numbers included at
location designated by
attribute.
SEQ
Library
Member(s)
+INCAWS
mem
pfx.
where:
AWS
mem
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
:
:
:
:
:
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.
attach jobs,
display a job's execution status,
display job-related information,
alter file attributes,
copy jobs,
print jobs, and
cancel jobs.
It can also be used to execute operator commands and check the system console.
You can display the Job Facility by issuing the command:
AJOB
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
on the command line.
PA keys will take you back one level.
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.
8
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....
JOB FACILITY
FUNCTION
===>
JOB/GRP NAME
JOB NUMBER
FILE NUMBER
PAGE NUMBER
LINE NUMBER
===>
===>
===>
===>
===>
A - ATTACH JOB
AI - ATTACH INITIATORS
AT - ALTER JOB
DEST/CLASS
ACTIVE JOB TYPE
CONTROL CHARS
CONFIRM CANCEL
C - COPY JOB
CN - CANCEL JOB
I
L
===>
===>
===> NO
===> YES
- INFO JOB
- SYSTEM LOG
(ALL,JES,STC,TSO)
(Y,N)
(Y,N)
OP - OPER CONTROL
P - PRINT JOB
X - TERMINATE
JOB/GRP NAME
JOB NUMBER
FILE NUMBER
PAGE NUMBER
LINE NUMBER
DEST/CLASS
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
ROSAJCL
ROSJCL
ROSJCLEND
ROSXJCLX
DROS
DROSCOE
DROSTSO
Function
Action
Attach a job.
AI
Panel displayed.
AT
Alter a job.
Panel displayed.
Copy a job.
Panel displayed.
CN
Cancel a job.
Panel displayed
Panel displayed
OP
Panel displayed
Print a job.
Panel displayed
Performed
FUNCTION ===>
(M - MENU; F JOB NAME ===> SAMPQ
FILE ===>
LINE ===1 OF ==13
JOBNO JOBNAME
STATUS
----- -------- ------------------__
284 SAMPCSTT AWAITING PRINT (H)
__
283 SAMPDSTT AWAITING PRINT (H)
__ 411= SAMPSTR1 AWAITING PRINT (H)
__ 6843 SAMPLOGP AWAITING PRINT (H)
__ 2993 SAMPDSTT AWAITING PRINT (H)
__ 7158 SAMPETC EXECUTING 24:42:53
__ 716= SAMPCICS EXECUTING 24:42:48
__ 4596 SAMPCCCS EXECUTING
8:4=:5=
__ 5477 SAMPDSTT EXECUTING
5:39:45
__ 7667 SAMPCSTT EXECUTING
3:24:35
ORIGIN
--------LOCAL
LOCAL
LOCAL
LOCAL
LOCAL
LOCAL
LOCAL
SYSTEMC
LOCAL
LOCAL
14.36.=8
HELD/
STEP/LINES CPU TIME
---------- --------
SAMPETC
SAMPCICS
SAMPCCCS
MUF8=
CICS
298.45
63.13
18.79
8.45
36.23
--------------------------------------------------------------------------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
The fields comprising the job selection list can be used to change or further qualify the
display, and include:
FUNCTION
JOB NAME
FILE
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
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.
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.
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.
8
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....
JOB FACILITY
FUNCTION
===> OP
JOB/GRP NAME
JOB NUMBER
FILE NUMBER
PAGE NUMBER
LINE NUMBER
===>
===>
===>
===>
===>
A - ATTACH JOB
AI - ATTACH INITIATORS
AT - ALTER JOB
DEST/CLASS
ACTIVE JOB TYPE
CONTROL CHARS
CONFIRM CANCEL
C - COPY JOB
CN - CANCEL JOB
I
L
===>
===>
===> NO
===> YES
- INFO JOB
- SYSTEM LOG
(ALL,JES,STC,TSO)
(Y,N)
(Y,N)
OP - OPER CONTROL
P - PRINT JOB
X - TERMINATE
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.
This panel consists of four fields, as shown in the following example.
Jobs: Operator Control Display
8
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....
OPERATOR CONTROL
OPTION
===>
COMMAND
- OR LIB MEMBER
===>
UCB ADDRESS
===>
===>
COMMAND
LIB MEMBER
Note: CA-Roscoe supports the six-digit job number support added with z/OS
JES2/JES3 1.2.
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
The following example is displayed.
Jobs: AJOB Execution Status
FUNCTION ===>
(M - MENU; F JOB NAME ===> COMPILE
FILE ===>
LINE ===1 OF ==13
JOBNO JOBNAME
STATUS
----- -------- ------------------__ 2=85 COMPILE AWAITING PRINT(H)
__ 4678 COMPILE EXECUTING
=:==:2=
__ 5232 COMPILE AWAITING EXECUTION
14.36.=8
HELD/
C PTY SID
ORIGIN
STEP/LINES CPU TIME
- --- ---- --------- ---------- -------1 SYSH R1=
X
6 SYSH R1=
LINKMOD
=1.44
X
6 SYSH R1=
QPOS(18) YES
--------------------------------------------------------------------------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
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
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....
JOB FACILITY
FUNCTION
===> I
JOB/GRP NAME
JOB NUMBER
FILE NUMBER
PAGE NUMBER
LINE NUMBER
===> COMPILE
===>
===>
===>
===>
- ATTACH JOB
DEST/CLASS
ACTIVE JOB TYPE
CONTROL CHARS
CONFIRM CANCEL
- COPY JOB
===>
===>
===> NO
===> YES
(ALL,JES,STC,TSO)
(Y,N)
(Y,N)
- INFO JOB
OP - OPER CONTROL
Information about the specified job will be displayed in the format shown in the
following example.
Jobs: Information Display (Job Facility)
8
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....
JOB INFORMATION
OPTION
===> I
JOB NAME
===> COMPILE
JOB NUMBER
===> 1234
REFRESH INTERVAL ===> =4
JOB STATUS
JOB CLASS
PRIORITY
SYSID
:
:
:
:
EXECUTING
3
11
XXX1
(=1 - 6=)
27:49:5=
STEP/LINES
CPU TIME
HELD
ORIGIN
: CICS
: 1=.56
:
: SYSTEMX
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:
OPTION
JOB NAME
JOB NUMBER
REFRESH INTERVAL
The number of seconds to wait during autorefresh mode before
showing updated information. Must be a number from 1 to 60; the
default is 4.
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.
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
File
File
File
File
File
1
2
3
4
5
6
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=
8
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+...
JOB FACILITY
FUNCTION
===>A
JOB/GRP NAME
JOB NUMBER
FILE NUMBER
PAGE NUMBER
LINE NUMBER
===> SAMPLE
===>
===>
===>
===>
A - ATTACH JOB
AI - ATTACH INITIATORS
AT - ALTER JOB
DEST/CLASS
ACTIVE JOB TYPE
CONTROL CHARS
CONFIRM CANCEL
C - COPY JOB
CN - CANCEL JOB
I
L
===>
===>
===> NO
===> YES
- INFO JOB
- SYSTEM LOG
(ALL,JES,STC,TSO)
(Y,N)
(Y,N)
OP - OPER CONTROL
P - PRINT JOB
X - TERMINATE
FUNCTION ===>
(M - MENU; F JOB NAME ===> SAMPLE
FILE ===>
LINE ===1 OF ==13
JOBNO JOBNAME
STATUS
----- -------- ------------------A_
284 SAMPLE
AWAITING PRINT (H)
__
283 SAMPLE
AWAITING PRINT (H)
__ 2652 SAMPLE
AWAITING PRINT (H)
__ 5=41 SAMPLE
EXECUTING 27:38:11
__ 7158 SAMPLE
EXECUTING 24:42:53
ORIGIN
--------LOCAL
LOCAL
LOCAL
SYSTEMC
LOCAL
14.36.=8
HELD/
STEP/LINES CPU TIME
---------- --------
$$$$$$@
SAMPLE
1=.53
298.45
--------------------------------------------------------------------------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
The output files of your job can be attached at any time. (If an output file's
attributes are to be modified, you must submit the job with a special
site-defined SYSOUT class.) If your job is:
AWAITING EXECUTION: The JCL and all SYSIN data can be viewed.
(This is the only time this information is displayed.)
EXECUTING: The JCL and that much of the job log and SMB that is
currently written to the spool can be viewed, plus all available files. (If a
file is open and empty, only the end of file message is presented when that
file is displayed.)
AWAITING PRINT: All SYSOUT files that have not been printed or
purged can be viewed.
JES3
If an output file exists, you can examine it at any time. You can only modify
attributes of files routed to a SYSOUT class held for an external writer
(when ETSO is not active) or TSO (when ETSO is active). (A special
site-defined SYSOUT class designates that the output is to be held.)
>
> AWS()
SCRL FULL COLS ====1 ===72
>....+....1....+....2....+....3....+....4....+....5....+....6
==================================== T O P =================
//SAMPLE
JOB (account-info),CLASS=X,PRTY=6,MSGCLASS=T
//COB
EXEC PGM=IKFCBL==
...
//SYSPRINT DD
SYSOUT=H
//SYSIN
DD
Q
COBOL program inserted here
//LKED
EXEC PGM=LINKEDIT
...
//SYSPRINT DD
SYSOUT=Q
//GO
EXEC PGM=Q.LKED.SYSLMOD,...
//SYSOUT
DD SYSOUT=A
//SYSPRINT DD SYSOUT=Q
//SYSIN
DD Q
test data
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.
Locate
Locate
Locate
Locate
the
the
the
the
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==
THE PREFIX
THE BEGIN
THE EMBED
TEST END
TEST SUFFIX Qualifies the string as ending a word; only CONTEST matches.
JUSTIFIED
CENTERED
LOCKED
The display margins are not to be altered even if the matching string
occurs to the left or right of the current margins.
or
or
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.
ATTACH_
>
> 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.
ATTACH JOB )
>
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>
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/
PREV Job
FIRST Job
LAST Job
DETach Job
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.
8
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+...
JOB FACILITY
FUNCTION
===> AT
JOB/GRP NAME
JOB NUMBER
FILE NUMBER
PAGE NUMBER
LINE NUMBER
===> SAMPLE
===>
===>
===>
===>
A - ATTACH JOB
AI - ATTACH INITIATORS
AT - ALTER JOB
DEST/CLASS
ACTIVE JOB TYPE
CONTROL CHARS
CONFIRM CANCEL
C - COPY JOB
CN - CANCEL JOB
I
L
===>
===>
===> NO
===> YES
- INFO JOB
- SYSTEM LOG
(ALL,JES,STC,TSO)
(Y,N)
(Y,N)
OP - OPER CONTROL
P - PRINT JOB
X - TERMINATE
When you select the ALTER JOB function, the Alter Job panel will be displayed. It
will contain the name of the job which was entered on the primary menu, as shown in
the following example.
Jobs: Alter Job Panel Display
8
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+...
ALTER JOB/FILE ATTRIBUTES
OPTION
===>
JOB NAME
JOB NUMBER
FILE NUMBER
PRINT STATUS
DESTINATION
COPIES
===> SAMPLE
===> 1234
===>
(NN, ALL)
===>
(P, NOP)
===>
===>
CLASS
FORM
===>
===>
Select one of the four OPTIONs listed on the screen and fill in all appropriate fields,
which consist of the following:
OPTION
JOB NUMBER
FILE NUMBER
PRINT STATUS
DESTINATION
COPIES
CLASS
FORM
FUNCTION ===>
(M - MENU; F JOB NAME ===> SAMPLE
FILE ===>
LINE ===1 OF ==13
JOBNO JOBNAME
STATUS
----- -------- ------------------__
284 SAMPLE
AWAITING PRINT (H)
AT
283 SAMPLE
AWAITING PRINT (H)
AT 411= SAMPLE
AWAITING PRINT (H)
__ 4596 SAMPLE
EXECUTING
8:4=:5=
__ 5477 SAMPLE
EXECUTING
5:39:45
__ 7667 SAMPLE
EXECUTING
3:24:35
ORIGIN
--------LOCAL
LOCAL
LOCAL
SYSTEMC
LOCAL
LOCAL
14.36.=8
HELD/
STEP/LINES CPU TIME
---------- --------
SAMPLECS
MUF8=
CICS
18.79
8.45
36.23
--------------------------------------------------------------------------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
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.
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.
8
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+...
JOB FACILITY
FUNCTION
===> C
JOB/GRP NAME
JOB NUMBER
FILE NUMBER
PAGE NUMBER
LINE NUMBER
===> SAMPLE
===>
===>
===>
===>
A - ATTACH JOB
AI - ATTACH INITIATORS
AT - ALTER JOB
DEST/CLASS
ACTIVE JOB TYPE
CONTROL CHARS
CONFIRM CANCEL
C - COPY JOB
CN - CANCEL JOB
I
L
===>
===>
===> NO
===> YES
(ALL,JES,STC,TSO)
(Y,N)
(Y,N)
- INFO JOB
- SYSTEM LOG
OP - OPER CONTROL
P - PRINT JOB
X - TERMINATE
When you select the COPY JOB function, the Copy Job panel will be displayed. It
will contain the name of the job which was entered on the primary menu and its
corresponding job number, as shown in the following example.
Jobs: Copy Job Display
8
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+...
COPY JOB
OPTION
===> C
JOB NAME
JOB NUMBER
FILE NUMBER
FIRST LINE
LAST LINE
COPIES
===> SAMPLE
===> 1234
===>
===>
===>
===>
(C - COPY; X - EXIT)
AWS TARGET
===>
AWS NAME
===>
CONTROL CHARS ===> NO
(Y, N)
Select the Copy option and fill in all appropriate fields, as listed below:
OPTION
JOB NAME
JOB NUMBER
FILE NUMBER
FIRST LINE
LAST LINE
COPIES
AWS TARGET
AWS NAME
CONTROL CHARS
FUNCTION ===>
(M - MENU; F JOB NAME ===> SAMPLE
FILE ===>
LINE ===1 OF ==13
JOBNO JOBNAME
STATUS
----- -------- ------------------__
284 SAMPLE
AWAITING PRINT (H)
C_
283 SAMPLE
AWAITING PRINT (H)
C_ 411= SAMPLE
AWAITING PRINT (H)
__ 4596 SAMPLE
EXECUTING
8:4=:5=
__ 5477 SAMPLE
EXECUTING
5:39:45
__ 7667 SAMPLE
EXECUTING
3:24:35
ORIGIN
--------LOCAL
LOCAL
LOCAL
SYSTEMC
LOCAL
LOCAL
14.36.=8
HELD/
STEP/LINES CPU TIME
---------- --------
SAMPLECS
MUF8=
CICS
18.79
8.45
36.23
--------------------------------------------------------------------------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
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.
>
> STA(SAMPLE,2=85) SCRL FULL COLS ====1 ===72
JOB PENDING
....+....1....+....2....+....3....+....4....+....5....+....6....+
ROSCOE ALTER/STATUS PROCESSOR
JOB NAME
NO
SAMPLE
2=85
FILE
1
LINE
1
PAGE/
1
LINE
1
FIND LIMIT
2==
I/O COUNT
1=
(1)
(2) (3)
(4)
(5)
A FILE STA C DEST
LINES FORM
CPY NOTES
1 NOP T R1!
5
STD.
2 NOP T R1!
36 STD.
3 NOP T R1!
1=4 STD.
4 NOP T R1!
263 STD.
5 NOP T R1!
18 STD.
6 NOP T R1!
6 STD.
===================== END OF OUTPUT FILES ======================
NO
FILE
LINE
PAGE/
LINE
FIND LIMIT
I/O COUNT
A (Modifiable)
Attach file.
STA
C (Modifiable)
DEST (Modifiable)
LINES
FORM (Modifiable)
CPY (Modifiable)
NOTE
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.
FUNCTION ===>
(M - MENU; F JOB NAME ===> SAMPLE
FILE ===>
LINE ===1 OF ==13
JOBNO JOBNAME
STATUS
----- -------- ------------------__
284 SAMPLE
AWAITING PRINT (H)
S_
283 SAMPLE
AWAITING PRINT (H)
S_ 411= SAMPLE
AWAITING PRINT (H)
__ 4596 SAMPLE
EXECUTING
8:4=:5=
__ 5477 SAMPLE
EXECUTING
5:39:45
__ 7667 SAMPLE
EXECUTING
3:24:35
ORIGIN
--------LOCAL
LOCAL
LOCAL
SYSTEMC
LOCAL
LOCAL
14.36.=8
HELD/
STEP/LINES CPU TIME
---------- --------
SAMPLECS
MUF8=
CICS
18.79
8.45
36.23
--------------------------------------------------------------------------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
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.
8
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+...
JOB FACILITY
FUNCTION
===> P
JOB/GRP NAME
JOB NUMBER
FILE NUMBER
PAGE NUMBER
LINE NUMBER
===> SAMPLE
===>
===>
===>
===>
A - ATTACH JOB
AI - ATTACH INITIATORS
AT - ALTER JOB
DEST/CLASS
ACTIVE JOB TYPE
CONTROL CHARS
CONFIRM CANCEL
C - COPY JOB
CN - CANCEL JOB
I
L
===>
===>
===> NO
===> YES
- INFO JOB
- SYSTEM LOG
(ALL,JES,STC,TSO)
(Y,N)
(Y,N)
OP - OPER CONTROL
P - PRINT JOB
X - TERMINATE
When you select the PRINT JOB function, the Print Job panel will be displayed. It
will contain the name of the job which was entered on the primary menu, as shown in
the following example.
Jobs: Print Job Display
8
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+...
PRINT JOB
OPTION
===> P
JOB NAME
JOB NUMBER
FILE NUMBER
===> SAMPLE
===> 1234
===>
DESTINATION
CLASS
FIRST LINE
LAST LINE
FIRST COLUMN
LAST COLUMN
===>
===>
===>
===>
===>
===>
(P - PRINT; X - EXIT)
TAG
OUTPUT TYPE
TOP MARGIN
BOT MARGIN
PAGE LENGTH
PAGE WIDTH
===>
===>
===>
===>
===>
===>
COPIES
NOTIFY
SEPARATOR
ALIGN
SEQ NUMS
===>
===>
===>
===>
===>
(Y,
(Y,
(Y,
(Y,
N
N
N
N
Select the PRINT option and fill in all appropriate fields, which consist of the
following:
OPTION
JOB NAME
JOB NUMBER
FILE NUMBER
DESTINATION
CLASS
FIRST LINE
LAST LINE
FIRST COLUMN
LAST COLUMN
TAG
OUTPUT TYPE
TOP MARGIN
BOTTOM MARGIN
PAGE LENGTH
PAGE WIDTH
COPIES
NOTIFY
SEPARATOR
ALIGN
SEQ NUMS
FUNCTION ===>
(M - MENU; F JOB NAME ===> SAMPLE
FILE ===>
LINE ===1 OF ==13
JOBNO JOBNAME
STATUS
----- -------- ------------------__
284 SAMPLE
AWAITING PRINT (H)
P_
283 SAMPLE
AWAITING PRINT (H)
P_ 411= SAMPLE
AWAITING PRINT (H)
__ 4596 SAMPLE
EXECUTING
8:4=:5=
__ 5477 SAMPLE
EXECUTING
5:39:45
__ 7667 SAMPLE
EXECUTING
3:24:35
ORIGIN
--------LOCAL
LOCAL
LOCAL
SYSTEMC
LOCAL
LOCAL
14.36.=8
HELD/
STEP/LINES CPU TIME
---------- --------
SAMPLECS
MUF8=
CICS
18.79
8.45
36.23
--------------------------------------------------------------------------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
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.
8
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+...
JOB FACILITY
FUNCTION
===> CN
JOB/GRP NAME
JOB NUMBER
FILE NUMBER
PAGE NUMBER
LINE NUMBER
===> SAMPLE
===>
===>
===>
===>
A - ATTACH JOB
AI - ATTACH INITIATORS
AT - ALTER JOB
DEST/CLASS
ACTIVE JOB TYPE
CONTROL CHARS
CONFIRM CANCEL
C - COPY JOB
CN - CANCEL JOB
I
L
===>
===>
===> NO
===> YES
- INFO JOB
- SYSTEM LOG
(ALL,JES,STC,TSO)
(Y,N)
(Y,N)
OP - OPER CONTROL
P - PRINT JOB
X - TERMINATE
When you select the CANCEL JOB function, and the CONFIRM CANCEL value is
YES, the Cancel Job Confirmation panel will be displayed:
Jobs: Confirm Job Cancel
8
<...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+...
CANCEL JOB CONFIRMATION
CONFIRM CANCEL ===> N
(Y - YES, N - NO)
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.
FUNCTION ===>
(M - MENU; F JOB NAME ===> SAMPLE
FILE ===>
LINE ===1 OF ==13
JOBNO JOBNAME
STATUS
----- -------- ------------------__
284 SAMPLE
AWAITING PRINT (H)
CN
283 SAMPLE
AWAITING PRINT (H)
CN 411= SAMPLE
AWAITING PRINT (H)
__ 4596 SAMPLE
EXECUTING
8:4=:5=
__ 5477 SAMPLE
EXECUTING
5:39:45
__ 7667 SAMPLE
EXECUTING
3:24:35
ORIGIN
--------LOCAL
LOCAL
LOCAL
SYSTEMC
LOCAL
LOCAL
14.36.=8
HELD/
STEP/LINES CPU TIME
---------- --------
SAMPLECS
MUF8=
CICS
18.79
8.45
36.23
--------------------------------------------------------------------------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
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.
. . . . . . . . . . .
. . . . . . . . . . . .
. . . . . . . . . . . .
. . . . . . . . . . . .
. . . . . . . . . . . .
. . . . . . . . . . . .
. . . . . . . . . . . .
. . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . . . . . . . . .
. . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
. . . . . . .
31-1
31-2
31-3
31-6
31-7
31-8
31-10
32-1
32-2
32-2
32-5
32-6
32-9
32-10
32-10
32-11
32-11
32-12
32-13
33-1
33-2
33-3
33-3
33-4
33-5
33-8
33-8
33-8
33-10
34-1
34-2
34-2
34-3
34-3
34-5
34-5
34-8
. . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . .
. . . . . . . . . . . . . . . . . . . . . . . .
34-9
34-11
34-11
34-12
34-13
34-14
34-15
34-17
34-17
34-17
34-21
34-22
34-22
34-22
34-23
or
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
2
3
4
To
To
To
To
show
show
show
show
the
the
the
the
last
last
last
last
>
> LIB()
SCRL FULL COLS ====1 ===79
....+....1....+....2....+....3....+....4....+....5....+....6....+....7
LIBRARY FACILITY
FUNCTION
==>
PREFIX
MEMBER
SIGNON KEY
FORMAL KEY
SEARCH
CONFIRM DELETE
==>
==>
==>
==>
==>
==>
A
C
- ATTACH LIBRARY D
- COPY MEMBERS
I
LIB ALTER
===> EXPLICIT
(SHR,RES,EXE,NOD)
- DELETE MEMBERS
- INFO MEMBERS
P
R
X
- PRINT MEMBER
- RENAME MEMBERS
- TERMINATE LIB
PREFIX
MEMBER
SIGNON KEY
FORMAL KEY
SEARCH
CONFIRM DELETE
Members
Members
Members
Members
NO
The first time you use the Library Facility, this field is set to
YES. The setting in effect when you sign-off is remembered
and reinstated when you sign back on.
LIB ALTER
IMPLICIT
Function
Action
Performed.
Panel displayed.
Delete a member.
Panel displayed.
Performed.
Panel displayed.
Rename a member.
Panel displayed.
Performed.
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).
When additional information is needed, a function-related panel is displayed. When
such a panel is displayed, you can move from it to another panel or to the menu by
entering in the first panel field:
=[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.
|
|
X
D
R
AT
P
I
C
A
E
SU
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.)
Library: Selection List Function Hierarchy Example
>
> 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
A
I
D
R
XYZ.ABLE
XYZ.BEGINJCL
XYZ.COBTEST1
XYZ.COBTEST2
XYZ.JUNK
XYZ.MYRPF
DOJCL
JCL: Link-Edit
Sample COBOL Prog.
RPF: Builds JCL
1
1=
193
4=3
87
519
SHR N
SHR =
SHR =
SHR N
>
> 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
XYZ.BEGINJCL
XYZ.COBTEST1
XYZ.COBTEST2
XYZ.JUNK
XYZ.MYRPF
)ATTACH
)INFO
JCL: Link-Edit
Sample COBOL Prog.
)DELETE
)RENAME
1
1=
193
4=3
87
519
SHR
SHR
SHR
SHR
SHR
SHR
NOSEQ
=73,8
==1,6
==1,6
NOSEQ
NOSEQ
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
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.
Code
ROE
ROS
ROW
AJCL
JCL
JCLEND
XJCLX
RO
ROE
ROSCOE
or
>
> LIB()
SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6.
LIBRARY FACILITY
FUNCTION
===> A
PREFIX
MEMBER
SIGNON KEY
===> XYZ
===>
===>
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.
Library: Attaching a Qualified Selection List
>
> LIB()
SCRL FULL COLS ====1 ===79
....+....1....+....2....+....3....+....4....+....5....+....6.
LIBRARY FACILITY
FUNCTION
==>
PREFIX
MEMBER
SIGNON KEY
FORMAL KEY
SEARCH
==>
==>
==>
==>
==>
XYZ
RO+
SHR
(SHR,RES,EXE,NOD)
>
> 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
XYZ.BEGINJCL
XYZ.COBTEST1
XYZ.COBTEST2
XYZ.JUNK
XYZ.MYRPF
JCL: Link-Edit
Sample COBOL Prog.
RPF: Builds JCL
1
1=
193
4=3
87
519
SHR
SHR
SHR
SHR
SHR
SHR
NO
=7
==
==
NO
NO
You can use this Selection List to perform one or more of the following function:
A
AT
C
D
I
P
R
X
*
Attach a member
Alter attributes
Copy a member
Delete a member
Display member information
Print a member
Rename a member
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.
Screens which do not contain STATUS fields are not modifiable.
MATCH
MEM
EXCL
BLOCKS
M-LINES
LINES
The remaining fields identify the individual members comprising the List, and include
the information shown in the following table.
Field Name
Description
Alt
Attrib.
MEMBER
All
Asc
DESCRIPTION
ALL
Asc
LINES
Des
ATR
Asc
SEQNO
Asc
CREATED
Des
UPDATED
2/3
Des
ACCESS
Des
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:
>
> LIB()
SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6.
LIBRARY FACILITY
FUNCTION
===> A
PREFIX
MEMBER
SIGNON KEY
===> ABC
===> COBPROG
===>
>
> 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
XYZ.ABLE
XYZ.BEGINJCL
XYZ.COBTEST1
JCL: Link-Edit
Sample COBOL Prog.
1 SHR NOSEQ
1= SHR =73,8
193 SHR ==1,6
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.
SELECT DIR
SELECT mem
SELECT PREV
SELECT NEXT
When you are browsing a Selection List, you can use the SELECT command to
change the display by entering:
SELECT ALT
Locate
Locate
Locate
Locate
the
the
the
the
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==
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 PREFIX
THE BEGIN
THE EMBED
TEST END
TEST SUFFIX Qualifies the string as ending a word; only CONTEST matches.
JUSTIFIED
CENTERED
LOCKED
The display margins are not to be altered even if the matching string
occurs to the left or right of the current margins.
or
POINT LINE B
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.
or
NOTE Q LOC1
or
NOTE Q LOC1
The asterisk (*) is optional. If omitted or specified without qualification, it represents
the first displayed line.
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 issue the command:
STATUS NOTES
a list of all the names that you have assigned is displayed.
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.
ATTACH_
>
> 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.
ATTACH LIB )
>
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.
>
> 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/
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
SEQUENCE
NUMBER
ATTRIBUTE
SEQ
SEQ COBOL
SEQ s l
NOSEQ
SHARED
EXECONLY
ACCESS
ATTRIBUTE
The access attribute can be set to: SHR (for SHARED), EXE (for
EXECONLY) or RES (for RESTRICTED).
SEQUENCE
The sequence number attribute can be set to: NOSEQ (to omit
sequence numbers) or s,l (to include sequence numbers in the
designated location), where:
DESCRIPTION
Changes are made on the Selection List using the AT line command
and overtyping the field to be altered.
IMPLICIT
>
> LIB()
SCRL FULL COLS ====1 ===79
....+....1....+....2....+....3....+....4....+....5....+....6....+....7
LIBRARY FACILITY
FUNCTION
==>
PREFIX
MEMBER
SIGNON KEY
FORMAL KEY
SEARCH
==>
==>
==>
==>
==>
LIB ALTER
===> EXPLICIT
(SHR,RES,EXE,NOD)
The following example illustrates how you can use the Selection List to change the
description and attributes of a member EXPLICITly.
>
> 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
T
B
*
R
COPYX
XCOPY
Copies all or part of attached library data from one split screen into
the active AWS of the screen containing the command.
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.
8
>
> LIB()
SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....
COPY LIBRARY MEMBER
OPTION
===> S
PREFIX
MEMBER
===> XYZ
===> COBTEST1
1ST LINE
AWS TARGET
LIST HEADERS
===> 9==
===> T
===> NO
LAST LINE
===> 18==
AWS COPY COUNT ===> 1
Enter the code that is appropriate for the action you want to
perform. The codes are:
S
PREFIX
MEMBER
1ST LINE
LAST LINE
AWS TARGET
LIST HEADERS
Copy after the line at which the AWS pointer is currently positioned.
Copy at or after the line specified by v.
Copy to the bottom of the active AWS.
Replace the contents of the active AWS with the copied data.
Copy to the top of the active AWS.
The following example illustrates how you can copy multiple library members from a
Selection List.
Library: Copying Through a Selection List
>
> 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
C
C
C
XYZ.A
XYZ.BEGINJCL B
XYZ.COBTEST1 T
XYZ.COBTEST2
XYZ.JUNK
XYZ.MYRPF
T
JCL: Link-Edit
Sample COBOL Prog.
RPF: Builds JCL
1
1=
193
4=3
87
519
SHR
SHR
SHR
SHR
SHR
SHR
NOSEQ
=
=
=
N
N
8
>
> LIB()
SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....
DELETE LIBRARY MEMBER
OPTION
===> S
PREFIX
MEMBER
===> XYZ
===> JUNK
Enter the code that is appropriate for the action you want to perform.
The codes are:
S
PREFIX
MEMBER
>
> LIB()
SCRL FULL COLS ====1 ===72
LINE ====1
....+....1....+....2....+....3....+....4....+....5....+....6..
==================================== T O P ===================
SIGNON KEY
MEM EXCL BLOCKS M-LINES LINES
SMITH
82
=
223
2==== 117=1
MEMBER
STATUS
DESCRIPTION
LINES ATR SEQNO
D
D
XYZ.COBTEST1
XYZ.COBTEST2
XYZ.JUNK
>
> 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.
>
> LIB()
SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6.
LIBRARY FACILITY
FUNCTION
===> I
PREFIX
MEMBER
===> XYZ
===> COBTEST1
or, specifying the I function code on the Selection List, as in the following example.
Library: Inquiring Through a Selection List
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
8
>
> LIB()
SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6.
LIBRARY MEMBER INFORMATION
PREFIX
MEMBER
===> XYZ
===> COBTEST1
LAST ACCESS
LAST UPDATE
CREATION
RECORD COUNT
BLOCK COUNT
ATTRIBUTE
SEQUENCE
DESCRIPTION
===>
===>
===>
===>
===>
===>
===>
===>
11/=4/88
=5/29/87
=5/23/86
193
3
SHR
==1,6
Sample COBOL Prog.
The last three fields are unprotected. See 34.1, Altering Member Attributes on
page 34-2 for information about changing these fields.
>
> LIB()
SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....6...
PRINT LIBRARY MEMBER
OPTION
===> S
PREFIX
MEMBER
===> XYZ
===> MYPROG
1ST LINE
TAG NAME
DEST
PAGE WIDTH
TYPE/FORMAT
1ST COL
===>
===>
===>
===>
===>
===>
LAST LINE
SEPARATOR
PR17 COPIES
PAGE LEN
DEF TOP MARGIN
1
LAST COL
===>
===>
===>
===>
===>
===>
999999 NOTIFY
YES
FORCEALIGN
1
CLASS
SEQ NUMBRS
BOT MARGIN
32767
===>
===> NO
===> =
===> YES
===>
Enter the code that is appropriate for the action you want to
perform. The codes are:
S
PREFIX
MEMBER
You can use the following fields to customize the print operation.
1ST LINE
LAST LINE
NOTIFY
SEPARATOR
NO
COPIES
CLASS
Enter the print class to be used at the location where the request
is to print. (Site management will tell you which classes are
valid for 328x-type printers and which are valid for system
printers.)
PAGE WIDTH
PAGE LEN
SEQ NUMBRS
NO
ANS
MCC
DUMP
CHEX
VHEX
TOP MARGIN v
BOT MARGIN v
1ST COL
LAST COL
>
> 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
P
P
XYZ.BEGINJCL
XYZ.COBTEST1
XYZ.COBTEST2 PR99
JCL: Link-Edit
Sample COBOL Prog.
1= SHR
193 SHR
4=3 SHR
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.
8
>
> LIB()
SCRL FULL COLS ====1 ===72
....+....1....+....2....+....3....+....4....+....5....+....
RENAME LIBRARY MEMBER
OPTION
===> S
PREFIX
NAME
===> ABC
===> TESTJCL
NEW PREFIX
NEW MEMBER
===> ABC
===> PRODJCL
This example illustrates how you can use this panel to change a member name from
TESTJCL to PRODJCL.
The fields comprising the panel include:
OPTION
Enter the code that is appropriate to perform the desired action. The
codes are:
S
PREFIX
MEMBER
NEW PREFIX
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.
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
XYZ.BEGINJCL
XYZ.COBTEST1
XYZ.COBTEST2 INVREPT
XYZ.JUNK
XYZ.MYRPF
JCL: Link-Edit
Sample COBOL Prog.
RPF: Builds JCL
1
1=
193
4=3
87
519
SHR
SHR
SHR
SHR
SHR
SHR
N
=
=
=
N
N
. . . .
35-1
35-2
35-2
35-3
35-5
35-6
35-8
35-11
35-12
35-13
35-15
35-16
35-16
35-17
35-18
35-20
35-20
35-21
35-22
35-24
35-25
35-27
35-28
. . . . . . . . . . . . . . . . . . . . . . . .
36-1
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . . . . . . . . . . . . .
. . . .
37-1
. . . . . . . . . . . . . .
38-1
38-2
38-3
38-4
38-7
38-8
38-9
38-10
. . . . . . . . . . . . . . .
39-1
. . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . . .
. . . . . . . . . . . . .
40-1
pfx.BBSX.
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.
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.)
8
-- BBS ----------------------------------------------------------------------Thread Titles
New Message Thread Entry-2 ZZB
No Threads------------------ ZZD
ZZC
-----------------------------------------------------------------------------PF1 Utility
2 Ignore!
3 Exit
4 Lastread
5 Firstnew
6 Addmsg
7 Backward 8 Forward
9 Refresh
1= Top
11 Bottom
12 Zmsg
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
PF2/14 Ignore!
PF4/16 Lastread
PF5/17 Firstnew
Brings up the first new message you have not read. (NEW
denotes not yet viewed).
PF6/18 Addmsg
PF9/21 Refresh
PF12/24 Zmsg
Thread Entry-1
===
be entry #2 =>ZZC
==2
be entry #4 =>ZZC
==4
be entry #6 =>ZZC
==6
be entry #8 =>ZZC
==8
Prefix:
This will be
This will
This will
This will
entry #1
be entry
be entry
be entry
=>ZZC ==1
#3 =>ZZC ==3
#5 =>ZZC ==5
#7 =>ZZC ==7
-----------------------------------------------------------------------------PF1 Utility
2 Ignore!
3 Exit
4 Prevnew
5 Nextnew
6 Addmsg
7 Backward 8 Forward
9 Refresh
1= Top
11 Bottom
12 Zmsg
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.
-- BBS -----------------------------------------------------------------------
Title:
This will be entry #7 =>ZZC
LAST
Name: ZZC==7 Date&co
-----------------------------------------------------------------------------From: RO, ROSCOE.CONTROL
Date: Tuesday August 6, 1991
Time: 16.2=.27
-----------------------------------------------------------------------------PF1 Utility
2 Ignore!
3 Exit
4 Prevmsg
5 Nextmsg
6 Addmsg
7 Backward 8 Forward
9
1= Top
11 Bottom
12 Zmsg
Title
This field contains the member name of the thread entry you are
viewing, made up of the prefix and thread code. You can
associate each thread entry by name.
Date
Entry Text
The thread entry text follows the second line of hyphens. The
text consists of:
the ID and key that created the message, listed in the From
field,
the date and time the message was created, and
the message.
The PF-key functions specific to this screen are the same as the previous screen,
except for PF4, PF5, and PF9:
PF4/16 Prevmsg
PF5/17 Nextmsg
PF9/21
Is not used.
-- Reply ---------------------------------------------------------------------
Time: 16.==.=4
As shown in the above panel, Reply is a split screen mode. The top half of the screen
displays the thread or entry your cursor was on (when you press PF6/18). This part of
the screen is protected. It contains:
the
the
the
the
the
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
opens the lower portion of the screen to the insert mode, just after the line
on which it was entered.
-- Reply ---------------------------------------------------------------------
Time: 16.==.=4
Seq
==1
==2
==3
==4
.
.
.
.
.
----+--------+---2----+----3----+----4--------5----+----6----+----7-
This is the message text.
It can be any message.
It can be as long as you want.
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
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
PF2/14
PF4/16
PF5/17
Help
CopyMem
Bwd (Top)
Fwd (Top)
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.
Create a Thread Title
8
-- BBS ----------------------------------------------------------------------Thread Prefix: ZZB - title: New Message Thread Entry-2
Message title: New Message Thread Entry-2
Your message title:
<
-----------------------------------------------------------------------------PF1
2 NewThread 3 Cancel
4
5
6 EditAgain
7
8
9
1=
11
12
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.
8
-- BBS ----------------------------------------------------- Press PF3 to exit
Current message: ZZB=== - New Message Thread Entry
Place the cursor on the desired utility and press ENTER.
Set Options
Print Thread
Show News
Prune Profile
Print Message
Note: The BBS index data are NOT refreshed after any of these functions.
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
Set Options
Show News
Prune Profile
Print Message
Print Thread
8
-- BBSOpt -------------------------------------------------- Press PF3 to exit
Save AWS on entry (Y/N)? Y
Saved AWS name prefix: BBSAWS
BBS will accept the same attribute for both read and unread messages.
CA-Roscoe printer name:
Specify the name of the printer that you want to print all requested threads and
entries. The default will be set by your site.
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 =============
91/=6/27 - This BulletinBoard System System has been established
to support interchange of technical information within
the L1== Technical Group.
You may view messages on the bulletin board, add messages
to existing threads, and create new threads.
===>
-----------------------------------------------------------------------------PF1 Help
2
3 Exit
4
5
6
7 Backward 8 Forward
9
1= Top
11 Bottom
12 ZMsg
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:
8
-- DoPrint ------------------------------------------------------------------Destination: DEFAULT.
------------------------------------------------------------------ Line 1 of 9
=================================== T O P ====================================
--------------------------------------------- New Message Thread Entry-2
From: RO, ROSCOE.CONTROL
Date: Tuesday August 6, 1991
Time: 16.==.=4
-----------------------------------------------------------------------------PF1 Help
2
3 Exit
4 Print
5
6
7 Backward 8 Forward
9
1= Top
11 Bottom
12 ZMsg
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
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.
8
-- DoPrint ------------------------------------------------------------------more =>
Destination: DEFAULT.
PRINT Tag: ZZB.....
----------------------------------------------------------------- Line 1 of 36
=================================== T O P ====================================
Thread title: New Message Thread Entry-2
--------------------------------------------- New Message Thread Entry-2
From: RO, ROSCOE.CONTROL
Date: Tuesday August 6, 1991
Time: 16.==.=4
Time: 16.19.36
-----------------------------------------------------------------------------PF1 Help
2
3 Exit
4 Print
5
6
7 Backward 8 Forward
9
1= Top
11 Bottom
12 ZMsg
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.
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.
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.
Some other information regarding ZMsg:
ZMsg requires a screen which contains at least 13 lines.
Sending another CA-Roscoe user a message through ZMsg makes use of the
CA-Roscoe SEND command. The message(s) you send does not get posted on
the BulletinBoard, but goes only to the CA-Roscoe prefix or ID you specify.
The first time you enter ZMsg mode, you will be presented with the latest ZMsg
News Announcements. After you view this screen, press ENTER to continue to
your messages. This announcement screen will not be presented to you again,
unless you specifically request it (using PF2/14 News). If any new ZMsg
announcements are posted, this screen will be issued the next time you enter the
ZMsg mode.
ZMsg will run in split screen mode; you may keep it active in one screen while
you work in another.
If you have suppression set, it is possible (but not likely) that you will miss a
message between the time you press PF3/15/CLEAR to exit ZMsg and the time
ZMsg restores your original SEND option.
or key:
-----------------------------------------------------------------------------PF1 Help
2 News
3 Exit
4 Swap
5 Delete
6 FindUser
7 Backward 8 Forward
9 SetOpts
1= Top
11 Bottom
12 Refresh
Prefix/Key
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.
Options
Suppress active
Column n
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
(*>>USR) THIS IS THE MESSAGE I SENT TO USR.
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.)
8
-- ZMsg ----------------------------------------------- Message sent to pfx=ro
Enter prefix: RO or key:
Message: send this message to myself
GetMsgs active ------------------------------------------------------ Column 1
=================================== 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
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
PF2/14 News
PF4/16 Swap
PF5/17 Delete
PF6/18 FindUser
PF9/21 SetOpts
PF12/24 Refresh
ENTER
CLEAR
Exits ZMsg.
8
-- ZMsgOpts ------------------------------------------------------ PF3 to exit
Suppress ROSCOE messages when exiting ZMsg? (Y/N): N
GetMsgs processing active? (Y/N): Y
Save AWS on entry to ZMsg for ROSCOE 5.6 and lower (Y/N)? N
8
-- FindUser -----------------------------------------------------------------Enter the prefix: djh or the key:
Job name
-------ROSCOE1
ROSCOE2
ROSCOE3
Status
Time
------------------------TERM IO WAIT ==:==:=8.86
DSN SUBTASK
==:==:=3.31
TERM IO WAIT ==:=1:57.64
-----------------------------------------------------------------------------PF1 Help
2 News
3 Exit
4
5
6
7 Backward 8 Forward
9
1= Top
11 Bottom
12 ZMsg
The information provided through FindUser is the same as the data you receive when
you issue the following command.
LOO D ROS ST Key(or PFx)=Id
All other functions that can be executed from this panel have been previously
described.
ROSCOE TO DB2
1.
2.
3.
4.
5.
6.
7.
<CLEAR>
REFRESH
(RUSTI)
(DECLGEN)
(BIND)
(REBIND)
(FREE)
(CMNDS)
(RUN)
PFK3
EXIT
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.
DMF also provides a set of basic functions that you can assign to any of the PF keys.
Once you have made the assignments, DMF includes them in every generated panel. If
the terminal user presses a PF key to which you have assigned a function, DMF
handles the processing.
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.
For additional information, see the CA-Roscoe RPF Language Guide.
IEBCOPY1
>
> 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
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.
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)
>
>
....+....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
To release all of the files you have allocated, enter:
FREE ALL
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.
To execute an RPF program, enter its name in the Command Area and press the
ENTER key. For example, assume the RPF program that updates a customer master
file is saved as the member CUSTOMER. To execute this program, you would enter:
CUSTOMER
It might prompt for information by displaying a full-screen panel such as the one
shown in the following example.
RPF: Sample Full-Screen Panel
8
U P D A T E
C U S T O M E R
M A S T E R
COMPANY NAME: _
TELEPHONE:
CONTACT:
ADDRESS:
F I L E
TITLE:
CONTRACT NO:
If the RPF program you wish to execute belongs to another user, you must precede the
name with that user's prefix (for example, AAA.CUSTOMER).
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
Appendixes
Appendix A. Using Typewriter Devices With CA-Roscoe
A.1 Beginning a Session . . . . . . . . . . . . . . . . . . .
A.2 Establishing Connection . . . . . . . . . . . . . . . . .
A.3 Signing On . . . . . . . . . . . . . . . . . . . . . . . .
A.4 Ending a CA-Roscoe Session . . . . . . . . . . . . . .
A.5 Using a Typewriter Device . . . . . . . . . . . . . . .
A.6 Using CA-Roscoe Commands and Facilities . . . . . .
A.7 Using the Data Set Facility
. . . . . . . . . . . . . .
A.8 Viewing Job Output . . . . . . . . . . . . . . . . . . .
A.9 Non-Executable Commands and Facilities . . . . . . .
A-1
A-2
. A-3
. A-4
. A-6
. A-7
. A-9
A-10
A-11
A-12
. . . . . . . . . . .
. . . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . .
. . . . . . . . . . .
A.3 Signing On
A.3 Signing On
At typewriter devices, CA-Roscoe issues a sign-on prompt like the one below:
SON03 ENTER KEY FOR CA-Roscoe version - date time
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:
sign-on key/group code
If the account has previously been assigned a password (either by you or site
management), the following prompt is issued:
SON04 ENTER PASSWORD
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.3 Signing On
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:
current password/new password
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.).
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.
Teletype Terminal Keyboard:
CTRL-E Keys
CTRL-I Keys
CTRL-S Keys
SCALE
TTY
Sets the speed characteristics for the terminal. Site management will tell
you of the value associated with each terminal type and the site defaults.
WIDTH
Physically changes the width of the print line from the default value to a
value between 72 and 132 characters.
A.7
Index
Special Characters
- (Reexecuting Last Command) 2-6
-INC Statement Expansion
Changing 6-16
Using 28-7
,, (Representing Last Line) 2-5
:C (To Copy Screen)
Using 15-9
:E (To End Split Screens)
Using 8-11
:L (To Lock Screen)
Using 8-14
:P (To Print Screen)
Using 7-2
:S (To Split Screen)
Using 8-8
:SK (PRINT Formatting Pseudo-Command) 7-4
:TOP (PRINT Formatting Pseudo-Command) 7-4
:W (To Swap Split Screens)
Using 8-11
.SK (PRINT Formatting Pseudo-Command) 7-4
.TOP (PRINT Formatting Pseudo-Command) 7-4
< (Less Than Sign)
As Special Character 4-5
* (Asterisk)
As Reserved Character 2-6
Deferring Command Execution 2-6
Representing
Name of Last FETCHed, SAVEd, UPDATEd
Member 23-5
&
Change Command Delimiter 6-15
+INC Statement Expansion
Changing 6-17
Using 28-6
+ (Plus Sign)
As Reserved Character 2-7
Redisplaying Last Executed Command 2-13, 2-14
4-5
Numerics
3270-Type Devices
DELETE Key 16-7
ERASE EOF Key
Control Use Of 6-16, 16-6
Screen Components
Command Area 8-3
Execution Area 8-6
System Control Area 8-38-5
Screen Format
Change 8-12
Full/Partial 8-7
Terminal Lock 8-13, 8-14
Signing Off 10-13
Signing On 10-210-3
A
A (Destination) Line Command 15-4
With Move 21-4
Access Attribute, Library Member
Changing Default 6-17
AD (Destination/Drop) Line Command
With COPY 15-5
Addmsg Function (BBS) 35-4
AJOB Command
Job Execution Status 29-2
Job Facility
Menu 28-9
Selection List 28-13
Job Information 29-7
ALLOCATE Command
Data Sets
Using 27-2, 27-3
Under ETSO 38-438-5
Index X-1
Attributes (continued)
Job Output File (continued)
Displaying 30-2330-24
Library Member
Changing Default Access 6-17
Automatic
Indentation
Controlling 6-15
Using 18-15
Line Insertion
Controlling 6-15
Using 18-9
Signoff
Controlling 6-15
Site Defaults 6-12
Terminal Lock
Controlling 6-17
Site Defaults 6-12
AWS
Adding String To Line
At Beginning 14-2
At End 14-2
Between Specific Columns 14-2
Attaching 13-3
Bringing Data Into 13-4
Creating 13-6, 13-7
Deleting Contents
Using Line Commands 16-4
Using Primary Commands (By Line
Number) 16-2
Using Primary Commands (Lines Containing
String) 16-3
Detaching 13-8
Discarding
Change Attribute 13-5
Display/Change Attributes 17-5
Explicit 13-9
Display/Change Attributes 17-117-6
Editing Data
Changed Line Indicator (Controlling) 6-16
Controlling Column Boundaries 4-14-5
Editing Data (Character Strings)
Tracking Changes 14-814-10
Using Line Commands 14-7
Using Primary Command 14-6, 14-7
Editing Data (Characters)
Using Line Commands 14-5
Using Primary Command 14-4
Entering Data
Controlling Number of Inserted Lines 6-15
From Command Area 18-14
Using a Mask 18-1118-12
AWS (continued)
Entering Data (continued)
Using Automatic Line Insertion 18-9
Using I and IB Line Commands 18-8
Using PF Key 18-13
Using Primary Commands 18-218-7
Using TE Line Command 18-10
With Automatic Indentation 18-15
Fill Character, Trailing 6-16
introduction 13-1
Keyword on System Information Line 8-3
Locate/Display Data
All Occurrences (Modifiable Display) 20-620-9
All Occurrences (Non-Modifiable Display) 20-7,
20-8
By Occurrence, Line Commands 20-5
By Occurrence, Primary Command 20-3
Contents in HEX 5-7, 5-8
Customizing Display 20-10
Non-Matching Occurrence (Modifiable
Display) 20-6
Non-Matching Occurrence (Non-Modifiable
Display) 20-8
Positioning Display
By Pointer Position 13-10
Using Line Commands 13-12
Using Primary Command 13-11
Print Contents of 7-2
Reattaching 13-13
Recovery
Change Attribute 13-5
Display/Change Attributes 17-5
Set Attributes 13-6
Renaming 13-5
Renumber Contents of
Any Time 22-122-3
Reorder Contents 14-3
Save Contents of 23-2
Selecting 13-14
AWS Attributes
Change 13-5
Display/Change 17-117-6
Establish 13-6, 13-7
AWS Display
Display Format 5-7, 5-8
Display/Change 17-117-6
Sequence Number Display 5-6
B
B (Destination) Line Command 15-4
With Move 21-4
BASIC Mode
Character Translation/Recognition 3-3
BB (Destination) Line Command 15-4
With Move 21-4
BBD (Destination/Drop) Line Command
With COPY 15-5
BBS
Overview 35-1, 35-2
BBSOpt Mode 35-13
BBSSAV 35-13
BD (Destination/Drop) Line Command
With COPY 15-5
Boundaries
See Column Boundaries
BOUNDS Line Command 4-5
BulletinBoard System
Addmsg Function 35-8, 35-9
Create Message Threads 35-8, 35-9
Create Thread Entries 35-8, 35-9
deleting unwanted thread 35-16
Edit Mode 35-9, 35-10
Error/Status Line 35-3
GetMsgs Processing 35-23
Locate CA-Roscoe Users 35-28
Message Display Description 35-24
Message Selection List 35-3
News Announcements 35-2
Overview 35-1
Print
Message Thread 35-18, 35-19
Thread Entry 35-17
Prune Profile 35-16
Reply/Insert Mode 35-8, 35-9
Send Messages 9-5
Sending Messages to CA-Roscoe Users
Description 35-20
Using ZMsg 35-2535-27
Session parameters, Set 35-13
Set Defaults
Options (Utility) 35-13
Printer 35-14
Read Message Attribute 35-14
Unread Message Attribute 35-14
Signing On 35-2
Suppress Message Processing 35-23
Utility (PF1/13) 35-1135-19
View News Announcements 35-15
Index X-3
C
C Line Command 15-3
CA-Librarian
-INC Statement Expansion
Controlling 6-16
Attaching Module 25-15
Attaching Selection List 25-2
Using EXPORT Command 27-60
CA-Panvalet
EXPORT Command
Using 27-60
CA-Roscoe
Controlling Info Messages 6-16
Documentation, User 12-2
HELP Facility 12-312-5
Online Tutorial 12-6
Sign On
From CA-Roscoe 10-4, 10-5
From CICS 10-6
From TSO 10-7
From VTAM 10-3
Sign-on Screen 10-210-3
CA-SysView Interface (BBS) 35-28
CALL Command 38-8
Cancel Function (BBS) 35-10
Cancel Job
Using Job Facility 30-30
Using Selection List 30-31
Capitalize Text
Initial Cap
Using Line Commands 19-6
Using Primary Command 19-5
Lowercase All
Using Line Commands 19-5
Using Primary Command 19-5
Printing 7-3
Uppercase All
Using Line Commands 19-5
Using Primary Command 19-5
CATALOG Command 27-11, 27-12
Catalog Selection List
Attaching 25-7, 25-8
Description Of 25-925-12
Detaching 26-2
D
D
Line Command 16-4
DASD Space, Release Unused 27-52
Data Set Display
Display Format 5-7, 5-8
Sequence Number Display 5-6
Data Set Facility
Attaching
Catalog Selection List 25-7, 25-8, 25-925-12
Data Set 25-26, 25-27
GDG 25-14
LIBRARIAN Module 25-1525-17
LIBRARIAN Selection List 25-225-6
Menu 24-2, 24-3
PDS Member 25-1525-17
PDS Selection List 25-18, 25-19
Volume Selection List 25-28
VTOC Selection List 25-3325-34
Cataloging 27-11, 27-12
Define GDG
Function Panel 27-25
Index X-5
Display Margins
Display/Change
Description 6-2, 6-3
Using SET DISPLAY 5-5
Using STATUS AWS 17-4
Using STATUS DISPLAY 5-4
Temporary Change 5-3, 5-4
Display Mode
Display/Change Using STATUS AWS 17-4
Displaying
Data in HEX 5-7, 5-8
DMF, Description Of 37-1
Documentation, Description of User 12-2
DoPrint Mode (BBS) 35-1735-19
DROP Command
With Data Set, Member, Module 26-9
DS Line Command 16-5
DSB Line Command 16-5
DSN
Keyword on System Information Line 8-4
DST Line Command 16-5
DT Line Command 16-4
DU Line Command 16-5
DX Line Command 16-5
DXB Line Command 16-5
DXT Line Command 16-5
E
E Line Command 14-7
EB Line Command 14-7
Edit Messages (BBS) 35-9, 35-10
EditAgain Function (BBS) 35-10
Editing Data
BulletinBoard System Messages 35-9, 35-10
Changing Indicator Option 6-16
Character
Using Line Commands 14-5, 14-7
Using Primary Command 14-4, 14-6, 14-7
Track Changes 14-814-10
EDSN Command 27-61
EE Line Command 14-7
Entering Data In AWS
From Command Area 18-14
Using a Mask 18-1118-12
Using Automatic Line Insertion 18-9
Using Line Commands
I and IB 18-8
TE 18-10
Using PF Key 18-13
Using Primary Commands
INPUT Command 18-218-5
Index X-7
F
FETCH Command 34-7
Fill Character
AWS 6-16
Display/Change 17-4
FILL Command 14-2
FindUser Function (BBS) 35-28
FIRST Command
AWS 20-3
Job Output
Locate String 30-8
Position Within 30-12
G
Generation Data Group (GDG)
See Data Set Facility
GetMsgs Processing (BBS) 35-23
GROUP CODE Field on Sign-on Screen
10-3
H
HALF (SCRL Field Value) 8-4
HELP Command 12-312-5
HELP Facility 12-312-5
Hex
Locate String In 20-11, 20-12
Hexadecimal Display
Setting 5-7, 5-8
Hierarchy
Command Evaluation 2-9
HLP Keyword on System Information Line
I
I Line Command 18-8
IB Line Command 18-8
Ignore! Function (BBS) 35-4
IM Line Command 18-11
IMPLICIT
LIB ALTER Operand 34-3, 34-4
INCL Command
AWS 20-6, 20-7
Job Output 30-9
Library Facility 33-4
INCL Line Command 20-8, 20-9
8-4
J
JCK Command 28-2, 28-3
JCL Syntax Checker 28-2, 28-3
JES Printers
Change Location
For Request 7-10
For Session 7-10
Displaying Locations 7-11
Print At 7-2
JOB
Keyword on System Information Line
Job Facility
Alter Job
Display Description 30-18
Using 30-18
Cancel Job 30-30
Copy Job
Display Description 30-21
Using 30-20
Detaching Job 30-7
Displaying
Menu 28-9
Selection List 28-13
Operator Control 28-15
Print Job
Display Description 30-28
Using 30-26
Job Information
AJOB Command 29-7
8-4
Job Output
Attaching 30-230-6
Cancel Job
Using Commands 30-30
Using Job Facility 30-30, 30-31
Copy to AWS
Job Menu 30-20
Primary Commands 30-20
Selection List 30-22
Description 30-5
Detaching
Using Commands 30-7
Using Job Facility 30-7
Display Format 5-7, 5-8
Displaying
Data in HEX 5-7, 5-8
Execution Status 29-2
File Attributes 30-2330-24
Sequence Number Displaying 5-6
File Attributes
Change Using Command 30-17
Change Using Job Menu 30-18
Change Using Modifiable Display 30-2330-24
Change Using Selection List 30-19
Positioning Display
Between Files 30-12
To String 30-8
Printing Files
Using Commands 30-26
Using Job Menu 30-26
Using Job Section List 30-29
Reattaching 30-15
Searching For String
All Occurrences 30-9
Line Limit, Changing 6-16
Lines Limit, Site Default 6-13
Non-Matching Occurrences 30-9
Specific Occurrence 30-8
SYSOUT Class Requirements 30-5
Job Selection List
Alter Job 30-19
Copy Job 30-22
Job Status 30-25
Print Job 30-29
Join Lines
Using Line Commands 19-18
Using Primary Command 19-15, 19-16
Index X-9
K
KEY Field on Sign-on Screen 10-2
Keywords (syntax diagrams) xxvi
L
Language Character Set
Changing 6-15
LAST Command
AWS 20-3
Job Output
Locate String 30-8
Position Within 30-12
Library Facility 33-3, 33-4
LAST Line Command 20-5
Lastread Function (BBS) 35-4
LC Line Command 19-5
LCB Line Command 19-5
LCC Line Command 19-5
LCT Line Command 19-5
LIB
Keyword on System Information Line 8-4
LIBRARIAN Selection List
Detaching 26-2
Reattaching 26-10, 26-11
Search for String
All Occurrences 26-4
By Occurrence 26-3
Non-Matching Occurrences 26-4
Selecting Different Level 25-38
LIBRARY Command 31-331-5
Library Facility
Alter Member Attributes 34-2, 34-3
Attaching
Member 32-10, 32-11
Selection List 32-2
Copying 34-5, 34-6
Deleting 34-11
Detaching 33-2
Function Panels Description 31-6
Inquiring About Member 34-15, 34-16
Library System 31-1
Menu 31-331-5
Printing 34-17
Reattaching 33-10, 33-11
Selection List
Function Code Hierarchy 31-8, 31-9
Refresh 31-10
Using 31-7
Wildcard Characters 32-3
Library Member
Attaching 32-10, 32-11
Copying
Using Command 34-5, 34-6
Using Function Panel 34-8, 34-9
Using Selection List 34-9, 34-10
Creating 23-2
Deleting
Using Command 34-11
Using Function Panel 34-12
Using Selection List 34-13
Display Format 5-7
Displaying
Data in HEX 5-7, 5-8
Format of Display 32-12
HEX display 5-7, 5-8
Inquiring About 34-15, 34-16
Position Display
To Named Line 33-8
To Specific Line 33-8
Printing
Using Command 34-17
Using Function Panel 34-17
Using Selection List 34-21
Renaming
Using 34-22
Using Command 34-22
Using Function Panel 34-22
Using Selection List 34-23
Save AWS Contents As 23-2
Search for String
All Occurrences 33-4
Non-Matching Occurrences 33-4
Specific Occurrence 33-3, 33-4
Update Contents 23-5
Library Member Display
Display Format 5-8
Sequence Number Display 5-6
Library System, Description 31-1
Line Commands
Correcting Invalid/Incomplete 2-10
Description of Use 2-3, 2-4
Display Format Description 2-2
Evaluation Hierarchy 2-9
Locate CA-Roscoe Users (BBS) 35-28
Locate/Display Data
All Occurrences
In AWS (Modifiable Display) 20-7, 20-8, 20-9
In AWS (Non-Modifiable Display) 20-7, 20-8
By Occurrence
In AWS (Line Commands) 20-5
In AWS (Primary Command) 20-3
M
M Line Command 21-3
Manipulate Text
Center
Using Line Commands 19-3, 19-4
Using Primary Command 19-2
Initial Cap
Using Line Commands 19-6
Using Primary Command 19-5
Join Lines
Using Line Commands 19-18
Using Primary Command 19-15, 19-16
Lowercase All
Using Line Commands 19-5
Using Primary Command 19-5
Reformat
Using Line Command 19-819-9
Using Primary Command 19-7, 19-8
Shift Lines
Using Line Commands 19-11, 19-12
Using Primary Command 19-10, 19-11
Split Line
Using Line Commands 19-17
Using Primary Commands 19-13, 19-14
Index X-11
MT Line Command
21-3
N
Name
Field on System Information Line 8-3
Print Request
Assigning 7-6
Displaying 7-13
News Announcements (BBS)
Description 35-2
View 35-15
NewThread Function (BBS) 35-10
NEXT Command
AWS 20-3
Job Output
Locate String 30-8
Position Within 30-12
Library Facility 33-3, 33-4
NEXT Line Command 20-5
Nextnew Function (BBS) 35-6
NONUM
Define Sequence Number Display 5-6
NOPRESERVE Mode
Character Translation 3-4
NOTE Command
With Data Set, Member, Module 26-8, 26-9
With Job Output 30-13
With Library Member 33-8, 33-9
Note Names
Library Member 33-8, 33-9
Notification Messages
PRINT Completion 7-8
NUM
Define Sequence Number Display 5-6
NUM2
Define Sequence Number Display 5-6
NUMX
Define Sequence Number Display 5-6
O
O (Destination/Overlay/Drop) Line Command
With COPY 15-4
O (Destination/Overlay) Line Command
With COPY 15-4
With Move 21-4
OB (Destination/Overlay) Line Command
With COPY 15-5
With Move 21-4
P
Parentheses
syntax diagrams, use in xxvii
Password
Changing User
During Session 10-8, 10-9
When Signing On 10-3, 10-8
PASSWORD Field on Sign-on Screen 10-2
PAU Keyword on System Information Line 8-4
PDS Member 25-1525-17
PDS Selection List
Attaching 25-18, 25-19
Description Of 25-20
Detaching 26-2
Function Code List 25-2025-22
Inquire About
Load Module 25-2025-22
Source Module 25-2325-25
Reattaching 26-10, 26-11
Search for String
All Occurrences 26-4
By Occurrence 26-3
Non-Matching Occurrences 26-4
Selecting Different Level 25-38
PF/PA Keys
BulletinBoard System 35-2
Changing Assignment
Description 11-8, 11-9
Fixed Assignment 11-10, 11-11
Scroll Functions 11-13
Special Functions 11-15
Variable Assignment 11-11, 11-12
Index X-13
Programs (continued)
parentheses
syntax diagrams, use in xxvii
punctuation
syntax diagrams, use in xxvi
Prune Profile Utility (BBS) 35-16
Punctuation marks (syntax diagrams) xxvi
PURGE Command
Job Output 30-30
R
R Line Command 15-7
RBX Prefix 35-2
Read Message Attribute (BBS) 35-14
Reattaching
AWS 13-13
Data Set Object 26-10, 26-11
Job Output 30-15
Library Facility 33-10, 33-11
Reexecuting Last Command/RPF 2-6
Reformat Lines
Using Line Command 19-819-9
Using Primary Command 19-7, 19-8
REFRESH Command
Data Set Facility 24-15
Library Facility 31-10
Refresh Function (BBS) 35-4
Refreshing Selection List
Data Set Facility 24-15
Library Facility 31-10
RELEASE Command 27-52
RENAME Command
AWS 13-5
Data Set Object 27-53
Library Member 34-22
Rename Function Panel
Data Set Facility 27-54
Renaming
AWS
Using Command 13-5
Using STATUS AWS 17-3
Data Set Object
Using Command 27-53
Using Function Panel 27-54
Using Selection List 27-57
Renumber AWS Contents
Any Time 22-122-3
RENUMBER Command 22-122-3
Reserved
Characters 2-5, 2-6
S
SAVE Command
Assigning Attributes 23-4
Assigning Description 23-4
Creating Library Member 23-2
Saving AWS Contents 23-2
Scale Line 8-6
Screen
Change
Copy Destination 6-15
Size 8-12
Components of
Command Area 8-3
Description 8-2
Execution Area 8-6
Response Line 8-3
Scale Line 8-6
System Control Area 8-38-5
System Information Line 8-3
Copy 15-9
Print 7-2
Split
Full 8-78-8
Overview 8-7
Partial 8-9
Resplit 8-10
Swap 8-10, 8-11
Terminate 8-11
Types of
Full/Half 8-7
Terminal Lock 8-13, 8-14
SCREEN Command 8-12
Screen Types of 10-210-3
Sign-on 10-3
Sign-on' 10-2
6-16
Index X-15
SET Command
STATUS DISPLAY Information 6-15
SET COPYDEST Command
STATUS DISPLAY Information 6-15
SET CURSOR Command 6-15
SET DATEFORM Command 6-15
SET DISPLAY Command
Change Display Format 5-7, 5-8
Change Display Margins 5-5
Change Sequence Number Display 5-6
STATUS DISPLAY Information 6-15
SET DSNCMLST Command
STATUS DISPLAY Information 6-16
SET DSNCNT Command
Site Default 6-13
STATUS DISPLAY Information 6-16
SET DSNEMPTY Command 6-16
SET DSNRECALL command 6-16
SET DUPCR command 6-16
SET EDITCHNG Command
STATUS DISPLAY Information 6-16
Tracking Changed Lines 14-814-10
SET EOF Command
Control ERASE EOF Use 16-6
STATUS DISPLAY Information 6-16
SET ESCAPE Command
STATUS DISPLAY Information 6-16
SET EXECPFX command 6-16
SET FILL Command
STATUS DISPLAY Information 6-16
SET JOBCNT Command
Site Default 6-13
STATUS DISPLAY Information 6-16
SET MASTER Command
STATUS DISPLAY Information 6-16
SET MODE Command
Control Character Recognition/Translation 3-3
Control Non-Displayable Character Translation 3-4
STATUS DISPLAY Information 6-16
SET MONLEVEL command 6-16
SET MONTRAP command 6-16
SET MSGLEVEL Command
STATUS DISPLAY Information 6-16
With Job Submission 28-4
Set Options Utility (BBS) 35-13
SET PFKDELIM Command
STATUS DISPLAY Information 6-16
SET RPSDEST Command
STATUS DISPLAY Information 6-9
SET RPSNOTIFY Command
For PRINT Completion Notification 7-8
Index X-17
T
Tab Character
Change Via STATUS AWS 17-5
TAB Command 18-16, 18-17
TC Line Command 19-3
TCB Line Command 19-3
TCC Line Command 19-3
TCT Line Command 19-3
TE Line Command 18-10
Terminal Lock Facility
Changing Options 6-17
Invoking 8-13, 8-14
Site Defaults 6-12
Terminating 8-13, 8-14
Terminate
Split Screens 8-11
Terminal Lock Screen 8-13
U
UC Line Command 19-5
UCB Line Command 19-5
UCC Line Command 19-5
UCT Line Command 19-5
V
Variables (syntax diagrams) xxvi
Viewing Message Thread (BBS) 35-5
Viewing Message Thread Entries (BBS) 35-6, 35-7
Volume Selection List
Attaching 25-28
Description Of 25-3025-31
Detaching 26-2
Function Code List 25-3025-31
Reattaching 26-10, 26-11
Search for String
All Occurrences 26-4
By Occurrence 26-3
Non-Matching Occurrences 26-4
Selecting Different Level 25-38
Wildcard Characters 25-29
VTAM Sign-on
Initial 10-3
Signing Off 10-13
VTOC Selection List
Attaching 25-3325-34
Description Of 25-3525-37
Detaching 26-2
Function Code List 25-3525-37
Reattaching 26-10, 26-11
Search for String
All Occurrences 26-4
By Occurrence 26-3
Non-Matching Occurrences 26-4
Selecting Different Level 25-38
Wildcard Characters 24-8, 25-33
X
XCOPY Command
Between Screens 15-1215-14
XCOPYS Command
Between Screens 15-1215-14
XCOPYX Command
Between Screens 15-1215-14
XL Line Command 14-5
XLB Line Command 14-5
XLT Line Command 14-5
XTENDED Mode
Character Translation/Recognition
XTPM
Signing On CA-Roscoe 10-4
3-3
Z
ZAnn Mode (BBS) 35-15
ZMsg (BBS)
Function 35-4
Mode, Using 35-2135-27
PFKey Functions 35-25
Set Options 35-27
ZMsgOpts Display (BBS) 35-27
ZZZZZMSG Member
View Using BulletinBoard System
35-2135-24
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