You can automatically transfer files between VM or MVS machines and your workstation by using IRISXFR and IND$FILE.
When using IRISXFR to transfer files, you can use the updown program on the VM host and sgixfr.clist (updown) on an MVS host. When you start updown, the program checks the file updown profile, also on the host, to determine which files to transfer automatically. An example of updown profile is shown in Example D-1.
The updown profile contains information about which files to transfer. The information, such as the name of the file and its type, is organized into data fields.
Before setting up IRISXFR to transfer files automatically, make sure that it is installed correctly on the IBM host and on your machine. If you have not done so already, see the file /var/opt/3270/example/CASE4/README for instructions on verifying the IRISXFR installation.
Make a copy of updown profile. Then, change the various fields to meet your particular needs. Read the comments in the file to determine the function of each field and which ones to change.
When you have finished modifying updown profile, run updown on the IBM host. It automatically uploads or downloads any files specified in updown profile. With updown and updown profile, you can transfer several files without using the IRISXFR Setup Menu for each individual file.
Example D-1 shows the default updown profile for a VM host. Lines that begin with two slash marks (//) are comments.
// This file contains the information necessary for updown // to work. It supplies all of the information necessary to automate // the file upload and download process. Comment lines must begin with // a '//' in the first two columns, otherwise, updown will treat // the line as input data. Field definitions are provided below: // // 1 2 3 4 5 6 // 1234567890123456789012345678901234567890123456789012345678901234567890 // nnnnnnnn tttttttt mm wwwwwwwwwwwwwwwwwwwwwwwww u t f nnnnn n n nnn // nnnnnnnn tttttttt mm wwwwwwwwwwwwwwwwwwwwwwwww d b v nnnnn r o nnn // // 01 - 08 is the IBM host file name // 10 - 17 is the IBM host file type // 19 - 20 is the IBM host file mode // // 22 - 46 is the workstation file name // // 48 is u or d (upload or download) // 50 is t or b (text or binary) // 52 is f or v (fixed or variable) // // 54 - 58 is the IBM host record size // // 60 is n or r (no-restart or restart) // 62 is n or o (no-overwrite or overwrite) // 64 is the expected return code // // Use lines 31 to 38 to validate that IRISXFR has been properly installed // on your VM system. After validating the installation, modify // this file to automate your file transfers to and from the host. // 1 2 3 4 5 6 7 //34567890123456789012345678901234567890123456789012345678901234567890 display wrap a DISPLAY.WRAP u t f 79 n n 000 display data a DISPLAY.DATA u t v 16 n n 000 binary wrap a BINARY.WRAP u b f 80 n n 000 binary data a BINARY.DATA u b f 16 n n 000 display wrap a DISPLAY.WRAP d t f 79 n o 000 display data a DISPLAY.DATA d t v 16 n o 000 binary wrap a BINARY.WRAP d b f 80 n o 000 binary data a BINARY.DATA d b f 16 n o 000 |
Example D-2 is an updown profile file for an MVS host.
// This file contains the information necessary for updown // to work. It supplies all of the information necessary to automate // the file upload and download process. Comment lines must begin with // a '//' in the first two columns, otherwise, updown will treat // the line as input data. Field definitions are provided below: // // 1 2 3 4 5 6 7 //12345678901234567890123456789012345678901234567890123456789012345678901234567 //nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn wwwwwwwwwwww u t f nnnnn n n nnn //nnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn wwwwwwwwwwww d b v nnnnn r o nnn // // 01 - 36 is the IBM host file name // // 38 - 57 is the workstation file name // // 59 is u or d (upload or download) // 61 is t or b (text or binary) // 63 is f or v (fixed or variable) // // 65 - 69 is the IBM host record size // // 71 is n or r (no-restart or restart) // 73 is n or o (no-overwrite or overwrite) // 75 is the expected return code // // Use lines 32 to 39 to validate that IRISXFR has been properly installed // on your MVS system. After validating the installation, modify // this file to automate your file transfers to and from the host. // // 1 2 3 4 5 6 7 //345678901234567890123456789012345678901234567890123456789012345678901234567 display.wrap.a DISPLAY.WRAP u t f 79 n n 000 display.data.a DISPLAY.DATA u t v 20 n n 000 binary.wrap.a BINARY.WRAP u b f 80 n n 000 binary.data.a BINARY.DATA u b f 16 n n 000 display.wrap.a DISPLAY.WRAP d t f 79 n o 000 display.data.a DISPLAY.DATA d t v 16 n o 000 binary.wrap.a BINARY.WRAP d b f 80 n o 000 binary.data.a BINARY.DATA d b f 16 n o 000 |
You can also automate file transfers for either IND$FILE or IRISXFR from the UNIX command line. Refer to the example provided in /var/opt/3270/example/CASE6/README for instructions.