Transfer SAVF using FTP (SENDSAVF)

The Transfer SAVF using FTP (SENDSAVF) command builds a list of save file names that match the user's selection criteria and transfers those save file to another system using FTP; specifically it uses the COZTOOLS FTPFILE command to transfer the save files.

This command is conditionally threadsafe.

Parameters

Keyword	Description	Choices	Notes
RMTSYS	Remote server or IP	Values (up to 64 repetitions): Path name	Required, Positional 1
USER	Remote User	Name, *CURRENT	Optional, Positional 2
PWD	Remote password	Character value, *USER	Optional, Positional 3
SAVF	Save file to transfer	Values (up to 300 repetitions): Qualified object name	Optional, Positional 4
	Qualifier 1: Save file to transfer	Generic name, name, *ALL
	Qualifier 2: Library	Name, LIBL, USRLIBL, CURLIB, ALL, *ALLUSR
RSTLIB	Send to library	Name, SAVFLIB, SAVLIB	Optional, Positional 5
OMIT	Save files to omit	Single values: NONE Other values (up to 300 repetitions): Generic name, name*	Optional, Positional 6
ORDERBY	Ordering (Sequence)	Character value, 'ODOBSZ ASC,ODLBNM,ODOBNM', ARRIVAL, NONE	Optional, Positional 7
PASV	Passive Mode FTP	AUTO, ACTIVE, PASV, EPASV, NONE, NONE, NO	Optional, Positional 8
JOBQ	Submit to batch JOBQ	Single values: NONE, INTERACT, NOMAX, USRNOMAX, USRPRF Other values: Qualified object name*	Optional, Positional 9
	Qualifier 1: Submit to batch JOBQ	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
JOBLOG	Create joblog	JOBD, YES, NO, NOLIST	Optional, Positional 10

Top

Remote server or IP (RMTSYS)

Specifies the systems receiving the copy of the Save Files.

This is a required parameter.

remote or IP: Specify the remote location name (from your DNS or host table) or the IP address of the target location where the Save Files are transmitted.

Remote User (USER)

Specifies the user profile used to log onto the remote system (RMTSYS). The FTP 'user' command is sent along with the values specified for this parameter.

*CURRENT: The user profile of the user running the command is retrieved and used to log onto the remote system.
name: The specified user profile is sent to the remote system with the FTP 'user' command to log onto that remote system.

Remote Password (PWD)

Specifies the password used to log onto the remote system (RMTSYS). The FTP 'user' command is sent along with the values specified for this parameter: as follows: 'user usrprf pwd'

NOTE: The password is objscured when written to the FTP log.

*USER: The user profile specify on the USER parameter is also used as the password.
character-value: The specified FTP password for the user profile specified on the USER parameter.

Save file to transfer (SAVF)

Specifies a list of save file names (generic, full or *ALL) that are to be sent to the RMTSYS using FTP via the COZTOOLS FTPFILE command.

You can specify 300 values for this parameter.

Qualifier 1: Save file to transfer

*ALL: If the save file name is *ALL, all save files in the specified library are included in the transfer operation.
generic-name: Specify a generic name of the save files to be transferred. All save files whose names begin with the same letters as specified on this parameter are included in the transfer. Use a trailing * to indicate a generic name, for example SAVF((QGPL/ABC*))
name: Specify the name of a save file that is transferred using this command. Up to 300 qualified Save File names may be specified.

Qualifier 2: Library

*LIBL: All save files found on the library list that match the name, generic name or *ALL, are included.
*USRLIBL: All save files found on the user-portion of the library list that match the name, generic name or *ALL, are included.
*CURLIB: All save files found in the "current" library that match the name, generic name or *ALL, are included. If there is no "current" library then QGPL is used (this is the system's default methodology).
*ALL: All save files found in all libraries on the system that match the name, generic name or *ALL, are included.
*ALLUSR: All save files found in all User libraries on the system that match the name, generic name or *ALL, are included.
name: Specify the name of a library whose save files that match the save file name are to be included in the transfer.

Send to library (RSTLIB)

Specifies an alternate restore-to library name on the remote system.

*SAVFLIB or *SAVLIB: The save files are transferred to the same library name on the remote system as they appear on the local system. This is the default. NOTE: both *SAVLIB and *SAVFLIB are specified here for compatibility with system SAVxxx commands.
name: Specify the name of the library on the remote system where the Save Files are to be transferred. This library must exist on the remote system or the transfer will fail, but may still take just as long as a successful one.

Save files to omit (OMIT)

Specifies the names of Save files to be omitted from the transfer. Any save file whose name matches the pattern of the name(s) specified on this parameter are exclude from the transfer operation. The library name is not considered when omitting a save file.

Single values

*NONE: All save files are included in the transfer operation.

Other values (up to 300 repetitions)

generic-name: Specify the name (generic name or full name) of the save file(s) to be omitted from the transfer.
name: Specify the name (generic name or full name) of the save file(s) to be omitted from the transfer.

Ordering (Sequence) (ORDERBY)

Specifies sequencing in which to process the save file names. This is a standard SQL "ORDER BY" clause over the IBM Supplied CL command DSPOBJD output file QADSPOBJ. Any fields in that file may be specified. The default is to sort the list by Object Size, ascending. If you prefer a different sequence, specify it here. NOTE: all save file names (up to 300) are processed and added to a work file and then the sequencing specified on ths parameter is applied. The SQL ORDER BY keyword ASC or DESC may be specified to control the ascending or descending sequence of the key field, respectively. By default, as you probably know, ASC (ascending) is the default for any key field specified for this parameter.

'ODOBSZ ASC,ODLBNM,ODOBNM': The default sequence is by object size, library name, object name.
character-value: Specify any valid SQL ORDER BY clause. Up to 5000 characters may be specified.

Passive Mode FTP (PASV)

Specifies whether FTP Passive Mode is to be used by default. Some networks do not support Passive Mode nor do they support Extended Passive Mode. This parameter allows you to control how the FTP PASV mode is sent to the remote system. If the transfer is taking a long time and then ends without transferring any data, Passive Mode may be your issue. Try specifying PASV(*NONE) or PASV(*ACTIVE) and try the request again.

*AUTO: The FTPFILE command attempts to send a PASV or EPASV FTP command. On some systems, if that fails, it will switch to ACTIVE mode.
*ACTIVE: FTP ACTIVE Transfer Mode is used.
*PASV: FTP Passive Transfer Mode is used.
*EPASV: FTP Extended Passive Transfer Mode is used.
*NONE: FTP Passive Active Transfer Mode is used; same as PASV(*ACTIVE)