Ship list files

The ship list file describes the files from the build to include in the new component version to deploy.

You must create a ship list file before you run the IBM® z/OS® deployment tools. Typically, you write a script that works with your build engine to create a ship list file from the build output. Ship list files are XML files that contain a list of file specifiers.

Partitioned data sets

Partitioned data set (PDS) members are identified by the PDS container type and the PDSmember resource type. You can use an asterisk (*) as a wildcard for the resource name, if you want all members in a partitioned data set to be included in a package.

For example, to package the BLZCPBTK member from the BLD.JCL PDS and all of the members in the BLD.LOAD1 PDS and the ORDRSET and RDBKC01 members from the BLD.LOAD2 PDS, the ship list file might contain the following lines:

<?xml version="1.0" encoding="CP037"?>
<manifest type="MANIFEST_SHIPLIST">
    <container name="BLD.JCL" type="PDS">
        <resource name="BLZCPBTK" type="PDSMember"/>
    </container>
    <container name="BLD.LOAD1" type="PDS">
        <resource name="*" type="PDSMember"/>
    </container>
    <container name="BLD.LOAD2" type="PDS">
        <resource name="ORDRSET" type="PDSMember"/>
        <resource name="RDBKC01" type="PDSMember"/>
    </container>
</manifest>

Sequential data sets

Sequential data sets are identified by the sequential container type.

For example, to package the BLD.DATA1 sequential data set, the ship list file might contain the following lines:

<?xml version="1.0" encoding="CP037"?>
<manifest type="MANIFEST_SHIPLIST">
    <container name=" BLD.DATA1" type="sequential">
    </container>
</manifest>

Deployment types

You can set the deployType attribute on containers and resources. The deployType attribute is used to identify different types of artifacts so that they can be processed differently during a deployment. The following ship list file shows deployType attributes that are added to the previous PDS example:

<?xml version="1.0" encoding="CP037"?>
<manifest type="MANIFEST_SHIPLIST">
    <container name="BLD.JCL" type="PDS" deployType="JCL">
        <resource name="BLZCPBTK" type="PDSMember"/>
    </container>
    <container name="BLD.LOAD1" type="PDS" deployType="CICS LOAD">
        <resource name="*" type="PDSMember"/>
    </container>
    <container name="BLD.LOAD2" type="PDS">
        <resource name="ORDRSET" type="PDSMember" deployType="CICS LOAD"/>
        <resource name="RDBKC01" type="PDSMember" deployType="CICS LOAD"/>
    </container>
</manifest>

Custom properties

You can add custom properties to containers and resources. The properties are displayed in the Version Artifacts view and can be used by plug-in steps. For example, properties can be used by the Generate Artifact Information step in the IBM z/OS Utility plug-in. The following ship list file shows an example of custom properties.

<?xml version="1.0" encoding="CP037"?>
<manifest type="MANIFEST_SHIPLIST">
    <container name="BLD.DBRM" type="PDS">
        <property name="COLLID" value="C001"/>
        <resource name="MOD01" type="PDSMember">
            <property name="devowner" value="Martin"/>
        </resource>
    </container>
</manifest>

To learn more about using custom properties, see "Using custom properties in deployments" in the IBM z/OS Utility plug-in documentation.

Deletions

You can mark PDS members or sequential data sets for deletion by specifying the containers inside a deleted element. Data sets that are marked for deletion are deleted from the target environment when the deployment process runs. If you use the ship list file to delete data sets, you can roll back the deletions as needed.

For example, the following ship list deploys PGM1 and PGM2 and deletes PGM3 from the target environment:

<?xml version="1.0" encoding="CP037"?>
<manifest type="MANIFEST_SHIPLIST">
    <container name="BLD.LOAD1" type="PDS">
        <resource name="PGM1" type="PDSMember"/>
        <resource name="PGM2" type="PDSMember"/>
    </container>
<deleted>
    	<container name="BLD.LOAD1" type="PDS">
        	<resource name="PGM3" type="PDSMember"/>
	</container>
</deleted>
</manifest>

Note:

The ship list file must be encoded in CP037 format.
Only one container element must be used for all members in the same partitioned data set.

Feedback