jajs_pmtcon
- Organization of this page
Format
- For JP1/AJS3 - Manager
jajs_pmtcon [-h logical-host-name] {-a|-m} [-v|-u]
- For JP1/AJS3 - Agent
jajs_pmtcon [-h logical-host-name] -a [-v|-u]
Description
Performs either of the following operations depending on the specified options:
-
Enables the contents of the connection permission configuration file.
-
Outputs a list of the hosts that are currently permitted to connect.
Execution privileges
In Windows: Administrators privileges
In UNIX: Superuser privileges
Arguments
-h logical-host-name
Specifies the name of the logical host for the processing.
You can specify a character string of 1 to 255 bytes.
If you omit this option, the logical host name specified in environment variable JP1_HOSTNAME is assumed. If the JP1_HOSTNAME environment variable has not been specified, the physical host is assumed.
If the local host name is specified and if the local host name is the same as the logical host name, the local host acts as a logical host. If the name is not the same as the logical host name, the host acts as if the physical host had been specified.
If JP1_DEFAULT is specified in the -h option, the KAVS0103-E message is output and the command terminates abnormally. If JP1_DEFAULT is specified in the JP1_HOSTNAME environment variable, the KAVS0187-E message is output and the command terminates abnormally.
-a
Specifies that the connection source restriction function for agents is used for the processing.
If the -m option is specified concurrently, the KAVS0116-E message is output and the command terminates abnormally.
-m
Specifies that the connection source restriction function for managers is used for the processing.
If the -a option is specified concurrently, the KAVS0116-E message is output and the command terminates abnormally.
The -m option can be specified only in JP1/AJS3 - Manager. If it is specified in JP1/AJS3 - Agent, the KAVS0100-E message is output and the command terminates abnormally.
-v
Outputs the status of the connection source restriction function, the date and time applied, and a list of the IP addresses of the hosts that are currently permitted to connect. If the connection source restriction function is disabled, the date and time and the list are not output.
If the -u option is specified concurrently, the KAVS0116-E message is output and the command terminates abnormally.
For an example of the output of this option, see Output example.
-u
Enables the contents of the connection permission configuration file.
For details about the connection permission configuration file, see 4.4 Settings for restricting connections to JP1/AJS3 in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1 (for Windows) or 14.4 Settings for restricting connections to JP1/AJS3 in the Job Management Partner 1/Automatic Job Management System 3 Configuration Guide 1 (for UNIX).
If the -v option is specified concurrently, the KAVS0116-E message is output and the command terminates abnormally.
Return values
0 |
Normal end |
Values other than 0 |
Abnormal end |
Example
- The following command enables the agent connection permission configuration file:
jajs_pmtcon -a -u
- The following command outputs a list of hosts that are permitted to connect to the agent:
jajs_pmtcon -a -v
Output example
The following shows an example of outputting a list of hosts that are permitted to connect to the agent.
Notes
-
If you want to delete a manager host IP address from the agent connection permission configuration file, make sure that a job has not been requested to execute from the manager host before you execute the command. If you attempt the deletion during execution of a job, internal JP1/AJS communication is refused, and the job cannot be forcibly terminated. If you mistakenly delete the IP address of the manager host and need to forcibly terminate a running job, add the IP address of the manager host to the agent connection permission configuration file and then retry.
-
Do not execute multiple instances of this command concurrently. If you do so, the contents of the connection permission configuration file might not be updated correctly.
-
If the shared memory used by the connection source restriction function is inadvertently deleted, this command will not operate correctly as explained in the following:
-
If this command is executed with the -v option specified, the command outputs not restricted as the results, even though the actual status is restricted.
-
If this command is executed with the -u option specified, the KAVS8034-E message is output and the command terminates abnormally.
For this command to operate correctly, stop both the JP1/AJS3 service and JP1/AJS3 Queueless Agent service, and then restart both services.
-