All Platforms Package Maintenance Levels - Agent 7.2.x

Overview

This page identifies the changes made in all Universal Agent 7.2.x maintenance releases, including the initial release, for all supported platforms.

Each change identifies the platform(s) for which it was made.

For a list of changes made to optional Agent 7.2.x packages, such as Universal Command Agent for SOA 6.7.x, see the platform-specific Maintenance Levels pages.

For a list of all changes in a release - all platforms, specific components - see Component Maintenance Levels.
 

Note

Install changes refer to changes to the programs, scripts, or supporting files used to install the package. There are no changes to the actual product components.

Release 7.2.0.9 - March 12, 2024

Change ID

Platforms

Component

Description

D-11900

Unix

UAGSRV

Ensure that failed attempts to launch child processes spawned by UAG Server (via the ./ubroker/sbin/cskern utility) are handled gracefully.

D-12304z/OS

UAGSRV

Improves threading support for some OpenSSL functions to prevent UAG Server unexpected terminating with an exit code 8 or an 0C4 ABEND.

Release 7.2.0.8 - February 13, 2024

Change ID

Platforms

Component

Description

D-11676

Unix
Windows

UAGSRV

Fixes an intermittent issue where UAGSRV may terminate abnormally when stopped with the Universal Control utility (UCTL). The failure is not common and was observed only when the UAG Server JTSK_NUM configuration option was set to its maximum value of 64.

D-12222z/OS

UAGRERUN
UAGU84
UAGUSI

Resolves unexpected behavior for a z/OS task, under the following conditions:

  • The z/OS task contains a Step Condition that is defined treat an ABEND as an expected result, by specifying an action of Continue/Success
  • A subsequent step in the z/OS task's JCL contains an EXEC COND= parameter that references the ABENDed step, that would normally prevent execution of the step

Prior to this fix, the EXEC COND= parameter is not honored when the ABEND occurs, and the step executes.

This fix ensures the Step Condition and the EXEC COND= configuration is honored.

D-12223WindowsUAGSRVAdds the Windows network error ERROR_UNEXP_NET_ERR (59) as a retry-able error condition for a Windows File Monitor task, when file monitor fault tolerance is enabled.

Release 7.2.0.7 - January 9, 2024

Change ID

Platforms

Component

Description

D-11555Unix
Windows
USAPResolves a performance issue when downloading a large SAP spool file.

Release 7.2.0.6 - December 12, 2023

Change ID

Platforms

Component

Description

D-11353AllUFTP
UPPS

Update the libcURL library used by Universal Agent components to 7.88.1 for Unix/Windows and 7.81.0 for zOS.

The libcURL library used for the Universal Agent for HP-UX distribution was not updated.

D-11189All

OMSSRV
UAGCMD
UAGSRV
UBROKER
UCMD
UCMSRV
UCERT
UCTL
UCTSRV
UDM
UDMSRV
UEM
UEMSRV
UFTP

Update the OpenSSL library used by Universal Agent components to 1.1.1u.

The OpenSSL library used for the Universal Agent for HP-UX distribution was not updated.

D-11889AllOMSSRV
UAGSRV
UBROKER
UCMSRV
UCTSRV
UDMSRV
UEMSRV
Changes the message digest used to sign internally-created self-signed certificates from SHA1 to SHA256 to prevent UC-OMS connection failures on newer Linux distributions.

Release 7.2.0.5 - October 31, 2023

Change ID

Platforms

Component

Description

D-11115Unix (except HP-UX)
Windows
UAGSRV
UEXT
Fixes a problem where the requires_python field of a Universal Extension fails to detect or select a suitable Python executable when comparison operators less than (<) or greater than (>) are used.
D-11174All

UCMD
UCTL
UEM
UFTP
UPPS
USAP

