Once again, changes made to the Agent Configuration (.cab) file are not effective until they are applied, allowing Publisher agent maintenance to be done outside of the critical upgrade path. The apply operation instructs the Publisher to begin processing based on the changes previously issued but not yet actually applied to the agent itself.
In order to apply changes, the agent must first be stopped. This operation in effect pauses the agent task and permits the additions and/or modifications to the configuration to be applied. Once the agent is restarted, the updated configuration will be active.
//*----------------------------------------
//* STOP THE AGENT
//*----------------------------------------
//STOP EXEC SQDCONF
//SQDPARMS DD *
stop <cab_file_name>
//*
//*----------------------------------------
//* APPLY UPDATED CONFIGURATION FILE
//*----------------------------------------
//APPLY EXEC SQDCONF
//SQDPARMS DD *
apply <cab_file_name>
//*
//*----------------------------------------
//* START THE AGENT
//*----------------------------------------
//START EXEC SQDCONF
//SQDPARMS DD *
start <cab_file_name>
//*