The fields that appear are correlate to the File Type you select. If you need assistance determining these values, please contact your MVS administrator. All required fields are marked with an asterisk on the screen.
- Connection Name — The name of the file connector (specific to your application and unrelated to the file itself).
- Host Name / IP — The network host name or IP address of the PDS server.
- FileName — The source file fully qualified data set name, including "(0)" for generation data group files.
- FileType — The source file type: normal, VSAM, or GDG.
- UserID — The user login this connector will use to connect to the mainframe host system to access the PDS copybook files. For VSAM files, use the cluster name.
- Password — The password associated with the Login ID or Username. (This password is stored encrypted.)
- File DCB RECFM — The source file record format; possible values: F, FB, FBA, V, VB, VBA.
- BLKSIZE — The source file block size, from 1 to 32760.
- File DCB LRECL — The source file logical record length, from 1 to 32760. If record format is fixed, must be a divisor of block size.
- Header/Trailer Code — The number of records to skip (copy and not mask) at the beginning and end of the source file. The format is in the form "H,x,T,y", "H,x", or "T,y" where:
- H and T are constants.
- x is the number of header rows to skip.
- y is the number of trailer rows to skip.
Normal file types have a Test Connection button at the bottom left of the New Connector window. VSAM and GDG file types do not have a Test Connection button.
We highly recommend that you test your connection. Do so before you leave this window. When you click the Test Connection button, DMsuite uses the information in the form to attempt a mainframe connection. When finished, a status message appears indicating whether the attempt was successful or failed.
VSAM files are treated sequentially as ordinary files. IDCAMS uses the cluster name to create an ordinary file. This GOLDCOPY is used to load the target dataset later.
To allocate the new file, the process uses record format, record length, and block size, as follows:
- If the VSAM source record is fixed length, use FB and record length, and make block size the largest multiple of record length less than 27,998 (half-track blocking).
- If the VSAM record is variable length, use VB, and use the maximum record length +4 as the record length, and use block size of 27,990.
This information pertains to processing the source records and allocating the GOLDCOPY; it does not apply to system records about the original source.