The task is used to store a single text or binary file on a z/VM^® system via FTP.

Attributes

The task supports Build Extensions Debugging Attributes and Build Extensions General Attributes, as well as, its own task specific attributes. Click on a link for more information on the common attributes.

The following table describes the task specific attributes for the task:

Task Specific Attributes
Attribute	Description	Required
binaryFile	If `true`, a binary transfer is performed. If `false` (the default), a text transfer is performed.	No
deleteFile	If `true`, the local file is deleted after the file is successfully transferred. If `false` (the default), the local file is not deleted.	No
file	The fully qualified path to the local file to transfer.	Yes
zosCodePage	Specifies the name of the z/VM FTP code page to use when storing the file. If a code page is not specified, the default code page is used. The default code page is locally defined on the specified z/VM system.	No
zosDataset	Specifies the z/VM VDEV (virtual device address) for the disk where the file will be stored. This VDEV is associated with the specified zvmUser. An MDISK or LINK directory statement for the VDEV is required in the zvmUser’s directory entry. The zvmUser must have write access to the specified disk.	Yes
zvmFilename	Specifies the z/VM file name.	Yes
zvmFiletype	Specifies the z/VM file type.	Yes
zvmHost	Specifies the URL of the z/VM host.	Yes
zvmPassword	Specifies the encrypted password to use when logging onto the z/VM system.	Yes
zvmUser	Specifies the user ID for authentication to the z/VM system.	Yes

Notes

Encrypted passwords can be generated by the zVMPassword task or by the zImportGetPassword Java application. To generate an encrypted password with the zVMPassword task refer to the zVMPassword Task Reference. To generate an encrypted password with the zImportGetPassword Java application, issue the following command from a Windows command prompt window:
```
java -classpath path_to_jar\com.ibm.team.enterprise.smpe.build.scmutilities.jar
  com.ibm.team.enterprise.smpe.toolkit.internal.zimport.util.zImportGetPassword pw
        
```
substituting "path_to_jar" with the actual path to the jar file, "pw" with the actual password, and substituting the jar bundle version (_1.0.0.v20161214_0308) with the one in the version of the toolkit you installed. You will need to navigate to the jar in your file system to get the actual jar name.

Examples

Store a file:

<?xml version="1.0" encoding="UTF-8"?>
<project name="zVMStore" default="main" xmlns:es="antlib:com.ibm.team.enterprise.smpe.toolkit">
    
    <target name="main" description="main">
        <es:zVMStore
            file="C:\zvmstore.txt"
            zvmDisk="191"
            zvmFilename="ZVMSTORE"
            zvmFiletype="TXT"
            zvmHost="stlvm1.svl.ibm.com"
            zvmPassword="-5e993fc4f3b23dd11502775ded3804a0"
            zvmUser="DJREILLY"
        />
    </target>
    
</project>

getTaskNameHdr()

Attributes

Notes

Examples