9.5 monbegin (starts a server in the monitor mode)
Format
- Starting a server:
-
monbegin server-alias-name
- Starting a server (the return code reflects the result of the server start command):
-
monbegin -w server-alias-name
Users who can execute the command
Superuser and general user
Description
The monbegin command starts a server in the monitor mode.
Options
-
server-alias-name
Specifies the server alias name of the server that is to be started.
-
-w
The command returns results after server start processing is completed. Specify this option if you want to confirm the server start result from the return code of the command. You can specify this option if yes is specified for the waitserv_exec operand in the server environment definition.
If a server is placed in a wait state#, the monbegin command does not return results until the server is started or stopped. For details about how to start and stop a server in a wait state, see 7.4.1 Starting a server in the wait state and then restarting jobs.
- #
-
The server is in either of the following states:
• Waiting for the active server to start
• Waiting for the resource server to start
Return codes
If the -w option is not specified:
|
Value |
Meaning |
|---|---|
|
0 |
Normal termination (the request to start a server in the monitor mode has been accepted) |
|
Other than 0 |
Abnormal termination |
If the -w option is specified:
|
Value |
Meaning |
|---|---|
|
0 |
Normal termination (the command successfully started the server in monitor mode)# |
|
Other than 0 |
Abnormal termination (the command failed to start the server in monitor mode)# |
- #
-
This return code does not indicate whether resource connection was successful.
Notes
-
The monbegin command can be used only for servers in the monitor mode.
-
If the -w option is not specified, the command starts the server asynchronously with the return of the monbegin command results.
-
If the -w option is not specified, the monbegin command outputs a KAMN376-I message and returns 0 as the return code when it receives a server start request, regardless of the status of the specified server.