Start RJE Session (STRRJESSN)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
Start RJE Session
The STRRJESSN command starts a session. Each session that is active or pending restart must have a unique name. In addition, STRRJESSN controls the operation of automatic restart for that session. If the default values are used, no attempt will be made to restart the session if it ends abnormally.
When readers and writers are started, start commands can be sent to the host subsystem to start the associated host functions. If you specify SNDSTRCMD(*YES), only the start commands for the readers and writers being started are sent. If the host subsystem reader or writer is already started, some host subsystems return error messages. RJE ignores these messages. If you specify SNDSTRCMD(*NO), the start commands for the specified readers and writer are not sent.
Error messages for STRRJESSN
*ESCAPE Messages
- RJE0012
- RJE session &1 in &2 is already active.
- RJE0024
- Errors found. Processing of request ended.
- RJE0045
- Session &1 needs at least two communications entries.
- RJE0228
- You require job control authority.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| SSND | RJE session description | Qualified object name | Required, Positional 1 |
| Qualifier 1: RJE session description | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| RDRS | Start RJE readers | *YES, *NO | Optional, Positional 2 |
| WTRS | Start RJE writers | *YES, *NO | Optional, Positional 3 |
| SNDSTRCMD | Send HOST start commands | *YES, *NO | Optional |
| CLRMSGQ | Clear RJE message queue | *YES, *NO | Optional |
| RETRIES | Number of retries | 1-99, *NONE | Optional |
| INTERVAL | Retry interval | 1-60, 10, *NONE | Optional |
| PGM | Program to call | Single values: *NONE Other values: Qualified object name |
Optional |
| Qualifier 1: Program to call | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB |
| Top |
RJE Session Desc (SSND)
Specifies the qualified name of the session description for the session being started.
The possible library values are:
- *LIBL: The library list for the job that issued the command is used to locate the session description.
- *CURLIB: The current library for the job is used to locate the session description. If no current library is specified, QGPL is used.
- library-name: Specify the name of the library where the session description is located.
session-description-name: Specify the name of the session description. This session description must have been created by the CRTRJECFG or CRTSSND command.
| Top |
Start RJE Readers (RDRS)
Specifies whether the readers defined in the session description are started.
The possible values are:
- *YES: Readers are started. That is, all reader job queues defined in the session description are released by RJE, and a START command is sent to the host subsystem. Only readers with corresponding communications entries are started. The corresponding communications devices also must be varied on, or the session is not started.
- *NO: Readers are not started. Use the STRRJERDR command to start the readers after the session is active.
| Top |
Start RJE Writers (WTRS)
Specifies whether the writers defined in the session description are started.
The possible values are:
- *YES: Writers are started. Corresponding communications devices must be varied on, or the session is not started.
- *NO: Writers are not started. If a request is received from the host subsystem for a writer that is not started, a message is sent to the RJE message queue. The data is held by the host subsystem until the writer is started. Use the STRRJEWTR command to start the writers after the session is active.
| Top |
Snd Host Start Cmd (SNDSTRCMD)
Specifies whether, when the session is started, commands are sent to the host subsystem to start its readers and writers.
The possible values are:
- *YES: The start commands are sent.
- *NO: The start commands are not sent. The start commands are sent to the host subsystem if the readers and writers are canceled and restarted in the same session. Use this option for RJE sessions in which the host logon procedure is set up to automatically issue the reader and writer start commands.
| Top |
Clear RJE MSGQ (CLRMSGQ)
Specifies whether the messages from previous sessions are printed and cleared from the session description message queue.
The possible values are:
- *YES: Messages from the previous session are printed, and the session message queue is cleared.
- *NO: The messages are not printed, and the queue is not cleared.
Note: The CLRMSGQ parameter only takes effect when the session is initially started. If the session is restarted by automatic restart, CLRMSGQ is set to *NO.
| Top |
Number of Retries (RETRIES)
Specifies the number of times automatic restart will attempt to restart a session that has ended abnormally.
The possible values are:
- *NONE: No restart attempts are made.
- number-of-retries: Specify a value, from 1 to 99, to indicate the number of restart attempts.
| Top |
Retry Interval (INTERVAL)
Specifies the length of time in minutes between each retry attempt.
The possible values are:
- 10: Retries will take place every 10 minutes until the session successfully restarts or the retries number is exceeded.
- retry-interval: Specify a value between 1 and 60 to indicate the number of minutes.
- *NONE: The interval between retry attempts is controlled by the user program.
| Top |
Program to Call (PGM)
Specifies a user program that will be called by automatic restart prior to each restart attempt. If automatic restart is activated, a user program should be used to recover the connection to the host system. RJE makes no attempt to recover this connection.
The possible values are:
- *NONE: A user program is not provided.
- program name: Specify the name of a user program. If a library name is not specified, *LIBL is used.
Note: The user is responsible for providing the program and for ensuring that it runs successfully, and returns control to RJE.
If a user program is specified when the RETRIES parameter is *NONE, an error message is issued.
| Top |
Examples
None| Top |
Error messages
*ESCAPE Messages
- RJE0012
- RJE session &1 in &2 is already active.
- RJE0024
- Errors found. Processing of request ended.
- RJE0045
- Session &1 needs at least two communications entries.
- RJE0228
- You require job control authority.
| Top |