Component Maintenance Levels - Agent 7.6.x

Owned by Stonebranch (Deactivated)
Last updated: Oct 10, 2024
10 min read

Introduction

This page summarizes the changes introduced in each component maintenance release for Universal Agent 7.6.x.

For a list of all component changes included in the maintenance release for each platform, see:

All Components

Release 7.6.0.1 - May 14, 2024

Change IDPlatformsComponentDescription
E-02039AllAllMiscellaneous fixes to improve Universal Agent stability and reliability.

Universal Agent Server

Release 7.6.0.5 - October 8, 2024

Change IDPlatformsComponentDescription
D-12303WindowsUAGSRV

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

D-12576z/OSUAGSRVRelax validation for UAG Server's AGENT_IP configuration option on z/OS to accept VIPA addresses.
D-12652z/OSUAGSRVDo not require a value for the CA_CERTIFICATES configuration option when SystemSSL is used and the Agent requests OMS Server authentication.

Release 7.6.0.4 - September 10, 2024

Change IDPlatformsComponentDescription
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-12564z/OSUAGSRVFix the value reported for the MIN_SSL_PROTOCOL option in the UNVAUDIT report.
D-12659Unix
Windows		UAGSRVPrevent an unnecessary UTF-8 conversion for UDM task output.

Release 7.6.0.3 - July 9, 2024

Change IDPlatformsComponentDescription
D-12638z/OSUAGSRVWhen all steps selected for rerun FLUSH, ensure the task instance for that rerun ends with a Failed status.

Release 7.6.0.2 - June 11, 2024

Change IDPlatformsComponentDescription
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-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-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-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.

Release 7.6.0.1 - May 14, 2024

Change IDPlatformsComponentDescription
D-11270z/OSUAGSRV
UAGMCENG		Provide 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-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-12559All (except HP-UX)

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

Update the OpenSSL library that Universal Agent uses to OpenSSL 1.1.1w.


Release 7.6.0.0 - April 3, 2024

Change ID

Platforms

Component

Description

B-09236z/OSUAGSRV

Enhance options used to override a CA-7 Schedule ID with the following changes:

  • Support lists and ranges of Schedule IDs with the #JI statement (e.g., #JI,ID=(1,3,5-8,12)).
  • Accept #XI, #XO, and #XEND statements as synonyms for the #JI, #JO, and #JEND statements already supported by UAG Server
B-15814z/OS

UAGSRV
UAGUTIL

Provides a local data store that holds job history that can be used manually rerun jobs originally executed by UAG Server.

Note that any job rerun in this manner is not monitored or tracked by the z/OS Universal Agent or Universal Controller.

This feature adds the UAG Server configuration options HISTORY_DATASET and HISTORY_RETENTION. A new installation job, UNVIN12, is provided to create and configure this new feature.

See the UAGRERUN Stand Alone Execution section in the Universal Agent User Guide for complete details.

B-16983

Unix (except HP-UX)
Windows

UAGSRV
UEXT

Add the ability to resolve the following Controller functions when embedded in text and array fields of a Universal Extension:

  • Credential functions
  • Script functions
  • SAP Connection functions
  • Database Connection functions
  • Task Instance/Sibling Task Instance Output Path
  • Variable Path functions

Note

This is a companion item to the Universal Controller enhancement B-16984.

B-17780z/OSUAGSRV
UAGRERUN

