By default a ZIP container has PAM file format.
Alternatively a ZIP container can also be a binary SAM file (with RECORD-FORMAT=U). This format occurs in the following cases (see also section “Windows interoperability”):
Only if the ZIP container was transferred to BS2000 using openFT
<V11.0 will it have been stored as a binary SAM file (i.e. with RECORD-FORMAT=U). For processing purposes the ZIP container must be in PAM file format.A binary SAM file (with RECORD-FORMAT=U) is required for transfer using openFT
<V11.0.
The CONVERT-ZIP-CONTAINER statement converts a ZIP container to the other file format (from PAM to SAM with RECORD-FORMAT=U and vice versa). The ZIP container is retained unchanged, and the converted ZIP container is stored in the output file specified.
CONVERT-ZIP-CONTAINER | ||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||
FROM-FILE = *CURRENT / <filename 1..54 without-gen-vers> / *LINK(...)
Specifies the ZIP container which is to be converted.
FROM-FILE = *CURRENT
The container is the one which is presently open.
FROM-FILE = <filename 1..54 without-gen-vers>
Converts the specified ZIP container.
FROM-FILE = *LINK(...)
The ZIP container to be converted is specified by means of a link name.
LINK-NAME = <structured-name 1..8>
Link name which is assigned to the ZIP container.
TO-FILE = *STD / <filename 1..54 without-gen-vers> / *LINK(...)
Specifies the output file in which the converted ZIP file is stored.
TO-FILE = *STD
The output file is assigned a standard name which contains the file name of the ZIP container which is to be converted and a suffix indicating the file format involved (SAM or PAM).
The output file is created under the user-id and default cat-id of the user. An user-id and/or cat-id specified in the FROM-FILE parameter will be ignored for the output file.
The standard name is formed in accordance with the following rules:
The ZIP container is in PAM file format.
Name of the ZIP container
Name of the output file
partialname.PAM
partialname.SAM
partialname.PAM.ZIP
partialname.SAM.ZIP
partialname.ZIP
partialname.SAM.ZIP
filename
filename.SAM
The ZIP container is in SAM file format with RECORD-FORMAT=U.
Name of the ZIP container
Name of the output file
partialname.SAM
partialname.PAM
partialname.SAM.ZIP
partialname.PAM.ZIP
partialname.ZIP
partialname.PAM.ZIP
filename
filename.PAM
In the case of a partialname.ZIP or filename ZIP container, the path name for the output file can be longer than 54 characters when the suffix is appended. In this case the partialname or filename in front of the suffix is truncated by the required number of characters.
TO-FILE = <filename 1..54 without-gen-vers>
The converted ZIP container is stored in the specified file.
TO-FILE = *LINK(...)
The output file is specified via a link name.
LINK-NAME = <structured-name 1..8>
Link name which is assigned to the output file.
WRITE-MODE =
Specifies whether the output file should be created or only overwritten.
WRITE-MODE = *CREATE
The output container must be created. The statement is rejected if it already exists.
WRITE-MODE = *REPLACE-ONLY
The output file must exist and is replaced. The statement is rejected if the file does not exist.
WRITE-MODE = *ANY
The output file is overwritten if it exists, otherwise it is created.