When you start CRM from the command line, the CRM Command Line Console puts its prompt in the window and, if exited, shuts down all of the active links.
CRM has two types of log files stored in
$APPDIR,
RSTRTLOG, and
BLOBLOG. RSTRTLOG is the transaction state log used during the recovery process, while the
BLOBLOG log stores session and link information. Deleting the log files requires a cold start for each link involved. You can use the
CRMLOGS command to display the contents and state of the
CRM log files.
•
|
0 = No tracing. Setting this level effectively disables CRM tracing and closes the trace file, if there is one. If tracing is subsequently restarted, a new file is created with an incremented numerical suffix.
|
•
|
1 = Minimum tracing. At this level, CRM traces only major events and is sufficient only to determine the sequence of application conversations.
|
•
|
2 = Medium tracing. At this level, CRM also traces all I/O buffers.
|
•
|
3 = Maximum tracing. At this level, CRM also traces all APPC verbs.
|
Note:
|
-P and -R impact all CRM links.
|
-P and
-R can be set together, but only the polling interval is valid, thr retry interval is ignored. If a link is stopped by CRM utilities (for example,
CRMLKOFF),
-R is invalid.
APPDIR must be set to the application directory.
CRM exits with a return code of 0 upon successful completion.
When you start CRM from the UNIX command line, the following CRM Command Line Console appears:
To launch CRM with the console running in the background:
To launch CRM with detailed tracing and APPC Stack API tracing turned on from the command line using the host/port address, type:
Use the CRMLOGS command to display the contents and state of the two
CRM log files.
RSTRTLOG is the transaction state log used during the recovery process and the
BLOBLOG log stores session and link information. Deleting the log files requires a cold start for each link involved.
CRMLOGS requires the following parameters:
CRMLOGS exits with a return code of 0 upon successful completion.
crmretrc retrieves trace from CRM, which is specified in command line. It can be used from any machine located on the same TCP/IP network as the machine running the CRM server; it can only be used on open system as CRM is usually used on MF.
crmretrc returns 0 upon successful completion, and returns 1 as failed with error messages.
crmlkon starts all of the CRM links named on the command line. This command is useful if one or more individual links failed to start when the CRM server booted. Use this command from any machine located on the same TCP/IP network as the machine running the CRM server. When used in a script,
crmlkon will return
0 if the command could be sent to the target CRM. It will return
1 if the command could not be sent to the target CRM.
To start links link2 and
cicstest owned by the CRM running on
mach1 at port 5000:
crmlkon only checks the syntax of the command. Separate facilities, either jsnacrm or mainframe-based facilities must be used to determine if the link actually became active. If the command could not be successfully sent to the CRM,
crmlkon prints an error message if in verbose mode and exits with error code 1. Upon successful completion,
crmlkon exits with exit code 0.
crmlkoff stops all of the CRM links named on the command line. This is useful if one or more individual links need to be stopped after the CRM server booted. It can be used from any machine located on the same TCP/IP network as the machine running the CRM server. It can be used in a script and will return 0 if the command could be sent to the target CRM. It will return 1 if the command could not be sent to the target CRM.
To stop links link1 and
cicstest owned by the CRM running on
mach at port 5000:
crmlkoff only checks the syntax of the command. Separate facilities, either
jsnacrm or mainframe based facilities, must be used to determine if the link actually became inactive. If the command could not be successfully sent to the CRM,
crmlkoff prints an error message if in verbose mode and exits with error code
1. Upon successful completion,
crmlkoff exits with exit code
0.
crmdown shuts down the CRM specified on the command line. It can be used from any machine located on the same TCP/IP network as the machine running the CRM server. It can be used in a script and will return
0 if the command could be sent to the target CRM. It will return
1 if the command could not be sent to the target CRM.
crmdown only checks the syntax of the command. If the command could not be successfully sent to the CRM,
crmdown prints an error message if in verbose mode and exits with error code
1. Upon successful completion,
crmdown exits with exit code
0.