Add support for z/OS tasks whose JCL contains a JES2 /*ROUTE PRINT statement, to ensure proper output processing.

Prior to this change, output could be routed to another system before UAG Server had a chance to process it.

When UAG Server encounters this statement, it will use its JES_SYSOUT_CLASS configuration parameter to manage output processing and routing.

B-17891Unix (except HP-UX and Solaris)
Windows

UAGSRV
UBROKER
UFTP

Add end-to-end OpenTelemetry tracing support to UFTP when run from a File Transfer or Remote File Monitor task. Tracing support is also available for stand-alone UFTP execution.

B-17927z/OS

UAGSRV
UAGRERUN

Provides support for the JCL RD keyword on the JOB and EXEC statements. When RD=NR or RD=NC is specified, the Agent will mark the affected step is marked as non-restartable.

Note

To disable this behavior, use the new UAGRERUN parameter NORDNR.

To disable this behavior for all z/OS tasks, use the new RERUN_OPTIONS option in the UAG Server configuration member, UAGCFG00.

B-18417z/OSUAGRERUN

Update UAGRERUN behavior so that it deletes datasets prior to a run or rerun of a job, including those datasets whose expiration date has not passed.

Prior to this change, unexpired datasets were not deleted by UAGRERUN's dataset cleanup processing.

B-18578All

OMS
UAGSRV

Update the Agent to rely on a dynamically-generated key to decrypt sensitive information obtained from the Controller.


Note

This change deprecates the Universal Agent's AUTHVER configuration option.

The option, if configured, will still be recognized by UAG Server, but will no longer be honored.

B-18723z/OSUAGUTIL

Provides an optional installation job, UNVIN14, that can be used to assist Agent configuration. This new job will automatically generate the EXIT ADD statements that should be added to a SYS1.PARMLIB PROGxx member to ensure SMF exits used by the Agent are configured correctly.

UNVINV14 uses the SYS1.PARMLIB SMFPRMxx as input and generates a list of missing exit point definitions and/or SMF record types.

B-18730Unix (except HP-UX)
Windows

UAGSRV
UEXT

Provides a change to the Universal Extension Event API to support arrays (Python list) as attribute values.

D-10536z/OSUAGSRV

When the Universal Agent AGENT_IP configuration option specifies an IP address instead of a host name, eliminate the UNV0182E 'Cannot resolve' error, and accept the IP address as entered.

D-11139Unix (except HP-UX)
Windows		UAGSRV

The extensions directory, located in the DATA_DIRECTORY path option for UAG Server, will now be created automatically when a non-default value is set for this option.

Prior to this change, Universal Task instances would stay in an Undeliverable status until directory was created.

D-11383AllUAGSRV

Fixes a UAG Server crash that may occur when multiple Remote File Monitor instances finish at the same moment as a new instance is starting.

D-11431z/OSUAGSRV

Always insert the UAGRERUN step ahead of any IF statements in the JCL. This will ensure that UAGRERUN is executed ahead of any initial EXEC or PROC statement that may be enclosed within an IF statement.

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
D-11900UnixUAGSRVEnsure that failed attempts to launch child processes spawned by UAG Server (via the ./ubroker/sbin/cskern utility) are handled gracefully.
D-11974Unix
Windows		UAGSRV

Fixes an issue where Program and Variant Names do not appear in their respective drop down lists when adding an ABAP Program Job Step to an SAP Task.

The failure applies to Load Balancing (Type-B) connections only and results in a "Missing required Value for RFC Connection" error.

D-12221z/OSUAGSRV

Prevent a JCL error by ensuring that line numbers are not pulled into a JCL statement when

  • The JCL used for a z/OS task contains line numbers, and
  • A z/OS task variable is replaced with a value that is shorter than the variable name

The fix also prevents truncation of JCL statements that contain in-line data with hexadecimal values.

D-12222z/OSUAGRERUN
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.

Universal Broker

Release 7.6.0.4 - September 10, 2024

Change IDPlatformsComponentDescription
D-12633Unix
Windows		UBROKERManage uems.db growth by removing information for an event occurrence upon completion.

Release 7.6.0.1 - May 14, 2024

Change IDPlatformsComponentDescription
D-12559All (except HP-UX)

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

Update the OpenSSL library that Universal Agent uses to OpenSSL 1.1.1w.

Release 7.6.0.0 - April 3, 2024

Change ID

Platforms

Component

Description

B-16966z/OSUBROKER

Provides a change that causes the Universal Broker on z/OS to mount the UNVSPOOL file system with the zFS RWSHARE option to prevent sharing violations in a Sysplex configuration.


B-17891Unix (except HP-UX and Solaris)
Windows

UAGSRV
UBROKER
UFTP

Add end-to-end OpenTelemetry tracing support to UFTP when run from a File Transfer or Remote File Monitor task. Tracing support is also available for stand-alone UFTP execution.

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

Universal Command

Release 7.6.0.1 - May 14, 2024

Change IDPlatformsComponentDescription
D-12559All (except HP-UX)

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

Update the OpenSSL library that Universal Agent uses to OpenSSL 1.1.1w.

Release 7.6.0.0 - April 3, 2024

Change ID

Platforms

Component

Description

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

Universal Connector for SAP

Release 7.6.0.5 - October 8, 2024

Change IDPlatformsComponentDescription
D-12976Unix
Windows		USAPPrevent a possible crash when executing the DISPLAY selscreen command with USAP.

Release 7.6.0.2 - June 11, 2024

Change IDPlatformsComponentDescription
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.

Release 7.6.0.0 - April 3, 2024

Change ID

Platforms

Component

Description

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

Universal Control

Release 7.6.0.1 - May 14, 2024

Change IDPlatformsComponentDescription
D-12559All (except HP-UX)

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

Update the OpenSSL library that Universal Agent uses to OpenSSL 1.1.1w.

Release 7.6.0.0 - April 3, 2024

Change ID

Platforms

Component

Description

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

Universal Data Mover

Release 7.6.0.5 - October 8, 2024

Change IDPlatformsComponentDescription
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.

Release 7.6.0.2 - June 11, 2024

Change IDPlatformsComponentDescription
D-12020AllUDM
UDMSRV		Expands support for files whose names contain multibyte (i.e., Unicode) characters.

Release 7.6.0.1 - May 14, 2024

Change IDPlatformsComponentDescription
D-12559All (except HP-UX)

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

Update the OpenSSL library that Universal Agent uses to OpenSSL 1.1.1w.

Release 7.6.0.0 - April 3, 2024

Change ID

Platforms

Component

Description

B-17011

Unix
Windows

UDM
UDMSRV

Introduces the following UDM variables that provide access to the following Utility Agent credential and hostname information:

  • $(ops_utility_cred_user)
  • $(ops_utility_cred_pwd)
  • $(ops_utility_agent_name)
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

Universal Event Monitor

Release 7.6.0.1 - May 14, 2024

Change IDPlatformsComponentDescription
D-12559All (except HP-UX)

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

Update the OpenSSL library that Universal Agent uses to OpenSSL 1.1.1w.

Release 7.6.0.0 - April 3, 2024

Change ID

Platforms

Component

Description

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

Universal Extension

Release 7.6.0.3 - July 9, 2024

Change IDPlatformsComponentDescription
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

Release 7.6.0.0 - April 3, 2024

Change ID

Platforms

Component

Description

B-16983

Unix (except HP-UX)
Windows

UAGSRV
UEXT

Add the ability to resolve the following Controller functions when embedded in text and array fields of a Universal Extension:

  • Credential functions
  • Script functions
  • SAP Connection functions
  • Database Connection functions
  • Task Instance/Sibling Task Instance Output Path
  • Variable Path functions

Note

This is a companion item to the Universal Controller enhancement B-16984.

B-18730Unix (except HP-UX)
Windows

UAGSRV
UEXT

Provides a change to the Universal Extension Event API to support arrays (Python list) as attribute values.

D-11526WindowsUIP-VSCODE

Fixes a problem where a debugging session will not start if the Debug button in the "Run and Debug" section of the activity bar is selected.

Prior to this change, the only way to start a debugging session was with F5.

D-11862WindowsUIP-VSCODE

Fixes a problem where a user specifies a dynamic choice field in the configuration.yml file that does not exist, and there are no dependent fields specified in the template.json file.

In this situation, the debugger fails to launch, and the error message KeyError: 'raw_type' is displayed.

D-12338

Unix (except HP-UX)
Windows

UEXT

Fixes Universal Extension support for Python's async functionality that was provided in Python 3.9.

Full async functionality is supported in

  • Normal task execution
  • Dynamic commands, and
  • Dynamic choice commands.


Universal FTP Client

Release 7.6.0.1 - May 14, 2024

Change IDPlatformsComponentDescription
D-12559All (except HP-UX)

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

Update the OpenSSL library that Universal Agent uses to OpenSSL 1.1.1w.

Release 7.6.0.0 - April 3, 2024

Change ID

Platforms

Component

Description

B-17891Unix (except HP-UX and Solaris)
Windows

UAGSRV
UBROKER
UFTP

Add end-to-end OpenTelemetry tracing support to UFTP when run from a File Transfer or Remote File Monitor task. Tracing support is also available for stand-alone UFTP execution.

Universal Message Service (OMS)

Release 7.6.0.1 - May 14, 2024

Change IDPlatformsComponentDescription
D-12559All (except HP-UX)

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

Update the OpenSSL library that Universal Agent uses to OpenSSL 1.1.1w.

Release 7.6.0.0 - April 3, 2024

Change ID

Platforms

Component

Description

B-18578All

OMS
UAGSRV

Update the Agent to rely on a dynamically-generated key to decrypt sensitive information obtained from the Controller.


Note

This change deprecates the Universal Agent's AUTHVER configuration option.

The option, if configured, will still be recognized by UAG Server, but will no longer be honored.

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

Installation Changes

Release 7.6.0.5 - October 8, 2024

Change IDPlatformsComponentDescription
D-12265WindowsINSTALLSuppress all message boxes and dialogs when the user mode install is run in SILENT mode.

Release 7.6.0.0 - April 3, 2024

Change ID

Platforms

Component

Description

B-15867WindowsINSTALL

Sign all Universal Agent binaries and packages with a digital signing certificate.

To view Certificate information, view the installed file's properties from Windows Explorer and select the Digital Signatures tab.

B-17038Solaris Intel
Solaris SPARC		INSTALL

Drop support for Solaris 10.

Starting with Universal Agent 7.6.0.0, installs are only permitted on Solaris 11. The install will be allowed to continue on any Solaris 11 system, but only Solaris 11.4 is certified.


Critical Information

This is a breaking change for upgrades from Universal Agent versions prior to 7.6.0.0.

If you are running an OMS Server on a Solaris Intel system and attempt to upgrade to 7.6.0.0 or later, the OMS message file can no longer be read.

The reason is that Universal Agent versions prior to 7.6.0.0 were 32-bit on Solaris Intel. Starting with 7.6.0.0, Solaris Intel deliveries are 64-bit. If Universal Agent 7.6.0.0 or later attempts to read an OMS message file created by an earlier 32-bit Universal Agent, the OMS Server will crash.

For the best upgrade experience and to minimize any unexpected downtime, please refer to this section.

Upgrades on Solaris SPARC are not affected.

B-17111IBM iINSTALLCertify the IBMi Universal Agent 5.1.1 for IBM i 7.5.
B-17883AllINSTALL

Add PGP signatures to Universal Agent distribution files.

For information on verifying these signatures, please refer to the following information.


Python Distribution for Universal Agent

Release 7.6.0.4 - September 10, 2024

Change IDPlatformsComponentDescription
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.

Release 7.6.0.2 - June 11, 2024

Change IDPlatformsComponentDescription
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

Release 7.6.0.0 - April 3, 2024

Change ID

Platforms

Component

Description

B-17935Unix (except HP-UX)
Windows		PYTHON

Update the Universal Agent's Python distribution to 3.11.6.

The 3pp modules listed below were updated for this distribution. The module is provided for all platforms, except where noted:

  • azure-storage-blob==12.19.1
  • boto3==1.34.62
  • cx_Oracle==8.3.0 (Windows only)
  • docker==7.0.0 
  • google-cloud-storage==2.15.0
  • hdbcli==2.19.21 (Windows only)
  • hdfs==2.7.3 (Linux and Windows only)
  • kubernetes==29.0.0 (Linux and Windows only)
  • paramiko==3.4.0 
  • pyodbc==5.1.0 (Linux Intel and Windows only)
  • requests==2.31.0
D-12323Unix (except HP-UX)PYTHONDelivers a fix within the updated Python distribution that ensures the built-in _ssl and _hashlib modules are imported correctly.