Prevent an error when the value of the -pwd option contains a single space (e.g., -pwd " ").
D-11342Unix
Windows
UAGSRVEnsures that any temporary files created by Universal Extension tasks are properly removed following completion of UAG Server warm start processing.
D-11458AllUAGSRVFixes a problem where UAG Server memory's consumption may gradually increase following repeated, forced reconnections to OMS Server.

Release 7.2.0.4 - July 31, 2023

Change ID

Platforms

Component

Description

D-11137WindowsUAGSRVRestore the ability for Windows file monitor tasks to correctly interpret file paths that contain a double backslash (i.e., \\).
D-11156UnixUAGSRVEnsure that all file descriptors are properly closed when a task fails because credentials were specified for a user account that does not exist.
D-11166

All

UFTP

Fixes an issue that causes UFTP to fail when multiple files are transferred to a remote directory path that contains spaces.

D-11178UnixUAGSRVFixes an issue that could result in excessive CPU consumption when UAG Server launches and/or executes several different task types concurrently.
D-11238

Unix
Windows

UFTP
UPPS
Update the libssh2 library used by Universal Agent components from 1.9.0 to 1.10.0.
D-11335WindowsUAGSRVFixes an issue that prevents successful completion of a Change file monitor instance when the file path contains double backslashes (i.e., \\) or a single forward slash (i.e., /). Prior to this fix, the task instance remains in a Running status.
D-11424z/OS

UAGU83

Fixes a problem where an ABEND within the UAGU83 SMF exit module could cause RMF to terminate with an S0C1.

Release 7.2.0.3 - April 28, 2023

Change ID

Platforms

Component

Description

D-09964UnixUAGSRVEnsure that all file descriptors are closed when an attempt to execute an Agent File Monitor task using credentials for a non-existent user is specified.
D-10316Unix (except Solaris Intel)
Windows
USAPFix an issue that requires SAP credentials to be specified when using X.509 certificate authentication. It is now possible to execute USAP using only an X.509 certificate.
D-10510z/OSUDM
UDMSRV

Eliminate all "benign" ICH408I message occurrences from the RACF log. 

These messages would sometimes appear during UDM's processing, when checking for access to resources it required. UDM would silently ignore the situation that caused these messages, using an alternate execution path. This change will ensure that UDM takes no action that could result in these messages. 

D-10727z/OSUCMDFix an issue that prevented a z/OS UCMD Manager from performing a success network fault tolerant (NFT) recovery when SystemSSL was used.
D-10897Unix
Windows
UAGSRVFix a situation in which a create or change file monitor task using a stability check may fail to detect the creation of or change to intended files.
D-10910AllUBROKERFix a memory leak that, if left unchecked, could require frequent Universal Broker restarts.
D-10934AllUBROKERFix a memory leak that could occur within the Universal Broker Memory when responding to a UAG Server configuration refresh request
D-11003z/OSUAGSRVFix a situation in which a z/OS File Monitor task could be triggered more than once for the same dataset or file
D-11059z/OSUAGSRVFix a situation in which the step that executes the UAGRERUN utility is inserted into a z/OS task's JCL at an unexpected/unsupported location
D-11084

Unix (except HP-UX)
Windows

UAGSRV
UEXT
Fix a performance issue that may occur when a Universal Extension task's output is returned via EXTENTION OUTPUT. 
D-11108Unix (except HP-UX)
Windows
UAGSRV
UEXT

Correct the spelling of a credential's passphrase when referenced by a Universal Extension task. The previous spelling pasphrase is now corrected to passphrase.

For backward compatibility, pasphrase is still accepted, but new extensions should use the correct spelling as this backward compatibility could be lost in future releases.

D-11118AllUAGSRVFix a situation in which tasks could end with a Start Failure or say in a Queued status if the Agent's hostname is longer than 62 characters.
D-11198z/OSUAGSRVFix a situation in which a password might be exposed in the Universal Agent log.
D-11212

Unix
Windows

PythonUpdate the version of Python distributed with Universal Agent from 3.7.6 to 3.7.16.

