jevent, jtool event
jevent is a command-line system tool for raising a named event.
Note: For installation instructions, see jtool.
Syntax
Copy
jevent [-h|-?|-help] [-l <loglevel>] [-f <logfile>] -j|-job-context|<connfile>
[-s|-silent] <event> [<comment>]| Argument | Description |
|---|---|
| -s | Silent mode (no output will be generated). |
| -h, -?, -help | Shows the help. |
-l <loglevel> |
Sets the log level. |
-f <logfile> |
Logs to a file instead of stdout and stderr. |
| -j,-job-context | Specifies that the jevent should run in a job context. If this is not the case, a connection file <connfile> is required. |
<connfile>
|
A connection file. This is required when -job-context is not specified. You can generate this file with jsecret -c. |
<event name>
|
The name (<partition>.<name>) of the event to raise. The default Partition is GLOBAL. |
<comment>
|
The raiser comment. |
TLS Arguments
| Argument | Environment Variable | Description |
|---|---|---|
| -tlsv1_3, -tls13 | JCS_SSL_METHOD=tlsv1_3
|
Use TLS v1.3 secured connection. |
| -tlsv1_2, -tls12 | JCS_SSL_METHOD=tlsv1_2
|
Use TLS v1.2 secured connection. |
| -tlsv1_1, -tls11 | JCS_SSL_METHOD=tlsv1_1
|
Use TLS v1.1 or better secured connection. |
| -tlsv1, -tls | JCS_SSL_METHOD=tlsv1
|
Use TLS v1.0 or better secured connection (default). |
| -sslv3, -ssl | JCS_SSL_METHOD=sslv3
|
Use SSL v3 or better secured connection. |
-cipherlist <text> |
JCS_SSL_CIPHERLIST
|
Set list of available ciphers. |
-passphrase <text> |
JCS_SSL_PASSPHRASE
|
Set passphrase for private key. |
-key <file> |
JCS_SSL_KEYPATH
|
Set private key. |
-cert <file> |
JCS_SSL_CERTIFICATE_PATH
|
Set public certificate. |
-ca <file|path> |
JCS_SSL_TRUSTED_CERTIFICATE_FILE
|
Trusted CA certificates path or file. |
| -[no]verify | JCS_SSL_VERIFY_CERT
|
(Do not) verify peer (server or client) certificate. |
-verify-names <namelist> |
JCS_SSL_VERIFY_SERVER_NAMES, JCS_SSL_VERIFY_CLIENT_NAMES |
Verify peer (server or client) certificate hostname against list. |
Proxy Setting Environment Variables
The following environment variables are used to retrieve proxy server connection details.
HTTP_PROXY: The URL of the proxy server. For example:https://proxy.example.com:3128.PROXY_USER: The user for the proxy server. This value is ignored ifHTTP_PROXYis not set.PROXY_PASSWORD: The password for the proxy user. This value is ignored ifHTTP_PROXYis not set.NO_PROXY: Enforces a direct connection.
These environment variables override the settings in the connection file for all tools that connect to the central Redwood server.
Example
In this example, the RunMyJobs server is named pr1.example.com and its port is 50000. Note that when you enter your password for the connection file, no text is displayed as you type to protect your security.
Copy
D:\Agent\&agent_release;\bin>jsecret -c ..\..\net\instance\default\example.conn pr1.example.com:50000 GLOBAL
Username:jdoe
Password:
D:\Agent\9_2_11_20230727_10\bin>jevent ..\..\net\instance\default\example.conn -s "FinancialsLoadedSuccessfully" "Event raised from jevent"
Login successful on pr1.example.com
Successfully raised event with ID 74
D:\Agent\9_2_11_20230727_10\bin>Note: Redwood recommends you store your connection files in the directory for your instance.