DescriptionThe z/OS USS Utility plug-in automates working with USS files on the z/OS operating system. This plug-in supports working with the IBM z/OS version 2.2 and later and requires HCL Launch agent on the z/OS server.
The z/OS USS Utility plug-in automates the manipulation of files and directories. This plug-in runs on an z/OS Mainframe System supported by the HCL Launch agent.
- HCL Launch 7.1.0 and later
- HCL Launch agents on z/OS
- IBM z/OS version 1.9 or later
No special steps are required for installation. See Installing plug-ins in HCL Launch.
- Initial release
- Fixed FileNotFound exception for replace token properties file
- Removed unused log4j jar file
Replace tokens in files using properties.
|Custom Encoding||String||Specify a character encoding to use. If blank, the replacement file is created with
the local character encoding of the agent. Example encodings:
|Directory Offset||String||The directory relative to the current working directory that contains the files to
|End Token Delimiter||String||The end delimiter character used to identify tokens.||No||endDelimiter|
|Exclude Files||String||A list of patterns, separated by commas or spaces, that describe the files to exclude.
New lines will be replaced with commas.
|Explicit Tokens||String||A list, separated by newline characters, of explicit tokens to replace in the form
if you specify
|Include Files||String||A list of patterns, separated by commas or spaces, that describe the files to include. New lines will be replaced with commas.||Yes||includes|
|Property File Name||String||The name of the file used to store the replacement name-value pairs. You can use an existing file. If the file does not exist, it is created and then removed when the step completes.||No||propFile|
|Property List||String||The property used to determine the tokens to replace in the target file. For example, if you specify
|Property Prefix||String||Specify a prefix to use to determine which properties are included in token replacement. Leave blank to include all properties.||No||propertyPrefix|
|Start Token Delimiter||String||The start delimiter character used to identify tokens.||No||startDelimiter|
The z/OS USS plug-in contains the following step:
- Replace Tokens USS
You can use the Replace Tokens step to replace values in USS files:
- Explicit replacement – Use the Explicit Tokens property to specify a list of token-value pairs.
- Replacement by using a property list – Use existing property names as tokens by specifying properties in the Property List property.
- Replacement by using a property file – Use the Property File Name property to specify a file name.
When specifying a property file, the property file is modified when the step runs. Delimiters and prefixes are added to tokens that match tokens in the target files. To ensure repeatable behavior, download the property file to the agent computer each time before running the Replace Tokens USS step.
To replace tokens in multiple files, specify the file names in the Include Files property.
To access this plug-in in the palette, click Utilities > zOS USS Utility.
Click the Steps tab for details about each of the step properties.