Transfer SAVF using FTP (SENDSAVF)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

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.

Top

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, *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.
Top

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.
Top

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.
Top

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.
Top

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.
Top

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.
Top

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.
Top

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)
Top
Top
Top

Examples

None
Top

Error messages

Unknown
Top