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 Unloading the Software.

Transfer Files To Host Mainframe

After the Setup Wizard has copied and decompressed the XMIT format mainframe software files to your PC or a network drive, you 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 has 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 3270 emulator software, see File Transfer Using 3270 Emulator.

File Transfer Using FTP

This section describes how to use FTP to upload ChangeMan ZMF 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 user ID and password.
Security authorization to allocate files on the mainframe.

Execute these steps on your PC:

Open a Command Prompt window:

Windows NT®:	Start > Programs > Command Prompt
Windows® 2000:	**Start > Programs > Accessories > Command Prompt
Windows® XP:	**Start > Programs > Accessories > Command Prompt
Windows® 7:	**Start > All Programs > Accessories > Command Prompt

At the Command prompt, type the following command to start FTP and connect to the host mainframe. Specify the dotted decimal IP address of the target mainframe computer:

ftp nnn.nnn.nnn.nnn

Press ENTER.
When you are prompted for your user ID, type your mainframe user ID and press ENTER.
When you are prompted for your password, type your mainframe password and press ENTER.
At the FTP prompt, type the following command to set the transfer type to binary:

binary

Press ENTER.
At the FTP prompt, type each of these commands and press ENTER in the order shown:

literal site recfm=fb lr=80 blocksi=3120 cylinders

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. (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\Serena\
    ChangeMan ZMF Server\SERCOMC.V5R5M0.ASMSRC"
    'user111.binary.sercomc.v5r5m0.assemble'
```
The first file name is the PC file to be transmitted. 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” (user ID) as a high level qualifier.

Note

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 ZMF PDS library on the mainframe.

Press ENTER.
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 to disconnect from the mainframe computer and end the FTP session.

quit

Press ENTER.
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 3270 Emulator

Extra!® from Attachmate Corporation and IBM Personal Communications are popular 3270 emulator programs. These and other 3270 emulator programs commonly use IND$FILE to transfer files between a PC and a mainframe host computer.

Execute these steps if you use 3270 emulator software on your PC to transfer ChangeMan ZMF 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 ZMF 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.CMNZMF.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 ZMF delivered libraries.
```
DATASET(‘node.SERCOMC.VnRnMn.LOAD’) NEW\|OLD
```
The RECEIVE command displays IEBCOPY sysout messages.

Note

It is recommended that you define the last node in your PDS library names the same as the last node of the XMIT files you are expanding.

If you need more information about using the RECEIVE receive command, type the following on the Command line.

TSO HELP RECEIVE