Rules Structure

The following tables describe the structures of the File Transfer to Another System solution rules, as well as the following REXX procedure:

• FTP File "Put"

  Table 153 Send a File using FTP Rule Structure

  Item	Description
  Title	Send a File using FTP
  Name	CTOFTPPT
  Table	TCP/IP
  DO RULE	CTOFTPPT destination local-file foreign-file condition time-out
  DO RULE Description	The DO RULE statement that triggers this statement must contain the arguments shown above.
  Basic Scheduling Parameters	Always schedule this rule.
  Runtime Scheduling Parameters	No special considerations.
  Global Variables	None.
  Rule Logic	The rule is triggered by a DO RULE statement in another rule. Rule arguments are parsed and a REXX procedure is invoked. (Rule arguments are described in detail in "Customization" below.) If a return code of 0 is returned from the REXX procedure, the specified condition is set. Otherwise, a message to the operator is issued.
  Rule Actions	Invokes a REXX procedure to perform file transfer. "Shouts" a message to the operator if the file transfer was not successful.
  Activating the Rule	Once scheduled, the rule remains active until deleted from Control-O.
  Recommended Mode or Category	During the testing period activate the rule in LOG mode. When you are satisfied with the results of the rule, change the mode to PROD to avoid log messages for the rule. SolveWare Category for this rule is 1—minimal or no customization is required.
  Customization	The following arguments must be specified in the DO RULE statement that invokes this rule: destination–Name of the destination host (as defined to TCP/IP) local-file–Name of the file to be transferred The file to be transferred can be either a sequential dataset or a member. foreign-file–Name under which the file is to be stored in the destination host condition–Name of the IOA condition to be set upon successful completion of file transfer Maximum length: 20 characters. time-out–Value to be entered in the TIMEOUT field of the DO TSO statement that invokes REXX procedure CTOFTPPT Table 154 FTP File "Put" REXX Procedure Structure
  Item	Description
  Title	FTP File "Put"
  Name	CTOFTPPT
  REXX Script Description	This script opens a connection to the destination host system and transfers a specified file using that connection.
  Activating the Script	This REXX procedure is activated using rule CTOFTPPT in this solution.
  Parameters	destination Name of the destination host (as defined to TCP/IP). local-file–Name of the file to be transferred. The file to be transferred can be either a sequential dataset or a member. foreign-file–Name under which the file is to be stored in the destination host. userid–User ID of the job or started task or TSO under which the rule that activated this REXX procedure is running.
  	Note: Parameters destination, local-file and foreign-file are passed as arguments from the rule that activated this REXX procedure. The value of parameter userid is extracted from AutoEdit variable %%$USERID.
  Special Considerations	The script allocates a password file, named userid.NETRC (where userid is the value in %%$USERID as explained above), which is read by the FTP software. Since this file contains sensitive information, it must be protected by on-site security software. The structure of this file is: MACHINE sys1 LOGIN usera PASSWORD passa MACHINE sys2 LOGIN userb PASSWORD passb MACHINE sys3 LOGIN userc PASSWORD passc . . . where sysn is the host name (as defined to TCP/IP). userx is the user ID. passx is the password for the user (userx above).