Rational Developer for System z
Enterprise PL/I for z/OS, Version 3.8, Programming Guide

Specifying ENVIRONMENT options

The ENVIRONMENT options applicable to consecutive data sets are:

F|FB|FS|FBS|V|VB|U
RECSIZE(record-length)
BLKSIZE(block-size)
SCALARVARYING

CONSECUTIVE or ORGANIZATION(CONSECUTIVE)
CTLASA|CTL360
LEAVE|REREAD

The options through SCALARVARYING are described in Specifying characteristics in the ENVIRONMENT attribute, and those after SCALARVARYING are described below.

See Table 13 to find which options you must specify, which are optional, and which are defaults.

CONSECUTIVE

The CONSECUTIVE option defines a file with consecutive data set organization, which is described in this chapter and in Data set organization.

Read syntax diagramSkip visual syntax diagram>>-CONSECUTIVE-------------------------------------------------><
 

CONSECUTIVE is the default.

ORGANIZATION(CONSECUTIVE)

Specifies that the file is associated with a consecutive data set. The ORGANIZATION option is described in ORGANIZATION option.

The file can be either a native data set or a VSAM data set.

CTLASA|CTL360

The printer control options CTLASA and CTL360 apply only to OUTPUT files associated with consecutive data sets. They specify that the first character of a record is to be interpreted as a control character.

Read syntax diagramSkip visual syntax diagram>>-+-CTLASA-+--------------------------------------------------><
   '-CTL360-'
 

The CTLASA option specifies American National Standard Vertical Carriage Positioning Characters or American National Standard Pocket Select Characters (Level 1). The CTL360 option specifies IBM machine-code control characters.

The American National Standard control characters, listed in Figure 29, cause the specified action to occur before the associated record is printed or punched.

The machine code control characters differ according to the type of device. The IBM machine code control characters for printers are listed in Table 17.

Figure 29. American National Standard print and card punch control characters (CTLASA)
Code
Action
 
Space 1 line before printing (blank code)
0
Space 2 lines before printing
-
Space 3 lines before printing
+
Suppress space before printing
1
Skip to channel 1
2
Skip to channel 2
3
Skip to channel 3
4
Skip to channel 4
5
Skip to channel 5
6
Skip to channel 6
7
Skip to channel 7
8
Skip to channel 8
9
Skip to channel 9
A
Skip to channel 10
B
Skip to channel 11
C
Skip to channel 12
V
Select stacker 1
W
Select stacker 2

Table 17. IBM machine code print control characters (CTL360)
Print and
Then Act
 
Code byte
 
Action
 
 
 
Act immediately
(no printing)
 
Code byte
00000001 Print only (no space)
00001001 Space 1 line 00001011
00010001 Space 2 lines 00010011
00011001 Space 3 lines 00011011
10001001 Skip to channel 1 10001011
10010001 Skip to channel 2 10010011
10011001 Skip to channel 3 10011011
10100001 Skip to channel 4 10100011
10101001 Skip to channel 5 10101011
10110001 Skip to channel 6 10110011
10111001 Skip to channel 7 10111011
11000001 Skip to channel 8 11000011
11001001 Skip to channel 9 11001011
11010001 Skip to channel 10 11010011
11011001 Skip to channel 11 11011011
11100001 Skip to channel 12 11100011

LEAVE|REREAD

The magnetic tape handling options LEAVE and REREAD allow you to specify the action to be taken when the end of a magnetic tape volume is reached, or when a data set on a magnetic tape volume is closed. The LEAVE option prevents the tape from being rewound. The REREAD option rewinds the tape to allow reprocessing of the data set. If you do not specify either of these, the action at end-of-volume or on closing of a data set is controlled by the DISP parameter of the associated DD statement.

Read syntax diagramSkip visual syntax diagram>>-+-LEAVE--+--------------------------------------------------><
   '-REREAD-'
 

If a data set is first read or written forward and then read backward in the same program, specify the LEAVE option to prevent rewinding when the file is closed (or, with a multivolume data set, when volume switching occurs).

The effects of the LEAVE and REREAD options are summarized in Table 18.

Table 18. Effect of LEAVE and REREAD Options
ENVIRONMENT
option
DISP
parameter
Action
 
REREAD Positions the current volume to reprocess the data set. Repositioning for a BACKWARDS file is at the physical end of the data set.
LEAVE Positions the current volume at the logical end of the data set. Repositioning for a BACKWARDS file is at the physical beginning of the data set.
Neither
REREAD nor
LEAVE
PASS
 
 
DELETE
 
KEEP,
CATLG,
UNCATLG
Positions the volume at the end
of the data set.
 
Rewinds the current volume.
 
Rewinds and unloads the current
volume.
 

Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)