Release 7.2.0.1 - August 5, 2022

Change ID

Platforms

Component

Description

D-10715

Unix
Windows

UAGSRV

Fix a problem where File Monitor tasks do not honor a specified stable period if there are multiple file monitor instances running with the same credentials.

Note

This item may be identified in other UA releases as D-10568 or D-10705.

D-10716

All

UAGSRV

Prevent a deadlock that may occur when a CHANGE File Monitor instance detects new matching files.

Note

This item may be identified in other UA releases as D-10587 or D-10707.

D-10717WindowsUAGSRV

Ensure that Windows Powershell and batch scripts which reside in the Controller's script library and whose contents include UTF8 sequences are handled correctly by UAG Server.

Note

This item may be identified in other UA releases as D-10563.

D-10732AllUAGSRV

Prevent a CHANGE File Monitor that specifies a stable period from incorrectly generating multiple events.

Note

This item may be identified in other UA releases as D-10544 or D-10733.

D-10796

Unix (except Solaris Intel)
Windows

USAP

Prevent a failure for the Display Event History command when the timestamp exceeds 8 characters.

This item may be identified in other UA releases as D-10742 or D-10795.

D-10827

Unix (except Solaris Intel)
Windows

USAP

Prevent a failure when a model job uses a jobname of exactly 32 characters in length.

Note

This item may be identified in other UA releases as D-10730 or D-10828.

D-10849UnixUBROKER

Remove world-writable permission from the ./spool/reservedSpace file.

Note

This item may be identified in other UA releases as D-05312.
D-10852WindowsUAGSRV

Prevent a situation in which the value of the UAG Server extension_python_list option may contain unprintable characters when written to the Agent log file.

Note

This item may be identified in other UA releases as D-10783.

Release 7.2.0.0 - April 1, 2022

B-13286z/OSUAGSRV

Extend 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.

Note

The AUTOMATIC_FAILOVER option continues to support a default value of never, which will disable automatic failover and will require failovers to be managed manually via a Universal Broker MODIFY command. 

B-13287z/OSUAGSRV

Extend 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.

Note

The AUTOMATIC_FAILOVER option continues to support a default value of never, which will disable automatic failover and will require failovers to be managed manually via a Universal Broker MODIFY command. 

B-13288z/OSUAGSRVAdded the (mutually-exclusive) ZOS_JOB_SYSAFF and ZOS_JOB_SYSTEM configuration options that can manage a zOS task's execution via a SYSAFF or SYSTEM JOB card parameter, respectively.
B-13292z/OSUAGSRV

Extend 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.

Note

The AUTOMATIC_FAILOVER option continues to support a default value of never, which will disable automatic failover and will require failovers to be managed manually via a Universal Broker MODIFY command. 

B-14036AllUFTP

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-14071

Unix

UAGSRV

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. 

B-14270

Unix
Windows

UEXT

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.

Note

The HP-UX and z/OS Agents do not provide the Universal Extension. 

B-14271

Unix
Windows

UEXT

Add 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


Note

The HP-UX and z/OS agents do not provide the Universal Extension. 

B-14544

Unix
Windows

UEXT

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 (e.g., self.uip_task_variables['ops_task_id']).

Note

The HP-UX and z/OS agents do not provide the Universal Extension. 

B-14630

Unix
Windows

UAGSRV
UFTP

Add the ability to retrieve values from the Universal Controller File Transfer Task form that support transfers using explicit FTPS (that is, FTP with SSL). 

Note

Explicit FTPS (FTPES) support was added to the Agent in the 7.1.0.0 release with B-10691. The change delivered in Universal Agent 7.2.0.0 provides full support and integration with the File Transfer Task.

B-14720WindowsUEXT

Add Visual Studio Code Plugin support for the UIP-CLI task commands provided by B-14271 (see above).

Note

The HP-UX and z/OS agents do not provide the Universal Extension. 

