This statement sets the default values for the CONVERT-FILE statement. The specified defaults then apply to the current program run until the next MODIFY-CONVERT-FILE-DEFAULTS statement is issued.
If the statement is entered without operands, the existing default values remain valid.
The currently applicable values may be queried using the SHOW-CONVERT-FILE-DEFAULTS statement.
Format
MODIFY-CONVERT-FILE-DEFAULTS | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
DIRECTION = *UNCHANGED / *ONKEY / *NONKEY-TO-KEY
Designates the desired default value for the direction of file conversion.
DIRECTION = *UNCHANGED
The current default value for DIRECTION is not changed.
DIRECTION = *TO-NONKEY
This file is to be converted into NK format.
DIRECTION = *NONKEY-TO-KEY
This file is to be converted from NK to K format.
SELECT = *UNCHANGED / *ALL / *BY-ATTRIBUTES(...)
Specifies whether the files to be converted are selected via specific selection criteria in addition to the partially qualified file name.
SELECT = *UNCHANGED
The current default value for SELECT is not changed.
SELECT = *ALL
No selection criteria are set for the source files.
SELECT = *BY-ATTRIBUTES(...)
Defines the selection criteria for the files to be converted and which are to apply as default values for the CONVERT-FILE statement.
CREATION-DATE = *ANY / *INTERVAL(...) / <date> / *TODAY / *YESTERDAY
Designates the creation date as a selection criterion.
CREATION-DATE = *ANY
The creation date is not used as a selection criterion. All files are taken into account for selection.
CREATION-DATE = *INTERVAL(...)
Files with a creation date within the specified interval are selected. The range limits are defined by the FROM and TO operands.
FROM = 0000-01-01 / *YESTERDAY / <date>
Files with a creation date equal to or later than the specified limit are selected.
FROM = 0000-01-01
The lower limit is the earliest possible date.
FROM = *YESTERDAY
The lower limit is yesterday’s date. Files with a creation date ≥ yesterday’s date are selected.
FROM = <date>
The lower limit is the specified date. Files with a creation date ≥ the specified value are selected.
TO = *TODAY / *YESTERDAY / <date>
Files with a creation date equal to or earlier than the specified limit are selected.
TO = *TODAY
The upper limit is the current date. Files with a creation date ≤ the current date are selected.
TO = *YESTERDAY
The upper limit is yesterday’s date. Files with a creation date ≤ yesterday’s date are selected.
TO = <date>
The upper limit is the specified date. Files with a creation date ≤ the specified value are selected.
LAST-ACCESS-DATE = *ANY / *INTERVAL(...) / <date> / *TODAY / *YESTERDAY
Designates the date of the last file access as a selection criterion.
For the meaning of ANY, INTERVAL(...), <date>, TODAY and YESTERDAY see the CREATION-DATE operand.
SIZE = *ANY / <integer 0..16777215> / *INTERVAL(...)
Designates the file size as a selection criterion.
SIZE = *ANY
The file size is not used as a selection criterion.
SIZE = <integer 0..16777215>
Files with a size equal to the specified value are selected.
SIZE = *INTERVAL(...)
Files with a size within the specified range are selected. The range limits are defined by the FROM and TO operands.
FROM = 0 / <integer 0..16777215>
Files with a size ≥ the specified limit are selected.
FROM = 0
The lower limit is the absolute minimum.
FROM = <integer 0..16777215>
The lower limit is the specified size.
TO = 16777215 / <integer 0..16777215>
Files with a size ≤ the specified limit are selected.
TO = 16777215
The upper limit is the absolute maximum.
TO = <integer 0..16777215>
The upper limit is the specified size.
FILE-STRUCTURE = *ANY / list-poss(3): *SAM / *ISAM / *PAM
Designates the access method as a selection criterion.
FILE-STRUCTURE = *ANY
The access method is not used as a selection criterion.
FILE-STRUCTURE = *SAM
Files with the SAM access method are selected.
FILE-STRUCTURE = *ISAM
Files with the ISAM access method are selected.
FILE-STRUCTURE = *PAM
Files with the PAM access method are selected.
BLKSIZE = *ANY / <integer 1..16>
Designates the block size as a selection criterion.
BLKSIZE = *ANY
The block size is not used as a selection criterion.
BLKSIZE = <integer 1..16>
Files with a block size equal to the specified value are selected.
BLKCTRL = *ANY / *PAMKEY / *NO / *DATA / *DATA2K / *DATA4K
Designates the block control attribute as a selection criterion.
BLKCTRL = *ANY
The block control attribute is not used as a selection criterion.
BLKCTRL = *PAMKEY
Files with the block control attribute PAMKEY are selected.
BLKCTRL = *NO
Files with the block control attribute NO are selected.
BLKCTRL = *DATA
Files with the block control attribute DATA are selected.
BLKCTRL = *DATA2K
Files with the block control attribute DATA2K are selected.
BLKCTRL = *DATA4K
Files with the block control attribute DATA4K are selected.
TO-FILE-BLKSIZE = *UNCHANGED / *STD / *NK4 / <integer 1..16>
Specifies the logical block size of the target file.
TO-FILE-BLKSIZE = *UNCHANGED
The default value currently valid for TO-FILE-BLKSIZE is to remain unchanged.
TO-FILE-BLKSIZE = *STD
The logical block size of the target file is not defined by the user. PAMCONV uses the values defined for the target pubset and, if necessary, increases the blocking factor. The blocking factor is increased internally by a maximum of 1.
TO-FILE-BLKSIZE = *NK4
The logical block size of the target file is controlled in such a way that it is always even, i.e. the target file can be stored on an NK4 pubset. The blocking factor is increased internally by a maximum of 1.
TO-FILE-BLKSIZE = <integer 1..16>
The target file is generated with a block size equal to the specified value, provided that this specification is compatible with the other conditions governing reblocking (see the section “Reblocking”).
TO-FILE-BLKCTRL = *UNCHANGED / *STD / *NK4
Specifies the block control information of the target file. This operand is relevant only for the conversion direction TO-NONKEY and for ISAM files.
TO-FILE-BLKCTRL = *UNCHANGED
The default value currently valid for TO-FILE-BLKCTRL is to remain unchanged.
TO-FILE-BLKCTRL = *STD
The block control information is set in accordance with the target pubset. With NK2 pubsets, the data format is DATA2K; with NK4 pubsets, it is DATA4K.
TO-FILE-BLKCTRL = *NK4
The block control information is assigned the value DATA4K.
REPLACE-OLD-FILES = *UNCHANGED / *NO / *YES / *DIALOG
Indicates whether any files existing under this name are to be overwritten.
REPLACE-OLD-FILES = *UNCHANGED
The current default value for REPLACE-OLD-FILES is not changed.
REPLACE-OLD-FILES = *NO
Existing files must not be overwritten; file conversion is to be aborted in this case (default value).
REPLACE-OLD-FILES = *YES
Existing files are overwritten unless additional protection (password, ACCESS=*READ,..) has been provided.
REPLACE-OLD-FILES = *DIALOG
The system issues a query as to the desired procedure for existing files with the same name. Possible in interactive mode only.
FILE-DISPOSAL = *UNCHANGED / *KEEP / *RENAME / *REPLACE / *INPLACE
Determines what happens to the source and target file after conversion.
FILE-DISPOSAL = *UNCHANGED
The current default value for FILE-DISPOSAL is not changed.
FILE-DISPOSAL = *KEEP
The target files are to be created with the names specified for them in the conversion statement. The target files exist in addition to the source files.
FILE-DISPOSAL = *RENAME
The target files are to be created with the names specified for them in the conversion statement. After successful conversion, the source files are to be deleted.
FILE-DISPOSAL = *REPLACE
The target files are to be created with the names specified for them in the conversion statement. After successful conversion, the source files are to be deleted and the target files are to receive the names of the source files. In effect, the source file is replaced by the target file.
FILE-DISPOSAL = *INPLACE
The target files are to be created with the names specified for them in the conversion statement. After successful conversion, an attempt is to be made to overwrite the source file with the target file and to assign the source file name to the target file. This has the effect that the target file also physically takes up approximately the same space as the source file. In effect, the source file is replaced by the target file.
PROTECTION = *UNCHANGED / *STD / *SAME
Specifies whether the file protection attributes of the source file are to be transferred to the target file.
PROTECTION = *UNCHANGED
The currently valid default value for PROTECTION is to remain unchanged.
PROTECTION = *STD
The file protection attributes are not transferred.
PROTECTION = *SAME
The file protection attributes are transferred to the target file. For more details see “Transfer of file protection attributes after conversion” (Special points relating to conversion).
DEVICE-FOR-TEMPFILE = *UNCHANGED / *NONE / *TAPE(...) / *DISK(...)
Designates the storage medium which is to accommodate the intermediate (temporary) file created.
DEVICE-FOR-TEMPFILE = *UNCHANGED
The current default value for DEVICE-FOR-TEMPFILE is not changed.
DEVICE-FOR-TEMPFILE = *NONE
No intermediate file is to be stored on a private volume.
DEVICE-FOR-TEMPFILE = *TAPE(...)
The intermediate file is to be stored on magnetic tape.
VOLUME = list-poss(100): <alphanum-name 1..6>
Designates the VSN(s) of the tape(s) to be used as storage medium, if more than one VSN are stated in a list.
DEVICE-TYPE = <text 1..20>
Designates the device type to be used.
DEVICE-FOR-TEMPFILE = *DISK(...)
The intermediate file is to be stored on private disk.
VOLUME = list-poss(100): <alphanum-name 1..6>
Designates the VSN(s) of the private disk(s) to be used as storage medium, if more than one VSN are stated in a list.
DEVICE-TYPE = <text 1..20>
Designates the device type to be used.