Release Notes

Universal Agent release 7.2.0.0 contains the following high-level features. For a complete list of all the included features and fixes please refer to the Universal Agent 7.2.x Maintenance list.

Data Pipeline

Backlog

Title

Description

B-14036

UFTP : Establish Connection before processing other options

Establish a connection to the (S)FTP Server before attempting the requested transfer operation. This will allow connection-specific failures to be isolated and reported.

To support this change, the following message:

UNV3707E cURL reports could not connect.

was replaced with:

UNV6955E Unable to establish an FTP server connection (curl_rc): curl_msg

where curl_rc and curl_msg are the return code and error message, respectively, that identify the problem.

In addition, UFTP now displays the entire connection conversation between it and the Server without requiring the -verbose option.

B-14630

Add support for new FTPES fields available from UC task form

Universal Agent 7.1.0.0 added FTPES support for UFTP; this adds Universal Agent support for the new Universal Controller FTPES file Transfer Task.

Sysplex Failover

Backlog	Title	Description
B-13286	Allow a Primary to be re-started and become a Secondary	Extends the AUTOMATIC_FAILOVER option to support the primary_secondary value, which will instruct a Universal Agent configured with a SYSPLEX_ROLE of primary to start as a secondary Agent if another primary Agent is already running.
B-13287	Allow a Primary to be restarted and become a Primary	Extends the AUTOMATIC_FAILOVER option to support the secondary_primary[n] value, where n is an optional numeric value that sets a priority to determine which secondary Agent (among several active secondary Agents) will take over as primary.
B-13292	A new Primary should remain a Primary	Extends the AUTOMATIC_FAILOVER option to support the always_primary value, which will force an Agent whose SYSPLEX_ROLE is primary to always start as a Primary Agent. Any other Agent running as a Primary Agent will become a Secondary Agent when this Agent starts.

UAG

Backlog	Title	Description
B-14071	Wait for process tree to complete after cancel before reporting to Universal Controller	Add the KILL_PROCESS_TREE option to control how UAG Server responds to a Cancel task command from Universal Controller. When yes, the entire process tree is terminated via SIGTERM. Any process within the tree that is still running after 10 seconds is terminated with a SIGKILL. UAG Server will confirm that all processes in the process tree are terminated before it notifies the Controller of the termination. To preserve compatibility with existing behavior, the default value for this option is no, which can prevent the termination of a process in the tree that ignores the SIGTERM signal. This may cause the task's status in the Universal Controller to show Cancelled although the (now orphaned) process continues to run. Note This new option has no effect on tasks running with sudo authority. Such tasks will not receive a SIGTERM signal and are always terminated immediately with a SIGKILL.

Universal Integration Platform

Backlog	Title	Description
B-14270	Add additional logging level to separate debug and trace level statements	Remove internal DEBUG-level messages that are generated by the Universal Extension base class when the extension task's log level is DEBUG. Only DEBUG messages issued by the extension developer should be shown.
B-14271	Add ability to launch extension tasks from UIP-CLI	Adds the following commands/options to the UIP-CLI utility: task launch - launch a Universal Extension task task status - obtain the status of a Universal Extension task task output - obtain the output generated by a Universal Extension task
B-14720	Add ability to launch extension tasks from UIP-CLI	Visual Code support for new UIP-CLI commands implemented by B-14271.
B-14544	Accept task instance variables for direct access within an extension	Make all all Task Instance variables set by the Controller for a Universal Extension task available to the Extension. An extension can access these variables via the `self.uip.task_variables` dictionary property (for example, s`elf.uip_task_variables['ops_task_id`']).
B-14724	Accept new parameters in extension launch message to signal when extension is launched as trigger	To support integration with Universal Monitor tasks, receive information from the Controller that can by used to identify an Extension task launched via a Universal Monitor Trigger. Values received from the Controller are saved in the following properties: `self.uip.trigger_id` Trigger UUID value set by the Controller that uniquely identifies the trigger instance. This will be undefined if the extension task was not launched by a Universal Monitor Trigger. `self.uip.instance_id` EXECID set by the Controller than uniquely identifies the Extension task instance. `self.uip.monitor_id` Universal Monitor UUID that uniquely identifies the Universal Monitor instance. This will be undefined if the extension task was not launched by a Universal Monitor. The Universal Extension base class sets the following property when a Trigger ID is received: `self.uip.is_triggered` If the Extension task was executed via a Universal Monitor Trigger, this property will be True. Otherwise, it is False.
B-14725	Add ability for agent to reconnect to extension task upon agent restart	Adds support for Universal Monitor tasks, including the ability to reconnect to Universal Extension tasks (executed on behalf of the Monitor task) that continue to run when an Agent is restarted.

z/OS Enhancements

Backlog	Title	Description
B-13288	Configure which systems are eligible to execute a job	Added the (mutually-exclusive) ZOS_JOB_SYSAFF and ZOS_JOB_SYSTEM configuration options that can manage a z/OS task's execution via a SYSAFF or SYSTEM JOB card parameter, respectively.

Browser not supported