All Platforms Package Maintenance Levels - Agent 7.7.x

All Platforms Package Maintenance Levels - Agent 7.7.x

Overview

This page identifies the changes made in all Universal Agent 7.7.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.7.x packages, such as Universal Command Agent for SOA 7.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.7.1.8 - July 8, 2025

Change IdPlatformComponentDescription
B-21393WindowsAllCertify support for Windows Server 2025.
D-09780Unix
Windows
z/OS
UBROKERPrevents a Universal Broker crash following successful Manager Fault Tolerant (MFT) recovery of a UCMD Manager task. In this situation, recovery processing was successful. The crash occurred as the Broker cleaned up tracking records stored in its BerkeleyDB database files.
D-13549WindowsUAGSRVFixes a problem in which the Universal Agent for Windows process could crash at startup during Universal Extension task initialization. Specifically, the issue occurred within the Agent's Python discovery processing.
D-13578z/OSUAGSRV

Ensure that the UAG Server's configured CODE_PAGE is honored during OMS message processing.

Specifically, this fix addresses a problem with z/OS Task parameter translation when the z/OS system environment is configured to use a codepage other than IBM1047 (UAG Server's default codepage). The problem applies to the following situation:

  • The z/OS Task defines one or more task parameters
  • UAG Server uses the parameter(s) to construct a SET statement for insertion into the task's JCL
  • A parameter's name or value contains a character whose IBM1047 encoding is different from the encoding used by the z/OS system's configured codepage (e.g., IBM1141)

Prior to this fix, the parameter's name and value would always be translated from UTF8 to IBM1047, even if the UAG Server's configured codepage were set to something other than IBM1047. 

With this fix, UAG Server will now honor its configured codepage and translate the parameter name and value accordingly. The default is still IBM1047.

Note that a similar defect, D-13592, is provided for this release that fixes translation of parameters used for JCL variable substitution. These are parameters whose names start with *@.


Possibility of Breaking Change

Exercise care before doing the SMP/E ACCEPT of this PTF. If any work-arounds exist that rely on a task parameter's name or value always being translated as IBM1047, they will no longer work if the CODE_PAGE option is set in UAGCFG00 to something other than IBM1047.

For example, the at symbol ('@') has a UTF8 encoding of 0x0040. Its IBM1047 encoding is 0x7C. Its IBM1141 encoding is 0xB5. Prior to this fix, it the z/OS system's configured codepage were IBM1141, the '@' symbol in a task parameter name or value had to be replaced with a section sign ('§'). This would force the UTF8-to-IBM1047 translation to produce an encoding of 0xB5. When viewing the SET statement that UAG Server adds to the task's JCL, the value would be shown as '@' as expected.

With this change, you can now set the CODE_PAGE option in UAGCFG00 to IBM1141 and use the '@' symbol in the task parameter. The work-around described above is no longer needed.

If you choose to leave such work-arounds in place, simply make sure the UAG Server's CODE_PAGE option in UAGCFG00 is undefined or set to IBM1047.

If all of your task parameter names and values are inserted into the JCL's SET statements correctly today (that is, without any work-arounds), then you do not need to do anything after applying this fix. Everything will continue to work as it does today.

D-13589

Unix (Solaris only)

INSTALLFixes a problem with Universal Agent upgrades on Solaris that could cause Universal Extension tasks to fail. The failures only occur if the Universal Extension API changed between your installed version and the upgraded version. The fix provided in this maintenance will ensure that existing Universal Extension tasks execute successfully following the upgrade.
D-13592z/OSUAGSRV

Ensure that the UAG Server's configured CODE_PAGE is honored during OMS message processing.

Specifically, this fix addresses a problem with z/OS Task parameter translation when the z/OS system environment is configured to use a codepage other than IBM1047 (UAG Server's default codepage). The problem applies to the following situation:

  • The z/OS Task defines one or more task parameters that start with *@
  • UAG Server uses these parameters to perform variable substitution in the z/OS task's JCL
  • The z/OS environment is configured to use a codepage that uses an EBCDIC encoding for the '@' symbol that is not the same as IBM1047 (0x7C). Of the codepages provided by the Universal Agent install, the following use a different encoding for the '@' symbol:
    • IBM1141, IBM1144, IBM273, IBM280 (0xB5)
    • IBM1142, IBM277 (0x80)
    • IBM1143, IBM278 (0xEC)
    • IMB1147 (0x44)

If your z/OS system's codepage is configured with one of the above codepages, this fix will provide the ability to retain the '@' symbol in the task parameter definition and your z/OS task's JCL.

Prior to this fix, the parameter would always be translated from UTF8 to IBM1047, even if the UAG Server's configured codepage were set to something other than IBM1047. 

With this fix, UAG Server will now honor its configured codepage and translate the '@' symbol correctly. The default is still IBM1047.

Note that a similar defect, D-13578, is provided for this release that fixes translation of parameters used for JCL SET statements.


Possibility of Breaking Change

Exercise care before doing the SMP/E ACCEPT of this PTF. If any work-arounds exist in your JCL to replace the '@' variable with a symbol that will match the IBM1047 encoding for '@' AND the CODE_PAGE option is set in your UAGCFG00 to something other than IBM1047, the work-around will no longer work.

For example, the at symbol ('@') has a UTF8 encoding of 0x0040. Its IBM1047 encoding is 0x7C. Its IBM1141 encoding is 0xB5. Prior to this fix, it the z/OS system's configured codepage were IBM1141, the '@' symbol could not be used in your JCL. The '@' had to be replaced with a section sign ('§') This would force the UTF8-to-IBM1047 translation to produce an encoding of 0xB5, which allowed UAG Server to find the variables in the JCL and replace them with the values of the task's parameters.

With this change, you can now set the CODE_PAGE option in UAGCFG00 to IBM1141 and use the '@' symbol in your JCL (assuming your z/OS system's codepage is IBM1141). The work-around described above is no longer needed. This is true for any of the codepages listed above, provided the configured CODE_PAGE in UAGCFG00 matches the codepage set for your z/OS environment.

If you choose to leave such work-arounds in place, simply make sure the UAG Server's CODE_PAGE option in UAGCFG00 is undefined or set to IBM1047.

If all of the variables in your z/OS task's JCL start with '@' and are translated correctly today (that is, without any work-arounds), then you do not need to do anything after applying this fix. Everything will continue to work as it does today.

Release 7.7.1.7 - June 10, 2025

Change IdPlatformComponentDescription
D-12968WindowsUAGSRVFixes a memory leak observed when running several Agent File Monitor tasks over an extended period of time.
D-13442

z/OS

UAGSRVFixes a problem where UAG Server may insert SET statements into existing JCL ahead of an existing EXPORT SYMLIST statements. This change ensures the EXPORT SYMLIST statement will precede SET statements.
D-13463Unix
Windows
UAGSRVFixes a problem where a Universal Extension Task that defines a field with a percent sign (%) in its value may be misinterpreted by UAG Server, causing it to crash.

Release 7.7.1.6 - May 13, 2025

Change IdPlatformComponentDescription
D-11317UnixUAGSRVImproves trace file messaging for an Agent File Monitor task that executes on a Linux/Unix Agent. Messages are now consistent with those written for Agent File Monitor tasks that execute on Windows Agents.
D-12016

Unix
Windows
z/OS

UCMD
UCMSRV
UDM
UDMSRV
UFTP
Library dependencies updated due to vulnerabilities.
D-12785AllAllImprove data security by making sure all references to sensitive data are cleared before the memory holding that data is freed.

Note that no memory was leaked nor was any sensitive data exposed prior to this change. This change applies to the way in which the Universal Agent applications are built. Some compilers may "skip" a call to clear memory in situations where that that memory is immediately freed in the next statement. This is an undesirable optimization, and this change prevents the call to clear the memory from being skipped.
D-12805UnixUEM
UEMSRV
Fixes a problem where UEM tries to monitor a symbolic link on a Linux system that resides in a world-writeable directory.
D-13270AllUAGSRVFixes a problem where a Universal Broker started with the command line option -dest stderr failed to honor the UAGLOGLVL environment variable.
D-13397Unix (Linux Intel only)INSTALL

A Universal Agent install or upgrade on Linux Intel (the RPM or Debian package) would replace file permissions for the /etc/universal/uai_log4jConfiguration.xml file, which is used by the Universal Agent for SOA. This change preserves that file's permissions.

This issue only affects users of the Universal Agent for SOA product.

D-13418UnixUDM
UDMSRV
Add support for the rdw session attribute for UDM sessions that execute on Linux/Unix.

This change allows users to inform UDM that a file transferred from Linux/Unix to z/OS contains RDW that can either be discarded or retained on a transfer to z/OS. This attribute was previously available on Windows and z/OS only.

Release 7.7.1.5 - April 8, 2025

Change IdPlatformComponentDescription
D-01220AllUBROKEREnsure that the function responsible for removing records from the Universal Event Subsystem (UES) database processes always processes 1000 records with each iteration. Previously, the function always deleted the first 1000 records, causing the removal of subsequent records to be delayed.
D-13120WindowsUDM
UDMSRV
Fix broken UTF-8 support in UDM for Windows 2016 and below.
D-13141z/OSUDM
UDMSRV

Provides a new z/OS-specific UDM script attribute "lbi" to enable or disable the Large Block Interface (LBI) for transfers to prevent the corruption of datasets with RECFM=U.

Previously, LBI support was enabled for all transfers, but this caused records shorter than the dataset's block size to be padded with 0x0 characters, which corrupted the output dataset. This change disables LBI by default, and makes it possible to re-enable it with lbi=yes.

D-13177Unix
Windows
USAPFixes an issue that caused USAP XBP 2.0 API calls to fail when the MAX_XBP configuration option was set to 2.0 and only XBP 2.0 was available on the SAP system. 
D-13285z/OSUAGSRVPrevents JCL SET from statements from being removed and re-added upon subsequent reruns of a failed z/OS task.

Release 7.7.1.4 - March 11, 2025

Change IDPlatformsComponentDescription
D-11743z/OS

UAGSRV

Update the UAGRERUN utility to improve detection of changes to base GDG names and to relative and absolute GDG dataset names. This change should fix an issue where UAG may not request confirmation of JCL changes as expected.

D-12641z/OSUAGSRVEnsure JCL SET statements are written to the JCL immediately following the JOB card and any JCL comments that directly follow the JOB card.
D-13043z/OSUAGSRVEnsure that a z/OS Agent Change File Monitor task correctly detects file (or dataset) creation on a Secondary agent when "Trigger on Create" is set in the file monitor task.
D-13209z/OS

UDM
UDMSRV

Fixes a problem that prevented UDM from correctly obtaining allocation attributes for an input GDG dataset specified using a relative name (i.e., with the generation number in parentheses). That information is now available as the default allocation attributes for the target dataset.

Release 7.7.1.3 - February 11, 2025

Change IDPlatformsComponentDescription
D-12474AllUSAPFixed issue where EXTERNAL_STEP or EXTERNAL_COMMAND statements were not allowed to come directly after a temporary variant content statement in a USAP job definition file.
D-13128Unix (except HP-UX)
Windows

UEXT

Eliminates the "Exception while exporting metrics..." message that appears in a Universal Extension task's stderr when OTEL_EXPORT_METRICS is disabled. By design, no metrics should be exported when OTEL_EXPORT_METRICS is set to NO.

Release 7.7.1.2 - January 14, 2025

Change IDPlatformsComponentDescription
D-06689z/OSUAGSRVFixes a situation in which UAG Server could incorrectly interpret instream packed binary data passed via SYSIN to an executing program, causing a z/OS task to fail.
D-09345z/OS

UDM
UDMSRV

Improve detection and resolution of conflicts between source and target dataset's dsorg and dsntype allocation attributes.











Specifically fixes an issue copying a PDS member to a sequential dataset when only the DSORG=PS attribute is specified.

Release 7.7.1.1 - December 10, 2024

Change IDPlatformsComponentDescription
D-12351z/OSUCMSRV

Provide a fix to guarantee unique EMCS names within a sysplex.

Note

Fix to UCMSRV is provided via UCMSPCST, whose version is updated to 7.7.1.1 for this delivery.

D-12863z/OSUAGSRV

Ensure that JCL errors encountered when a z/OS task is rerun do not allow the task to finish with a status of SUCCESS.

D-13034Unix (except HP-UX)
Windows

UEXT

Ensure that binaries bundled with an extension (using the zip_safe=false option) retain the necessary execute permissions when unbundled by the Agent.

D-13056

Windows

UAGSRV

Fixes a regression introduced in Universal Agent 7.5.0.0, which causes Windows task execution to fail if the "Interact with Desktop" is selected from the task form.

Release 7.7.1.0 - November 12, 2024

Change IDPlatformsComponentDescription
B-20664IBMiUAGSRVProvide Universal Agent support for the SBMJOB command type added to IBM i tasks for the UC 7.7.1.0 release.
B-21193IBMiUAGSRV

Provides support for a configurable UAG Server END SEVERITY option that is applied to tasks launched on the IBM i platform.

Also provides support for an End Severity value which was added to the Controller's IBM i Task form for the UC 7.7.1.0 release. When specified, the task instance's value overrides the configured UAG  Server value.

B-21212

z/OS

UAGSRV

Provide sysplex support for the z/OS External Monitor task.

B-21229Unix (Linux only)
Windows

UPPS

Expands Application Fault Tolerant behavior by enhancing the UPPS configuration option, APPL_RETRY_MSG_IDS. The option now provides the ability to select specific message sets and status codes which should cause interrupted Web service calls to be retried.
D-11405z/OS

USAP

Fixes the situation in which a job name longer than 14 characters may result in an error message stating that the variant "exceeds maximum allowed size of 14 bytes".

D-12841

z/OS

UDM
UDMSRV
Allow multiple sessions to be created from a single UDM script when SystemSSL is used.
D-12826AllUAGSRVFixes a situation in which UAG Server may not receive OMS messages, causing submitted tasks to stay in a Queued state, although the Universal Agent is still successfully sending heartbeat messages to the Controller.
D-12913

Unix
Windows

UEXT

Fixes a situation in which a Universal Extension Task fails to reconnect to a Universal Agent following an Agent restart.

D-12938Unix
Windows
UAGSRVFixes a problem where an Agent File Monitor task fails to detect files larger than 20 GB when a minimum file size is specified.
D-12946Unix
Windows
OMSSRVFixes a problem in which force finishing an Agent task may result in subsequent tasks to stay in Queued state.
D-12991IBMiPKGUpdated the UCHGRLS program to all tagging and un-tagging for Universal Agent version 5.1.1.
D-13071IBMiUSMBJOBEnsure that USMBMJOB can handle multiple libraries in the INLIBL option.

Release 7.7.0.0 - October 1, 2024

Change IDPlatformsComponentDescription
B-06499z/OS

UAGSRV
UAGU84
UAGUTIL

Provide the ability to monitor IBM z/OS jobs executed outside of the Universal Controller.

The Universal Controller 7.7.0.0 release provides a new z/OS Monitor task type and associated z/OS Monitor Trigger that can report the status of these jobs and direct additional work based on the monitor's completion.

B-18369
B-18547
IBMi

UAGSRV
UBROKER
UEXT

Enable Universal Controller integration with the Universal Agent for IBMi and support execution of native IBMi tasks and Universal Extension tasks.

NOTE: This delivery does not contain updated Universal Command and Universal Data Mover support. If you still require those components, you will need a Universal Agent for IBMi 5.1.1 install to run alongside a 7.7.0.0 install. Updated Universal Command and Universal Data Move support will be available in an upcoming release.

B-18371All (except HP-UX)

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

Upgrade the OpenSSL library that Universal Agent uses to OpenSSL 3.0.14.
B-19912z/OS

UAGSRV
UAGWMDBX

Provide the ability to access to Write-to-Operator (WTO) messages issued to different address spaces.

D-11270z/OSUAGSRVProvide message UAG5656E Dataset <dsname> specified for <jcl_save_library> cannot be found to make UAG Server start failures that occur due to missing JCL_SAVE_LIBRARY datasets more clear.
D-11460

Unix
Windows

UAGSRVImprove Agent warm start behavior in low memory environments to allow more task statuses to be recovered and accurately reported.
D-11554Unix (except HP-UX)PYTHON

Exclude the nis module from the Universal Agent's Python distribution on Linux.

The nis module is a thin wrapper around the NIS library, which is only available on Unix systems (not Linux).

Attempts to import the nis module from a script that executes with the Universal Agent Python distribution on Linux will issue the following error: ModuleNotFoundError: No module named 'nis'

The module will import successfully on AIX and Solaris with the following warning: <stdin>:1: DeprecationWarning: 'nis' is deprecated and slated for removal in Python 3.13

D-11867Unix (except HP-UX)
Windows
UAGSRVEnsure that all temporary Universal Extension files are removed following cancellation of a Universal Extension task.
D-11929z/OSUAGSRV

Provide a new UAG Server configuration option, RERUN_BEFORE_INCLUDE, which is defined in UAGCFG00. This option controls whether a JCL INCLUDE statement should trigger the insertion of the UAGRERUN step.

Valid values and their meaning are as follows:

  • no -- a JCL INCLUDE statement will not trigger insertion of a UAGRERUN step. This is the default, which matches the behavior in previous versions.
  • yes – a UAGRERUN step is inserted ahead of a JCL INCLUDE statement.
D-12020Unix
Windows
z/OS
UDM
UDMSRV
Expands support for files whose names contain multibyte (i.e., Unicode) characters.
D-12265WindowsINSTALLSuppress all message boxes and dialogs when the user mode install is run in SILENT mode.
D-12303WindowsUAGSRV

Fixes a problem that causes Agent File Monitors running on Windows to fail when user credentials contain Unicode characters.

D-12314

Unix
Windows

UDMFixes a possible password exposure when a File Transfer Task using a UDM script echoes the $(ops_primary_cred_pwd) value when specified for an exec statement. Prior to the fix, the value was not scrubbed from the task output. This fix provides proper scrubbing for this value.
D-12493z/OSUAGCMDFail correctly when the -q or -t option is specified for UAGCMD on a platform that does not yet support TLS 1.3.
D-12505z/OSUAGSRV

Adds the following messages to provide better information when the UNVJSC cluster dataset is not found or fails to open:

  • UAG5656 - Dataset jscds must be a VSAM cluster, where jscds is the name of the UNVJSC dataset
  • UAG5657 - Dataset jscds could not be opened, where jscds is the name of the UNVJSC dataset
D-12506z/OSUAGRERUN

Improve error messaging when UAGRERUN executes on a system that does not have UAG Server. For example, when z/OS Workload Manager routes a job to a non-Agent system within a Sysplex, include a clear description of the error and the system on which UAGRERUN ran.

D-12543z/OSUAGRERUNEnsures that unexpired archived datasets are deleted by UAGRERUN's cleanup logic.
D-12548Unix (except HP-UX, Solaris)
Windows
UAGSRVProvides a change that causes UAG Server and OMS Server activity spans for PeopleSoft task instances to remain associated with the Universal Controller's parent trace grouping.
D-12564z/OSUAGSRVFix the value reported for the MIN_SSL_PROTOCOL option in the UNVAUDIT report.
D-12570

Unix
Windows

UAGSRV
USAP
Expands support for multi-byte (i.e., Unicode) values specified in SAP tasks. This change ensures that Unicode values in job definition scripts or SAP task definitions are correctly passed to and received from the SAP system.
D-12573WindowsUIP-CLI
UIP-VSCODE
Ensure that UIP-CLI exits with a non-zero value upon failure.
D-12576z/OSUAGSRVRelax validation for UAG Server's AGENT_IP configuration option on z/OS to accept VIPA addresses.
D-12599Unix (except HP-UX)
Windows
PYTHONUpdate Universal Agent's Python distribution to 3.11.9 to address outstanding CVEs.
D-12633Unix
Windows
UBROKERManage uems.db growth by removing information for an event occurrence upon completion.
D-12638z/OSUAGSRVWhen all steps selected for rerun FLUSH, ensure the task instance for that rerun ends with a Failed status.
D-12652z/OSUAGSRVDo not require a value for the CA_CERTIFICATES configuration option when SystemSSL is used and the Agent requests OMS Server authentication.
D-12659Unix
Windows
UAGSRVPrevent an unnecessary UTF-8 conversion for UDM task output.
D-12670Unix
Windows
z/OS
UDMFixes a possible password exposure in a trace file when UDM executes on systems whose locale is not UTF-8. 
D-12721

Unix (except HP-UX)
Windows

UEXT

Address reported CVEs by providing the following updates:

  • Update the Python modules installed to the ./uagsrv/uext/_3pp/public directory to the versions indicated:
    • certifi == 2024.06.02
    • charset_normalizer == 3.3.2
    • googleapis_common_protos == 1.63.2
    • idna == 3.7
    • protobuf == 4.25.3
    • requests == 2.32.3
    • typing_extensions == 4.12.2
    • urllib3 == 1.26.19
    • wrapt == 1.16.0
    • zipp == 3.19.2
  • Update the PyYAML Python module installed to the ./uagsrv/uext/_3pp/internal/yaml27 directory to 5.4.1
  • Update the PyYAML Python module installed to the ./uagsrv/uext/_3pp/internal/yaml39 directory to 5.4.1
D-12864Unix (except HP-UX)
Windows
PYTHON

Update external modules (and their dependencies) provided by the Universal Agent Python distribution to address any CVEs reported for those modules.

  • A list of external modules provided for Unix installations may be found here.
  • A list of external modules provided for Windows installations may be found here.
E-02039AllAllMiscellaneous fixes to improve Universal Agent stability and reliability.