Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 7 Next »

Introduction

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

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

Universal Agent Server

Release 7.2.0.0 - April 1, 2022

Change ID

Platforms

Component

Description

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

Universal Broker

Release 7.2.0.0 - April 1, 2022

Change ID

Platforms

Component

Description

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.

Universal Data Mover

Release 7.2.0.0 - April 1, 2022

Change ID

Platforms

Component

Description

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:

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

Universal Extension

Release 7.2.0.0 - April 1, 2022

Change ID

Platforms

Component

Description

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

Universal FTP Client

Release 7.2.0.0 - April 1, 2022

Change ID

Platforms

Component

Description

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. 

Universal Message Service (OMS)

Release 7.2.0.0 - April 1, 2022

Change ID

Platforms

Component

Description

D-10417

Unix
Windows

OMSSRVFix an issue that prevents a zOS Agent using IBM System SSL (i.e., RACF-based keyrings) from connecting to an OMS Server.
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.
  • No labels