Manual File Transfer and Expand
This appendix tells you how to manually transmit XMIT format files from a networked PC to a mainframe host and how to expand those files into PDS libraries.
Use the procedures in this appendix if you have problems with the automated procedures described in Unload Mainframe Components
Transfer Files To Host Mainframe
After Windows Installer has copied and decompressed the XMIT format mainframe software files to your PC or a network drive, you must copy the files to the mainframe.
The transfer process must not convert the file into character format; the transfer must be binary. The receiving mainframe files must have these characteristics:
File Organization: Sequential
Record Format: Fixed block
Record Length (LRECL): 80
Block Size: 3120
Choose the transfer procedure that you prefer:
-
To use FTP, see File Transfer Using FTP.
-
To use 70 emulator software, see File Transfer Using 70 Emulator.
File Transfer Using FTP
This section describes how to use FTP to upload ChangeMan ZDD files from a PC to a mainframe host computer. These instructions assume that you have:
-
TCP/IP FTP connectivity from your PC to the mainframe computer.
-
The dotted decimal IP address of the mainframe.
-
A mainframe userid and password.
-
Security authorization to allocate files on the mainframe.
Execute these steps on your PC.
-
Open a Command Prompt window:
Start\>Programs\>Accessories\>Command Prompt
-
At the Command prompt, type this command to start FTP and connect to the host mainframe and press [Enter]. (
nnn.nnn.nnn.nnn
is the dotted decimal IP address of the target mainframe computer.)ftp nnn.nnn.nnn.nnn
-
When you are prompted for your userid, type your mainframe userid and press [Enter].
-
When you are prompted for your password, type your mainframe password and press [Enter].
-
At the FTP prompt, type this command to set the transfer type to binary and Press [Enter]:
binary
-
At the FTP prompt, type each of these commands and press [Enter] in the order shown:
literal site blocksi=3120 literal site lr=80 literal site rec=f literal site cyl These commands set the DCB and the SPACE units for the receiving files that are automatically allocated on the mainframe.
-
At the FTP prompt, type this command to transfer a file from the PC to the mainframe host and press [Enter]. (The sample command here is too long to display on this page without artificial breaks. Long command lines like this one will wrap in the Command Prompt window.)
put "C:\\Program Files\\Micro Focus\\ ChangeMan ZDD Server\\SERCOMC.V5R3M2.ASMSRC" 'user111.binary.sercomc.v5r3m2.assemble"
Notes
-
The mainframe file you specify in the PUT command is not a PDS library. Specify an intermediate file name rather than a data set name you intend to use for a ChangeMan ZDD PDS library on the mainframe.
-
The first file name is the PC file to be transmitted. You must enclose the PC file name in double quotes if there are spaces in a directory name or in the file name. The PUT command is not case sensitive.
-
The second file name is the receiving file on the mainframe computer. Enclose the mainframe file in single quotes to suppress the addition of the “working directory” (userid) as a high level qualifier.
-
-
Type a PUT command at the FTP prompt and press [Enter] for each file to be transferred to the host.
-
After you have transferred all files from the PC to the host mainframe computer, type the following command at the FTP prompt and press [Enter] to disconnect from the mainframe computer and end the FTP session.
quit
-
Close the Command Prompt window.
-
Logon to the mainframe and verify that the new mainframe files have the proper record format, logical record length, and block size.
File Transfer Using 70 Emulator
Extra!® from Attachmate Corporation and Personal Communications from IBM are popular 70 emulator programs. These and other 70 emulator programs commonly use IND$FILE to transfer files between a PC and a mainframe host computer.
Execute these steps if you use 70 emulator software on your PC to transfer ChangeMan ZDD files to the host mainframe computer.
-
In the File Transfer facility of your PC host emulator software, change the TSO binary transfer type to use these settings, or define a new TSO Binary transfer type:
Setting Value VM / TSO / CICS TSO Transfer Type Binary ASCII NO CRLF NO APPEND NO Record Format Fixed (block) Record Length 80 Block Size 3120 Allocation Units Cylinders Primary Allocation 1 Secondary Allocation 1 -
With the preceding settings, the file transfer software should allocate a sequential target file on the host for each file transfer. However, if you wish to preallocate one or more host target files, use these file allocation parameters:
SPACE=(CYL,(1,1)), DCB=(DSORG=PS,RECEM=FB,LRECL=80,BLKSIZE=3120)
-
Run the file transfer function to transfer each file on the PC to a target sequential disk data set on the host.
Note
The mainframe file you specify in the transfer facility is not a PDS library. Specify an intermediate file name rather than the data set name you intend to use for the ChangeMan ZDD PDS library on the mainframe.
-
Logon to the mainframe and verify that the new mainframe files have the proper record format, logical record length, and block size.
Expand Host Target Files
Execute these steps to expand the sequential XMIT files transferred from your PC into PDS libraries.
-
Choose Option 6 (Command) from the ISPF/PDF Primary Option Menu.
-
On the ISPF Command Shell panel, type the TSO RECEIVE command:
RECEIVE INDATASET(‘host.target.dataset.name’) Specify one of the sequential XMIT files that you uploaded from the PC.
-
The RECEIVE command prompts you with these messages:
INMR901I Dataset USER11.CMN512.GOLDCODE.CNTL.FIX from... INMR906A Enter restore parameters or 'DELETE' or 'END' + Respond by typing a DATASET parameter to specify the data set name you chose for ChangeMan ZDD vendor libraries. See [Component Libraries](installation-considerations.md#component-libraries). DATASET(‘node.SERCOMC.VnRnMn.LOAD’) NEW\|OLD The RECEIVE command displays IEBCOPY sysout messages.
Note
We recommend that you define the last node in your PDS library names the same as the last node of the original files on the download image or distribution CD.
-
If you need more information about using the RECEIVE receive command, type the following on the Command line:
TSO HELP RECEIVE