The MODIFY command zosConnect-3.0

Use the MVS system MODIFY command to refresh the z/OS Connect Server API and API requester WAR files and configuration files.

zosConnect-3.0 Applies to zosConnect-3.0.

Started task Applies to z/OS Connect Servers run by using a z/OS started task procedure.

MODIFY system commands are required after initial startup of the z/OS Connect Server in order to update application and server resources. For more information about the Liberty server MODIFY command, see A launch icon to indicate a link opens a new tab or window. Modify commands on z/OS in the WebSphere Application Server for z/OS Liberty documentation.

Syntax

Use the following command to specifically update process pending application updates.
MODIFY <jobname>,REFRESH,APPS
Use the following command to specifically update process pending configuration updates.
MODIFY <jobname>,REFRESH,CONFIG
Use the following command to refresh keystores, including SAF key rings.
MODIFY REFRESH,KEYSTORE

You can abbreviate the MODIFY command to F.

Parameters

jobname
Specifies the job name of the target server.

Options

REFRESH
Required.
Specifies that the z/OS Connect Server artifacts be refreshed. These artifacts include API WAR project files and configuration files.
APPS
Required.
Specify this parameter to process pending application updates. The updateTrigger attribute on the applicationMonitor element that is in the configuration file must also be set to mbean.
CONFIG
Required.
Specify this parameter to process pending configuration updates. The updateTrigger attribute on the config element that is in the configuration file must also be set to mbean.

Configuration processing applies to the configuration file, any files it includes, and any configuration files placed in the configDropins/overrides or configDropins/defaults directory.

Examples

refresh
The following command reloads and restarts the applications.
modify zosconn01,refresh,apps
The following example is the same command as the previous example with the MODIFY replaced with F.
/F zosconn01,REFRESH,APPS
The following command processes any pending configuration updates.
modify zosconn01,refresh,config

The following example is the same command as the previous example with the MODIFY replaced with F.

/F zosconn01,REFRESH,CONFIG

If you need to distinguish between multiple jobs that use the same job name, use <jobname>.<idenifier>

modify zosconn01.1023,refresh,config