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 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.
<?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 are identified by the sequential container type.
<?xml version="1.0" encoding="CP037"?>
<manifest type="MANIFEST_SHIPLIST">
<container name=" BLD.DATA1" type="sequential">
</container>
</manifest>
<?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>
<?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.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.
<?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>
Use generic artifacts to describe changes to deploy that are not physical files. For example, use generic artifacts to deploy system configuration changes or middleware configuration changes that are not associated with standard artifacts. Generic artifacts have the GENERIC container type.
For example, the following ship list describes two message queues to deploy to the target environment:
<?xml version="1.0" encoding="CP037"?>
<manifest type="MANIFEST_SHIPLIST">
<container name="QLOCAL" type="GENERIC" deployType="">
<resource name="LCQ1">
<property name="maxdepth" value="5000"/>
</resource>
<resource name="LCQ2">
<property name="maxdepth" value="200000"/>
</resource>
</container>
To deploy generic artifacts, use the Generate Artifact Information step from the z/OS Utility plug-in to generate commands for deploying the artifacts. Then, use an appropriate command step to run the commands. Steps that you can use to run commands include the Submit Job step, the Shell step, and the TSO/ISPF Command step. Other plug-ins can also use the output of the Generate Artifact Information step to deploy changes.