Note:
In this section, the term "tape" represents any
installation media (e.g. tape and CD-ROM) supported by Software AG. The
information provided here applies to the use of any of these media.
All files of a Software AG product are stored as sequential files on the tape. To copy these files from tape to disk SMA uses the procedure P.COPYTAPE which is located in the library JOBLIB.
The procedure P.COPYTAPE works as follows:
If the file &DSND already exists it will be renamed to
&(DSND).RENAMED-BY-&(VSNT). For example, file XYZ123.MOD will be
renamed to XYZ123.MOD.RENAMED-BY-T12345 (assuming that
VSNT=T12345). If this file also exists then the
procedure will be terminated
abnormally.
| Name | Description |
|---|---|
| DSNT | Name of the file on the tape |
| VSNT | Name of the tape. For example: T12345 |
| DEVT | Tape device type. For example: TAPE-C4 |
| FSEQ | Tape file sequence number (see the Software AG Product Delivery Report). |
| DSND | Name of file on the BS2000/OSD disk |
| DSORG | File (data set) organization (see table below) |
| ACCESS | File access protection against overwriting.
Possible values are *READ or *WRITE. The value of this parameter is controlled
by SMA parameter FILE-ACCESS.
|
| USER-ACCESS | Specifies whether or not the file may be
processed under user IDs other than the file owner’s ID. Possible values are
*ALL-USERS or *OWNER-ONLY. The value of this parameter is controlled by SMA
parameter FILE-USER-ACCESS.
|
| CONV-PROG | Name of the program to be used to convert a
sequential file on the tape into a PLAM library on the BS2000/OSD disk.
Possible values are SAMTOLIB or PERCON. The program SAMTOLIB is written by
Software AG and is delivered in source from. If available, PERCON is the
recommended program. The value of this parameter is controlled by SMA parameter
CONV-PROG.
|
| DSORG | FILE-STRUC | REC-SIZE | Conversion-/Copy-Program |
|---|---|---|---|
| LIB | PAM | 4096 | SAMTOLIB / PERCON |
| LMS (*) | PAM | 80 | LMS (ISP syntax) |
| PAM (*) | PAM | 2064 | SAMTOPAM |
| SAM | SAM | ANY | PERCON |
| SEQ | SAM | <256 | EDT |
(*) DSORG types LMS and PAM are no longer used for new product releases.
SYSOUT and SYSLST of the procedure P.COPYTAPE are written to file L.COPYTAPE.&(DSNT) .
/CALL-PROC *LIB(JOBLIB, P.COPYTAPE), - / (JOBLIB = JOBLIB, - / DSNT = XYZ123.PAMS, - / VSNT = T12345, - / DEVT = T-C4, - / FSEQ = 3, - / DSND = $SAG.XYZ123.MOD, - / DSORG = LIB)