jpctool service register
- Organization of this page
Format
jpctool service register -id service-ID [-host host-name] [-lhost logical-host-name]
Function
The jpctool service register command re-registers into Performance Management the service information for a deleted Performance Management program.
Normally, the jpctool service delete command, which deletes service information, cannot delete service information that is active. However, such service information can be deleted if the service's activation status cannot be verified because of a communication error, etc. If active service information has been inadvertently deleted because of a communication error, etc., you can use the jpctool service register command to re-register the service's information after the communication error has been corrected.
Hosts that can execute the command
PFM - Manager
Execution permission
- In Windows:
-
-
User with Administrators permissions
-
User with Backup Operators permission
-
- In UNIX:
-
User with root user permissions
Installation directory
- In Windows:
installation-folder\tools\
- In UNIX:
/opt/jp1pc/tools/
Arguments
-id service-ID
Specifies a service ID. For service-ID, specify a string of 1 to 258 bytes.
You can use a wildcard character to specify multiple service IDs. In this case, processing of the remaining services continues, even if an error occurs on one service. If errors occur on multiple services, the command returns a value for the last error that occurred.
-host host-name
Specifies a host name if service information for a specific host is to be re-registered. For host-name, specify a string of 1 to 32 bytes, consisting of alphanumeric characters with no space characters. If you omit this option, the local host is assumed.
You can use a wildcard character to specify multiple host names.
-lhost logical-host-name
Specifies a logical host name if this command is to be executed by a host in a logical host environment, not in the physical host environment. For logical-host-name, specify a string of 1 to 32 bytes, consisting of alphanumeric characters with no space characters. If you omit this specification, the physical host is assumed. Wildcard characters cannot be used.
Notes
-
Arguments must be specified in the order that they appear in the description. Otherwise, they will not be recognized correctly.
-
This command cannot be executed if the Name Server service, Master Manager service, or the specified service are stopped.
-
If command execution is interrupted by pressing the Ctrl + C keys or by a signal, a predefined return value is not returned. Therefore, you should ignore the return value when the command was interrupted by the Ctrl + C keys or by a signal.
-
Service information for the Name Server and Status Server services cannot be registered.
Return values
0 |
The command terminated normally. |
1 |
An argument specification is invalid. |
2 |
The user does not have execution permission for the command. |
3 |
One or more of the specified services is not active. |
5 |
PFM - Manager has not been installed. |
7 |
The specified service ID belongs to the Name Server or Status Server service. |
100 |
The Performance Management environment is invalid. |
101 |
Name Server service, Master Manager service, or the specified service is not active. |
102 |
The specified logical host name has not been set up. |
200 |
A memory shortage occurred. |
210 |
A disk space shortage occurred. |
211 |
A file or directory cannot be accessed. |
220 |
A host name specified in the service configuration information file is invalid. |
222 |
A communication error occurred. |
255 |
An unexpected error occurred. |
Usage example
This example re-registers the service information of all Performance Management programs at the host03 host:
jpctool service register -id * -host host03