cjstartrecover (recover J2EE server transaction)
- Organization of this page
Format
cjstartrecover [server-name] [-nosecurity] [-nostartapp]
[[-p key-name=value] ...] [-t timer-monitoring-time]
Function
This command starts a J2EE server in recovery mode, which is used exclusively for recovery processing.
A J2EE server that is started in recovery mode terminates as soon as the transaction recovery processing is completed.
Arguments
- server-name
-
Specifies the server name of the J2EE server to be recovered. If the server name is omitted, the host name is assumed.
- -nosecurity
-
Specifies that the SecurityManager is to be released. Although the overhead for permission checking during resource access decreases, the security level also decreases because the J2EE application can access any resource.
- -nostartapp
-
Specifying this option avoids situations in which an application cannot be swapped out, such as when a J2EE application that has fallen into an endless loop or is performing some other invalid operation starts automatically when the J2EE server is restarted, even after the server has been terminated forcibly.
When the J2EE server is started with this option specified, a registered J2EE application on which one of the following operations is performed is not started if this option is omitted the next time the J2EE server is started:
-
Setting the application property
-
Adding resources (filter, WAR, EJB-JAR, or resource adapters)
-
Deleting resources (filter, WAR, EJB-JAR, or resource adapters)
-
Importing library JAR
-
Deleting library JAR
-
Replacing applications
-
Generating SQL statements for the CMP2.x Entity Bean
If a running J2EE application is exported together with execution information, the J2EE application is started automatically when this EAR file is imported, regardless of whether the -nostartapp option is specified.
-
- -p key-name=value
-
Specifies a system property of the JavaVM that executes the J2EE server. The items that can be specified are keys of usrconf.properties (user properties file for the J2EE server). For the usrconf.properties (user properties file for the J2EE server), see 2.2.3 usrconf.properties (User property file for J2EE servers) in the uCosminexus Application Server Definition Reference Guide.
When you specify for the value a character string that includes a space or a special character (such as "|" or "&"), you must enclose the value in double quotation marks (").
If a specified key name duplicates the key name of a property defined in the user properties file for the J2EE server, the property value specified with the -p option has priority. If a specified property value contains an error, the specification for the specified property key name is used. If the specified property key name contains an error, the command ignores the specification and continues processing.
- -t timer-monitoring-time
-
Specifies a timer monitoring time (in seconds), as an integer in the range 0 to 3600.
If recovery processing is not completed within the amount of time specified here, the command terminates the J2EE server forcibly. If this option is omitted, a monitoring time of 0 seconds is set.
When 0 is specified (or assumed) as the timer monitoring time, the command does not execute timer monitoring and waits until the J2EE server terminates.
Input examples
cjstartrecover MyServer -t 300
Return values
- 0:
-
The command terminated normally.
- 1:
-
The command terminated abnormally.
- 2:
-
The command was forcibly terminated due to a timeout.
Notes
-
To execute the cjstartrecover command in Windows, you must have administrator permission.
-
To execute the cjstartrecover command in UNIX, you must have root permission (if Component Container Administrator is not set) or Component Container Administrator permission (if Component Container Administrator is set).
-
When you specify server name in command argument, the server name should be immediately after the command name. You can specify the other arguments in any order as long as they are subsequent to the server name (or subsequent to the command name if the server name is omitted). However, you cannot switch the sequence of an option name and its corresponding value (Example: timer-monitoring-time -t); also, you cannot specify an option name in conjunction with a non-corresponding value (Example: -t key-name=value -p timer-monitoring-time).
-
When you specify a server name in the command arguments, you must specify a case-sensitive character string that matches a server name specified in a cjsetup (set up or unsetup J2EE server).
-
When you specify the -t option in the command arguments, you must specify it after the other arguments. When setting the timer monitoring time, you must also consider the transaction time timeout value and the time required for J2EE server startup processing, and then set a longer time.
-
The OS being used might limit the character string length that can be specified on the command line that can be considered if you specify the -p option multiple times.