B-14724

Unix
Windows

UEXT

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 - the 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 - the EXECID set by the Controller than uniquely identifies the Extension task instance
  • self.uip.monitor_id - the 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.


Note

The HP-UX and z/OS agents do not provide the Universal Extension. 

B-14725

Unix
Windows

UAGSRV
UEXT

Add full 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.

Note

The HP-UX and z/OS agents do not provide the Universal Extension. 

D-10379WindowsUAGSRVFix an issue where a File Monitor task running on a Windows Agent fails to recognize Unicode characters.
D-10417

z/OS

UAGSRVFix an issue that prevents a z/OS Agent using IBM System SSL (that is, RACF-based keyrings) from connecting to an OMS Server.
D-10430

Unix
Windows

UAGSRVWhen an SAP task instance is cancelled, ensure that the associated Universal Connector for SAP (USAP) process is cancelled as well.
D-10523

Unix
Windows

UDM
UDMSRV

Prevent an authentication error for a File Transfer task when the following conditions exist:

  • File Transfer task uses Universal Data Mover (UDM)

  • UDM script is used by the task

  • UDM script issues the exec or execsap command

  • exec or execsap command uses the pwd parameter
  • One of the built-in credential variables – $(ops_primary_cred_pwd) or $(ops_secondary_cred_pwd) -- is used for the pwd parameter's value

For example:

UDM Script Statements
open src=local dst=rmthost.ipaddr user=$(ops_secondary_cred_user) pwd=$(ops_secondary_cred_pwd)
exec src cmd="dir" user=$(ops_primary_cred_user) pwd=$(ops_primary_cred_pwd)

Starting with UA 7.0.0.0, this will cause the resolved $(ops_primary_cred_pwd) value in the exec statement to be enclosed in double quotes ("). The double quotes are retained when passed to UCMD Manager (or USAP for an execsap statement). The double quotes will prevent successful password authentication.

D-10530UnixUBROKERWhen the Universal Broker daemon encounters an EPIPE when attempting to log a message to unv.log, close the existing log file and resume logging to a new file.
D-10531z/OS

UDM
UDMSRV

Fix an issue where an attempt to transfer PDS members from z/OS using UDM may result in an S0C4 ABEND.

When this occurs, the following error is reported:

CEE3204S The system detected a protection exception (System Completion Code=0C4).
From entry point UPdsRead at compile unit offset +00000398 at entry offset +00000398 at address 0A5B5030.

Note

This problem was introduced by D-08997, delivered in UA 7.1.0.0.

D-10534

Unix
Windows

UAGSRV
UEXT

UAG Server may crash when a Universal Extension task references a credential token greater than 3000 characters in length.

Note

The HP-UX and z/OS agents do not provide the Universal Extension. 

D-10556z/OSUAGSRV

Fix an issue that prevented a file monitor task from locating datasets when a wildcard is used as the first character in the dataset pattern.

This restores behavior that existed prior to Universal Agent 7.0.0.0.

D-10559

Unix
Windows

UAGSRV

Fix an issue introduced in UA 7.1.0.0, where a Universal Task fails to properly resolve resolvable credentials when the credential variable is enclosed in double quotes.

D-10567

Unix
Windows

OMSSRVWhen OMS Server's AUTHENTICATE_PEER option is no, fix an issue that will cause OMS to accept an SSL connection when no client certificate is presented, even when an OMS_ACCESS UACL rule exists to reject such connections.
D-10676AllUFTPEnsures that UFTP will not crash when used to transfer a comma-separated list of files from z/OS using the MGET command.
D-10687z/OSUAGSRV

When running a File Transfer Task via a z/OS Agent, if the Local and/or Remote Filename values exceeded 72 characters, UAG Server failed to properly format the SYSIN DD statement in the JCL used to execute UFTP.

The z/OS Agent now ensures that such values are properly terminated at column 72 and continued to the next line.