jcachange
- Organization of this page
Function
This command reloads the automated action definition file or places the automated action function on standby.
If both options are omitted, the command reloads the automated action definition file. After you have changed the contents of the automated action definition file, you use this command to activate the modified action definitions by reloading the file.
This command skips invalid action definitions in the automated action definition file, and continues processing.
If the automated action definition file contains an invalid action definition, the command displays the KAVB5104-W message. If you want to reload the automated action definition file you edited, before executing the jcachange command, execute the jcamakea command to make sure there are no errors in the automated action definition file.
If the KAVB5104-W message is displayed, review the contents of the automated action definition file.
If the loaded automated action definition file contains no valid action definitions, the command displays the KAVB4053-I message and places the automated action function on standby.
A reloaded automated action definition parameter that exceeds the maximum size is ignored by the command. For details about the size of an automated action definition parameter, see Automated action definition file (actdef.conf) in 2. Definition Files.
Format
jcachange [-n] [-h logical-host-name]
Execution permission
In Windows: Administrator permissions (if the Windows UAC feature is enabled, the command is executed from the administrator console)
In UNIX: Superuser permissions
Storage directory
- In Windows:
-
Console-path\bin\
- In UNIX:
-
/opt/jp1cons/bin/
Arguments
- -n
-
Specifies that the automated action function is to be placed on standby. No actions are executed even if an event that matches an action definition is received.
To restart the automated action function, either execute the jcachange command with no options specified or restart JP1/IM - Manager.
- -h logical-host-name
-
When you are operating in a cluster system, this option specifies the logical host name. The command reloads or places on standby the action definitions for the specified logical host. If this option is omitted, the logical host name specified in the JP1_HOSTNAME environment variable is assumed. If the JP1_HOSTNAME environment variable is not specified, the physical host name is assumed. If you are not using a cluster system, specification of this option is not needed.
Return values
0 |
Normal termination |
1 |
Invalid argument |
2 |
Pipe-related error |
4 |
There was no response from the automated action function |
5 |
Command failed to reload the automated action definition file or place the automated action function on standby |
-13 |
A specified argument value was invalid |
-102 |
File input/output error |
Other value |
System error |