Using dynamic port allocation in a template
About this task
When you add a CICS template by using IBM® Cloud Provisioning and Management for z/OS®, you can use the z/OSMF ability to allocate ports dynamically from port ranges. Typically, a network administrator uses z/OSMF to define a range of ports for use with templates and supplies this information to the system administrator who creates the templates.
By default, when a container is provisioned, any available port is allocated from the port allocation ranges that were defined for use with a template.
However, you can control which range of ports are used for dynamic allocation by setting a usage type. Typically, the network administrator uses z/OSMF to set a usage type when they define each port allocation range for use with templates. When you use z/OS PT to create a template, you use a configuration property to specify the required usage type for a type of port. When a container that requires such a port is provisioned, any available port is allocated from the port allocation range that this usage type identifies.
- DFH_JVM_DEBUG_USAGETYPE. Sets the usage type for the port that a Java™ debugger can be connected to.
- DFH_REGION_CMCIPORT_USAGETYPE. Sets the usage type for a CMCI port (used for connection to CICS Explorer®).
- DFH_REGION_HTTP_USAGETYPE. Sets the usage type for an HTTP port.
- DFH_REGION_HTTPS_USAGETYPE. Sets the usage type for an HTTPS port.
- DFH_REGION_IPIC_USAGETYPE. Sets the usage type for an IPIC port.
- DFH_REGION_TCPIP_USAGETYPE. Sets the usage type for the CICSPlex® SM WUI port.
- Create a number of templates, where each one is configured for a different usage type. Remember that with this approach, each template requires a setup and approval process.
- Create a template that is configured for multiple usage types, then configure and build different images for the different usage types.
- Create a template that is configured for one or more usage types. Either configure and build different images for the different usage types, or configure and build different images that override the usage type. You need to specify that the relevant usage type configuration properties can be overridden in an image. See Modifying the set of CICS configuration properties that can be overridden.
The following procedure outlines how to use specific port ranges for different purposes by creating a template that is configured for multiple usage types.