FT - transfer Files/PLAM-elements with FT-BS2000

ONXFT ['str1'=...] [%name | %? [,JRS=jrfile|,?] [,]] [host2] [, user-id2] [, acct-nr2] [, passw2] [, rem-succ] [, rem-fail]

[, rem-par] [, direct] [, lst] [, time]

If no operands are specified, they will be requested from a special FT parameter mask (see above).

'str1'=... The name of the file in the target system will be created such that 'str1' will be sought in the source file name and replaced by 'str2'. By definition, every name is prefixed with an empty string '', and suffixed with a blank string '_' . If the source file does not contain 'str1', the file will not be transferred.

For more information on Name transformation rules see page 5-.

If this operand is not specified, the target file name will be the same as the source file.

%name The File Transfer parameters will be taken from the specified parameter set.

%? All relevant parameter sets will be displayed in a mask, from which one may be selected by marking it.

JRS=jrfile Name of the JRSAVE file in which the parameter set is stored.

Standard: CFS.JRSAVE.xxxx. For further information, see page 27-.

? The FT screen will be filled with the contents of the parameter set and the user can modify it as required. Normally the FT screen will not be displayed.

Notes:

The File Transfer parameters activated by the parameter set can be modified directly by specifying parameter values such as host2, user-id2 etc.

Saving the last FT parameters to have been used to a parameter set is achieved by means of the SP FT%name command. For further information, see page 7-. When saving the parameter set, any defined FTEP parameters will be retained.

host2 Symbolic name of the remote host computer.

The name specified as host2 is not the host name generated in PDN, but the partner name defined in the FT parameters.

user-id2 Userid in the remote system to which or from which the file should be transferred.

Standard: same userid as on the local system.

FTAC: As an alternative to a remote userid, an FTAC Transfer-Admission parameter may be specified for the remote system. To do this, the constant "FTAC:" should be entered in the "Remote User-Id" field, followed by the actual Transfer-Admission. When entering a Transfer-Admission, particular care must be taken, since FTAC profiles are case sensitive. CFS will not convert lower case letters to upper case.

acct-nr2 Account number.

Standard: the same account number as in the local system.

passw2 Logon password of the userid in the remote system ( [C]'...' | X'...' ).

Standard: no password.

rem-succ Remote Success Procedure. The name of a procedure to be executed in the event of the transfer being successful.

proc,* The DO procdure specified as proc will use the name of the transferred file as a parameter.

/cmd .... Following the successful transfer of the file, the specified BS2000 command will be executed on the remote system. If an '*' is specified anywhere in the command, the name of the transferred file will be substituted at that point. Multiple BS2000 commands, separated by semicolons, may be specified (/cmd1 ...;/cmd2 ...).

'/cmd ...' Following the successful transfer, the specified command will be executed on the remote system. In this case, however, an '*' will not be substituted with the file name.

Standard: no Remote Success Procedure.

rem-fail Remote Failure Procedure. The name of a procedure to be executed in the event of the transfer failing.

proc,* The DO procdure specified as proc will use the name of the transferred file as a parameter.

/cmd .... Following the unsuccessful transfer of the file, the specified BS2000 command will be executed on the remote system. If an '*' is specified anywhere in the command, the name of the transferred file will be substituted at that point. Multiple BS2000 commands, separated by semicolons, may be specified (/cmd1 ...;/cmd2 ...).

'/cmd ...' Following the unsuccessful transfer, the specified command will be executed on the remote system. In this case, however, an '*' will not be substituted with the file name.

Standard: no Remote Failure Procedure.

rem-par Remote Parameter (Type of remote system).

possible values: *BS2000 | *MSP | *ANY | *any

*BS2000 BS2000 target system.

*MSP MVS target system.

*ANY Other target system (SINIX/VMS/AMBOSS/..). File names will be transferred to the remote system in upper case.

*any Other target system, e.g. SINIX. BS2000 File names will be transferred to the remote system in lower case.

Standard: *BS2000.

direct Transfer Direction.

possible values: FROM | TO

Standard: TO.

lst Listing. Should a listing be produced for each transferred file?

Specifying YES will result also in CFS activating the Job Report System after termination of the file transfer request, and displaying the results on screen.

possible values: YES | NO

Standard: NO.

time hh:mm Do not start the transfer before the specified time.

If the specified start time has already passed, the transfer will begin at that time the following day.

Standard: Start the transfer as soon as possible.

" modify Extended Parameters for FT " (last field in the FT mask):

Entering Y in this field will display the File Transfer Extended Parameter mask (FTEP mask). Additional parameters needed less often can be specified for future transfers in this screen. For example, the "Local Transfer Admission Userid, Acct-Nr, Password", parameters, as well as "Local Success Procedure", "Local Failure Procedure" can be specified. These additional parameters may also be specified using the FTEP param command or by calling the FTEP mask directly (FTEP command, see page 7-) before the first FT call.

Standard: N (no display of the FTEP mask).

Notes:

If the parameters up to and including acct-nr2 are specified explicitly in the ONXFT statement, the FT parameter mask will not be displayed, and the standard values will be used for the unspecified parameters.

If PLAM elements are transferred to another BS2000 system, the elements will be created in the remote system under the same name, and in a library of the same name.

When transfering files with the ONXFT Variable Action, any necessary read passwords will not be requested dynamically.

The termination of FT requests can be monitored by the CFS Job Report System as from FT-BS2000 Version 3 by specifying the FT parameter Protocol-Listing: YES. For further information, refer to the JRFT/ NJRFT commands on page 11-.

To select all files being transferred, refer to the NSTAT option in the FILENAME-SELECT field in the selection mask.

For further information about file transfer - in particular between BS2000 and SINIX systems - refer to Chapter 12 "File Transfer with FT-BS2000 / RDAC".

Example:

ON&FT HOST5,USER5,A001,C'12345',,,,,YES

All files in the list will be transferred to the remote system named HOST5. The remote userid, account number and logon password are: USER5,A001,C'12345'.

The remote system is a BS2000 system (Standard value).

A listing will be produced for each transferred file.